BeaconGame Updates (6.0 → 7.0)

Auto-map-building & Map Management

• Auto-build on first launch: The initial maps for BeaconGame 1–4, the lobby, and the game worlds are bundled with the plugin. On a new server's first startup, if these worlds are detected as newly created, the maps are automatically laid out—no manual building or world copying needed. Existing maps are never overwritten on restart, and players' edits are never reverted.
• Chunked, lag-free placement: Maps are laid block-by-block over frames so startup stays smooth. The console prints "Start laying out / Layout complete" along with block counts. 6 maps total over 240,000 blocks, ~150 KB compressed—no startup impact.
• Manual rebuild for admins: New /bg map inspects each world's embedded map (block count, palette, volume); /bg map rebuild <world|all> re-lays it manually.

Map & Arena Renaming

• The 4 maps were renamed from default / map2 / map3 / map4 to BeaconGame 1 / 2 / 3 / 4 (the default map has been called Beacongame 1 since 6.2). Arena ids, world names, lobby NPCs, player menus, leaderboards, and help all show the unified name such as "BeaconGame 1".
• Auto-migration: On startup, spawn points, borders, teleport spots, teleport NPCs, and signs that pointed to old world names are automatically re-pointed to the new names—no manual config edits. On error, arenas.yml / config.yml are auto-backed-up (up to 5 copies) for rollback.
• Delete old folders manually: Old worlds (beacongame_default, beacongame_2…) are not auto-deleted; empty new worlds spawn under the new names after startup. Please remove the old empty folders after shutting down the server. Claims still follow the beacongame_<map> naming; old claims become orphans but don't affect new matches.

Map Settings & Gamerules

• Attacker Beacon Compass toggle: A new "Attacker Beacon Compass" option in /bg → Map Settings → Parameters. When on, attackers each round receive a "Beacon Tracking Compass" that points to the nearest defender beacon; when off, it's no longer issued and any issued compass is removed. The toggle is saved in config and applies uniformly to all maps, and changes take effect instantly (opening it mid-game immediately issues compasses; closing it retracts them).
• One-click server gamerule setup: The /bg menu's "Admin" section adds a "Server Gamerules" item, listing boolean vanilla gamerules (doMobSpawning, mobGriefing, keepInventory, doDaylightCycle, etc.), each togglable. The "Apply to Lobby & Arenas" button at the bottom writes the config to the lobby and all arena worlds (leaving the overworld/nether/end untouched) and reports how many took effect. Rules are stored in a separate plugins/BeaconGame/gamerules.yml, auto-generated with defaults and comments on first launch—editable by hand. On startup and /bg reload, the plugin re-applies gamerules.yml to keep settings persistent.

Menus & Match Start

• Player menu: Non-admins typing /bg open a player menu to join a map's waiting queue with one click, and can leave the queue, view the leaderboard, get help, read the game guide, and return to lobby—no admin commands exposed.
• Manual start only: Removed the "auto-prompt when enough players" logic; now only an admin clicking "Start Game" in the menu or running /bg start begins a match.
• Team/queue bug fixes: Merged into the single correct "Start Game" button (teams formed per menu-assigned attacker/defender groups, unassigned players auto-balanced to fill), with live display of both sides' counts—this fixed the bug where "setting teams via menu turned everyone into spectators". Before joining a queue, stale queue records across all maps are cleared so maps switch normally; the dead queues left by the old buggy path are also purged, fixing "entering a map says already in queue".
• Cleaner admin menu: The map settings screen is re-zoned into Parameters / Spawn / Region / Runtime, with the Runtime zone highlighting "Start Game" / "Stop Game" / "Team Assignment" and showing live match status.
• Defenders no longer forced to pick skills: The skill-route selection UI is now attacker-only. Defenders can't use skills anyway; the forced pick prompt on match entry is removed, so defenders no longer see a skill popup.

Credits

• New command /bg thanks (aliases 鸣谢 / credits) shows players the credits list. It currently honors Shuqing Sun and Zaipin Tan, and will expand in later versions. The command is added to the /bg help player command list and is available to all players anytime.

Core Gameplay (Official Release)

• Right-click the teleport NPC in the lobby, or type /bg join to join the queue, then wait for an admin's /bg start. A match has two phases:
  • Build phase: Defenders have time to place beacons and dig/build defenses; attackers are temporarily blinded and can't see beacon spots. Only beacons may be placed, not ordinary blocks.
  • Attack phase: PvP is enabled; attackers get the "Beacon Tracking Compass" to destroy beacons. Destroy all beacons to win, or defenders survive until time ends to win.
• Progress-triggered events include airdrop supplies, buffs/debuffs, nuclear strikes, teleport swaps, skill boosts, and a final assault. After a match, the field and your inventory auto-reset.
• Skill system: Attackers pick one of three evolution paths (Raid / Disrupt / Support), unlock skills via kills this match, and release them with the "Skill Core" right-click in their inventory; defenders hold the towers and are not equipped with skills.
• Stats & display: Automatically records wins/losses, kills, deaths, beacon breaks, and match counts—viewable via /bg top. The lobby and in-game show win-leaderboard, KDR-leaderboard, beacon-break leaderboard, and a current match-status display sign.
• Player commands: /bg join, /bg leave, /bg arenas, /bg top, /bg settings, /bg help, /bg skill info, /hub.
• Admin commands: /bg admin, /bg start, /bg stop, /bg team, /bg res, /bg region, /bg sign, /bg skill, /bg reload, /bg lobby.
• Player-visible issues fixed: After clearing a field border, that area is no longer permanently locked so nobody can enter; after an admin resizes a field, the actual protection range applies immediately per the new size instead of the old border; if a match didn't get protection applied, it's reapplied before start with an admin warning—no more "thought it was protected but it wasn't"; PvP toggles in the attack phase are more stable, no longer occasionally stuck on or off.
• Tips: Arenas are void terrain—you must build your own footing and cover; a pure-void lobby makes you fall, so enable flight or lay some blocks. The game depends on the Dominion claim plugin, which the server owner is responsible for installing and maintaining.

---

BeaconGame 更新内容（6.0 → 7.0）

自动建图与地图管理

• 首次开服自动建图：BeaconGame 1~4、大厅和游戏世界的初始地图已随插件打包。新服务器首次启动检测到世界是新建的，会自动把地图铺设到位，服主不必手动建造或复制世界；已建好地图的服务器重启后不会被改动，玩家在地图上的改动也不会被还原。
• 分帧铺设不卡服：地图按每帧固定数量分批落地，开服过程不卡顿；控制台打印「开始铺设 / 铺设完成」及方块数。6 张地图共 24 万余个方块，压缩后仅约 150 KB，不影响启动速度。
• 管理员手动重铺：新增 /bg map 查看每个世界的内嵌地图（方块数、调色板、体积），以及 /bg map rebuild <世界名|all> 手动重新铺设。

地图与竞技场改名

• 4 张地图由原 default / map2 / map3 / map4 统一改名为 BeaconGame 1 / 2 / 3 / 4（6.2 起默认地图称 Beacongame 1）。竞技场 id、世界名、大厅 NPC、玩家菜单、排行榜、帮助等显示全部统一为 BeaconGame 1 这样的名字。
• 旧配置自动迁移：插件启动会自动把旧配置里指向旧世界名的出生点、边界、传送落点、传送 NPC、展示牌等改指到新世界名，无需手动改配置；异常时会对 arenas.yml / config.yml 自动备份（最多 5 份）可回滚。
• 旧世界文件夹请手动删除：旧世界（beacongame_default、beacongame_2…）不会被自动删，启动后会按新名新建空虚空世界；请关服后手动删掉旧空文件夹。领地仍按 beacongame_<地图名> 命名（如 beacongame_BeaconGame 1），旧 beacongame_default 等领地成为孤儿，不影响新对局。

地图设置与游戏规则

• 进攻方信标指南针开关：在 /bg → 地图设置 → 参数区新增一项「进攻方信标指南针」，点击在开启/关闭间切换。开启后，进攻方每局获得一支「信标追踪指南针」，自动指向最近的防守方信标（用于定位并摧毁）；关闭后不再发放，已发放的会被移除。该开关写在配置文件中，对所有地图统一生效；切换即时生效——开局中打开开关会立刻给在场进攻方补发指南针，关闭则立即收回。
• 服务器游戏规则一键设置：/bg 菜单「管理」区新增「服务器游戏规则」项，列出一批布尔型原版游戏规则（如 doMobSpawning、mobGriefing、keepInventory、doDaylightCycle 等），每项可点击切换开/关。界面底部「应用到大厅与竞技场」按钮会把当前配置写入大厅与所有竞技场世界（不影响主世界/下界/末地等其它维度），并提示生效数量。规则配置存于独立的 plugins/BeaconGame/gamerules.yml，首次启动自动生成带默认值与说明的文件，可直接手改；插件启动与执行 /bg reload 时会自动按 gamerules.yml 重新应用到大厅与竞技场世界，保证配置长期生效。

菜单与开局流程

• 玩家菜单：非管理员输入 /bg 直接打开玩家菜单，可一键加入某张地图的等待队列，并提供离开队列、排行榜、帮助、游戏说明、返回大厅等受限操作（不暴露任何管理指令）。
• 开局改为纯手动：移除了"人数达标自动提示开局"的逻辑；现在只有管理员在菜单点「开始游戏」或执行 /bg start 才会开局。
• 修复阵营/队列相关 bug：原地图设置里有两个开始按钮，其中一个会绕过阵营分配直接空名单开局，现已合并为唯一正确的「开始游戏」按钮（按菜单分配的攻/防阵营组队，未分配者自动均衡补位），并在界面显示当前状态与双方人数——修复了「从菜单设阵营后全员变观战」。加入队列前先清除玩家在所有地图队列中的残留记录，可正常切换地图——修复了「进入地图提示已在等待队列中」，同时旧的错误开局路径遗留的卡死队列也被一并清除。
• 管理员菜单更清晰：地图设置界面重新分区（参数 / 出生 / 区域 / 运行），运行区突出「开始游戏」「结束游戏」「阵营分配」，并实时显示对局状态。
• 防守方不再被强制选技能：选技能路线界面现在只对进攻方开放。防守方本来就不能使用技能，之前却会在开局被要求选路线，现已修正——防守方进入对局后不会再有选技能弹窗。

鸣谢名单

• 新增命令 /bg thanks（别名 鸣谢 / credits），向玩家展示鸣谢名单，目前收录 孙书青、谭再品 两位，后续版本会随更新继续扩充；该命令已加入 /bg help 玩家指令列表，所有玩家均可用 /bg thanks 随时查看。

正式上线核心玩法

• 在服务器大厅右键传送 NPC，或输入 /bg join 加入队列，等管理员 /bg start 开局。一局分两个阶段：
  • 布置阶段：防守方有时间放置信标、挖地形搭防御；进攻方会被暂时致盲，看不到布标位置。此阶段不能乱放普通方块，只能放信标。
  • 进攻阶段：PvP 开启，进攻方拿到「信标追踪指南针」去拆信标；拆光全部信标即胜，或防守方守到时间结束即胜。
• 过程中会按进度触发事件：空投补给、增益/减益、核打击、移形换影、技能强化、终局总攻等。一局打完，场地和你的背包会自动还原，不用担心东西被改。
• 技能系统：进攻方可选三条进化路线（突袭 / 干扰 / 辅助），靠本局击杀解锁技能，背包里用「技能核心」右键释放；防守方负责守塔，不装备技能。
• 战绩与展示：自动记录你的胜/负、击杀、死亡、破标、场次，可用 /bg top 查看排行。大厅和游戏里可看到胜场榜、KDR 榜、破标榜和当前对局状态展示牌。
• 玩家命令：/bg join（加入）、/bg leave（退出）、/bg arenas（看有哪些场）、/bg top（排行榜）、/bg settings（看设置）、/bg help（帮助）、/bg skill info（技能说明）、/hub（回大厅）。
• 管理员命令：/bg admin（图形设置面板）、/bg start、/bg stop、/bg team、/bg res、/bg region、/bg sign、/bg skill、/bg reload、/bg lobby。
• 这次版本顺手修好的问题（玩家能感知到的）：清除场地边界后，那片区域不会再被永久锁死、谁都进不去；管理员改了场地大小后，实际保护范围会立刻按新范围生效，不再沿用旧边界；万一某场没正常套上保护，开局前会重新补好并提醒管理员，不会出现「以为有保护其实裸奔」；进攻阶段双方 PvP 开关更稳，不会偶尔关不掉或开不出。
• 小提示：竞技场是虚空地形，落脚和掩体需要自己搭；纯虚空大厅会下坠，记得开飞行或自己铺块地。本游戏依赖 Dominion 领地插件运行，由服主负责安装与维护。