MinigamesAddons - 新一代游戏装饰系统

MinigamesAddons 是一款为你的小游戏服务器增添多种视觉与听觉效果的插件，它提供了胜利之舞、击杀特效、弓矢轨迹、死亡音效、光环、商店皮肤和击杀消息等丰富的可定制内容。你不仅可以自由配置一切，还能轻松创建属于自己的独特装饰。

💡核心特性

装饰类型

• 胜利之舞：赢得游戏时触发。支持手动命令触发，也支持在兼容的迷你游戏插件中自动触发。
• 击杀特效：击杀玩家时触发。
• 弓矢轨迹：射箭时产生轨迹。同时支持鸡蛋、钓鱼竿和雪球。
• 死亡音效：在你和击杀者之间播放音效。
• 光环：在你行走时脚下显示特效。
• 商店皮肤：为商店NPC更换皮肤。目前仅支持 BedWars1058 插件，并需要最新版的 Citizens2。
• 击杀消息：击杀玩家时显示自定义消息。可直接使用或与 BedWars1058 / MBedWars 插件配合。
• 拆床特效：破坏其他队伍的床时触发。目前可与 MBedWars 插件配合使用。

系统功能

• 完全可配置：所有内容均可高度自定义。
• 智能GUI系统：提供功能齐全且完全可定制的GUI，可添加无限物品并执行自定义操作，甚至可以使用自定义头颅或玩家头颅作为物品。
• 多插件支持：可自动为多种流行的小游戏插件运行装饰效果。
• 存储方式：支持通过 MySQL 或 YML 文件存储数据。
• 自定义音效：可配置有趣的音效。
• 经济系统：可为装饰设置是否可购买及其价格。
• PlaceholderAPI 支持：兼容 PlaceholderAPI，便于在其他插件中显示信息。

🎮命令与权限

服务器命令

• /ma help - 显示帮助信息。
• /ma reload - 重载所有配置文件。
• /ma gui {KE/DC/BT/VD/Auras/Skins/KM/BBE} - 打开你选择的GUI界面。

装饰管理命令

• /ma getCosmetics [玩家] - 显示目标玩家拥有的装饰。
• /ma setKillEffect [特效名称] {玩家} - 设置击杀特效。
• /ma setDeathCry [音效名称] {玩家} - 设置死亡音效。
• /ma setBowTrail [轨迹名称] {玩家} - 设置弓矢轨迹。
• /ma setVictoryDance [舞蹈名称] {玩家} - 设置胜利之舞。
• /ma setAuras [光环名称] {玩家} - 设置光环。
• /ma setSkin [皮肤名称] {玩家} - 设置商店皮肤。
• /ma setKillMessages [消息名称] {玩家} - 设置击杀消息。
• /ma setBedBreakEffect [特效名称] {玩家} - 设置拆床特效。
• /ma runVictoryDance [玩家] - 手动运行指定玩家的胜利之舞。

经济命令

• /ma addMoney {玩家} {数量} - 为玩家增加金钱。
• /ma takeMoney {玩家} {数量} - 从玩家处扣除金钱。
• /ma setMoney {玩家} {数量} - 设置玩家的金钱数量。

权限节点

• ma.admin - 拥有所有权限。
• ma.ke.{KillEffectName} - 使用特定击杀特效的权限，例如 ma.ke.HeartExplosion。
• ma.vd.{VictoryDanceName} - 使用特定胜利之舞的权限，例如 ma.vd.AnvilRain。
• ma.skins.{ShopkeeperSkinName} - 使用特定商店皮肤的权限，例如 ma.shopkeeperskins.Herobrine。
• ma.auras.{AurasName} - 使用特定光环的权限，例如 ma.auras.RedStone。
• ma.dc.{DeathCryName} - 使用特定死亡音效的权限，例如 ma.deathcries.Wolf。
• ma.bt.{BowTrailName} - 使用特定弓矢轨迹的权限，例如 ma.bt.Color。
• ma.bbe.{BedBreakEffectName} - 使用特定拆床特效的权限，例如 ma.bbe.BedBugs。

🔧创建自定义装饰教程

创建自定义商店皮肤

请注意，此功能目前仅适用于 BW1058，MBedWars 的支持即将到来。同时需要最新版 Citizens2 作为依赖。

• 打开 Cosmetics 文件夹中的 ShopkeeperSkins.yml 文件。
• 皮肤有两种类型：Entity 和 Custom。
• Entity 类型：

- 为新的皮肤对象起一个唯一的名称，例如 `YourCustomSkin2`。

- 设置唯一的 `UniqueID`，例如 `14`。

- 配置 `MenuItem`（菜单显示物品，教程见下文）。

- 在 `Purchase` 中设置是否可购买及价格。

- 将 `SkinType` 设为 `Entity`。

- 设置 `EntityType`（Minecraft 原版实体类型），例如 `ZOMBIE_VILLAGER`。

• Custom 类型：

- 与上述步骤类似，但将 `SkinType` 设为 `Custom`。

- 需要额外添加 `SkinValue` 和 `SkinSignature`，这些信息可在 MineSkin.org 获取。

• 完成后，使用 /ma reload 重载插件，然后打开菜单，新物品应已自动添加。

创建自定义光环

• 打开 Cosmetics 文件夹中的 Auras.yml 文件。
• 在光环对象中，需要配置以下重要元素：

- 唯一的对象名称，例如 `YourCustomAura`。

- 唯一的 `UniqueID`，例如 `4`。

- 显示在GUI中的 `Name`，可使用颜色代码，例如 `&aCustom Aura`。

- `MenuItem`（菜单显示物品）。

- `Purchase`（购买设置）。

- `Material`（脚下显示的方块，必须是原版方块），例如 `DIAMOND_BLOCK`。

• 使用 /ma reload 重载，然后在菜单中查看。

创建自定义弓矢轨迹

• 打开 Cosmetics 文件夹中的 BowTrails.yml 文件。
• 在轨迹对象中配置：

- 唯一的对象名称，例如 `YourCustomTrail`。

- 唯一的 `UniqueID`，例如 `6`。

- `MenuItem`（菜单显示物品）。

- 显示名称 `Name`，例如 `&aCustom`。

- `Purchase`（购买设置）。

- `Particle`（Minecraft 原版粒子类型），例如 `HEART`。

- `Amount`（粒子数量，建议设为 `10`，过多可能导致卡顿）。

• 使用 /ma reload 重载，然后在菜单中查看。

创建自定义死亡音效

• 打开 DeathCries.yml 文件。
• 在音效对象中配置：

- 唯一的对象名称，例如 `CustomCry`。

- 唯一的 `UniqueID`，例如 `8`。

- 显示名称 `Name`，例如 `&aCustom Cry`。

- `MenuItem`（菜单显示物品）。

- `Purchase`（购买设置）。

- `Sound`（Minecraft 原版音效名称，请注意服务器版本），例如 `ENTITY_ENDERMEN_TELEPORT`。

- `Volume` 和 `Pitch`（音量与音高，若不熟悉可设为 `1.0F`）。

• 使用 /ma reload 重载，然后在菜单中查看。

创建自定义击杀消息

• 重要：如果你在使用 BedWars1058/LostSkyWars，请先将其语言文件中的默认击杀消息设为空！否则击杀时会显示两条消息。
• 打开 KillMessages.yml 文件。
• 在消息对象中配置：

- 唯一的对象名称，例如 `CustomMsg`。

- 唯一的 `UniqueID`，例如 `3`。

- 显示名称 `Name`，例如 `&aYour custom messages`。

- `MenuItem`（菜单显示物品）。

- `Purchase`（购买设置）。

- `Messages`：这是一个字符串列表，你可以添加无限条消息。触发时，插件会随机选择一条显示。可使用变量 `{killer}`（击杀者）和 `{victim}`（受害者）。

• 使用 /ma reload 重载，然后在菜单中查看。

✨菜单自定义教程

MA 提供了功能完整且完全可定制的 GUI 系统，你可以向 GUI 中添加无限物品。

步骤1：全局变量

以下变量可用于你创建的任何物品的 Lore（描述）中：

• 胜利之舞：{var_vd}
• 弓矢轨迹：{var_bt}
• 击杀特效：{var_ke}
• 死亡音效：{var_dc}
• 光环：{var_auras}
• 拆床特效：{var_bbe}
• 击杀消息：{var_km}
• 商店皮肤：{var_skin}
• 你的金钱：{var_money}

步骤2：使用自定义头颅或玩家头颅

在物品配置中，你不仅可以设置原版物品，还可以使用自定义头颅。

• 将 Item 设置为 CUSTOM_SKULL。
• 添加一个名为 Skull 的键。
• 若要使用自定义皮肤，在 Skull 后粘贴皮肤值（Skin Value）。
• 若要使用玩家头颅，将 Skull 值设置为 <PLAYER>。

步骤3：物品的点击动作

动作（Action）功能强大，允许你配置玩家点击物品时发生什么。有5种类型：

• NONE：点击时不执行任何操作。
• OPEN：点击时打开特定菜单。
• COMMAND_PLAYER：以玩家身份执行命令。
• COMMAND_CONSOLE：以控制台身份执行命令。
• MESSAGES：发送一条消息。

设置格式为：ActionType : ActionContent。各菜单文件中均有示例。

步骤4：装饰的菜单物品

每个自定义装饰都有一个 MenuItem 部分，用于配置其在GUI中的显示。你需要设置 Name、Item、Amount、Data、Lore。注意：在装饰物品中你不需要设置 Action。

步骤5：在每个菜单中添加自定义物品

Menus 文件夹中的每个文件都可以自定义。

• 警告：你不能在装饰物品所占用的槽位放置自定义物品，这会导致错误。
• 只需按照示例创建物品即可，非常简单。
• 别忘了在这里设置 Action！

[$] 经济系统

MA 会自动检测你是否安装了 Vault。如果已安装，则使用 Vault 作为经济系统；如果没有，则使用自定义经济系统。这意味着你可以选择是否与 Vault 联动。

步骤1：设置权限命令

• 前往 config.yml 设置权限命令。
• 当玩家购买装饰时，此命令将被执行。你必须根据你的权限插件来设置它，否则即使玩家付了钱，装饰也可能无法解锁。
• 玩家变量是 {player}，权限变量是 {permission}。
• 设置完成后，经济系统应能正常工作。

步骤2：管理玩家经济

经济管理命令已在上方列出。你可以使用这些命令来管理玩家的金钱。

• 请注意：如果使用 Vault，它将设置 Vault 系统内部的玩家金钱。

❓PlaceholderAPI 占位符

• %ma_selected_bt% - 显示你选择的弓矢轨迹。
• %ma_selected_dc% - 显示你选择的死亡音效。
• %ma_selected_ke% - 显示你选择的击杀特效。
• %ma_selected_vd% - 显示你选择的胜利之舞。
• %ma_selected_auras% - 显示你选择的光环。
• %ma_selected_skin% - 显示你选择的商店皮肤。
• %ma_selected_km% - 显示你选择的击杀消息。
• %ma_selected_bbe% - 显示你选择的拆床特效。

⭐重要须知

支持与社区

• 本插件仅支持 Spigot 1.8 - 1.12.2。
• 我们拥有一个良好的 Discord 社区，提供支持，无广告，无垃圾信息。
• 如果我们没有即时回复，请不要直接留下差评。我们都有自己的生活，且这本身是一个免费资源。请尊重开发者和管理员。

条款与条件

• 禁止在未经许可的情况下重新上传本插件。
• 禁止反编译本插件。
• 所有代码均由作者本人编写。
• 遇到困难请联系作者。
• 请不要在评论区留下错误报告，请使用 Discord！
• 请不要在评论区提出建议，请使用 Discord！
• 希望你喜欢这个插件！别忘了留下 ⭐⭐⭐⭐⭐ 好评！

捐赠

如果你认为这是一个优秀的作品并想支持我们，欢迎捐赠！你将获得插件的源代码、Discord 中的捐赠者角色以及捐赠者专属服务。感谢 @zasami 捐赠 25美元。