BlockParty - 方块派对

BlockParty 是一款 Minecraft 小游戏插件，灵感来源于 HiveMC 上的热门游戏。玩家需要在舞池中跟随随机出现的方块提示，快速移动到对应颜色的方块上，站错位置即被淘汰。你可以轻松设置多个不同世界的竞技场，并使用自定义或随机生成的舞池地板。

💡核心特性

• 支持多世界、多竞技场配置。
• 游戏玩法：每轮随机指定一种方块颜色，玩家需迅速移动到对应颜色的地板块上。
• 灵活的舞池设置：可使用预设图案或随机生成地板。
• 内置记分牌和丰富的粒子效果。
• 支持通过告示牌加入游戏。
• 可配置的网页音乐播放器，为游戏增添背景音乐。

🎮要求与依赖

• 基础运行：无需任何其他插件。
• 增强功能（可选）：
• NoteBlockAPI：用于播放音符盒音乐。

🔧安装指南

• 下载 BlockParty.jar 文件。
• 将其放入服务器的 plugins 文件夹。
• 重启服务器。插件将自动生成配置文件夹 plugins/BlockParty/。
• 立即在测试服务器体验：PowerPlugins.net

⭐配置概览 (`config.yml`)

主要配置选项如下，文件位于 plugins/BlockParty/config.yml。

语言与基础设置

• LocaleFileName: 语言文件，默认为 locale_en.yml。
• SaveOnDisable: 插件关闭时是否保存数据。
• DisabledSubCommands: 禁用的子命令列表。
• EnableCommandShortcuts: 是否启用命令快捷方式（如 /start <arenaName>）。

聊天设置

• ArenaChatFormat: 竞技场内的聊天格式。可用占位符：%ARENA%, %NAME%, %DISPLAY%, %MESSAGE%。
• ArenaPrivateChat: 是否将竞技场聊天与普通聊天隔离。

加入告示牌设置

• 启用后，告示牌文本可根据竞技场状态（禁用、大厅、游戏中等）动态更新。
• 可自定义每行文本、颜色及占位符（如 %ARENA%, %PLAYERS%）。

BungeeCord 支持

• 启用后，玩家将自动连接至 DefaultArena，并在离开竞技场时被踢出服务器。

网页音乐服务器

• 启用后，可通过浏览器播放背景音乐。
• 需设置 WebSocketLibrary（推荐 jetty）和 Port（非游戏端口）。

数据库

• Method: 存储方式，可选 SQL（本地文件）或 MySQL。
• 可配置表前缀、文件名或 MySQL 连接信息。

✨竞技场设置教程

创建竞技场

• 创建竞技场：执行 /bp create <arenaName>。
• 设置大厅出生点：站到预定位置，执行 /bp setspawn <arenaName> lobby。
• 设置舞池边界：
• 方法一：分别站到两个对角点，执行 /bp pos 1 和 /bp pos 2。
• 方法二：使用 /bp wand 获取工具，左键和右键点击两个对角点。
• 最后执行 /bp setfloor <arenaName> 确认。
• 设置游戏出生点：站到游戏开始位置，执行 /bp setspawn <arenaName> game。
• 启用竞技场：执行 /bp enable <arenaName>。

自定义竞技场参数

创建后，可在 plugins/BlockParty/Arenas/<arenaName>.yml 中详细配置，例如：

• MinPlayers / MaxPlayers: 最小/最大玩家数。
• LobbyCountdown: 大厅等待时间。
• UseAutoGeneratedFloors: 是否使用随机生成的地板。
• UsePatternFloors: 是否使用图案地板。
• UseWebSongs: 是否使用网页播放器音乐。

✨舞池图案设置

创建自定义图案

• 使用陶瓦、羊毛或玻璃等方块（1.13+ 所有支持的方块）建造一个二维平面图案。
• 使用 /bp pos 或 /bp wand 设定该图案的边界。
• 执行 /bp save <patternName> 保存图案至 plugins/BlockParty/Floors/ 文件夹。

为竞技场添加图案

• 测试图案（可选）：执行 /bp placepattern <patternName>。
• 激活图案地板：在竞技场配置中，将 UsePatternFloors 设为 true。
• 添加图案到列表：可直接在竞技场配置文件的 SongManager 部分添加，或使用命令 /bp addsong <arenaName> <patternName>。
• 命名为 start 的图案将首先加载。
• 命名为 end 的图案将在游戏结束时加载。
• 重载配置：更改后执行 /bp reload。

管理图案列表

• 查看列表：/bp listpatterns <arenaName>
• 移除图案：/bp removepattern <arenaName> <patternName>

✨网页音乐播放器设置

启用播放器

• 编辑 config.yml，找到 MusicServer 部分。
• 设置 Enabled: True。
• 设置 WebSocketLibrary: jetty。
• 设置一个未被占用的 Port（例如 8080）。

添加歌曲

• 将音频文件（如 .mp3）放入 plugins/BlockParty/web/songs/ 文件夹。
• 为竞技场添加歌曲：
• 使用命令：/bp addsong <arenaName> <songName>（例如 /bp addsong exampleArena example.mp3）。
• 或直接编辑竞技场配置文件，在 SongManager 下列出歌曲。
• 确保竞技场配置中 UseWebSongs 设为 true。

✨告示牌设置

使用告示牌让玩家加入游戏

• 第一行输入：[BlockParty]
• 第二行输入：竞技场名称（区分大小写）

告示牌文本可在 config.yml 的 JoinSigns 部分完全自定义。

❓权限列表

• blockparty.admin.*: 授予所有管理命令权限（如 /bp admin）。
• blockparty.user.*: 授予基本用户命令权限（如 /bp help）。

---

教程由 ericbarbwire 提供