方块竞速BlockRacing
这是一个Minecraft多人竞速小游戏，分为两个队伍，先收集完指定方块的队伍获胜。
版本：Java 26.2
仅替换插件 JAR 不会自动更新已有配置文件。旧版 config.yml 和 lang.yml 的版本号如果与插件不一致，游戏内会显示警告，并且新设置或新文本可能无法正常工作。
升级前请备份 plugins/BlockRacing，然后选择一种方式：
特色功能
准备阶段：
目标方块库修改
在服务器文件夹下的plugins\BlockRacing目录中，存在下面这几个文件：
默认 config.yml 使用英文注释，且不再控制玩家语言。玩家请在游戏中使用 /language；自定义语言文字可编辑 lang.yml 和 languages/en_us/lang.yml。
5个方块库文件你可以自由修改，但请注意：
请通过 GitHub Issues 报告问题或提出功能建议。
联系方式：
版权说明
该项目签署 GNU Affero General Public License v3.0 授权许可
游戏源代码
github.com
这是一个Minecraft多人竞速小游戏，分为两个队伍，先收集完指定方块的队伍获胜。
版本：Java 26.2
升级须知
仅替换插件 JAR 不会自动更新已有配置文件。旧版 config.yml 和 lang.yml 的版本号如果与插件不一致，游戏内会显示警告，并且新设置或新文本可能无法正常工作。
升级前请备份 plugins/BlockRacing，然后选择一种方式：
- 没有自定义配置：删除旧的 config.yml、lang.yml、五个方块库和两个翻译 JSON，重启服务器自动生成当前版本文件。
- 有自定义配置：将自定义内容手动合并到当前版本的默认文件中，不要只修改文件末尾的版本号。
特色功能
- 队伍箱子：每个队伍拥有共享存储，数量可通过 max-team-chest-num 配置。
- 奖励机制：每收集一个方块，对方队伍将会获得一组该方块（存放在队伍箱子里）。
- 队伍TP：同队伍之间可以自由TP。
- 轮换方块：队伍可投票替换当前难以获取的目标，每局次数可通过 max-roll-count 配置。
- 定位：玩家可以花费队伍积分购买locate指令，用于定位群系或结构。
- 记录点：每个队伍可共享保存、传送和删除记录点，数量可通过 max-team-waypoint-num 配置。
- 玩家独立语言：聊天提示、标题、菜单、队伍前缀、方块名称和计分板均可跟随 Minecraft 客户端语言，也可以手动切换英文或简体中文。
- 队伍聊天：游戏期间默认仅队友可见，可使用 /shout、@ 或 ! 发送全服消息。
- 崩服恢复：异常停服后可恢复未结束比赛的分数、目标、队伍箱子和记录点。
- 队伍工具：菜单提供随机平均分队、队友传送和极速模式团队补给。
准备阶段：
- 进入游戏后，按Shift+F打开菜单。
- 在菜单进行选队。
- 菜单中可以设置目标方块库，可以选择性开启中等难度方块、困难难度方块、染色方块和末地方块。
- 菜单中可以设置目标方块数量。
- 菜单中可以切换模式（普通模式或竞速模式，可选开启极速模式）
- 所有玩家准备后，即可在菜单点击钻石开始游戏。
- 上一局结束后，全体玩家可确认 /restartgame，在服务器下次启动时重置世界。
- 游戏进行期间默认使用队伍聊天；使用 /shout <消息>，或以 @、! 开头可发送全服消息。
- 未结束的比赛会保存到 game-progress.yml，服务器异常退出后会自动恢复。
- 随机传送后，按照记分板上的内容，开始收集方块吧。
- Shift+F可以打开菜单，在菜单里使用队伍箱子、轮换、定位、记录点、队友传送、随机传送和极速模式补给。
- 购买定位权限后，可以使用 /locatestructure 或 /locatebiome 进行定位。
- 输入/tp <teammates>可以TP队友。
- 准备一个运行 Java 25 的 Paper 26.2 服务器
- 下载插件，将插件放到服务器目录下的plugins文件夹中
- （推荐）将server.properties中spawn-protection的值改为0（避免出生点无法破坏方块）
- （推荐）在server.properties文件中，更改如下设置：
推荐关闭PVP，让玩家沉浸于方块收集。
如果希望每局使用随机世界，推荐将种子留空。
全员确认 /restartgame 后，插件会安全关闭 Paper 并记录这是一次主动重置。 下次启动时，插件会在默认世界打开前把旧世界移动到带时间的 world-backups 目录，再由 Paper 生成新世界。崩服不会产生重置请求， 因此会原样保留世界并恢复比赛进度。
start.bat 不再需要任何删除世界的命令。如果面板本身会自动拉起已停止或 崩溃的服务器，无需修改脚本。本地服务器只需要普通的自动重启循环：
记得修改server.jar为你的服务器核心文件名，并按实际情况分配内存。
目标方块库修改
在服务器文件夹下的plugins\BlockRacing目录中，存在下面这几个文件：
默认 config.yml 使用英文注释，且不再控制玩家语言。玩家请在游戏中使用 /language；自定义语言文字可编辑 lang.yml 和 languages/en_us/lang.yml。
5个方块库文件你可以自由修改，但请注意：
- 每行只写一个方块名
- 方块名使用全大写的方块命名空间
- 5个方块库中不要有重复方块
- 不要有空行、空格等字符
- 不要修改文件名，不要删除文件
- 游戏内除了简单方块库必选以外，剩下的都可以选择性开启，如非特殊需要不要动这5个文件
简单：游戏进程从0%到100%，权重从100减小到20。
中等：游戏进程从0%到40%，权重从20增加到60；游戏进程从40%到100%，权重保持60不变。
困难：游戏进程从0%到50%，权重从1增加到20；游戏进程从50%到100%，权重从20增加到60。
染色：游戏进程从0%到100%，权重保持10不变。
末地：当游戏进程超过非末地方块在总方块的占比时，权重固定为60。当游戏进程未达到非末地方块在总方块的占比时：游戏进程从0%到80%，权重为0；游戏进程从80%到100%，权重从0增加到60。（参考数据：默认方块库，如果所有方块难度全部启用，末地方块占比约为2%，非末地方块占比约为98%）
意见反馈请通过 GitHub Issues 报告问题或提出功能建议。
联系方式：
QQ：2784628010
版权说明
该项目签署 GNU Affero General Public License v3.0 授权许可
游戏源代码
GitHub - LQSnow/BlockRacing: 方块竞速：率先收集完指定方块的队伍获胜！
方块竞速：率先收集完指定方块的队伍获胜！. Contribute to LQSnow/BlockRacing development by creating an account on GitHub.
github.com
