GameBox - 游戏盒 - 13款背包小游戏合集

💡GameBox - 一站式背包游戏集合

GameBox 提供了一个统一的图形界面（GUI），让你可以轻松访问并游玩多种内置的背包小游戏。它的目标是让你能够自定义属于自己的游戏模式，并包含一套完整的代币奖励与商店系统。

🎮安装与设置

• 将 GameBox.jar 文件放入服务器的 plugins 文件夹。
• 给予你自己（或管理员）权限 gamebox.admin.modules。
• 启动或重启服务器。
• 在游戏中，执行命令 /gb，点击底部行中间的箱子图标（如果看不到，请检查第2步权限是否正确）。
• 在GUI中右键点击各个模块来安装它们。每个模块可能包含多个游戏。
• 关于不同模块及其自定义配置的详细信息，请查阅模块网站。

⭐核心特性

• 易于使用且美观的GUI：所有游戏都通过直观的菜单访问。
• 丰富的游戏库：包含众多有趣的游戏。
• 代币系统与可配置商店：玩家获胜可获得代币，用于在商店兑换物品或执行命令。
• 高度可定制：从消息文本到游戏模式均可调整。
• 完整的权限控制：可精细控制玩家对每个游戏和功能的访问。

游戏列表

默认包含的经典游戏有：Cookie Clicker、GemCrush、Minesweeper、Battleship、ConnectFour、Sudoku、Three In A Row、Whac A Mole、MatchIt、Tic Tac Toe、Rock Paper Scissors 和 2048。

🔧如何使用

玩家可以通过以下方式打开主菜单

• 使用命令 /gb、/gamebox 或 /games。
• 如果已启用并配置，也可以使用枢纽物品点击打开。

每个菜单都包含帮助按钮，其提示信息（Lore）可配置，用于解释游戏玩法。主菜单中还有为每个玩家提供的音效开关、代币计数器以及商店快捷入口。

多人游戏与邀请

对于多人游戏，设有邀请系统。玩家可以通过聊天邀请他人，被邀请者会收到包含可点击信息的信息，点击即可直达菜单接受邀请。

✨自定义选项

• 所有文本：通过语言文件自定义所有消息，包括插件名称和前缀。
• 所有界面元素：按钮、描述、显示名称、库存标题等均可调整。
• 导航按钮：可配置返回主菜单、退出、返回游戏菜单等按钮的位置，或通过设置为负值槽位来完全禁用。
• 自定义游戏模式：可以为任何游戏添加自定义模式。

- 例如：可创建简单（5个地雷）、普通（8个地雷）、困难（10个地雷）三种难度的扫雷。

- 每个模式可单独设置奖励、成本和是否记录高分榜。

• 代币商店：在 tokenShop.yml 中配置。

- 创建自己的商品类别。

- 在每个类别中添加任意数量的商品（支持自动分页）。

- 商店在配置前会显示“商店暂未营业”，默认不出售任何物品，以防止插件在配置前干扰服务器经济。

• 其他开关：启用/禁用经济支持、游戏音效。
• 枢纽世界：为你的枢纽世界配置枢纽模式。
• 世界禁用：可在特定世界禁用本插件。

🎮命令列表

玩家命令

• /gamebox 或 /gb 或 /games：打开主GUI。
• /gb help 或 /gb ?：显示可配置的帮助信息。
• /gb info：显示所有已安装游戏的可配置信息（默认包含所有快捷命令列表）。

快捷命令

• /gb gc：直接打开 GemCrush GUI。
• /gb bs：直接打开 Battleship GUI。
• /gb ms：直接打开 Minesweeper GUI。
• /gb 2048：直接打开 2048 GUI。
• /gb c4：直接打开 ConnectFour GUI。
• /gb sudoku：直接打开 Sudoku GUI。
• /gb wam：直接打开 Whac A Mole GUI。
• /gb cc：直接打开 Cookie Clicker GUI。

管理员命令

主命令：/gameboxadmin、/gbadmin 或 /gba（需要权限 gamebox.admin）。

• /gba token [玩家名]：显示该玩家的代币数量。
• /gba reload：重载 GameBox 及所有已安装的游戏。
• /gba token [give|take|set] [玩家名] [数量]：管理指定玩家的代币数量。只要玩家曾登录过服务器，即可对离线玩家操作。

✨权限系统

权限系统允许不同玩家访问不同的游戏。

• 基础控制：你可以收回默认权限 gamebox.play.*，然后使用 gamebox.play.(游戏ID) 只授予特定游戏的游玩权限。

- 游戏ID包括：`cookieclicker`、`minesweeper`、`battleship`、`2048`、`connect4`、`sudoku`、`whacamole`、`gemcrush`。

• 禁止使用GUI：要完全禁止玩家通过命令或枢纽物品打开GUI，请收回权限 gamebox.use。
• 控制游戏GUI访问：gamebox.play 权限仅控制开始游戏。玩家仍可访问游戏GUI查看高分榜和游戏模式。要限制此访问，请收回 gamebox.gamegui.*，并使用 gamebox.gamegui.(游戏ID) 授予特定权限。
• 商店权限：要禁止特定玩家使用代币商店，请收回权限 gamebox.shop。如果不想任何人使用商店，应在配置文件中完全禁用代币系统。
• 其他权限：

- `gamebox.admin`：执行管理员命令所需。

- `gamebox.info`：允许使用 `/gb info`（默认：true）。

- `gamebox.help`：允许使用 `/gb help` 和 `/gb ?`（默认：true）。

❓PlaceholderAPI 支持

GameBox 支持 PlaceholderAPI。例如，占位符 %gamebox_game_name% 会被替换为玩家当前正在游玩的游戏名称。

**代码示例 (Java)**

@EventHandler
public void onInvClick(InventoryClickEvent event) {
    Bukkit.getConsoleSender().sendMessage(PlaceholderAPI.setPlaceholders((Player) event.getWhoClicked(), event.getWhoClicked().getName() + " is currently playing %gamebox_game_name%"));
}

如需更多占位符，请在讨论区提出。

🔧链接与支持

• 支持与反馈：请在讨论区、GitHub 或 Discord 中报告任何问题。评价区不用于提交错误报告。
• 游戏列表：点击此处查看所有已发布、计划中和正在开发中的游戏列表。
• 统计：查看 GameBox 在 bStats 上的数据。

> 注意：对于 Minecraft 版本低于 1.14 的服务器，请使用 GameBox v2。