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 支持) |
? 安装
- 下载
.jar 文件
- 将其放入
plugins/ 文件夹
- 启动服务器 — 配置文件自动生成
- 站在竞技场的中心 →
/hg create <name>
/hg setcornucopia <name> classic
- 走到每个生成点 →
/hg addspawn <name> (重复 2–24 次)
- 站在你的大厅 →
/hg setlobby
/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 会破坏插件
❓ 常见问题
我可以同时运行多个竞技场吗?
可以 —— 每个竞技场都在其独立的世界实例中完全隔离。
我需要 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:
开源 —— 欢迎贡献。
HungerGamesSSS
A full-featured Hunger Games survival plugin for Paper 1.21+
v4.6.4 — Architecture & Gameplay Bug-Fix Patch released 2026-06-04.
11 structural bugs fixed: contradictory ArenaEndEvent comments, duplicate
LootTableManager and CornucopiaBuilder instances causing config-reload drift,
startMatch() bypassing the FSM transition() contract, spawn cages placed inside
terrain at Y=100, players falling through piston floors due to async physics,
dead checkCompatibility() method, empty MatchSession class, stale nested language
directory, and disconnected players holding matches open indefinitely (now auto-expired
after configurable game.reconnect-timeout seconds, default 60).
No database migrations — drop-in replacement for 4.6.3.
Upgrade strongly recommended. See CHANGELOG.md for the full list.
45 legendary weapons. Procedural dungeons. Last player standing.
? Download • ? Report a Bug • ? Discord
? Table of Contents
- ✨ Features
- ? Requirements
- ? Installation
- ?️ Arena System
- ⏱️ Match Lifecycle
- ? Game Modes
- ⚡ Legendary Weapons
- ? Dungeons
- ? Cornucopia Builder
- ? Feast Event
- ? Teams
- ? Persistence
- ? Localisation
- ⌨️ Commands & Permissions
- ? Developer API
- ? Troubleshooting
- ? Credits
✨ Features
?️ Arena System
- Multi-arena support — run unlimited concurrent arenas in separate worlds
- Per-arena toggles — PvP, lifesteal, hardcore, veinminer, nether, end
- Glass cage countdown — players locked in cages at spawn until the match begins
- Auto-reset — arena world and all blocks fully restored after each match
- Legendary spawn points — holograms float above each marked item location
⚡ 45 Legendary Weapons
| Category |
Count |
Examples |
| Swords & Melee |
15 |
Cloud Sword, Excalibur, Dragon Katana |
| Bows & Ranged |
8 |
Artemis Bow, Phantom Longbow, Warden Crossbow |
| Staves & Magic |
8 |
Void Staff, Lich Staff, Hypnosis Staff |
| Tridents & Special |
9 |
Aiglos, Mjolnir, Ravager Horn |
| Armor |
3 |
Hades' Helm, Hermes Boots, Reinforced Elytra |
| Utility / Healing |
2 |
Fountain of Youth, Warpick |
✔️ Each weapon has unique active + passive abilities
✔️ All stats tunable in legend-items/<id>.yml
✔️ Hot-reload with /perf reload — no restart needed
? Procedural Dungeons
| Type |
Terrain |
| ?️ Spider Nest |
Cobweb cave |
| ? Crypt |
Stone brick chamber |
| ⛏️ Gold Mine |
Mineshaft tunnels |
| ? Lava Temple |
Nether-brick structure |
| ? Ice Temple |
Packed-ice biome |
| ?️ Surface Temple |
Sandstone ruin |
| ? Surface Outpost |
Watchtower |
| ?️ Sky Island |
Floating grass |
| ? Floating Castle |
Castle 30 blocks up |
✔️ No external schematics required
✔️ Loot configurable per dungeon type
✔️ All blocks restored after match ends
? Match Lifecycle
WAITING → STARTING → PLAYING → DEATHMATCH → ENDED
| Phase |
Description |
| ⏳ Waiting |
Players queue in lobby |
| ? Starting |
Countdown; players teleport into cages |
| ⚔️ Playing |
Grace period → main phase → feast → border shrink |
| ? Deathmatch |
Border closes; final players fight |
| ? Ended |
Winner announced; arena fully reset |
✔️ Disconnect/reconnect mid-match restores last location, inventory, and scoreboard
? Game Modes
❤️ Lifesteal
Kill a player → they drop a heart item. Pick it up to raise your max HP. Convert hearts back with /withdraw <amount>.
? Hardcore
Eliminated players are kicked instead of moved to spectator mode.
⛏️ Veinminer
Sneak + break an ore → chain-mines the entire vein. Max vein size is hot-configurable.
? Cornucopia Themes
13 procedural themes for the arena centrepiece:
classic · ultimate · speedsilver · ancient · void · royal · industrial · modern · crystal · jungle · end · nether · grand
? Localisation
10 built-in language files:
?? en · ?? vi · ?? ru · ?? de · ?? fr · ?? es · ?? pt · ?? ja · ?? ko · ?? zh
Players change language in-game with /hg lang <code>.
? Persistence — SQLite / MySQL
All arena state, player stats, team data, and match history persist across restarts. Switch backends in config.yml:
database:
type: sqlite # or "mysql"
sqlite-file: database.db
mysql:
host: localhost
port: 3306
database: hungergames
username: root
password: password
✔️ All writes are async
✔️ Auto schema migration on startup — no data loss
? Requirements
| Component |
Version |
| Java |
21+ |
| Paper |
1.21+ |
| PlaceholderAPI |
Optional |
| Vault |
Optional |
| ProtocolLib |
Optional |
| FastAsyncWorldEdit |
Optional (.nbt / .schem support) |
? Installation
- Download the
.jar
- Drop it into
plugins/
- Start the server — configs generate automatically
- Stand at the centre of your arena →
/hg create <name>
/hg setcornucopia <name> classic
- Walk to each spawn point →
/hg addspawn <name> (repeat 2–24×)
- Stand in your lobby →
/hg setlobby
/hg start <name>
Players join with /hg join <name>.
?️ Arena System
Per-arena toggles (changed live with /hg setuparena <name> <flag>):
| Flag |
Default |
What it does |
pvp |
on |
Enable / disable PvP damage |
lifesteal |
off |
Players drop heart items on death |
hardcore |
off |
Eliminated players are kicked |
veinminer |
off |
Sneak + break to chain-mine ores |
nether |
on |
Isolated Nether world per arena |
theend |
on |
Access to The End dimension |
Legendary spawn points:
/hg setlegendary <arena> <itemId> — mark spawn at your feet
/hg deletelegendary <arena> — remove nearest spawn (within 5 blocks)
⚡ Legendary Weapons
?️ Swords & Melee
| Item |
Ability |
| ☁️ Cloud Sword |
Walk on clouds; fall immunity; armor shred on hit |
| ? Midas Sword |
+1 damage per kill (stacks); golden particle on kill |
| ? Emerald Blade |
Deposit emeralds to upgrade damage; sneak+click GUI |
| ? Shadow Blade |
Sneak: teleport behind target; click: invisibility + Speed III |
| ? Reaper Scythe |
On hit: steal buffs and heal; right-click: AOE sweep |
| ? Dragon Katana |
Passive Speed I; right-click: Dragon Fireball dash |
| ✨ Excalibur |
5s true invincibility (all damage cancelled); 50% reflect |
| ? Golem Hammer |
Leap + shockwave on landing; passive knockback resistance |
| ? Magma Club |
Lava pillar AOE; sneak+click: volcanic eruption |
| ⛏️ Warpick |
On-hit 3×3 explosion; on critical hit: armor durability shred |
| ? Obsidian Dagger |
Sneak+click: Resistance V shield; click: meteor strike |
| ? Crimson Chainsword |
Shred stacks passive; right-click: Chainsaw Rampage burst |
| ? Soul Gauntlet |
Collect souls on hit; right-click: Soul Blast; sneak: Ground Slam |
| ? Harpoon Launcher |
Fires a harpoon that hooks and pulls the target toward you |
? Bows & Ranged
| Item |
Ability |
| ? Artemis Bow |
5 homing arrows; lightning proc; Sky Strike sneak ability |
| ?️ Phantom Longbow |
Invisible arrow; caster invisible on fire; target gets Darkness |
| ? Ender Bow |
Sneak: Void Dash; arrow hit: swap positions with target |
| ? Toxic Crossbow |
High-velocity bolt; poison cloud on impact |
| ? Warden Crossbow |
Sonic Boom projectile; converts blocks to Sculk on hit |
| ? Corrupted Crossbow |
Tick-based poison cloud bolt; Multishot enchant support |
| ? Guardian Cannon |
Passive Dolphins Grace in water; continuous stasis laser |
| ? Pufferfish Cannon |
Bouncing pufferfish; explodes with Poison + Nausea |
? Staves & Magic
| Item |
Ability |
| ? Lich Staff |
4 ammo ice balls; 30s reload; passive Frost Walker |
| ? Void Staff |
Toggle Portal / Shulker Mode; independent cooldowns per mode |
| ? Hypnosis Staff |
Hypnotise up to 5 mobs; minions target your enemies |
| ? Villager Wand |
Aim at block → explosive slime bomb detonates |
| ? Death Note |
/dn <player>: instant kill (3 uses, per-target cooldown 25s) |
| ? Sculkweaver's Lantern |
Sculk bomb: Darkness + Slowness lingering zone |
| ❄️ Horn of Winter |
Blizzard: continuous Freeze + Slowness in large radius |
| ? Ghastly Whistle |
Rideable Ghast companion; auto-fireball every 2s; 20s duration |
? Tridents, Launchers & Special
| Item |
Ability |
| ? Aiglos |
Trident: explosive throw + AOE freeze; melee stats via attributes |
| ? Wither Sickles |
Auto dual-wield offhand; throw (CD 7s); AOE Wither + lifesteal on hit |
| ⚡ Mjolnir |
Throw (returns); melee hit: lightning strike |
| ? Ravager Horn |
Mount a Ravager; sneak+click: Stampede wave |
| ? Shrink Ray |
Left-click: shrink target; right-click: enlarge target |
| ? Armadillo Detonator |
Shoot up to 3 armadillos; left-click: detonate all |
| ? Beehive Blaster |
Launches 4 angry bees that auto-target nearest enemy |
| ? Ribbit Reel |
Hit block: pull yourself; hit entity: pull them to you |
| ? Fountain of Youth |
Passive +1 HP/s while held; right-click: 30s healing zone for allies |
?️ Armor
| Item |
Slot |
Ability |
| ? Hades' Helm |
Head |
Night Vision; invisibility while sneaking; fire aura; Wither attacker on hit received |
| ? Hermes Boots |
Feet |
Speed II + Jump Boost; Hermes Dash; full fall immunity |
| ? Reinforced Elytra |
Chest |
Particle trail while gliding; Sonic Boom boost; landing explosion |
? Dungeons
Dungeons spawn procedurally during a match — no schematic files needed.
dungeons:
mob-hp: 60.0
boss-hp: 100.0
spawn-chance: 0.1
lava-temple:
enabled: true
mob-hp: 40.0
fire-ticks: 100
? Feast Event
High-tier chests spawn at the Cornucopia after a configurable timer.
arena:
feast:
enabled: true
time-minutes: 20
chest-count: 8
announce-minutes: [15, 10, 5, 3, 2, 1]
? Teams
| Command |
Description |
/team create <name> |
Create a team (you become leader) |
/team invite <player> |
Send an invite (expires 60s) |
/team join <name> |
Join an open team |
/team leave |
Leave your team |
/team open |
Toggle open / invite-only |
/team disband |
Disband team (leader only) |
/tc <message> |
Team chat |
⌨️ Commands
/hg — Main Command
| Sub-command |
Permission |
Description |
join <arena> |
hoplitebr.hg |
Join an arena lobby |
leave |
hoplitebr.hg |
Leave the current arena |
lang <code> |
hoplitebr.hg |
Change your language |
create <name> |
hoplitebr.admin |
Create a new arena |
start <arena> |
hoplitebr.admin |
Force-start a match |
setcornucopia <arena> <theme> |
hoplitebr.admin |
Set and build the Cornucopia |
addspawn <arena> |
hoplitebr.admin |
Add player spawn at your feet |
setuparena <arena> <flag> |
hoplitebr.admin |
Toggle per-arena flags |
setlegendary <arena> <id> |
hoplitebr.admin |
Mark legendary spawn |
setlobby |
hoplitebr.admin |
Set post-match lobby location |
admin give <player> <item> |
hoplitebr.admin |
Give a legendary item |
reload |
hoplitebr.admin |
Reload all config files |
Other Commands
| Command |
Permission |
Description |
/withdraw <amount> |
hoplitebr.withdraw |
Convert lifesteal hearts to items |
/perf <stats|optimize|reload|gc|chunks> |
hoplitebr.admin |
Performance tools |
/structure <reset|stats> |
hoplitebr.admin |
Structure management |
/locate <name> |
hoplitebr.hg |
Locate a placed structure |
/migrate |
hoplitebr.admin |
Migrate legacy legendary PDC tags |
/debug |
hoplitebr.admin |
Dump debug info to console |
/dn <player> |
hoplitebr.dn |
Death Note kill command |
? Permissions
| Permission |
Default |
Description |
hoplitebr.hg |
true |
Basic game commands |
hoplitebr.team |
true |
Team commands |
hoplitebr.tc |
true |
Team chat |
hoplitebr.withdraw |
true |
Lifesteal heart withdrawal |
hoplitebr.dn |
true |
Death Note kill command |
hoplitebr.admin |
op |
All admin / setup commands |
? Configuration
Config files:
config.yml — global settings, arena defaults, database, performance
loot.yml — chest loot tiers (common / uncommon / rare)
scoreboard.yml — scoreboard layout and update interval
legend-items/<id>.yml — per-weapon stats, recipe, lore, enchantments
dungeons.yml — dungeon type toggles and mob HP
cornucopia.yml — Cornucopia build presets
languages/<code>.yml — message translations
? Developer API
// Get the arena a player is in (null if not in any)
Arena arena = HopliteAPI.getPlayerArena(player);
// Access the plugin instance
Main plugin = HopliteAPI.getPlugin();
Custom Events:
| Event |
Fired when |
ArenaStartEvent |
Match transitions STARTING → PLAYING |
ArenaEndEvent |
Match ends (winner declared) |
PlayerEliminatedEvent |
A player is eliminated |
DungeonSpawnEvent |
A dungeon is generated |
? Troubleshooting
Legendary abilities not working
- Confirm the player is in an active arena (
PLAYING or DEATHMATCH)
- Check
hoplitebr.admin permission — OP always bypasses ability checks
- Run
/debug and check console for [Ability] log lines with debug: true
Countdown cancels immediately on start
- Fixed in 4.5.5 (BUG-CD-01)
- Update to latest version
Feast never spawns in second match
- Fixed in 4.5.5 (BUG-FM-01)
- Update to latest version
Stats reset to zero on every join
- Fixed in 4.5.7 (BUG-JOIN-02)
- Update to latest version
Ability listeners fire twice
- Fixed in 4.5.7 (BUG-REG-01)
- Was caused by
registerEvents() in ability constructors
Italic text on legendary item names
- Fixed in 4.5.4 (BUG-FONT-01)
- Paper 1.20.5+ changed the default rendering style for custom item names
Players not teleported to centre at Deathmatch start
- Fixed in 4.6.2 (BUG-1 / GameTask FSM bypass)
GameTask was calling arena.setState(DEATHMATCH) directly, bypassing MatchService.transition(). The teleport and border-collapse logic inside scheduleDeathmatchTask() never ran.
World border ignores my config values — always uses 1000 blocks
- Fixed in 4.6.2 (BUG-2 / mismatched config keys)
GameTask was reading game.initial-border-size and game.border.initial-size (wrong keys). The canonical key is game.border-initial-size. The game-loop always fell back to the hardcoded default of 1000.
Border flickers / jumps every second during PLAYING phase
- Fixed in 4.6.2 (BUG-4 / dual border control)
MatchService.scheduleBorderTask() and GameTask.handleWorldBorder() both wrote to the WorldBorder simultaneously. The per-tick recalculation overrode the smooth periodic animation every second. scheduleBorderTask() has been removed; GameTask is now the sole border authority.
Legendary item hologram shows material name (e.g. "WOODEN_SWORD") instead of weapon name
- Fixed in 4.6.2 (BUG-5 / legacy display-name API)
Arena.getActiveLegendaryLocations() called meta.getDisplayName() (legacy API) which always returns "" for items using the Adventure Component API. The fallback of recipe.getType().name() was always reached.
Game doesn't end when a full team is the last survivor
- Fixed in 4.6.2 (BUG-6 / checkWin team logic)
checkWin() only ended the game when aliveCount == 1. If the last 2+ survivors were all on the same team, the game continued and forced teammates to kill each other. Now checks if all alive players share a team.
Arena doesn't reset properly after double `/hg start`
- Fixed in 4.6.2 (BUG-3 / BUG-8 — countdown tasks not tracked)
- Both
startMatch(Arena, int) and startCountdown() created countdown BukkitRunnables without storing the task reference. cancelAllTasksFor() could not cancel them, leading to two countdown timers running concurrently and startArena() being called twice.
/reload breaks the plugin
- Always restart the server — never use
/reload
❓ FAQ
Can I run multiple arenas at once?
Yes — each arena is fully isolated in its own world instance.
Do I need FastAsyncWorldEdit?
No. It is only required if you want to paste custom .nbt / .schem structures.
Can players on the same team damage each other?
No — all legendary weapons include friendly-fire checks.
How do I add a custom language?
Create languages/<code>.yml — copy en.yml as a base and translate. Players switch with /hg lang <code>.
Does it support Spigot?
No — Paper 1.21+ is required.
? Credits
Author: Duong2012G — Modrinth
Several weapon mechanics were inspired by DemoRaLegendary Weapons by Demora (Apache 2.0 licence).
No source code was copied — only gameplay concepts were referenced.
? DemoRaLegendary Weapons:
Open source — contributions welcome.
评论 0
登录后参与评分
还没有评论,来抢沙发吧