Paintball Battle - 团队小游戏

Paintball Battle 是一款基于团队对抗的雪球大战小游戏。游戏开始时，双方队伍拥有一定数量的生命值。每当玩家被雪球击中，其所属队伍将扣除一点生命。率先耗尽生命值的队伍将输掉比赛。玩家可以通过击杀获得“击杀硬币”，用于购买连杀奖励、解锁特殊帽子或永久增益，以帮助团队取得胜利。

💡重要须知

本插件将不再添加新功能。

🎮游戏简介

• 被雪球击中即视为一次击杀。
• 被击杀后，你将在己方队伍的出生点复活。
• 完成击杀可获得“击杀硬币”。
• 可同时运行多个竞技场。

✨功能特性

• 高度可配置
• 竞技场冷却时间、时长和队伍生命值。
• 队伍自定义（名称、颜色、物品）。
• 库存自定义。
• 音效。
• 获胜者命令奖励。
• 所有游戏内消息。
• 8 种连杀奖励（可提议添加更多）
• 更多雪球：获得额外雪球。
• 强健臂膀：以更高速度投掷雪球。
• 三连发：一次投掷三个雪球。
• +3 生命：为你的队伍恢复 3 点生命。
• 传送：传送至你的死亡位置。
• 闪电打击：击杀一定半径内的所有敌人。
• 核弹：击杀所有敌人。
• 狂暴模式：免疫雪球，且投掷不消耗雪球。
• 9 种特殊帽子（可提议添加更多）
• 速度之帽：获得永久的速度 I 效果。
• 跳跃之帽：潜行 X 秒后获得跳跃提升 I 效果。
• 守护者之帽：有小概率闪避雪球攻击。
• 时间之帽：所有连杀奖励持续时间延长 X 秒。
• 卫士之帽：潜行 X 秒后获得无敌和缓慢 II 效果。
• 礼物之帽：游戏开始时，随机一名队友获得 3 枚击杀硬币。
• 刺客之帽：击杀上次击杀你的玩家，可获得额外击杀硬币。
• 小鸡之帽：投掷鸡蛋而非雪球。
• 爆炸之帽：被击杀时有小概率爆炸，击杀附近敌人。
• 3 种可配置等级的永久增益
• 额外生命：允许你以更多生命值开始游戏。
• 初始硬币：允许你以更多击杀硬币开始游戏。
• 额外硬币：击杀时获得更多击杀硬币。
• 全息排行榜：支持全局、月度、周度的获胜和击杀排行。
• 多竞技场支持：可同时运行多个竞技场。
• 竞技场内聊天：独立的竞技场聊天频道。
• 再玩一次物品：游戏结束时提供快速重玩选项。
• 命令白名单：限制游戏内可用的命令。
• PlaceholderAPI 支持：为记分板和聊天提供变量。
• MySQL 数据库：支持数据存储。
• 3 种经济类型：支持 Paintball 硬币、Vault 经济或 TokenManager。
• API：为开发者提供接口。
• 数据统计：保存玩家的胜、负、平局及击杀数。
• 版本兼容：支持 1.8 及以上版本。

🔧安装与依赖

核心要求

• SPIGOT（不支持 CraftBukkit）

可选依赖

• HolographicDisplays：用于全息排行榜。
• 链接：https://dev.bukkit.org/projects/holographic-displays
• Vault：用于经济系统。
• 链接：http://dev.bukkit.org/bukkit-plugins/vault/
• PlaceholderAPI：用于记分板和聊天变量。
• 链接：https://www.spigotmc.org/resources/placeholderapi.6245/

⭐创建竞技场

在创建竞技场前，请先使用 /paintball setmainlobby 设置主大厅。

步骤指南

• 使用命令 /paintball create <arena> 创建新竞技场。
• 使用命令 /paintball edit <arena> 打开 GUI 界面，设置竞技场属性。
• 点击第一个物品设置竞技场大厅。玩家进入竞技场时将在此位置生成。
• 点击第二和第三个物品分别设置队伍 1 和队伍 2 的出生点。
• 使用其他物品修改竞技场属性，如游戏时长、初始生命值、最小/最大玩家数及队伍颜色。
• 使用命令 /paintball enable <arena> 启用竞技场。
• 创建加入标牌，格式如下：

   [Paintball]
   arena_name

• 如需再次编辑竞技场，请先使用 /paintball disable <arena> 禁用它。

❓配置文件详解

大部分插件功能可通过配置文件调整。如需添加新的可配置项，可向开发者提出请求。

config.yml 主要选项

# 达到最小玩家数后，游戏开始的倒计时（秒）。
arena_starting_cooldown: 20

# 游戏默认时长（秒）。
arena_time_default: 360

# 游戏结束阶段的持续时间（秒）。
arena_ending_phase_cooldown: 10

# 是否允许玩家在游戏开始前选择队伍。
choose_team_system: true

# 每支队伍的初始生命值。
team_starting_lives_default: 100

# 玩家被击杀后的无敌时间（秒）。
respawn_invulnerability: 4

# 每次击杀获得的雪球数量。
snowballs_per_kill: 8

# 游戏开始时玩家持有的初始雪球数。
initial_snowballs: 64

# 每次击杀获得的击杀硬币数量。可使用“1-3”表示随机范围。
coins_per_kill: "1-2"

# 全息排行榜显示的玩家数量。
top_hologram_number_of_players: 10

# 全息排行榜更新间隔（秒）。
top_hologram_update_time: 300

# 使用的经济类型："paintball", "vault" 或 "token_manager"。
economy_used: "paintball"

# 奖励是否在传送回大厅后发放。若为 true，可发放物品奖励，但玩家提前离开则无法获得。
rewards_executed_after_teleport: false

# 队伍颜色与物品定义（可自定义）。
teams:
  blue:
    name: "&1&lBlue"
    color: 18175
    item: "BLUE_WOOL"
  red:
    name: "&4&lRed"
    color: 16711680
    item: "RED_WOOL"

# 游戏内允许使用的命令白名单。
commands_whitelist:
  - "/paintball leave"
  - "/help"

# 游戏内音效设置（格式："Sound;Volume;Pitch"）。
killedBySound: "BLOCK_NOTE_BLOCK_PLING;10;0.1"
killSound: "ENTITY_FIREWORK_ROCKET_BLAST;10;2"

# 雪球轨迹粒子效果，设为 'none' 可禁用。
snowball_particle: SNOW_SHOVEL

shop.yml 与 perks

• perks_upgrades：在此定义永久增益的等级、花费和名称。
• 格式："增益数值;花费硬币数;显示名称"
• 可通过将物品槽位（slot）设为 -1 来禁用任何商店物品。

messages.yml

此文件包含所有游戏内消息的文本与格式，可根据需要进行翻译或修改。

🔧命令列表

• /paintball create <arena> - 创建新竞技场。
• /paintball delete <arena> - 删除竞技场。
• /paintball join <arena> - 加入指定竞技场。
• /paintball joinrandom - 加入随机竞技场。
• /paintball leave - 离开当前竞技场。
• /paintball shop - 打开 Paintball 商店。
• /paintball givecoins <player> <amount> - 给予玩家 Paintball 硬币。
• /paintball setmainlobby - 设置小游戏主大厅。
• /paintball enable <arena> - 启用竞技场。
• /paintball disable <arena> - 禁用竞技场。
• /paintball edit <arena> - 编辑竞技场属性。
• /paintball createtophologram <name> <kills/wins> <global/monthly/weekly> - 创建全息排行榜。
• /paintball removetophologram <name> - 移除全息排行榜。
• /paintball reload - 重载配置文件。

⭐权限节点

• paintball.admin - 授予所有管理命令的使用权限。

🔧API 与开发者

数据获取

int wins = PaintballAPI.getWins(String player);
int loses = PaintballAPI.getLoses(String player);
int ties = PaintballAPI.getTies(String player);
int kills = PaintballAPI.getKills(String player);

经济与物品

int coins = PaintballAPI.getCoins(Player player);
boolean hasHat = PaintballAPI.hasHat(Player player, String hat);
int perkLevel = PaintballAPI.getPerkLevel(Player player, String perk);

PlaceholderAPI 变量

• %paintball_wins% - 玩家总胜场。
• %paintball_loses% - 玩家总负场。
• %paintball_ties% - 玩家总平局数。
• %paintball_kills% - 玩家总击杀数。
• %paintball_coins% - 玩家持有的 Paintball 硬币数。
• %paintball_arenaplayers_count_<arena>% - 指定竞技场的当前玩家数。
• %paintball_arena_status_<arena>% - 指定竞技场的状态。

❓常见问题与支持

• 请在给予差评前，先通过讨论区或直接联系开发者反馈问题。
• 已提供西班牙语和葡萄牙语翻译。
• 更多游戏截图与视频演示，请查看原发布页面。

---

致谢：感谢所有翻译贡献者与视频创作者。如果您愿意支持本插件的维护，欢迎通过捐赠鼓励开发者。