{"url":"https://levimc.org/mods/github.com/HuoHuas001/HuHoBot-BDS/","id":"github.com/HuoHuas001/HuHoBot-BDS","name":"HuHoBot","description":"HuHoBot BDS Adapter","owner":"HuHoBot","logo":"https://levimc.org/mods/icons/7dba0418700ca2c9-288.webp","repository":"https://github.com/HuHoBot/BDSAdapter","issues":"https://github.com/HuHoBot/BDSAdapter/issues","releases":"https://github.com/HuHoBot/BDSAdapter/releases","stars":7,"downloads":840,"updated":"2026-07-31T07:03:07Z","published":"2025-04-05T16:07:56Z","created":"2025-01-20T05:42:02Z","license":"GPL-3.0","side":["server","client"],"platform":["win-x64"],"gameVersions":[],"tags":["platform:levilamina","type:mod"],"latest":{"variant":"","version":"0.1.6","install":"lip install github.com/HuoHuas001/HuHoBot-BDS@0.1.6"},"readmes":[{"file":"readme.md","lang":"zh-Hans","text":"# HuHoBot BDSAdapter Adapter\n\n[![GitHub Release](https://img.shields.io/github/v/release/HuHoBot/BDSAdapter?style=for-the-badge)](https://github.com/HuHoBot/BDSAdapter/releases)\n[![License](https://img.shields.io/github/license/HuHoBot/BDSAdapter?style=for-the-badge)](https://github.com/HuHoBot/BDSAdapter/blob/main/LICENSE)\n\n专为BDS设计的下一代基岩版服务器管理解决方案，提供安全的无第三方QQ机器人依赖管理体验。\n\n## 🌟 核心优势\n\n| 特性     | 传统方案             | HuHoBot           |\n|--------|------------------|-------------------|\n| 账号安全   | ❌ 需要实体QQ号，存在封号风险 | ✅ 无QQ第三方客户端依赖，零风控 |\n| 部署复杂度  | ❌ 需搭建完整机器人框架     | ✅ 即装即用，一键绑定       |\n| 服务器兼容性 | ❌ 部分面板服不支持       | ✅ 全平台兼容，有网即用      |\n| 协议更新影响 | ❌ 需要频繁适配新协议      | ✅ 协议无关设计，相对稳定     |\n****\n## 🚀 功能特性\n\n### 核心功能\n\n- **无缝绑定**：通过WebSocket实现服务器与控制端即时绑定\n- **智能风控规避**：基于事件驱动的非侵入式通信协议\n\n### 功能列表\n\n<details>\n<summary>📜 点我查看</summary>\n\n| 命令     | 描述             |\n|--------|----------------|\n| /添加白名单 | 向服务器内添加一个白名单   |\n| /删除白名单 | 向服务器内删除一个白名单   |\n| /绑定    | 绑定服务器          |\n| /设置名称  | 设置自己在本群群服互通的名称 |\n| /发信息   | 群服互通向服务器内发送消息  |\n| /执行命令  | 向服务器发送执行命令的请求  |\n| /查白名单  | 查询服务器内置白名单     |\n| /查在线   | 查询服务器在线名单      |\n| /在线服务器 | 查询在线服务器        |\n| /执行    | 执行自定义指令        |\n| /管理员执行 | 以管理员身份运行自定义内容  |\n\n</details>\n\n### 进阶功能\n\n- **扩展API**\n    - 自定义命令系统(详见下文)\n\n## 📥 安装指南\n\n### 环境要求\n\n- LegacyScriptEngine 0.9.4+\n\n### 快速开始\n\n1. **访问 GitHub Releases 页面**：\n- 打开浏览器，访问 [HuHoBot-BDSAdapter Releases](https://github.com/HuHoBot/BDSAdapter/releases)\n- 下载最新版本的 `HuHoBot-BDS-vx.x.x.zip` 文件\n\n2. **放置插件文件**：\n- 将下载的 `HuHoBot-BDS-vx.x.x.zip` 文件`解压后`放入服务器的 `plugins` 目录中\n\n3. **重启服务器**：\n- 重启你的 Minecraft 服务器以加载新插件\n\n4. **添加机器人**\n- [加入交流群](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=N6tVRxGR8sDwYHBx9YgAhkqRTp1gseyk&authKey=M7Fd3Op6nHjXjSXefBtHBPqIq2wtX8AfufZor9DrfRrJkhyS2rohkt7iuOSwbtn8&noverify=0&group_code=1005746321) 点击HuHo_Bot头像并添加到群聊\n\n5. **完成绑定**：\n- 按照控制台提示完成服务器与机器人的绑定操作\n\n### 高级配置（可选）\n\n- 如果需要自定义功能，请参考`⚙️ 配置示例`进行详细设置\n\n---\n\n## ⚙️ 配置示例\n\n```json5\n{\n\t\"serverId\": \"\", //不用管\n\t\"hashKey\": \"\", //不用管\n\t\"serverName\": \"server\", // 服务器名称\n\t\"addSimulatedPlayerTip\": true, //是否添加模拟玩家提示\n\t\"chatFormat\": {\n\t\t\"game\": \"<{name}> {msg}\", // 群聊格式\n\t\t\"group\": \"群:<{nick}> {msg}\"\n\t},\n\t\"motd\": {\n\t\t\"server_ip\": \"play.easecation.net\", //使用/查在线的时候显示的图片地址（改成你自己的进服IP）\n\t\t\"server_port\": 19132, //使用/查在线的时候显示的图片地址（改成你自己的进服端口）\n\t\t\"api\": \"https://motdbe.blackbe.work/status_img?host={server_ip}:{server_port}\", //使用\"/查在线\"时的Motd图片地址Api（无特殊需求勿动）（必须返回图片）\n\t\t\"text\": \"共{online}人在线\", //使用\"/查在线\"时的Motd文本，留空不显示\n\t\t\"output_online_list\": true, //是否显示在线列表\n\t\t\"post_img\": true //是否显示Motd图片\n\t},\n\t\"customCommand\": [\n\t\t{\n\t\t\t\"key\": \"加白名\", //执行关键词，可使用\"/执行 关键词 参数1 参数2\"来执行自定义命令\n\t\t\t\"command\": \"whitelist add &1\", //&1为参数占位符，第一个参数为&1，第二个&2，以此类推\n\t\t\t\"permission\": 0 //0是普通权限，大于0则为管理员权限\n\t\t},\n\t\t{\n\t\t\t\"key\": \"管理加白名\",\n\t\t\t\"command\": \"whitelist add &1\",\n\t\t\t\"permission\": 1\n\t\t}\n\t],\n\t\"version\": 2\n}\n\n```\n\n## ❓ 常见问题\n\n<details>\n<summary>🤔 怎么绑定不上？</summary>\n检查控制台是否输出\"握手成功\"的字段\n如果未出现，请使用/huhobot reconnect手动重新建立连接\n</details>\n\n<details>\n<summary>🤔 需要准备QQ号吗？</summary>\n完全不需要！本方案采用全新的通信协议，彻底摆脱对第三方聊天平台的依赖。\n</details>\n\n<details>\n<summary>🛡️ 支持哪些服务器版本？</summary>\n✅ 已测试版本：1.21.50+\n</details>\n\n<details>\n<summary>🔧 如何更新配置？</summary>\n支持热重载配置：<code>/huhobot reload</code>\n</details>\n\n<details>\n<summary>🤖 怎么开启消息互通？</summary>\n本机器人不支持群服消息互通，因官方机器人API限制每个群每月仅能发送三条主动消息\n</details>\n\n<details>\n<summary>🌐 查在线显示其他服务器信息？</summary>\n请修改配置文件中的 <code>motdUrl</code> 字段为你的服务器地址  \n示例：<code>motdUrl: \"play.yourserver.com:25565\"</code>\n</details>\n\n<details>\n<summary>🔍 查在线无反应怎么办？</summary>\n排查步骤：  \n\n1. 检查连接状态，使用 <code>/huhobot reconnect</code> 重连\n\n2. 尝试清空 motdUrl 字段：<code>\"motdUrl\": \"\"</code>\n\n</details>\n\n<details>\n<summary>⌨️ 执行命令无响应？</summary>\n注意命令格式区别：  \n\n- <code>/执行 加白</code> → 用于自定义指令回调\n\n- <code>/执行命令 list</code> → 向控制台发送命令\n\n</details>\n\n<details>\n<summary>👥 允许玩家自助加白名单？</summary>\n请按上文配置文件示例配置customCommand字段\n\n使用方式：<code>/执行 加白 \"玩家ID\"</code>（带空格参数需加引号）\n\n</details>\n\n<details>\n<summary>👮 如何设置管理员？</summary>\n在群内使用指令：  \n<code>/管理帮助</code> → 查看管理指令列表\n</details>\n\n<details>\n<summary>🏰 是否支持多个服务器？</summary>\n当前版本每个群仅支持绑定一个服务器，多服务器绑定功能正在开发中  \n如需管理多服务器，建议为每个服务器创建独立群组\n</details>\n\n### 配置自定义命令\n\n#### 通过配置文件设置\n\n在 `config.json` 文件中，你可以通过 `customCommand` 字段来定义自定义命令。每个自定义命令包含以下属性：\n\n- **key**：触发命令的关键词（字符串）\n- **command**：实际执行的服务器命令（字符串）\n- **permission**：权限级别（整数）\n\n示例配置如下：\n\n```json5\n{\n    \"customCommand\": [\n\t\t{\n\t\t\t\"key\": \"加白名\", //执行关键词，可使用\"/执行 关键词 参数1 参数2\"来执行自定义命令\n\t\t\t\"command\": \"whitelist add &1\", //&1为参数占位符，第一个参数为&1，第二个&2，以此类推\n\t\t\t\"permission\": 0 //0是普通权限，大于0则为管理员权限\n\t\t},\n\t\t{\n\t\t\t\"key\": \"管理加白名\",\n\t\t\t\"command\": \"whitelist add &1\",\n\t\t\t\"permission\": 1\n\t\t}\n\t]\n}\n```\n\n#### 通过插件设置\n\n您可以按如下代码创建一个插件，编写一个HuHoBot拓展模块，并使用HuHoBot的API注册回调函数\n\n```javascript\nconst HUHONAMESPACE = 'HuHo_Bot' //勿动\nconst NAMESPACE = 'Test' //修改成你自己想要的Namespace\n\n/**\n * 回调函数\n * @param {array} keyWord\n */\n\nfunction Callback(params){ \n    return \"测试成功\" //可以返回一个文本消息到群内\n}\n\n/**\n * 注册回调函数\n * @param {string} keyWord\n * @param {function} func\n */\n\nfunction regCallbackEvent(type,keyWord,func){\n    if(!ll.hasExported(HUHONAMESPACE,'regEvent')){\n        return;\n    }\n    let regEvent = ll.imports(HUHONAMESPACE,'regEvent')\n    ll.exports(func,NAMESPACE,func.name)\n    regEvent(type,keyWord,NAMESPACE,func.name)\n}\n\nmc.listen(\"onServerStarted\",()=>{\n    let keyWord = \"测试\" //触发关键词\n    regCallbackEvent(\"run\",keyWord,Callback)\n})\n```\n\n## 📄 开源协议\n\n[GNU General Public License v3.0](LICENSE) - 自由使用、修改和分发，但需遵守以下条款：\n\n- **开源义务**：任何衍生作品必须保持开源\n- **相同许可**：修改后的版本必须使用相同许可证\n- **版权声明**：必须保留原始版权声明\n\n完整协议文本请查看 [LICENSE](LICENSE) 文件\n\n## 🤝 参与贡献\n\n欢迎提交PR或通过[Discussions](https://github.com/HuHoBot/BDSAdapter/discussions)提出建议\n\n"}],"gallery":[],"versions":[{"version":"0.1.6","prerelease":false,"released":"2025-04-18T18:28:26Z","releaseUrl":"https://github.com/HuHoBot/BDSAdapter/releases/tag/v0.1.6","manifestUrl":"https://github.com/HuHoBot/BDSAdapter/blob/v0.1.6/tooth.json","info":{"name":"HuHoBot","description":"HuHoBot BDS Adapter","tags":["platform:levilamina","type:mod"]},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"gitea.litebds.com/LiteLDev/legacy-script-engine-quickjs":">=0.7.9"}},{"side":"client","platform":"win-x64","deps":{"gitea.litebds.com/LiteLDev/legacy-script-engine-quickjs":">=0.7.9"}}]}},{"version":"0.1.5","prerelease":false,"released":"2025-04-12T04:44:02Z","releaseUrl":"https://github.com/HuHoBot/BDSAdapter/releases/tag/v0.1.5","manifestUrl":"https://github.com/HuHoBot/BDSAdapter/blob/v0.1.5/tooth.json","info":{"name":"HuHoBot","description":"HuHoBot BDS Adapter","tags":["platform:levilamina","type:mod"]},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"gitea.litebds.com/LiteLDev/legacy-script-engine-quickjs":">=0.7.9"}},{"side":"client","platform":"win-x64","deps":{"gitea.litebds.com/LiteLDev/legacy-script-engine-quickjs":">=0.7.9"}}]}},{"version":"0.1.5-hotfix","prerelease":false,"released":"2025-04-18T15:03:57Z","releaseUrl":"https://github.com/HuHoBot/BDSAdapter/releases/tag/v0.1.5-hotfix","manifestUrl":"https://github.com/HuHoBot/BDSAdapter/blob/v0.1.5-hotfix/tooth.json","info":{"name":"HuHoBot","description":"HuHoBot BDS Adapter","tags":["platform:levilamina","type:mod"]},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"gitea.litebds.com/LiteLDev/legacy-script-engine-quickjs":">=0.7.9"}},{"side":"client","platform":"win-x64","deps":{"gitea.litebds.com/LiteLDev/legacy-script-engine-quickjs":">=0.7.9"}}]}},{"version":"0.1.4","prerelease":false,"released":"2025-04-06T09:10:15Z","releaseUrl":"https://github.com/HuHoBot/BDSAdapter/releases/tag/v0.1.4","manifestUrl":"https://github.com/HuHoBot/BDSAdapter/blob/v0.1.4/tooth.json","info":{"name":"HuHoBot","description":"HuHoBot BDS Adapter","tags":["platform:levilamina","type:mod"]},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"gitea.litebds.com/LiteLDev/legacy-script-engine-quickjs":">=0.7.9"}},{"side":"client","platform":"win-x64","deps":{"gitea.litebds.com/LiteLDev/legacy-script-engine-quickjs":">=0.7.9"}}]}},{"version":"0.1.3","prerelease":false,"releaseUrl":"https://github.com/HuHoBot/BDSAdapter/releases","manifestUrl":"https://github.com/HuHoBot/BDSAdapter/blob/v0.1.3/tooth.json","info":{"name":"HuHoBot","description":"HuHoBot BDS Adapter","tags":["platform:levilamina","type:mod"]},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"gitea.litebds.com/LiteLDev/legacy-script-engine-quickjs":">=0.7.9"}},{"side":"client","platform":"win-x64","deps":{"gitea.litebds.com/LiteLDev/legacy-script-engine-quickjs":">=0.7.9"}}]}},{"version":"0.1.3-hotfix","prerelease":false,"released":"2025-04-05T16:07:56Z","releaseUrl":"https://github.com/HuHoBot/BDSAdapter/releases/tag/v0.1.3-hotfix","manifestUrl":"https://github.com/HuHoBot/BDSAdapter/blob/v0.1.3-hotfix/tooth.json","info":{"name":"HuHoBot","description":"HuHoBot BDS Adapter","tags":["platform:levilamina","type:mod"]},"variants":{"":[{"side":"server","platform":"win-x64","deps":{"gitea.litebds.com/LiteLDev/legacy-script-engine-quickjs":">=0.7.9"}},{"side":"client","platform":"win-x64","deps":{"gitea.litebds.com/LiteLDev/legacy-script-engine-quickjs":">=0.7.9"}}]}}],"dependencies":{"gitea.litebds.com/liteldev/legacy-script-engine-quickjs":{"id":"gitea.litebds.com/liteldev/legacy-script-engine-quickjs","name":"legacy-script-engine-quickjs","owner":"liteldev"}},"requiredBy":[]}