ArenaCore（竞技核心）

A team-versus-team minigame mod for Fabric 1.20.1, built for survival/adventure PvP.

作者 / Author：xinranzihao (欣然自豪/无聊的Here)

---

Overview / 简介

ArenaCore is a fully customizable team-versus-team minigame mod. The host configures teams, timing, rules, respawns and spawn points from an in-game OP panel; players pick a team, count down to launch, receive unified gear and team-colored armor, then fight in a fair match with scoring, respawns, HUD timers, kill feedback and settlement leaderboards. All settings are saved to disk and survive restarts.

中文：竞技核心（ArenaCore）是一个完全可自定义的团队对抗小游戏模组。房主通过 OP 控制面板一键配置队伍、时长、规则、复活与出生点；玩家选队后进入倒计时开局，统一发放装备与队伍色装备，进行一场有计分、有复活、有 HUD 计时、有击杀反馈、有结算排名的公平对抗。所有配置落盘保存，重启不丢。

---

Game Flow / 玩法流程

1. Start：The host presses Right Shift or types /minigame panel to open the panel, then clicks the always-visible "▶ Start Game" button at the bottom (or types /minigame start).

   中文：房主按 右 Shift 或输入 /minigame panel 打开控制面板，点底部常驻的「▶ 开始游戏」（或输入 /minigame start）。

2. Team Select：Everyone picks a team on the team-select screen; undecided players are auto-balanced to the least populated teams when time runs out.

   中文：全员进入选队界面，选择想加入的队伍；到时间未选则由系统自动均衡分配。

3. Countdown：Remaining seconds are announced; the match launches automatically when the countdown ends.

   中文：提示剩余秒数，倒计时结束后自动开局。

4. Match：Players receive unified items and team-colored leather armor (armor/toughness boosted to netherite tier), are teleported to their team spawn with spawn invulnerability, then fight freely.

   中文：统一发放物品、装备队伍色皮革甲（防御与韧性补到下界合金同档）、传送到出生点、给予开局无敌，随后自由对抗。

5. Death & Respawn：Depending on the host's respawn rules, players can respawn themselves by clicking "Respawn" (or enable "Instant Respawn" to auto-revive), or choose to spectate.

   中文：根据房主设定的复活规则，玩家可自己点「重生」复活（或开启「立即重生」自动复活），也可选择旁观。

6. Settlement：When the match timer ends, the settlement screen opens with four switchable leaderboards.

   中文：对局时长结束进入结算界面，可在四种排行榜间切换查看。

---

Features / 核心功能

Teams / 队伍系统

• Up to 8 teams; each team can set its own name, theme color (HEX) and spawn point (a "Locate" button fills your current position; leaving it blank uses the world spawn).
• The scoreboard shows team/player membership in real time; names and gear are tinted by team color.
• Players who skip selection are auto-assigned to the smallest team.

中文：

• 最多 8 支队伍，每队可自定义名称、主题色（HEX）、出生点（「定位」按钮一键填入当前坐标，留空=世界出生点）。
• 记分板实时显示队伍与玩家归属，玩家名/装备按队伍色区分。
• 未选队玩家自动分配至人数少的队伍。

Match Settings / 对局配置

• Total match duration, countdown, team-select time and respawn invulnerability are all configurable (in seconds).
• Game mode: Survival / Adventure.
• Starting items: itemID,count; separate multiple with semicolons, e.g. minecraft:iron_sword,1; minecraft:bow,1; minecraft:arrow,16.

中文：

• 游戏总时长 / 开局倒计时 / 选队时间 / 重生无敌全部可调（秒）。
• 游戏模式：生存 / 冒险。
• 开局发放物品：物品ID,数量; 多个用分号分隔，如 minecraft:iron_sword,1; minecraft:bow,1; minecraft:arrow,16。

Scoring / 计分系统

• Kill-count mode: +1 per kill.
• Kill-point mode: kills award points by tag — headshot, crit, explosion, combo streaks, long-range, invisible, etc.; assists give +1.
• HUD kill feed: slides in from the right and fades out, with killer/victim team colors and tags.

中文：

• 击杀人数模式：每次击杀 +1 分。
• 击杀积分模式：击杀按标签加分——爆头、暴击、爆炸、连杀（组合加成）、远程、隐身等；助攻 +1。
• HUD 击杀提示：右侧滑入 + 淡出，带杀手/受害者的队伍色与标签。

Respawn System / 复活系统

• Respawn modes: No Respawn (out on death) / Limited Respawns / Unlimited Respawns.
• "Instant Respawn" toggle: ON = auto-revive on death; OFF (default) = a choice screen pops up and the player clicks "Respawn (N left) / Spectate".
• When no respawn chances remain, players can be sent to spectator automatically or left on the death screen to decide.
• Respawn returns you to spawn, refills gear, clears status effects and grants invulnerability.

中文：

• 复活方式：不重生（死亡即出局）/ 有限次复活 / 无限次复活。
• 立即重生开关：开 = 死亡后自动复活；关（默认）= 弹出选择界面，玩家自己点「重生（剩 N 次）/ 观战」。
• 无复活机会时可选择自动进入旁观，或停在死亡界面自行决定。
• 复活自动回出生点、补满装备、重置状态、给予无敌时间。

Live HUD / 实时 HUD

• Top-stage timer (Team Select / Preparing / Fighting) with a blinking warning near the end.
• Score bar, alive count and the kill feed can all be toggled in the panel.

中文：

• 顶部阶段计时器（选队 / 准备 / 对战中）+ 剩余秒数闪烁提醒。
• 比分条、存活人数、击杀提示流，全部可在面板中开关。

Settlement Leaderboards / 结算四榜

Switchable after a match:

• Kill-Count Board：individual kills
• Kill-Score Board：individual points
• Team-Kill Board：total team kills
• Team-Score Board：total team points

Top 3 get gold/silver/bronze medal colors and your own row is highlighted; use the wheel + scrollbar when there are many rows.

中文： 对局结束可切换查看：

• 击杀人数榜：个人击杀数
• 击杀分数榜：个人积分
• 击杀团队榜：团队总击杀
• 团队积分榜：团队总积分

前三名金/银/铜奖牌色，本人所在行高亮；行数多时滚轮 + 滚动条翻页。

OP Control Panel / OP 控制面板

• Adaptively centered and never larger than the window — title, bottom buttons and content are all visible.
• Content scrolls with the mouse wheel plus a right-side scrollbar; both top and bottom are reachable.
• A full-width "Start Game" button occupies its own row at the bottom, always visible regardless of content length.
• Grouped card layout: Time / Rules / Respawn / Teams.
• Panel actions: Apply Config (broadcast & save), Start Game, Stop, Reset to Defaults, Close.

中文：

• 随分辨率自适应居中，永不超出窗口（标题、底部按钮、内容全部可见）。
• 内容区滚轮 + 右侧滚动条翻动，上下均可滑到头。
• 底部独占整行的超大「开始游戏」按钮，任何情况下常驻可见，绝不被内容顶掉。
• 分组卡片排版：时间设置 / 规则设置 / 复活设置 / 队伍设置。
• 面板支持：应用配置（广播并落盘）、开始游戏、停止、恢复默认、关闭。

Persistence / 配置持久化

• Applying config or starting a game writes the full config (teams, spawns, timings, rules, respawn settings) to minigame_config.json in the world folder.
• The config is reloaded on (re)start and echoed to OP players on join — nothing is lost on restart.

中文：

• 「应用配置 / 开始游戏」时把完整配置（队伍、出生点、时长、规则、复活设置）写入世界目录 minigame_config.json。
• 模组（重）启动自动读回，OP 进服自动回显，重启不丢。

---

Compatibility / 兼容性

• Minecraft 1.20.1, requires Fabric Loader + Fabric API.
• Install on both client and server (server for dedicated servers; clients need it too for the screens and HUD).
• Integrates with Mod Menu (icon, name and author shown there).
• Works in singleplayer without cheats enabled.

中文：

• Minecraft 1.20.1，需 Fabric Loader + Fabric API。
• 客户端与服务端需同时安装（多人服务器装在服务端，玩家端也需装上以显示界面与 HUD）。
• 与 Mod Menu 集成（模组菜单中显示图标、名称与作者）。
• 单人世界无需开启作弊也可使用面板与指令。

---

How to Use / 使用方式

1. Put arenacore-1.0.0.jar into the mods folder on both client and server (delete the old jar first).

   中文：将 arenacore-1.0.0.jar 放入客户端与服务器的 mods 目录（替换旧版前请先删除旧 jar）。

2. Once in-game:

   • Press Right Shift or type /minigame panel to open the panel.
   • Type /minigame start to launch directly.
   • /minigame stop to stop, /minigame teams shuffle to shuffle teams, /minigame reload to reload the config.

   中文：进入世界后：

   • 按 右 Shift 或输入 /minigame panel 打开控制面板。
   • 输入 /minigame start 直接开局。
   • /minigame stop 停止、/minigame teams shuffle 随机分队、/minigame reload 重载配置。

3. After configuring teams/rules/respawns/timing in the panel, click "Apply Config" or just hit "▶ Start Game".

   中文：在面板中完成队伍 / 规则 / 复活 / 时长设置后，点「应用配置」或直接点「▶ 开始游戏」。

---

Commands / 指令列表

Command	Description
/minigame panel	Open the OP control panel
/minigame start	Start the game immediately
/minigame stop	Stop the current match
/minigame reload	Reload the saved config
/minigame teams shuffle	Randomly assign all players to teams
/minigame mode <SURVIVAL/ADVENTURE>	Switch the match game mode

中文对照：

指令	说明
/minigame panel	打开 OP 控制面板
/minigame start	立即开始游戏
/minigame stop	停止当前对局
/minigame reload	重新加载已保存配置
/minigame teams shuffle	随机分配所有玩家到各队
/minigame mode <SURVIVAL/ADVENTURE>	切换开局游戏模式