~ 本插件旨在让你完全控制记分板/侧边栏。


- 超过 100 个变量
- 支持颜色和 UTF-8 符号:❤
(点击此处将 UTF-8 转换为 ASCII 以用于 yml 文件)
- 动态更新的侧边栏
- 为特定世界设置侧边栏
- 为每个组设置独立的侧边栏
- 可选地允许用户选择使用哪个侧边栏
- 使用命令管理玩家的侧边栏
- 使用内置脚本更改用户的侧边栏或添加新变量
- 组特定的侧边栏权限。根据你的需要添加或删除特定侧边栏的权限
- 无需数据库

安装过程很简单。只需将此插件以及 Vault 放入你的插件目录并重启服务器即可。
依赖项
本插件需要 Vault - 如果你还没有,请点击此处下载。

安装后会创建几个文件/文件夹。
config.yml
| 设置项 | 描述 | 默认值 |
| version | 插件版本(请勿更改) | 取决于版本 |
| scripting.directory | 自定义脚本的存放位置 | scripts |
| scripting.sidebar-directory | 侧边栏文件的位置 | scoreboards |
| multiworld.<world>.sidebar | 该世界使用的侧边栏(设置为 false 则不显示记分板) | default |
| sidebar.autoupdate.whitelist | 应该更新的占位符列表(在此处添加你自己的) | 一个很长的列表 |
| sidebar.auto-update.enabled | 记分板是否应自动更新,还是保持静态 | true |
| sidebar.interval-ticks | 更新记分板的频率(20 ticks = 1秒) | 20 |
| sidebar.async | 除非你清楚自己在做什么,否则不要改动此项 | false |
| language | 用于语言消息的 yml 文件 | english |
| compatability-mode | 是否允许其他记分板插件禁用此记分板 | true |
english.yml
- 尚未实现 :(
scripts 文件夹
这里已经有两个脚本了。
要使用脚本 "example.yml",只需在记分板文件中放入 "{example}"
要使用脚本 "test.js",只需在记分板文件中放入 "{js:test.js}"
要添加你自己的脚本,请在 scripts 目录中创建一个新的 .yml 或 .js 文件
关于脚本编写的过时信息,请点击此处。
点击此处查看 {变量} 列表
scoreboards 文件夹
| 设置项 | 描述 | 示例 |
| title | 记分板的标题(外观) | 例如 "Ranks" |
| permission | 使用此记分板所需的权限节点 | 例如 sidebar.use.ranks |
| description | 记分板的简短描述 | 例如 "不同游戏排名的费用" |
| keys | 键是记分板左侧的值 它们可以是任何少于 16 个字符的内容 键中可以包含占位符 | 例如 Money: ${money} 或者只是 "Money:" |
| values | 这是记分板的右侧 记分板元素会自动按降序排列 如果你想让某项排在顶部,它需要一个较大的值 这里只能放数字 或者能解析为数字的内容 | 例如 5 {money} |
添加你的第一个记分板:
1. 导航到 scoreboards 文件夹
当插件首次加载时,它会在你的 plugins 目录中创建一个名为 SideBar 的文件夹
- 在这里你会找到 scoreboards 文件夹(以及 config.yml)
2. 创建一个新的 yml 文件
示例记分板 (example.yml) 也应该存在。
建议你复制此文件并基于它创建新的记分板。
这是在 NP++ 中打开的示例记分板文件:

3. 更改标题
将 title 键设置为你希望记分板标签显示的内容。
- 例如 title: "Stats:"
4. 添加权限节点
将 permission 键设置为用户使用该计分板所需的权限节点。
- 例如:permission: sidebar.use.myfirstscoreboard
5. 添加描述
将 description 键设置为对计分板用途的简要说明,以便玩家了解每个计分板的作用。
(如果您希望允许用户使用命令设置自己的计分板,这将非常有用)
6. 添加分数
将在计分板上显示的分数位于 keys(键)和 values(值)之下
关于计分板行为的一些注意事项:
- 每个分数由一个字符串(文本)和一个整数(整数)组成
- 目前,字符串的长度不能超过 15 个字符。
- 分数会自动按降序排列(客户端)
(具有最高整数值的分数将始终位于顶部)
可用于“键”的内容:
- 纯文本,例如 Hello
- 颜色代码,例如 &6Hello
- 变量,例如 Hello {player}
- Unicode 符号,例如 \u2764(❤ 的 ASCII 等效字符)
点击此处查看变量列表
点击此处将 Unicode 符号转换为 ASCII
可用于“值”的内容:
- 整数,例如 6
- 变量,例如 {age}
- 表达式,例如 15*6+4
(您可以在表达式中使用变量)
(但结果必须计算为整数)
6. 将计分板添加到配置中
打开 config.yml
对于每个地图,都会有一个 sidebar 选项。
- 使用此选项为每个世界设置 sidebar/scoreboard。
- 将 sidebar 设置为计分板文件的名称(不包括 .yml 后缀)。
- 例如,如果您的计分板文件名为 custom.yml,您可以设置 sidebar: custom
7. 添加您自己的动态变量
点击此处获取创建您自己变量的帮助

| 命令 | 描述 | 权限 |
| /sidebar help | 显示命令列表 | 无 |
| /sidebar set <sidebar> | 设置您的侧边栏 | sidebar.set +特定计分板的节点 |
| /sidebar set <sidebar> <player> | 设置某人的侧边栏 | sidebar.set.other |
| /sidebar list | 显示计分板列表 | sidebar.list |
| /sidebar reload | 重新加载配置 | sidebar.reload |
[待办事项]
如果您希望添加某项功能,请告诉我
- 针对组/权限的侧边栏设置(需要 Vault 来支持组权限;如果未找到 Vault,它将回退到基于 Bukkit 的权限)
- 世界分组
- 隐藏侧边栏的命令
- 空的侧边栏不显示
- 组/权限/世界侧边栏的优先级选项
- 预览侧边栏的命令(在聊天中)
- 浏览占位符的命令
- 设置变量的命令
- 查看玩家当前侧边栏的命令
- 查看世界默认侧边栏的命令
最新构建版本可在此处找到:
| 仓库 | 状态 | 额外信息 |
| 子项目 | (点击图片访问仓库:Sub) | 不稳定 (主要是 Alpha/Beta 构建) |
| 主项目 | (点击图片访问仓库:Master) | 稳定 (稳定的 Beta/Release 构建) |
~ This plugin aims to give you complete control of the scoreboard/sidebar.


- More than 100 variables
- Color and UTF-8 symbol support: ❤
(see here to convert UTF-8 to ascii for yml)
- Dynamically updating sidebar
- Set a sidebar to appear in certain worlds
- Have per group sidebars
- Optionally allow users to choose what sidebar to use
- Use commands to manage a player's sidebar
- Use in-built scripting to change user's sidebar or add new variables
- Group Specific Sidebar Permissions. Add & remove permissions for certain sidebars at your command
- No database required

The installation process is easy. Simply put this plugin, as well as Vault into your plugin directory and restart your server.
Dependencies
This plugin requires Vault - Click here to download it if you don't already have it.

Several files/folders are created upon installation.
config.yml
| Setting | Description | Default Value |
| version | The plugin version (do not change) | version dependent |
| scripting.directory | The location to use for custom scripts | scripts |
| scripting.sidebar-directory | The location of the sidebar files | scoreboards |
| multiworld.<world>.sidebar | The sidebar to use for that world (set to false for no scoreboard) | default |
| sidebar.autoupdate.whitelist | A list of placeholders which should update (add your own here) | some big list |
| sidebar.auto-update.enabled | Whether the scoreboards should update, or simply be static | true |
| sidebar.interval-ticks | How often to update a scoreboard (20ticks=1s) | 20 |
| sidebar.async | Do not mess with this unless you know what you are doing | false |
| language | What yml file to use for the language messages | english |
| compatability-mode | Whether other scoreboard plugins should be allowed to disable this scoreboard | true |
english.yml
- Not implemented yet :(
scripts folder
You will find two scripts already here.
To use the script "example.yml" simply put "{example}" in your scoreboard file
To use the script "test.js" simply put "{js:test.js}" in your scoreboard file
To add your own script, create a new .yml or .js file in the scripts directory
For outdated information on scripting, click here.
Click here for a list of {variables}
scoreboards folder
| Setting | Description | Examples |
| title | The title (appearance) of the scoreboard | e.g. "Ranks" |
| permission | The permission node required to use this scoreboard | e.g. sidebar.use.ranks |
| description | A short description of the scoreboard | e.g. "Cost of different game ranks" |
| keys | Keys are the values on the left of the scoreboard They can be anything less than 16 characters You can have placeholders in a key | e.g. Money: ${money} or just "Money:" |
| values | This is the right side of the scoreboard Scoreboard elements are automatically sorted in descending order If you want something on top, it needs a large value You can only put numbers here or something that resolves to a number | e.g. 5 {money} |
Adding your first scoreboard:
1. Navigate to the scoreboards folder
When the plugin loads for the first time, it will create a folder (in your plugins directory) called SideBar
- Within here you will find the scoreboards folder (as well as the config.yml)
2. Create a new yml file
An example scoreboard (example.yml) should also be present.
It is recommended that you copy this file and base your new scoreboard off this.
Here is the example scoreboard file opened in NP++:

3. Changing the title
Set the title key to whatever you want the label to be for the scoreboard.
- e.g. title: "Stats:"
4. Add a permission node
Set the permission key to the permission node required for a user to use that scoreboard.
- e.g. permission: sidebar.use.myfirstscoreboard
5. Add a description
Set the description key to a brief explanation of the purpose of the scoreboard so that players will know what each scoreboard does.
(Useful if you want to allow users to set their own scoreboard using commands)
6. Add scores
The scores which will be visible on the scoreboard are under keys and values
Some things to note about scoreboard behavior:
- Each score is comprised of a String (some text) and an Integer (a whole number)
- Currently the length of the String cannot resolve to be longer than 15 characters.
- Scores are automatically sorted in descending order (client side)
(The score with the highest Integer value will always be on top)
Things you can use for "keys":
- Plain text e.g. Hello
- Color codes e.g. &6Hello
- Variables e.g. Hello {player}
- Unicode symbols e.g. \u2764 (ASCII equivilent of ❤)
See here for a list of variables
See here to convert UNICODE symbols to ASCII
Things you can use for "values":
- Whole numbers e.g. 6
- Variables e.g. {age}
- Expressions e.g. 15*6+4
(You may have variables within an expression)
(The result must evaluate to a whole number however)
6. Add the scoreboard to the config
Open the config.yml
For each map there will be a sidebar option.
- Set the sidebar/scoreboard for each world using this option.
- Set sidebar to the name (not including .yml) of the scoreboard file.
- e.g. If your scoreboard file is called custom.yml you may have sidebar: custom
7. Add your own dynamic variables
See here for help on creating your own variables

| Command | Description | Permission |
| /sidebar help | Shows a list of commands | none |
| /sidebar set <sidebar> | Set your sidebar | sidebar.set +node for specific scoreboard |
| /sidebar set <sidebar> <player> | Set someone's sidebar | sidebar.set.other |
| /sidebar list | Shows a list of scoreboards | sidebar.list |
| /sidebar reload | Reloads the configuration | sidebar.reload |
[TODO]
Tell me if you want a feature added
- Sidebar setting for groups/permissions (Vault Required for Group Permissions, if vault is not found it will revert to bukkit based permissions)
- World grouping
- Command to hide sidebar
- Empty sidebar will not display
- Priority option for group/permission/world sidebars.
- Command to preview a sidebar (in chat)
- Command to browse placeholders
- Command to set variables
- Command to view a player's current sidebar
- Command to view a world's default sidebar
Latest build can be found here:
| Repository | Status | Extra Info |
| Subproject | (Click image for repository: Sub) | Not Stable (Mostly alpha/beta builds) |
| Masterproject | (Click image for repository: Master) | Stable (Stable Beta/Release builds) |
评论 0
登录后参与评分
还没有评论,来抢沙发吧