BetterSidebar 侧边栏插件

v1.1.0 稳定版

侧边栏显示插件，支持自定义变量、动态更新、外部插件对接。

✨ 功能特性

功能	说明
📊 自定义内容	完全自定义显示行数和内容
🔄 动态更新	可配置刷新频率(1-20Hz)
🎨 颜色代码	支持 Minecraft 颜色代码
📈 丰富变量	40+ 内置变量
💰 经济对接	自动对接 MoneyCore
👤 玩家控制	玩家可自行开关侧边栏
🔌 开放 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

{
  "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 回调	C++ 接入指南
Python	自动生成 API 模块	Python 接入指南

详见 BetterSidebar API 文档

🔗 相关链接

• 下载中心
• API 文档