NBlog

由一条咸鱼搭建的博客

OPanel: 较大型开源个人项目初尝试

By NriotHrreion2025-09-30

高考之前,我就开始计划暑假要做的项目了。当时是计划做一个小游戏服务器,但奈何项目的饼画得太大,看着满满的计划表,我无力实施,因此,在暑假刚开始时就放弃了这个想法。然而人总是闲不住的,因此我还是把废案中的其中一项单独拉出来做一个项目,这就是OPanel的来历。

经过了两个月的开发,我基本把计划的功能做好了,而且适配了Bukkit、Fabric、Forge的1.21.x。看着日渐庞大的项目仓库,我萌生了一个做开源社区项目的想法,于是我叫来我的老友Deed,让他帮忙设计了一个Logo,然后在暑假的最后几天,我录制了一个宣传片,发到了B站。从发布视频的那一天开始,OPanel的流量就一直保持增长,仓库的star数也在不断增加————我第一次得到了自己的项目被关注的感觉。

项目结构的设计

多模块结构

OPanel作为一个服务器管理面板,势必要同时支持多个平台多个版本,不能只专做一个服务端平台,而且还需要考虑前端网页的部分,因此项目的结构设计至关重要。我并不认为目前的设计就是最优解,但我觉得目前的设计确实是当下较为合适的选择了。

然而我以前并没有做过类似的多平台多版本Minecraft插件项目,因此我一开始就去借鉴了网页地图插件dynmap的项目结构设计。

OPanel使用Gradle来管理项目,并且利用了项目子模块的特性来管理不同平台不同版本的实现代码。这样的设计下,项目被分为一堆模块,其中,core模块存放了网页面板的后端API和供其他模块实现的接口;而其他模块存放的是不同版本的具体实现代码,它们全部依赖于core模块,实现了core模块的接口,以供core模块对不同服务端进行统一的调用和操作。每一个模块都有自己的build.gradle,因此每一个模块都可以单独构建出插件 / 模组jar包。

面板前端

由于我希望把OPanel做成一体式开箱即用的插件,所以我必须将前端网页打进jar包,那么前端网页就不能使用SSR,而只能使用SSG。OPanel的前端使用next.js作为开发框架,但并没有用到任何SSR功能,而且每次修改完前端都必须执行一次npm run build,将前端打包成静态网页文件,并放入java resources文件夹。

个人感受

毕竟是第一次做这样的开源项目、第一次组建和带领开发组(虽然没几个人)、第一次受到这么多关注,激动和开心之余,当然也有紧张与压力。步入大学,平衡生活、学习与项目,并且让项目保持正向发展,这也是对我各方面能力的一种磨砺与考验。当然,OPanel也让我认识了很多服主,服主们反馈了很多bug,提了很多建议,也只有他们才能帮我测出那些实际环境才可能产生的bug。

总之,这个项目对我意义重大,是我的第一次较大型开源项目的实践。