BetterChairs Remastered - 更好的椅子

BetterChairs 让你和你的玩家可以坐在椅子上。每一级楼梯、每一个半砖，甚至每一个方块都可以成为椅子，只要你愿意！它快速、易于更新、高度可定制、稳定可靠，并且完全免费开源。

💡主要特性

• 高性能：代码编写时充分考虑了性能优化。
• 易于更新：自动通知新版本，配置文件可自动升级。
• 高度可定制：自动生成配置文件，可按需调整。
• 稳定可靠：原生支持 1.8 及以上的所有 Minecraft 版本。
• 免费开源：你可以请求新功能或自行添加。

🎮命令与权限

命令

• /BetterChairs <toggle|on|off|status> (别名：/toggleChairs, /bct)

- 允许玩家为自己启用或禁用椅子功能。

• /BetterChairs reset

- 管理员命令，将所有玩家从椅子上弹起。

• /BetterChairs reload

- 管理员命令，重新加载插件配置文件。

权限

• BetterChairs.use [默认: true]

- 允许玩家坐在椅子上。

• BetterChairs.updater

- 玩家加入服务器时通知其插件更新。

• BetterChairs.cmd.toggle [默认: true]

- 允许使用 `/BetterChairs toggle` 命令。

• BetterChairs.cmd.reset

- 允许使用 `/BetterChairs reset` 命令。

• BetterChairs.cmd.reload

- 允许使用 `/BetterChairs reload` 命令。

• BetterChairs.regeneration

- 允许在坐下时获得生命恢复效果（需在配置中启用）。

🔧与原版的区别

此重制版带来了大量改进和新功能

• 持续维护：作者积极修复漏洞、添加功能并支持新版本。
• 广泛版本支持：支持所有 1.8 以上版本（理论上也支持部分更旧版本）。
• 全版本支持：所有楼梯和台阶在所有版本中均受支持。
• 自定义椅子：可将任何你喜欢的方块设置为椅子（可在配置中启用）。
• PlaceholderAPI 支持：集成 PlaceholderAPI。
• 上半台阶支持：可以坐在放置于方块上半部分的台阶上。
• 稳定的更新检查器：更新检查失败时不会发送垃圾信息。
• 精确的告示牌检测：检查告示牌是否真的附着在椅子上（可在 config.yml 中启用要求告示牌的功能）。
• 更温和的交互：玩家尝试坐下时的行为不那么激进（可在 config.yml 中部分恢复原行为）。
• 配置文件重构：config.yml 和 messages.yml 内容已重组（旧文件会自动转换）。
• 世界过滤：拥有世界白名单或黑名单功能。
• 完善的 API：拥有文档齐全的 API。
• 代码完全重写：提高了可维护性、性能和可读性。
• 现代化构建：已迁移至 Maven 并配置 GitHub Actions 实现自动编译。

✨API 与开发者资源

BetterChairs 提供了完善的 API 和事件系统供开发者使用。

• API 文档与 JavaDocs：请查阅 Wiki 和 JavaDocs。
• 原始项目（已无活跃更新）：

- [GitHub](https://github.com/BlackScarx/BetterChairs)

- [SpigotMC](https://www.spigotmc.org/resources/betterchairs.107089/)

- [bStats](https://bstats.org/plugin/bukkit/BetterChairs/10709)

项目起源

BetterChairs 最初由 BlackScarx 于 2016 年在 SpigotMC 发布。几年后，我（Sprax）为了使用自定义事件首次修改了该项目，并随后获得了该仓库的写入权限。由于无法联系到 BlackScarx，我创建了这个新版本以满足自身需求并提供对新 Minecraft 版本的支持。我的版本很快进行了重大更改，我决定完全重写和重新设计该项目。如今，在 BlackScarx 不再活跃后，我非正式地接管了项目，并正在维护这个新版本。

❓配置详解

config.yml 主要选项

• Chairs

- `AllowedDistanceToChair`: 允许玩家尝试坐下时与椅子的最大距离（-1 为忽略）。

- `AutoRotatePlayer`: 玩家开始坐下时是否自动面朝前方。

- `NeedEmptyHands`: 尝试坐下时是否需要手部为空。

- `NeedsSignsOnBothSides`: 椅子是否需要两侧都有附着告示牌才能被识别。

• Position

- `NeedAirAbove`: 坐下时是否需要上方有空气（防止窒息）。

- `AllowAirBelow`: 是否允许椅子下方为空气。

- `UseStairs`: 是否启用楼梯作为椅子。

- `UseSlabs`: 是否启用台阶作为椅子。

• Filter:Worlds

- 可启用世界白名单或黑名单功能，限制椅子生效的世界。

• Filter:Blocks

- 可启用方块白名单或黑名单功能，精确控制哪些方块可作为椅子。

- `AllowAllTypes`: 启用后将忽略 `UseStairs` 和 `UseSlabs` 设置，仅依据下列列表判断。

• Updater

- `CheckForUpdates`: 是否检查新版本并向控制台报告（推荐启用）。

- `NotifyOnJoin`: 是否在管理员加入服务器时通知更新（需要权限 `BetterChairs.updater`）。

messages.yml

此文件用于自定义插件发送给玩家的所有消息，包括前缀、无权限提示、椅子使用状态提示等。

⭐插件统计 (bStats)

BetterChairs 使用 bStats 收集匿名统计数据以帮助改进插件。

• 收集内容：bStats 不收集任何个人数据。收集的数据主要是插件服务器的信息，如玩家数量、在线模式、Minecraft 版本、Java 版本等。
• 数据匿名性：所有数据均以完全匿名的方式发送和存储。服务器 IP 仅用于速率限制，且不与收集的数据关联。所有收集的数据都是公开可见的。
• 如何禁用：如需禁用 bStats，请参考 bStats 入门指南。
• 本插件统计页面：BetterChairs Remastered bStats