HungerGameSSS

插件

· 作者 Duong2012G

HungerGameSSS 是一款高性能的饥饿游戏插件,拥有独特的传奇武器(附带特殊能力)、动态玩法系统和完整的竞技场自定义功能——专为竞技 PvP 服务器打造。

0 本站下载 0 关注 更新于 4 个月前

最新 4.6.5 · 1.21.11 · Bukkit / Paper

一键开服(送7天)
HungerGamesSSS 图标

HungerGamesSSS

一款功能齐全的 Paper 1.21+ Hunger Games 生存插件

v4.6.4 — 架构与游戏性 Bug 修复补丁已于 2026-06-04 发布。 修复了 11 个结构性错误:矛盾的 ArenaEndEvent 注释、导致配置重载漂移的重复 LootTableManager 和 CornucopiaBuilder 实例、 startMatch() 绕过 FSM transition() 契约、在 Y=100 的地形内放置出生笼、 由于异步物理机制导致玩家穿过活塞地板、已废弃的 checkCompatibility() 方法、空的 MatchSession 类、过时的嵌套语言 目录,以及断开连接的玩家无限期保持比赛开放(现在将在可配置的 game.reconnect-timeout 秒后自动过期, 默认为 60 秒)。 无需数据库迁移 — 可直接替换 4.6.3 版本。 强烈建议升级。 完整列表请参阅 CHANGELOG.md。

45 件传奇武器。程序化地牢。最后幸存者。

? 下载 • ? 报告 Bug • ? Discord


? 目录

  • ✨ 特性
  • ? 要求
  • ? 安装
  • ?️ 竞技场系统
  • ⏱️ 比赛生命周期
  • ? 游戏模式
  • ⚡ 传奇武器
  • ? 地牢
  • ? 角 Cornucopia 构建器
  • ? 盛宴事件
  • ? 队伍
  • ? 持久化
  • ? 本地化
  • ⌨️ 命令与权限
  • ? 开发者 API
  • ? 故障排除
  • ? 致谢

✨ 特性

?️ 竞技场系统

  • 多竞技场支持 — 在独立世界中运行无限数量的并发竞技场
  • 每竞技场开关 — PvP、生命吸取、硬核、矿脉挖掘、下界、末地
  • 玻璃笼倒计时 — 玩家在出生点被锁在笼子中,直到比赛开始
  • 自动重置 — 每场比赛结束后完全恢复竞技场世界和所有方块
  • 传奇物品生成点 — 全息影像漂浮在每个标记的物品位置上方

⚡ 45 件传奇武器

类别 数量 示例
剑与近战 15 Cloud Sword, Excalibur, Dragon Katana
弓与远程 8 Artemis Bow, Phantom Longbow, Warden Crossbow
法杖与魔法 8 Void Staff, Lich Staff, Hypnosis Staff
三叉戟与特殊 9 Aiglos, Mjolnir, Ravager Horn
护甲 3 Hades' Helm, Hermes Boots, Reinforced Elytra
实用/治疗 2 Fountain of Youth, Warpick

✔️ 每件武器都有独特的主动 + 被动能力 ✔️ 所有属性均可在 legend-items/<id>.yml 中调整 ✔️ 使用 /perf reload 热重载 — 无需重启


? 程序化地牢

类型 地形
?️ 蜘蛛巢穴 蛛网洞穴
? 墓穴 石砖密室
⛏️ 金矿 矿井隧道
? 熔岩神殿 下界砖结构
? 冰神殿 压实冰生物群系
?️ 地表神殿 砂岩废墟
? 地表前哨站 瞭望塔
?️ 天空岛 悬浮草地
? 浮空城堡 位于 30 格高的城堡

✔️ 无需外部结构文件 ✔️ 每种地牢类型的掉落物可配置 ✔️ 比赛结束后所有方块恢复


? 比赛生命周期

等待 → 开始 → 进行中 → 死亡竞赛 → 结束
阶段 描述
⏳ 等待 玩家在大厅排队
? 开始 倒计时;玩家传送进入笼子
⚔️ 进行中 宽限期 → 主要阶段 → 盛宴 → 边界收缩
? 死亡竞赛 边界关闭;最后几名玩家进行战斗
? 结束 宣布获胜者;竞技场完全重置

✔️ 比赛中断线/重连会恢复最后的位置、背包和计分板


? 游戏模式

❤️ 生命吸取

击杀玩家 → 他们掉落一个心之物品。拾取它以提升你的最大生命值。使用 /withdraw <amount> 将心转化为生命值。

? 硬核

被淘汰的玩家将被踢出服务器,而不是进入旁观模式。

⛏️ 矿脉挖掘

潜行 + 破坏矿石 → 连锁挖掘整个矿脉。最大矿脉大小可在运行时配置。


? 角 Cornucopia 主题

竞技场中心装饰的 13 种程序化主题:

classic · ultimate · speedsilver · ancient · void · royal · industrial · modern · crystal · jungle · end · nether · grand


? 本地化

内置 10 种语言文件:

?? en · ?? vi · ?? ru · ?? de · ?? fr · ?? es · ?? pt · ?? ja · ?? ko · ?? zh

玩家在游戏中使用 /hg lang <code> 更改语言。


? 持久化 — SQLite / MySQL

所有竞技场状态、玩家数据、队伍数据和比赛历史都会在重启后保留。在 config.yml 中切换后端:

database:
  type: sqlite    # 或 "mysql"
  sqlite-file: database.db
  mysql:
    host: localhost
    port: 3306
    database: hungergames
    username: root
    password: password

✔️ 所有写入均为异步操作 ✔️ 启动时自动架构迁移 — 无数据丢失


? 要求

组件 版本
Java 21+
Paper 1.21+
PlaceholderAPI 可选
Vault 可选
ProtocolLib 可选
FastAsyncWorldEdit 可选 (.nbt / .schem 支持)

? 安装

  1. 下载 .jar 文件
  2. 将其放入 plugins/ 文件夹
  3. 启动服务器 — 配置文件自动生成
  4. 站在竞技场的中心 → /hg create <name>
  5. /hg setcornucopia <name> classic
  6. 走到每个生成点 → /hg addspawn <name> (重复 2–24 次)
  7. 站在你的大厅 → /hg setlobby
  8. /hg start <name>

玩家通过 /hg join <name> 加入。


?️ 竞技场系统

每竞技场开关(通过 /hg setuparena <name> <flag> 实时更改):

标志 默认值 作用
pvp on 启用/禁用 PvP 伤害
lifesteal off 玩家死亡时掉落心形物品
hardcore off 淘汰的玩家将被踢出服务器
veinminer off 潜行 + 破坏以连锁挖掘矿石
nether on 每个竞技场拥有独立的下界世界
theend on 允许进入末地维度

传说级刷新点:

/hg setlegendary <arena> <itemId>   — 在你脚下标记刷新点
/hg deletelegendary <arena>         — 移除最近的刷新点(5格范围内)

⚡ 传奇武器

?️ 剑与近战

物品 能力
☁️ Cloud Sword 在云上行进;免疫坠落伤害;命中时削减护甲
? Midas Sword 每次击杀增加1点伤害(可叠加);击杀时产生金色粒子效果
? Emerald Blade 投入绿宝石以升级伤害;潜行+点击打开 GUI
? Shadow Blade 潜行:瞬移到目标身后;点击:获得隐身 + 速度 III
? Reaper Scythe 命中时:窃取增益并治疗;右键:AOE 横扫
? Dragon Katana 被动速度 I;右键:龙息弹冲刺
✨ Excalibur 5秒真实无敌(抵消所有伤害);50% 伤害反射
? Golem Hammer 跳跃并在落地时产生冲击波;被动击退抗性
? Magma Club 熔岩柱 AOE;潜行+点击:火山爆发
⛏️ Warpick 命中时造成 3×3 爆炸;暴击时:削减护甲耐久度
? Obsidian Dagger 潜行+点击:抗性 V 护盾;点击:陨石打击
? Crimson Chainsword 削减层数被动;右键:链锯狂暴爆发
? Soul Gauntlet 命中时收集灵魂;右键:灵魂 blast;潜行:地面重击
? Harpoon Launcher 发射鱼叉钩住并将目标拉向你

? 弓与远程

物品 能力
? Artemis Bow 5支追踪箭;闪电触发;Sky Strike 潜行技能
?️ Phantom Longbow 隐形箭;施法者射击时隐身;目标获得黑暗效果
? Ender Bow 潜行:虚空冲刺;箭矢命中:与目标交换位置
? Toxic Crossbow 高速弩箭;撞击时产生毒云
? Warden Crossbow 声波轰击投射物;命中时将方块转化为深暗之域
? Corrupted Crossbow 基于刻的毒云弩箭;支持多重射击附魔
? Guardian Cannon 在水中被动海豚之恩;持续冻结激光
? Pufferfish Cannon 弹跳河豚;爆炸产生中毒 + 反胃效果

? 法杖与魔法

物品 能力
? Lich Staff 4发弹药冰球;30秒装填时间;被动冰霜行者
? Void Staff 切换传送门 / 潜影贝模式;每种模式独立冷却
? Hypnosis Staff 催眠最多5只生物;仆从攻击你的敌人
? Villager Wand 瞄准方块 → 爆炸粘液炸弹引爆
? Death Note /dn <player>:即死(3次使用次数,每目标冷却25秒)
? Sculkweaver's Lantern 深暗之域炸弹:黑暗 + 缓慢滞留区域
❄️ Horn of Winter 暴风雪:大范围持续冻结 + 缓慢
? Ghastly Whistle 可骑乘的恶魂伙伴;每2秒自动发射火球;持续20秒

? 三叉戟、发射器与特殊

物品 能力
? Aiglos 三叉戟:爆炸投掷 + AOE 冻结;通过属性获取近战数值
? Wither Sickles 自动副手双持;投掷(CD 7秒);命中时 AOE 凋灵 + 生命偷取
⚡ Mjolnir 投掷(会返回);近战命中:闪电打击
? Ravager Horn 骑乘劫掠兽;潜行+点击:践踏波
? Shrink Ray 左键:缩小目标;右键:放大目标
? Armadillo Detonator 最多发射3只犰狳;左键:引爆所有
? Beehive Blaster 发射4只愤怒的蜜蜂,自动锁定最近的敌人
? Ribbit Reel 击中方块:将自己拉过去;击中实体:将对方拉向你
? Fountain of Youth 持有时被动每秒恢复1点生命值;右键:为盟友创造30秒的治疗区域

?️ 盔甲

物品 部位 能力
? Hades' Helm 头部 夜视;潜行时隐身;火焰光环;受到凋灵攻击时反击
? Hermes Boots 脚部 速度 II + 跳跃提升;赫尔墨斯冲刺;完全免疫坠落伤害
? Reinforced Elytra 胸部 滑翔时产生粒子轨迹;声波轰击加速;落地爆炸

? 地下城

地下城在比赛中程序化生成——无需任何结构文件。

dungeons:
  mob-hp: 60.0
  boss-hp: 100.0
  spawn-chance: 0.1
  lava-temple:
    enabled: true
    mob-hp: 40.0
    fire-ticks: 100

? 盛宴事件

高级宝箱会在 configurable timer 过后于丰饶角处生成。

arena:
  feast:
    enabled: true
    time-minutes: 20
    chest-count: 8
    announce-minutes: [15, 10, 5, 3, 2, 1]

? 队伍

命令 描述
/team create <name> 创建队伍(你将成为队长)
/team invite <player> 发送邀请(60秒后过期)
/team join <name> 加入开放队伍
/team leave 离开当前队伍
/team open 切换开放/仅邀请模式
/team disband 解散队伍(仅限队长)
/tc <message> 队伍聊天

⌨️ 命令

/hg — 主命令

子命令 权限 描述
join <arena> hoplitebr.hg 加入竞技场大厅
leave hoplitebr.hg 离开当前竞技场
lang <code> hoplitebr.hg 更改你的语言
create <name> hoplitebr.admin 创建新竞技场
start <arena> hoplitebr.admin 强制开始比赛
setcornucopia <arena> <theme> hoplitebr.admin 设置并构建角斗场(Cornucopia)
addspawn <arena> hoplitebr.admin 在你脚下添加玩家重生点
setuparena <arena> <flag> hoplitebr.admin 切换每个竞技场的标志位
setlegendary <arena> <id> hoplitebr.admin 标记传奇重生点
setlobby hoplitebr.admin 设置赛后大厅位置
admin give <player> <item> hoplitebr.admin 给予传奇物品
reload hoplitebr.admin 重载所有配置文件

其他命令

命令 权限 描述
/withdraw <amount> hoplitebr.withdraw 将生命偷取之心转换为物品
/perf <stats|optimize|reload|gc|chunks> hoplitebr.admin 性能工具
/structure <reset|stats> hoplitebr.admin 结构体管理
/locate <name> hoplitebr.hg 定位已放置的结构体
/migrate hoplitebr.admin 迁移旧版传奇 PDC 标签
/debug hoplitebr.admin 向控制台输出调试信息
/dn <player> hoplitebr.dn 死亡笔记击杀命令

? 权限

权限 默认值 描述
hoplitebr.hg true 基础游戏命令
hoplitebr.team true 队伍命令
hoplitebr.tc true 队伍聊天
hoplitebr.withdraw true 生命偷取之心提取
hoplitebr.dn true 死亡笔记击杀命令
hoplitebr.admin op 所有管理员/设置命令

? 配置

配置文件:

  • config.yml — 全局设置、竞技场默认值、数据库、性能
  • loot.yml — 宝箱战利品层级(普通 / 稀有 / 史诗)
  • scoreboard.yml — 计分板布局和更新间隔
  • legend-items/<id>.yml — 每把武器的属性、配方、背景故事、附魔
  • dungeons.yml — 地牢类型开关和怪物生命值
  • cornucopia.yml — 角斗场(Cornucopia)建造预设
  • languages/<code>.yml — 消息翻译

? 开发者 API

// 获取玩家所在的竞技场(如果不在任何竞技场则返回 null)
Arena arena = HopliteAPI.getPlayerArena(player);

// 访问插件实例
Main plugin = HopliteAPI.getPlugin();

自定义事件:

事件 触发时机
ArenaStartEvent 比赛状态从 STARTING 变为 PLAYING
ArenaEndEvent 比赛结束(宣布获胜者)
PlayerEliminatedEvent 一名玩家被淘汰
DungeonSpawnEvent 生成一个地牢

? 故障排除

传奇技能不起作用
  • 确认玩家处于活跃竞技场中(PLAYING 或 DEATHMATCH 状态)
  • 检查 hoplitebr.admin 权限 —— OP 总是绕过技能检查
  • 运行 /debug 并在控制台中查找带有 debug: true 的 [Ability] 日志行
开始时倒计时立即取消
  • 已在 4.5.5 修复 (BUG-CD-01)
  • 更新至最新版本
第二场比赛从未刷新盛宴(Feast)
  • 已在 4.5.5 修复 (BUG-FM-01)
  • 更新至最新版本
每次加入时统计数据重置为零
  • 已在 4.5.7 修复 (BUG-JOIN-02)
  • 更新至最新版本
技能监听器触发两次
  • 已在 4.5.7 修复 (BUG-REG-01)
  • 由技能构造函数中的 registerEvents() 引起
传奇物品名称显示为斜体
  • 已在 4.5.4 修复 (BUG-FONT-01)
  • Paper 1.20.5+ 更改了自定义物品名称的默认渲染样式
玩家在死亡竞赛开始时未被传送到中心
  • 已在 4.6.2 修复 (BUG-1 / GameTask FSM 绕过)
  • GameTask 直接调用 arena.setState(DEATHMATCH),绕过了 MatchService.transition()。scheduleDeathmatchTask() 内的传送和边界收缩逻辑从未运行。
世界边界忽略我的配置值 —— 始终使用 1000 格
  • 已在 4.6.2 修复 (BUG-2 / 不匹配的配置键)
  • GameTask 读取了 game.initial-border-size 和 game.border.initial-size(错误的键)。标准的键是 game.border-initial-size。游戏循环总是回退到硬编码的默认值 1000。
在 PLAYING 阶段期间,边界每秒闪烁/跳动一次
  • 已在 4.6.2 修复 (BUG-4 / 双重边界控制)
  • MatchService.scheduleBorderTask() 和 GameTask.handleWorldBorder() 同时写入 WorldBorder。每次刻度的重新计算每秒覆盖了一次平滑的周期性动画。scheduleBorderTask() 已被移除;现在 GameTask 是唯一的边界控制权。
传奇物品全息图显示材质名称(例如 "WOODEN_SWORD")而不是武器名称
  • 已在 4.6.2 修复 (BUG-5 / 遗留显示名称 API)
  • Arena.getActiveLegendaryLocations() 调用了 meta.getDisplayName()(遗留 API),对于使用 Adventure Component API 的物品,它始终返回 ""。因此总是触发了 recipe.getType().name() 的回退逻辑。
当整支队伍作为最后幸存者存活时,游戏未结束
  • 已在 4.6.2 修复 (BUG-6 / checkWin 队伍逻辑)
  • checkWin() 仅在 aliveCount == 1 时结束游戏。如果最后存活的 2 名或多名玩家都在同一支队伍,游戏会继续并强迫队友互相击杀。现在会检查所有存活玩家是否属于同一支队伍。
执行两次 `/hg start` 后竞技场无法正确重置
  • 已在 4.6.2 中修复(BUG-3 / BUG-8 — 倒计时任务未被跟踪)
  • startMatch(Arena, int) 和 startCountdown() 在创建倒计时 BukkitRunnable 时均未存储任务引用。cancelAllTasksFor() 无法取消它们,导致两个倒计时计时器同时运行,并且 startArena() 被调用了两次。
/reload 会破坏插件
  • 始终重启服务器 —— 切勿使用 /reload

❓ 常见问题

我可以同时运行多个竞技场吗?

可以 —— 每个竞技场都在其独立的世界实例中完全隔离。

我需要 FastAsyncWorldEdit 吗?

不需要。仅当您想要粘贴自定义 .nbt / .schem 结构时才需要。

同一队伍的玩家可以互相伤害吗?

不可以 —— 所有传奇武器都包含友军伤害检测。

我如何添加自定义语言?

创建 languages/<code>.yml —— 复制 en.yml 作为基础并进行翻译。玩家通过 /hg lang <code> 切换语言。

它支持 Spigot 吗?

不支持 —— 需要 Paper 1.21+。


? 鸣谢

作者: Duong2012G — Modrinth

多种武器机制灵感来源于 DemoRaLegendary Weapons by Demora(Apache 2.0 许可证)。 未复制任何源代码 —— 仅参考了游戏玩法概念。

? DemoRaLegendary Weapons:

开源 —— 欢迎贡献。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源