侧边栏显示插件，支持自定义变量、动态更新、外部插件对接、C++高性能、发包。
[MD] # BetterSidebar 侧边栏插件 ## ✨ 功能特性 | 功能 | 说明 | |------|------| | 📊 自定义内容 | 完全自定义显示行数和内容 | | 🔄 动态更新 | 可配置刷新频率(1-20Hz) | | 🎨 颜色代码 | 支持 Minecraft 颜色代码 | | 📈 丰富变量 | 40+ 内置变量 | | 💰 经济对接 | 自动对接 MoneyCore(https://www.minebbs.com/resources/moneycore.14707/) | | 👤 玩家控制 | 玩家可自行开关侧边栏 | | 🔌 开放 API | 支持 C++/Python 插件对接 | ## 📥 下载安装 1. 下载 `endstone_better_sidebar.dll` 2. 放入服务器 `plugins/` 目录 3. 重启服务器 ## 🎮 命令列表 | 命令 | 说明 | 权限 | |------|------|------| | `/sidebar` | 打开侧边栏开关菜单 | `bettersidebar.command.sidebar` | | `/sidebar reload` | 重载配置文件 | `bettersidebar.admin`（仅OP） | | `/sidebar clear` | 清理所有外部变量 | `bettersidebar.admin`（仅OP） | | `/sidebar clear <分类>` | 清理指定分类的外部变量 | `bettersidebar.admin`（仅OP） | ## 📋 变量列表 ### 服务器变量 (ZX) | 变量 | 说明 | |------|------| | `{ZX.time}` | 现实时间 (HH:MM:SS) | | `{ZX.hour}` | 小时 | | `{ZX.min}` | 分钟 | | `{ZX.sec}` | 秒 | | `{ZX.date}` | 现实日期 (YYYY-MM-DD) | | `{ZX.year}` | 年 | | `{ZX.month}` | 月 | | `{ZX.day}` | 日 | | `{ZX.mctime}` | 游戏内时间 | | `{ZX.player}` | 在线人数 | | `{ZX.maxplayer}` | 最大人数 | | `{ZX.tps}` | 服务器TPS | | `{ZX.mspt}` | 服务器MSPT | | `{ZX.mob}` | 生物数量 | | `{ZX.item}` | 掉落物数量 | | `{ZX.uptime}` | 服务器运行时长 | | `{ZX.version}` | Endstone版本 | | `{ZX.mcversion}` | MC版本 | | `{ZX.seed}` | 世界种子 | | `{ZX.port}` | 服务器端口 | | `{ZX.levelname}` | 世界名称 | ### 玩家变量 (pl) | 变量 | 说明 | |------|------| | `{pl.name}` | 玩家名称 | | `{pl.money}` | 金币余额（MoneyCore） | | `{pl.point}` | 积分（计分板） | | `{pl.level}` | 经验等级 | | `{pl.exp}` | 经验进度% | | `{pl.health}` | 当前血量 | | `{pl.maxhealth}` | 最大血量 | | `{pl.gamemode}` | 游戏模式 | | `{pl.x}` `{pl.y}` `{pl.z}` | 坐标 | | `{pl.dim}` | 维度 | ### 设备变量 (dv) | 变量 | 说明 | |------|------| | `{dv.ping}` | 网络延迟(ms) | | `{dv.ip}` | IP地址 | | `{dv.device}` | 设备类型 | ## ⚙️ 配置文件 配置文件位于 `plugins/better_sidebar/config.json` ```json { "title": "§l§bscdalu", "update_hz": 1, "money_objective": "money", "points_objective": "point", "lines": [ "§a{ZX.time}", "§e游戏时间: §a{ZX.mctime}", "§e在线: §a{ZX.player}/{ZX.maxplayer}", "§eT/M: §a（{ZX.tps}|{ZX.mspt}）", "§e生物数量: §a{ZX.mob}", "§e掉落物: §a{ZX.item}", "§e延迟: §a{dv.ping}ms", "§e金币: §a{pl.money}" ] } ``` | 配置项 | 说明 | |--------|------| | `title` | 侧边栏标题 | | `update_hz` | 刷新频率(1-20次/秒) | | `money_objective` | 金币计分板名称 | | `points_objective` | 积分计分板名称 | | `lines` | 显示内容(数组) | ## 🔌 开发者对接 BetterSidebar 提供开放 API，允许其他插件在侧边栏显示自定义变量。 | 语言 | 对接方式 | 文档 | |------|----------|------| | C++ | ServiceManager 回调 |https://scdalu.top/api/sidebar-cpp.html C++ 接入指南 | | Python | 自动生成 API 模块 | https://scdalu.top/api/sidebar-python.html 接入指南 | 详见https://scdalu.top/api/sidebar.html API文档[/MD]
