本项目正在被重构,当前发布的临时适应版本中的所有问题都不会得到修复.重构进度请看这里喵.
GMLIB 是一个基于LeviLamina加载器的第三方模组前置库,为基于基岩版专用服务器—— Bedrock Dedicated Server (以下简称BDS)的模组开发者提供更多的API,一定意义上弥补了LeviLamina的API缺口.
GMLIB 封装了大量 LeviLamina 未直接提供的API,为模组开发者提供了更多便利.模组开发者可以调用 GMLIB 提供的API而非重复造轮子.
开发者可以通过使用头文件和静态链接导入本前置库,最终用户需要在服务器内安装GMLIB模组以支持其他模组.对于调用 GMLIB API 库的项目来说,如果GMLIB没有API改动,仅需本项目在底层适配更新即可，给基于该前置的模组的开发与维护带来了很大的便利.
本项目在 0.13.6 版本之前以 LGPL 3.0 协议开源,在其之后的版本源代码不再公开.
🔬 使用lip
首先请确认你以正确安装最新版的 lip 工具
在服务器根目录执行:
lip install github.com/GroupMountain/GMLIB-Release
或者安装特定的版本:
#将0.13.10替换成你想要安装的版本
lip install github.com/GroupMountain/[email protected]
- 前往Release 下载适配你服务器版本的
GMLIB-windows-x64.zip- 解压压缩包，将
GMLIB目录移动到你的插件目录.
在安装插件到服务器时遇到了问题时请先看我,会更省时!
Q: 本模组安装后控制台没有模组信息.
A: 你的服务器内没有模组依赖于本前置,前置会自动卸载.
如果你想禁止自动卸载请把模组
manifest.json中的passive改为false.
Q: 服务器报错GMLIB无法找到LeviLamina中的函数.
A: 请确保你的GMLIB版本与LeviLamina,bds的版本匹配.
详细的API使用请参考我们的文档站(正在建设⏳)或者参考头文件内注释.
如需使用正在测试的API,请加入我们的交流群获取和测试.
注意：
正在开发的测试版API随时可能进行调整,在正式发布之前不保证API向后兼容性,请谨慎使用!
我们推荐使用GMLIB-Mod-Template模版创建项目，或者借助GroupMountain的xmake-repo引入SDK。
手动添加GMLIB的SDK:
- 正常创建
LeviLamina模组项目。- 前往
Release下载SDK.zip并解压- 在项目中添加GMLIB头文件
- 静态链接GMLIB.lib
- 编写你的代码...
- 在
manifest.json中声明GMLIB的版本依赖关系
我们提供了GMLIB_LegacyRemoteCallApi模组使LSE插件调用 GMLIB 内部的API,详情请查看该模组的主页.
很遗憾本项目当前并不开放源代码,你无法在本地构建.
本项目在0.13.6之前的版本根据 LGPL3.0 协议开放源代码,代码位于main分支,请克隆仓库自行构建.
温馨提示:如果你修改了 GMLIB 开源版本的源代码,或者基于这个 GMLIB 编写了一个新的前置,你必须开源它.
您可以使用以下方法为 GMLIB 项目做出贡献
- 帮助我们修改并优化开发文档和使用文档
- 在
GitHub Issues中反馈使用过程中遇到的问题,或者提出好的建议 - 点亮Star,帮助我们推广
GMLIB,支持我们的发展!
⭐⭐⭐我们欢迎您的贡献!⭐⭐⭐
- 开发者不对您负责，开发者没有义务为你编写代码、为你使用造成的任何后果负责
- 本前置插件在
v0.13.6以前全部代码采用LGPL 3.0开源协议，在v0.13.6之后，由于部分人的恶劣行为，本库不再开源。 - 您可以使用任何开源许可证编写基于
GMLIB作为前置的插件，甚至不发布您的源代码。 - 如果你修改了
GMLIB开源版本的源代码，或者基于这个GMLIB编写了一个新的前置，你必须开源它。 - 如果你想要分发，转载本前置，你必须得到我们的授权！
- 感谢
LeviLamina的开源代码和底层API,极大的简化了本项目的开发难度. - 感谢
GroupMountain开发成员对项目的巨大贡献.