LiteLoaderBDS - 划时代 x 跨语言BDS插件加载器

🎁 第一印象

“为什么我应该选择LiteLoader？”
易于使用，直观的接口！

Click to expand...

C++语言示例插件

#include <EventAPI.h>
#include <LoggerAPI.h>
#include <LLAPI.h>
#include <MC/Player.hpp>
#include <MC/Actor.hpp>
Logger logger("AttackLog");

void PluginInit()
{
 LL::registerPlugin("PluginName", "Introduction", LL::Version(1, 0, 0));
    logger.info("插件 xxx 已加载.");
    //监听玩家攻击事件
    Event::PlayerAttackEvent::subscribe([](const Event::PlayerAttackEvent& ev) {
        Player* player = ev.mPlayer;
        Actor* actor = ev.mTarget;
        logger.info(u8"玩家:{} 攻击了 {} | 坐标 {} 维度 {}",
         player->getRealName(), actor->getTypeName(), actor->getPos().toString(),
            std::to_string(actor->getDimensionId()));
        return true;
    });
}

脚本语言示例插件

// 注册关服命令
mc.listen("onServerStarted", () => {
    const cmd = mc.newCommand("stopsvr", "关闭服务器");
    cmd.overload();
    cmd.setCallback((_cmd, ori, out, _res) => {
        out.success("关服命令执行成功");
        mc.broadcast(`玩家${ori.player.realName}执行了关服命令。服务器将在5秒之后关闭`);

        //执行关服命令
        setTimeout(() => mc.runcmd("stop"), 5000);
    });
    cmd.setup();
});

💎 优势

• 💻 支持多种不同的语言开发插件，保持接口统一

• 📕 开发体验流畅，兼容性强
  • 拥有自动生成的C++头文件，可以访问BDS所有的类和功能，拥有完善的工具链支持，且功能不断发展中
  • 对于脚本语言插件，拥有多语言代码补全库、强大的VSCode插件、热加载系统……众多辅助工具，帮你更有效地写好每一行代码
  • 版本更新时，将保证 API 基本 向下兼容，插件几乎不需要随版本更新而修改代码。LiteLoader 系列独有符号查找技术，跨版本 自动适配 不再是梦想
• 📋 开发文档完善，讲解详细
  • 欢迎 👉移步 LiteLoader 文档站👈 查看更多
• 🎈 大量封装完善的的接口
  • 拥有众多游戏API支持：玩家，实体，方块，物品，容器，NBT，服务器系统……
  • 多达 五十多种 游戏事件监听，不管什么事情发生，都可以第一时间响应
• 🛡 安全，稳定，通用
  • 修复BDS中的一些漏洞，确保您的服务器的稳定性和安全性
  • 广泛使用SEH异常保护框架，将服务器崩溃的风险降到最低
  • 支持通过 Wine 在Linux、MacOS平台运行，给其他平台也带来自由的插件体验：一次编写，多平台共享
• 🏆 应用生态健全
  • 海量现有插件，成熟发布平台，即刻 👉前往官方论坛👈 查找并下载你喜欢的 LL 插件
• 🏃 开源 & 社区共建
  • 项目采用 LGPL-3.0 开源许可证，永远不会 收费或者推出商业版。
  • 设计思想采取 去中心化 设计，放心享受 自由 的插件加载框架！

💻 安装LiteLoaderBDS

🎯 安装插件

📕 编写插件

开发辅助工具 - VSCode 开发辅助插件 & 补全库

开发辅助工具 - Blockly-LXL 图形化开发套件

🔨 构建项目

前往 GitHub Actions 来获取最新的构建工件(artifact)
当然，如果您愿意自己构建项目，或者向 LiteLoader 贡献代码，您可以按照以下说明自行构建项目

Click to expand...

1. 安装最新版本的 Microsoft Visual Studio 和标准的 C++ 桌面开发套件 （或者你也可以只安装完整的 msbuild 编译器套件，并配置好编译环境）
2. 安装最新的 Windows SDK
3. 使用你熟悉的 IDE （VS / VSCode / CLion等）打开项目目录，对 cmake 项目进行编译生成
4. 编译生成成功之后，返回到项目根目录，执行 Scripts 文件夹中的 PackRelease.cmd 脚本
5. 执行完之后，根目录 RELEASE 文件夹内的内容即为完整的 LiteLoader 环境及所有的依赖库
6. 如果需要 LL 的调试符号，则执行另一个 PackReleaseWithPDB.cmd 脚本，执行完后RELEASE 文件夹内还会附带上所有必要的调试符号，以方便调试

🎬 参与贡献

1. 贡献代码，维护项目和符号，增加新的API和事件以及基础设施
2. 帮助我们修改并优化开发文档、使用文档
3. 在GitHub Issue中反馈使用过程中遇到的问题，或者提出好的建议
4. 帮助我们推广 LiteLoaderBDS，支持我们的发展

📍 许可证

• 开发者不对您负责，开发者没有义务为你编写代码、为你使用造成的任何后果负责

额外限制和例外

不要作恶。

Click to expand...

🏆 致谢

• LiteLDev 开发组全体成员对项目的巨大贡献
• 开源 ScriptX 项目提供的跨语言脚本引擎支持
• ScriptX开发者 @LanderlYoung 在开发过程中给予的很多帮助
• LiteLuaLoader 项目 和 BDSPyRunner 项目 提供的很多底层接口实现
• 感谢整个BDS开源社区为相关技术发展添砖加瓦

重要贡献者

@ShrBox	@dreamguxiang	@WangYneos	@wzy	@xiaoqch	@yqs112358	@Sysca11	@RimuruChan