EscapeFromCraftov 是一个运行在 Minecraft Paper 上的「搜打撤」游戏框架,游戏名是 Escape from Craftov / 逃离块科夫。
完整的玩家玩法、管理员运营、代理配置、数据库闭环和开发者扩展说明见 GAMEPLAY.md。
玩家带着装备进入独立地图,搜索物资,与怪物或其他玩家战斗,然后尝试活着撤离。找到东西还不算真正拥有;只有撤离成功,战利品才会进入你的物资仓库。死亡则可能失去本局携带的装备与物资。
当前版本的重点是:Game/Lobby 强制分服、PostgreSQL 玩家数据、多对局实例、Manual First 可视化地图编辑器,以及已经接通的 Loot、POI 侦察、局内二维携行整理、倒地救援、撤离入库和死亡损失闭环。本文不会把规划功能写成已完成。
你可以把每局理解成一次有风险的行动。
开始前,你决定带什么装备。进入地图后,可以搜房子、避开危险、攻击玩家,或者尽早离开。杀人不是唯一目标,活着把有价值的东西带回来才是核心目标。
举个例子:
你带着一把铁剑、一张弓和两瓶治疗药水进入地图。搜索废弃矿井时,你找到一本附魔书和几块回响碎片,随后听见远处传来弓弦声。你可以举盾靠近争夺,也可以绕开。背包已经很值钱时,你决定不再冒险,前往撤离点。倒计时结束并撤离成功后,这些物品才真正属于你。
完整玩法目标如下:
- 在 Lobby 准备装备并选择地图。
- Lobby 通过 Redis 找到可用 Game 实例。
- Game 从地图模板复制一个独立世界。
- 玩家从该局固定的出生点进入地图。
- 玩家搜索 Loot,使用剑、斧、弓、弩、盾牌、药水和地形应对 AI 或其他玩家。
- Sidebar 会给全局同一个 POI 侦察热点;队伍可选择前往侦察,也可继续搜索或交战。
- 玩家可用
/craftov carry整理口袋、胸挂和背包中的二维携行布局,再决定继续冒险还是撤离。 - 进入撤离区域并等待倒计时。
- 成功撤离或对局结束后返回 Lobby。
- 成功撤离后,战利品会安全送回你的物资仓库。
目前分服、匹配数据、实例世界、出生点、Loot 交互、POI 侦察、局内二维携行、倒地救援、条件撤离、原生 PvP、基础 AI 生物行为、物品结算和返回 Lobby 已接通。
物资仓库保存成功带回的长期物品,出战栏决定下一局带入的物品。进入行动后,服务器以局内内存中的二维布局管理口袋、胸挂和背包,并把它投影到 Minecraft 玩家物品栏;/craftov carry 打开 TrMenu 整理界面,手持已装备的胸挂或背包右键也会打开并突出对应区域。菜单用分区标题和边界区分口袋、胸挂、背包,选择大件后逐格显示能否放下及越界、重叠、独立口袋格等具体原因。固定的“行动安全箱 · 3 格”入口打开死亡/超时保留界面。格坐标和朝向当前只在本局内存中生效,撤离与死亡结算仍按每件物品唯一的 ItemInstance 身份处理,不按菜单图标或覆盖格结算。
管理员可以创建虚拟 Loot Point 或绑定现有方块。玩家右键后打开共享搜索箱,LootTable 只在第一次打开时生成,物品拿取和公共容器状态都属于当前实例。
战斗完全以 Minecraft 1.21.11 的原生规则为基础:剑和斧负责近战,弓和弩负责远程压制,盾牌用于格挡,护甲与附魔改变攻防,药水、金苹果和食物负责恢复或提供状态效果。击退、暴击、投射物、火焰、摔落、岩浆和其他环境伤害都属于行动中的风险。
同一 Craftov 实例中的玩家可以使用这些原生机制 PvP。EscapeFromCraftov 会取消跨实例/非行动阶段伤害,按配置处理队伍友伤,解析近战和投射物击杀归属,并在死亡结算成功后返回大厅。每名玩家每局最多进入一次倒地状态;有存活队友时会进入 30 秒流血倒计时,队友可在 3 格内潜行右键并持续 5 秒完成救援。耐久专属结算仍属规划。
管理员可以配置 AI Zone、数量范围、刷新时间与难度。行动中会生成 Minecraft 原生生物,并应用安全落点、难度缩放、装备、奖励和有界行为。
每个 AI Zone 还可以选择配置最多 32 个有序巡逻点。选中区域后使用 /craftov editor ai patrol add|list|remove <index>|clear 管理路线;新增点取管理员当前脚部方块,必须唯一、同时位于 AI Zone 与地图边界内,并满足脚下可站立、脚部和头部可通过的安全检查。缺少或清空路线的旧地图继续使用原有随机巡逻,不需要迁移。
行动创建时会把巡逻路线随地图 revision 一起冻结。同一区域的 AI 使用稳定生成序号错开初始目标,并只在真正抵达后按作者顺序循环到下一点;目标区块未加载时保持当前点并延迟重试,不会主动加载区块。普通 AI 与 Boss 事件区域复用同一套路线和每 100 ms 最多 8 次决策、4 次新寻路的全局预算。
同局、同实例世界、仍存活且可参与战斗的玩家进入 AI 96 格唤醒范围后,即使玩家位于该 AI Zone 的 leash 之外,也只会让休眠 AI 开始巡逻。真正检测和追击仍要求玩家位于 zone leash 内、距离不超过 40 格且通过视线检查;攻击边界不会因为宽唤醒范围而扩大。
地图还可以在 map.yml 中配置可选的 HIGH_VALUE_TARGET 事件。启用事件会独占其引用的 AI Zone,不再进行普通 AI 刷新;延迟结束后,系统只会在已加载区块中的安全落点生成 Boss。击杀 Boss 会解锁事件引用的现有 Loot Point,并按击杀瞬间冻结的小队 UUID 提供限时优先搜索权。
每局开始时会从冻结且已启用的 POI 中选择一个最高 Tier 热点;同 Tier 使用 gameId + map revision + POI id 稳定决胜,因此同一房间所有玩家看到同一个目标,列表顺序变化也不会改选。完成状态按队伍隔离;没有队伍的玩家按自己的 UUID 独立计算,一队完成不会替敌队完成。
运行时每 250 ms 用一个全局任务按 round-robin 最多检查 128 名玩家的真实位置,不依赖可取消的移动事件。进入判定保留完整 3D 边界:脚部直接位于 POI 内即可;只有玩家确实落地时,才额外检查脚下紧贴的一块支撑方块,不会向下扫描或跨楼层命中。一名队员先进入后会先提交本队完成状态,再尽力向同实例世界的合法队友发送一次中文提示。
Sidebar 在未完成时显示 侦察 <名称> · <八方向> <XZ距离>m,到达中心显示“已到达”,超远距离封顶为 9999m+;完成后显示 侦察完成 · <名称>。当前侦察是共享行动目标和可观测性机制,不发奖励、不写数据库,也不作为 Loot、撤离或其他门禁条件;没有启用 POI 的旧地图保持完全无操作。
玩家进入地图配置中的 Cuboid 撤离区域后开始撤离,离开区域会取消。
NORMAL:直接撤离。TIMED:行动开始达到指定秒数后开放。PAID:支付金币后撤离,同一局只扣一次;扣费失败时不会吞掉物资。ITEM_REQUIRED:背包中需要带有指定escapefromcraftov:item_idPDC 的物品。
每局创建时会捕获地图 revision、出生点和撤离区域。管理员之后保存地图不会热改正在运行的对局,只影响下一局。
撤离倒计时结束后,玩家会进入“物资正在安全送回”状态。此时系统已经锁定本局实际携带物的快照,并暂时阻止移动、物品操作、拾取、丢弃、交互和伤害;玩家不能离开区域后重复发起撤离,也不会因为结算中的短暂断线被同时按阵亡处理。仓库暂时不可用时会每 5 秒自动重试;只有长期仓库确认完成后,才显示“撤离成功”并返回大厅。
| 功能 | 状态 | 说明 |
|---|---|---|
| Game / Lobby 强制分服 | 完成 | 两个 Jar 同服时拒绝启动 |
| PostgreSQL 档案、等级、余额 | 完成 | Hibernate ORM + HikariCP |
| PostgreSQL 设置与装扮 | 完成 | Lobby 等待数据就绪后开放菜单 |
| Redis 匹配与实例目录 | 完成 | 只保存带 TTL 的瞬态数据 |
| 多对局独立世界 | 完成 | 每局复制世界,结束后卸载并删除 |
| Manual First 地图制作 | 完成 | 导入现有世界后,由管理员在游戏内精确设置点位和区域 |
| 地图自动验证 | 完成 | 自动检查 Bounds、Spawn、Loot、AI、Extraction、POI 与引用关系 |
| 游戏内地图编辑器 | 完成 | 双点选区、个人粒子、HUD、点击选择、属性菜单、批量编辑、撤销/重做 |
| 地图验证与启用门禁 | 完成 | ERROR 阻止启用,WARNING 只提醒 |
| 地图 revision 与回滚 | 完成 | 原子保存,默认保留 3 个旧版本 |
| 对局地图快照 | 完成 | 运行中对局不会被热编辑改变 |
| WorldEdit / LuckPerms | 硬依赖 | 地图选区和权限事实源,缺失时拒绝加载 Game |
| DecentHolograms / PlaceholderAPI | 硬依赖 | 编辑器标签和对外占位符,缺失或适配器异常时拒绝加载 Game |
| TrMenu 社区版 3.12.5 | 硬依赖 | Lobby/Game 全部 Inventory GUI;动态物品由 EscapeFromCraftov 数据源注入 |
| 虚拟 Loot 搜索与撤离结算 | 完成 | 共享一次性 Loot GUI,成功撤离后入仓 |
| 局内二维携行与整理 | 完成 | 口袋/胸挂/背包分区、占格、隔舱、锁定格、原子移动和受限旋转;/craftov carry 打开 |
| AI 战斗 | 完成(基础) | AI Zone 原生生物、安全生成、难度缩放、装备、奖励与有界行为 |
| POI 团队侦察 | 完成 | 每局稳定选择最高 Tier 热点;同队共享、敌队隔离,Sidebar 显示八方向、距离与完成状态 |
| 高价值目标地图事件 | 完成 | 编辑器/YAML 配置、延迟 Boss、事件专属 AI Zone、缓存解锁、小队优先权及 EVENT_COMPLETED 撤离 |
| Minecraft PvP 结算与队伍规则 | 完成 | 原生伤害边界、友伤配置、击杀归属和死亡结算 |
| 动态 Sidebar / BossBar / Action Bar | 完成 | 编辑器和行动中使用个人稳定 HUD;行动 Sidebar 最多 15 行并包含 POI 侦察 |
| 剑/斧/弓/弩/盾牌物品分类 | 完成 | 默认领域物品与 LootTable 已使用 Minecraft 语义 |
| 物资仓库与出战栏 | 完成 | TrMenu 54 格分页界面 + Hibernate 事务 |
| 安全箱、军需处、交易行、倒地救援 | 完成 | 3 格内建安全箱、PostgreSQL 军需买卖与玩家挂单交易、每局一次倒地和队友持续救援 |
Game 和 Lobby 是互斥角色,不能把两个 Jar 放进同一个 Paper 服务端。
Velocity / BungeeCord
|
+-- Lobby Paper
| +-- EscapeFromCraftovLobby.jar
|
+-- Game Paper #1
| +-- EscapeFromCraftovGame.jar
|
+-- Game Paper #2 (可选)
+-- EscapeFromCraftovGame.jar
Lobby + Game -------- PostgreSQL
长期玩家数据 档案/等级/余额/设置/装扮
Lobby <-------------> Redis <-------------> Game
匹配分配/实例快照/扩容消息,全部带 TTL
一个 Game Paper 可以同时承载多局 Craftov,每局使用独立世界副本。房间之间会隔离实体、Tab、普通聊天、私聊目标、加入/退出提示、死亡提示和击杀提示。Lobby 只负责大厅、菜单和匹配,不承载 Craftov;Game 不提供内置 Lobby 回退。
- Java 25,
java -version必须显示 25。 - Paper 1.21.11。
- PostgreSQL,Lobby 与 Game 连接同一个数据库和 schema。
- Redis,Lobby 与 Game 连接同一个 Redis database。
- Velocity 或 BungeeCord,负责跨服传送。
- 第一次启动可访问 Maven Central。
HikariCP、PostgreSQL JDBC、Hibernate、Jedis 和 Gson 由 Paper PluginLoader 下载到服务器 libraries/ 缓存。它们不会打进 EscapeFromCraftov Jar;坐标不变时 Paper 会复用缓存。
以下版本来自 2026-08-09 的官方 Maven 元数据或项目正式发布,并已通过 Gradle compileClasspath 解析。尚未在本仓库内启动完整 Paper 集成服做交互测试。
| 插件 | 安装位置 | 用途 | 编译验证版本 | 缺失时行为 |
|---|---|---|---|---|
| LuckPerms | Game | 管理员权限 | API 5.5 | Game 拒绝加载 |
| WorldEdit | Game | 读取管理员 Cuboid 选区 | 7.4.4 | Game 拒绝加载 |
| DecentHolograms | Game | 全部编辑对象的个人标签、选中详情和验证错误 | 2.10.1 | Game 拒绝加载 |
| PlaceholderAPI | Game | 对外提供地图、对局、队伍、余额、物资价值和剩余时间 | 2.12.3 | Game 拒绝加载 |
| TrMenu 社区版 | Lobby + Game | 主菜单、仓库、设置、外观、Loot、编辑工具栏和对象属性 | 3.12.5 | 对应服务端拒绝加载 |
EscapeFromCraftov 已针对社区版 TrMenu 3.12.5 做了适配。官方资料和源码入口:
- 文档:TrMenu v3 文档
- 社区仓库:CoderKuo/TrMenu
- 下载:TrMenu-3.12.5.jar
安装时把下载的 TrMenu-3.12.5.jar 分别放进 Lobby 和 Game 两个服务端自己的 plugins/ 目录,然后重启对应服务端。发布文件 SHA-256 为 6f8019dcb20cecda3d16e8dfb5f6aad08f2ece603350f73759976fd1926281f6。TrMenu 是独立插件,不会被下载或打包进 EscapeFromCraftov Jar。当前适配会严格检查版本必须是 3.12.5;缺失、被禁用或版本不匹配都会阻止对应 EscapeFromCraftov 插件继续运行。
EscapeFromCraftov 会在 TrMenu 已加载时,把没有同名文件的内置模板复制到 TrMenu 的 menus/ 目录:
Lobby/plugins/TrMenu/menus/escapefromcraftov_lobby_main.yml
Lobby/plugins/TrMenu/menus/escapefromcraftov_lobby_preparation.yml
Lobby/plugins/TrMenu/menus/escapefromcraftov_lobby_settings.yml
Lobby/plugins/TrMenu/menus/escapefromcraftov_lobby_cosmetics.yml
Lobby/plugins/TrMenu/menus/escapefromcraftov_lobby_warehouse.yml
Lobby/plugins/TrMenu/menus/escapefromcraftov_lobby_vendor.yml
Lobby/plugins/TrMenu/menus/escapefromcraftov_lobby_vendor_sell.yml
Lobby/plugins/TrMenu/menus/escapefromcraftov_lobby_market.yml
Lobby/plugins/TrMenu/menus/escapefromcraftov_lobby_market_mine.yml
Lobby/plugins/TrMenu/menus/escapefromcraftov_lobby_market_list.yml
Lobby/plugins/TrMenu/menus/escapefromcraftov_lobby_market_confirm.yml
Game/plugins/TrMenu/menus/escapefromcraftov_editor_toolbar.yml
Game/plugins/TrMenu/menus/escapefromcraftov_editor_object.yml
Game/plugins/TrMenu/menus/escapefromcraftov_loot.yml
Game/plugins/TrMenu/menus/escapefromcraftov_death_crate.yml
Game/plugins/TrMenu/menus/escapefromcraftov_secure.yml
Game/plugins/TrMenu/menus/escapefromcraftov_carry.yml
已有文件绝不会被覆盖,管理员可以直接修改材质、布局和文字。EscapeFromCraftov 优先调用 TrMenu 3.12.5 的公开 TrMenuAPI(兼容社区版历史上使用过的 me.arasple.mc.trmenu 与当前源码使用的 trplugins.menu 两套包名);只有公开 API 不可用时,才由控制台通过同版本的 /trmenu open 兼容路径打开菜单,普通玩家不需要 TrMenu 管理员权限。首次复制模板后会要求 TrMenu 重载;约 10 秒内仍缺少任一必需菜单时,对应 EscapeFromCraftov 插件会停用并在日志列出菜单 ID。
所有 Inventory GUI 都由 TrMenu 创建和保护,没有原生 GUI fallback。动态仓库物品、共享 Loot、二维携行格和地图对象属性通过 TrMenu 的 CustomItemSourceEvent 取得 ItemStack;其中携行格只向菜单提供当前服务端视图的克隆。点击只会调用 EscapeFromCraftov 的动作端点;动作端点会再次检查对应 TrMenu 菜单仍处于打开状态,并检查玩家数据、房间、距离、权限、编辑会话、对象和当前页,再执行 Hibernate 事务或本局状态修改。复制菜单内部动作命令、关闭菜单后重放命令,都不能绕过这些校验。这样既使用 TrMenu 的虚拟菜单能力,也不把物品所有权、局内布局和结算权限交给 YAML 脚本。
菜单关闭也由 TrMenu 会话负责:玩家断线、离开 Loot、编辑操作失效、数据尚未就绪或插件停服时,EscapeFromCraftov 会调用 TrMenu 3.12.5 的 MenuSession.close(...) 和 shut(),关闭数据包窗口、触发关闭事件、取消菜单任务并清理查看会话。没有 Bukkit 原生窗口 fallback;如果 TrMenu API 不兼容,EscapeFromCraftov 会记录明确的集成错误,而不是悄悄切换到第二套菜单生命周期。
下面这些插件都逐项评估过,但当前不加入硬依赖。硬依赖不是“装得越多越好”:只有 EscapeFromCraftov 正在消费它的公开 API、能用它替代重复实现,并且不会抢走 PostgreSQL/地图快照的事实所有权,才进入启动链。
| 插件 | 当前决定 | 评估结论 |
|---|---|---|
| ProtocolLib | 暂不作为硬依赖 | Paper 1.21.11 已覆盖事件、Sidebar、Tab 和房间隔离;只有将来需要数据包级实体裁剪或自定义点击协议时,才增加独立 ProtocolLib Adapter。 |
| Citizens | 暂不作为硬依赖 | 适合托管 Bukkit NPC,但会与 MythicMobs 的生物定义重叠;AI Zone 目前只有地图定义,尚未消费 Citizens API。 |
| MythicMobs | 暂不作为硬依赖 | 适合复杂技能和生物脚本,但属于独立内容系统,且部分发行形态受许可影响;确定 PvE 内容方案后只能在 Citizens/MythicMobs 中选择一个适配器。 |
| ItemsAdder | 暂不作为硬依赖 | 可提供资源包和自定义物品外观,但不能成为 EscapeFromCraftov 仓库和结算的事实源;强制它会让纯原版服务器无法部署。 |
| CraftEngine | 可选展示依赖,当前部署启用 | 同一资源包为胸挂、背包、安全箱提供原生 item_model,为行动 Sidebar 提供固定 PUA 图标;完整文字始终保留。它不参与 UUID、PDC、网格、数据库和结算事实。 |
| Oraxen | 暂不作为硬依赖 | 与 ItemsAdder 属于同类外观方案,不能同时硬依赖;未来若选择 Oraxen,只增加物品外观适配器,不改变 PDC + Hibernate 结算。 |
| FAWE | 暂不作为硬依赖 | FAWE 是 WorldEdit 的高性能操作实现;EscapeFromCraftov 当前只读取选区、不批量改方块,强制安装反而增加与 WorldEdit 的版本耦合。 |
| Vault | 暂不作为硬依赖 | Vault 适合统一外部经济,但 EscapeFromCraftov 的金币必须和 PostgreSQL 物资结算在同一事务内,不能让另一个经济插件成为权威余额。未来可做只读展示适配器。 |
示例仅用于开发,请更换密码:
CREATE USER escapefromcraftov WITH PASSWORD 'replace-this-password';
CREATE DATABASE escapefromcraftov OWNER escapefromcraftov;默认 database.orm.schema-action: update 由 Hibernate 管理当前实体表。生产结构稳定后建议改为 validate,并使用受控迁移。不要在生产使用 create 或 create-drop。
分别创建 Lobby 与 Game 服务端,使用 Paper 1.21.11 和 Java 25。不要共用运行目录。
Lobby/plugins/EscapeFromCraftovLobby-0.1.0-SNAPSHOT.jar
Game/plugins/EscapeFromCraftovGame-0.1.0-SNAPSHOT.jar
必须插件放进对应服务端的 plugins/。Lobby 和 Game 都要各自安装同一个 TrMenu 3.12.5 社区版 Jar;Game 还必须安装 LuckPerms、WorldEdit、DecentHolograms 和 PlaceholderAPI。任一硬依赖缺失时,Paper 会拒绝加载对应 EscapeFromCraftov 插件。
新安装只需要维护:
plugins/EscapeFromCraftovLobby/config.yml
plugins/EscapeFromCraftovLobby/messages.yml
plugins/EscapeFromCraftovGame/config.yml
plugins/EscapeFromCraftovGame/messages.yml
plugins/EscapeFromCraftovGame/imports/ # 等待导入的普通世界或完整地图包
plugins/EscapeFromCraftovGame/maps/<map-id>/map.yml
旧版独立 database.yml 与 redis.yml 会迁入 config.yml。旧 auto-setup.yml 不再读取,也不会在新安装中生成。
Lobby 与 Game 的 PostgreSQL、Redis地址和凭据必须一致。Game 还需要配置:
server.id:Redis 网络内唯一,例如game-01。server.proxy-name:代理中的名字,例如craftov-01。network.lobby-server-name:代理中的 Lobby 名字,例如lobby。
Game 会把 server.id、server.proxy-name 和房间列表发布到 Redis,Lobby 直接使用快照里的代理名称传送玩家,不再维护第二份 Game 名称清单。玩家到达 Game 后还会校验分配中的玩家 UUID、内部服务器 ID 和代理后端名;任意一项不一致都会拒绝进入并送回 Lobby。
执行 /craftov info 检查版本、模块和运行数据。
地图采用 Import First:管理员优先导入已有 Minecraft 世界,不创建空白地形。普通世界只需要 level.dat;带 map.yml 的完整包还会保留已有点位。导入会后台复制原图,原目录不会被修改。
- 把普通 Minecraft 世界或完整地图包放入 Game 服务端:
plugins/EscapeFromCraftovGame/imports/factory/level.dat
plugins/EscapeFromCraftovGame/imports/factory/region/
# 可选:plugins/EscapeFromCraftovGame/imports/factory/map.yml
- 给 Builder 分配编辑权限,然后通过代理进入
plugins/EscapeFromCraftovGame/config.yml中server.proxy-name对应的 Game backend。例如代理名为craftov-backend-01:
/lp user <玩家名> permission set craftov.editor true
/lp user <玩家名> permission set craftov.editor.map true
/server craftov-backend-01
没有匹配分配时,只有 craftov.editor 或 craftov.admin 玩家可以留在 Game;他们会进入彼此隔离的地图编辑组。普通玩家仍会被送回 Lobby。Redis 查询失败不会被误判为编辑入口。
- 使用 Tab 选择地图文件夹并导入:
/craftov map import factory
导入在后台完成。看到“已导入地图”后进入编辑器:
/craftov editor enter factory
/craftov editor menu
- 使用 WorldEdit 木斧框出整张地图的可游玩范围,然后登记 Bounds:
//wand
# 左键 Pos1,右键 Pos2
/craftov editor map bounds
- 站到合适位置创建出生点和物资点;撤离点、Loot Zone、AI Zone 和 POI 使用 WorldEdit 选区创建:
/craftov editor spawn create
/craftov editor loot create
# 框出撤离区域后
/craftov editor extraction create north_gate normal
# 可选区域
/craftov editor lootzone create warehouse craftov_tier_2
/craftov editor ai zone create warehouse_guard
# AI Zone 创建后保持选中;站到安全脚位依次添加巡逻点
/craftov editor ai patrol add
/craftov editor ai patrol list
/craftov editor poi create warehouse 2
至少放置配置要求数量的 Spawn 和 Extraction。右侧动态计分板会持续显示对象数量、完成度、评分、错误、警告、当前工具、选中对象和未保存状态。橙色是地图边界,绿色是出生点,黄色是物资,红色是 AI,青色是撤离,紫色是 POI;FAWE 当前选区会按当前编辑工具显示同色加粗边框。
- 验证、保存、启用,再创建测试房间:
/craftov editor validate
/craftov editor save
/craftov map enable factory
/craftov game create factory
validate 有 ERROR 时不能启用;WARNING 可以保存和测试,但上线前应逐项确认。正式测试时从 Lobby 输入:
/play factory
完整流程是:放地图 → 导入 → 进入编辑器 → 框选/放置 → Validate → Save → Enable → 创建房间。管理员不需要打开 YAML 或手抄坐标,但必须亲自决定点位和区域;EscapeFromCraftov 不会猜测地图设计师的意图。
第一个 factory 房间创建并发布到实例目录后,Lobby 的 /play <map> Tab 补全会自动出现 factory。lobby.enabled-maps 用于常驻展示和默认选择,不再是发现新房间的唯一来源。每个房间都会从 craftov_source_factory 再复制独立的 craftov_<房间ID> 世界,结束结算后卸载并删除该副本,导入来源与编辑源都不会被修改。
craftov_<房间ID> 是 EscapeFromCraftov 保留的临时世界命名空间;每个副本都会写入一个 EscapeFromCraftov 所有权标记,Game 服务端启动时只会卸载并清理带有该标记、且上次异常停止留下的目录。
craftov_source_<map-id> 是编辑源,明确不会被这项清理删除。仍建议不要把正式地图或其他插件的长期世界命名为 craftov_...,以免和运行实例混淆;没有所有权标记的同名前缀世界不会被自动删除。
EscapeFromCraftov 不会自动猜测哪里应该是医院、高价值区、AI 防线或撤离出口。相同建筑在不同玩法中可能承担完全不同的作用,自动生成无法理解 Builder 的路线、视野和风险设计。
正式地图配置以管理员在编辑器中保存的内容为唯一权威。EscapeFromCraftov 负责把制作过程变得直观:WorldEdit 负责选区,TrMenu 负责属性菜单,DecentHolograms 和粒子负责空间标记,动态计分板显示进度,Validator 自动发现错误,revision 负责回滚。地图原方块不会被编辑器修改。
安装 WorldEdit 时,EscapeFromCraftov 优先读取当前 WorldEdit 选区:
//wand
木斧左键设置 Pos1,右键设置 Pos2。完成后直接执行 EscapeFromCraftov 的区域命令。
WorldEdit 是 Game 的硬依赖;EscapeFromCraftov 仍保留带 PDC 标记的 /craftov editor wand 作为第二套选区输入方式,左键方块设位置 1,右键方块设位置 2。显示名称被修改也不会让它失效。
第一阶段只保存精确的轴对齐 Cuboid。WorldEdit 多边形选区会转换为包围它的 Cuboid。
编辑器每位管理员各自可见:
- 橙色:地图边界。
- 加粗同色边框:当前 FAWE 选区或当前选中对象。
- 绿色:Spawn。
- 黄色:Loot / Loot Zone。
- 红色:AI Zone。
- 蓝色:Extraction。
- 紫色:POI。
HUD 显示地图、工具、选中对象和 * UNSAVED。附近对象通过 Chunk bucket 查询,默认每 10 ticks 刷新,单帧最多 160 个,不会每 tick 扫描全图。
DecentHolograms 是 Game 的硬依赖。预览范围内的 Spawn、Loot、Loot Zone、AI Zone、Extraction 和 POI 都会显示只对当前管理员可见的简洁标签;选中对象会升级为详细标签,执行验证后带 ERROR 的对象会显示具体原因。标签按“选中对象 → 最近的错误对象 → 最近的普通对象”排序,并受 maximum-holograms-per-player 独立限制。所有悬浮文字只通过 DecentHolograms 创建,没有 TextDisplay 或 ArmorStand 后备实现;编辑器的 HUD 和粒子仍由 Paper 原生能力渲染。
选中带路线的 AI Zone 时,个人粒子会额外显示绿色起点、紫色巡逻点、白色连线和橙色方向箭头,闭环方向就是运行时顺序。整条巡逻路线每位管理员每帧共享最多 256 个粒子采样,不会把 32 个点各自扩展成无界粒子量。
- 每位管理员有独立 Draft,互不共享未保存修改。
- 同一地图被其他管理员先保存时,旧 Draft 会遇到 revision 冲突,不能静默覆盖。
- 管理员临时掉线不会立刻丢弃未保存草稿;本次服务端运行期间重连并进入同一地图会恢复草稿。存在未保存修改时仍不能切换到另一张地图。
- 最多保留 100 步 Undo/Redo;保存成功后历史会清空,以新 revision 作为新的撤销基线,旧 revision 不会被撤销操作重新带回。
exit不会丢弃未保存修改;必须先保存或明确使用exit discard。- 成功退出时会同步关闭编辑器 TrMenu、移除个人 DecentHolograms 标签与点击标记,并取消尚未确认的危险操作。
- 批量删除先进入 15 秒确认窗口,再执行
/craftov editor confirm。 - 保存使用临时文件与原子替换。
| 命令 | 作用 |
|---|---|
/play |
使用默认地图加入匹配 |
/play <map> |
指定地图加入匹配,Tab 会列出常驻地图与在线 Game 房间实际公布的地图 |
/leavequeue |
取消当前匹配排队 |
/lobby / /menu |
打开大厅主菜单 |
/lobby warehouse |
打开物资仓库与下一局出战栏 |
/lobby settings |
打开大厅个人设置 |
/lobby cosmetics |
打开外观收藏 |
/lobby setting toggle <setting> |
TrMenu 设置按钮动作;重新校验数据后保存开关,参数支持 Tab |
/lobby cosmetic equip <index> / unequip |
TrMenu 外观按钮动作;保存或卸下外观 |
/lobby warehouse page <previous|next> |
TrMenu 仓库翻页动作 |
/lobby warehouse move <0-35> |
TrMenu 仓库格子动作;事务性地在仓库与出战栏之间移动 |
| 命令 | 作用 |
|---|---|
/craftov map import <source> [target] |
后台导入普通 Minecraft 世界或带 map.yml 的完整地图包;来源和默认目标支持 Tab 补全 |
/craftov map create <map> <world> |
高级兼容入口:登记已加载世界并从零编辑 |
/craftov map list |
列出地图 |
/craftov map info <map> |
查看 revision 与对象数量 |
/craftov map preview <map> |
进入个人可视的预览与高级编辑模式 |
/craftov map enable <map> |
验证通过后启用 |
/craftov map disable <map> |
禁止创建新对局 |
| 命令 | 作用 |
|---|---|
/craftov editor |
按当前世界或默认地图进入编辑模式;再次执行会退出编辑模式 |
/craftov editor enter <map> |
进入指定地图的编辑模式 |
/craftov editor exit [discard] |
退出;discard 明确丢弃修改 |
/craftov editor status |
查看当前工具、选中项与保存状态 |
/craftov editor help |
查看简短帮助 |
/craftov editor menu |
使用 TrMenu 打开完整编辑工具栏 |
/craftov editor property open |
使用 TrMenu 打开当前选中对象的动态属性菜单 |
/craftov editor property <action> <forward|reverse> |
TrMenu 属性按钮动作;再次校验对象和权限后修改草稿 |
/craftov editor wand |
获取内置选区工具 |
/craftov editor map bounds |
当前选区设为地图边界 |
/craftov editor tool <tool> |
切换当前编辑工具,方便配合快捷栏和预览 |
| 命令 | 作用 |
|---|---|
/craftov editor spawn create [id] |
在当前位置创建出生点 |
/craftov editor spawn region create <id> |
从选区创建出生区域;运行时只使用安全落脚点,并把单次检查限制在 24 个候选内 |
/craftov editor loot create |
当前坐标创建虚拟 Loot,自动 ID 与默认表 |
/craftov editor loot create <id> <loot-table> |
指定 ID 和 LootTable |
/craftov editor loot bind |
把准星所指方块绑定为 Loot |
/craftov editor spawn team <team> |
修改出生点队伍:players/any 通用,red=队伍 1,blue=队伍 2,也可用 team3、team_3 等数字队伍 |
/craftov editor spawn weight <weight> |
修改出生点在当前队伍候选池内的随机权重 |
/craftov editor spawn enable |
启用选中的出生点 |
/craftov editor spawn disable |
停用选中的出生点 |
/craftov editor loot type <container-type> |
修改物资容器类型 |
/craftov editor loot table <loot-table> |
修改物资掉落表 |
/craftov editor loot tier <1-4> |
修改物资稀有度 |
/craftov editor loot enable |
启用选中的物资点 |
/craftov editor loot disable |
停用选中的物资点 |
/craftov editor lootzone create <id> [loot-table] |
从选区创建 Loot Zone;省略掉落表时使用当前注册的默认表 |
/craftov editor lootzone table <loot-table> |
修改物资区域的掉落表 |
/craftov editor lootzone tier <1-4> |
修改物资区域层级 |
/craftov editor lootzone density <value> |
修改物资区域密度 |
/craftov editor lootzone danger <0-1> |
修改物资区域危险度 |
/craftov editor lootzone enable |
启用选中的物资区域 |
/craftov editor lootzone disable |
停用选中的物资区域 |
/craftov editor ai zone create <id> |
从选区创建 AI Zone |
/craftov editor ai type <type> |
修改生物区域类型标签 |
/craftov editor ai minimum <count> |
修改生物区域最小数量 |
/craftov editor ai maximum <count> |
修改生物区域最大数量 |
/craftov editor ai respawn <seconds> |
修改生物区域重生间隔 |
/craftov editor ai difficulty <value> |
修改生物区域难度 |
/craftov editor ai team <team> |
修改生物区域阵营 |
/craftov editor ai patrol add |
把当前位置的安全脚部方块追加到选中 AI Zone 的巡逻路线 |
/craftov editor ai patrol list |
按运行顺序列出选中 AI Zone 的巡逻点 |
/craftov editor ai patrol remove <index> |
删除选中 AI Zone 的指定巡逻点;序号从 1 开始并支持补全 |
/craftov editor ai patrol clear |
清空选中 AI Zone 的巡逻路线并恢复随机巡逻 |
/craftov editor ai enable |
启用选中的生物区域 |
/craftov editor ai disable |
停用选中的生物区域 |
/craftov editor extraction create <id> [normal] |
创建普通撤离点 |
/craftov editor extraction create <id> item <item-id> |
创建钥匙撤离点 |
/craftov editor extraction create <id> paid <cost> |
创建付费撤离点 |
/craftov editor extraction create <id> timed <seconds> |
创建计时撤离点 |
/craftov editor extraction name <name> |
修改撤离点显示名 |
/craftov editor extraction duration <seconds> |
修改撤离点倒计时 |
/craftov editor extraction type <type> [value] |
修改撤离点类型和条件 |
/craftov editor extraction condition <value> |
修改撤离点条件值 |
/craftov editor extraction enable |
启用选中的撤离点 |
/craftov editor extraction disable |
停用选中的撤离点 |
/craftov editor poi create <id> [tier] |
从选区创建 POI,Tier 为 1 至 4 |
/craftov editor poi name <name> |
修改兴趣点名称 |
/craftov editor poi tier <1-4> |
修改兴趣点层级 |
/craftov editor poi enable |
启用选中的兴趣点 |
/craftov editor poi disable |
停用选中的兴趣点 |
| 命令 | 作用 |
|---|---|
/craftov editor select <id> |
选择地图对象,Tab 会列出当前地图所有对象 |
/craftov editor info [id] |
查看准星指向或指定对象的完整字段,并自动选择对象 |
/craftov editor tp [id] |
安全传送到准星指向或指定对象附近 |
/craftov editor move |
把选中对象移到当前位置 |
/craftov editor clone <new-id> |
在当前位置克隆选中对象 |
/craftov editor copy |
把当前选中对象放入本次编辑会话的剪贴板 |
/craftov editor paste <new-id> |
在当前位置粘贴剪贴板对象,并使用新的 ID |
/craftov editor delete [id] |
删除指定或选中对象 |
/craftov editor delete type <type> |
请求批量删除同类对象 |
/craftov editor batch enable [type] |
按当前选区批量启用对象 |
/craftov editor batch disable [type] |
按当前选区批量停用对象 |
/craftov editor batch table <loot-table> |
按当前选区统一设置 Loot 组合 |
/craftov editor batch tier <1-4> |
按当前选区统一设置 Loot/POI 等级 |
/craftov editor batch delete [type] |
按当前选区请求批量删除,需二次确认 |
/craftov editor confirm |
确认待执行的危险操作 |
/craftov editor undo / redo |
撤销或重做 |
/craftov editor show|hide <type|all> |
过滤个人可视对象 |
/craftov editor show|hide bounds |
单独显示或隐藏地图边界 |
/craftov editor radius <16..512> |
调整可视半径 |
/craftov editor nearby |
按距离列出附近对象,聊天结果可点击选择 |
/craftov editor validate |
显示评分、ERROR 和 WARNING |
/craftov editor save |
保存新 revision |
/craftov editor history |
查看当前与可回滚 revision |
/craftov editor rollback <revision> |
恢复旧版本并保存为新 revision |
| 命令 | 作用 |
|---|---|
/craftov carry |
仅在进行中的行动里打开二维携行整理菜单;左键选择物品后再点空格移动,右键只旋转服务端物品定义允许旋转的物品 |
/craftov secure |
打开本局 3 格行动安全箱;主手物品可存入,阵亡或行动超时仍保留 |
/craftov ui carry left <nonce> <0-51> |
仅供携行 TrMenu 内部调用,不要手工使用;随机会话令牌、当前菜单、本局状态和布局版本不匹配时不会执行 |
/craftov ui carry right <nonce> <0-51> |
仅供携行 TrMenu 内部调用,不要手工使用;服务端会重新定位物品并校验是否允许旋转 |
/craftov game create [map] |
创建 WAITING 对局 |
/craftov game list |
查看每个房间的地图、状态、人数与世界副本准备状态 |
/craftov game start <id> |
管理员跳过自动开局倒计时;正常房间达到最低人数会自动开始 |
/craftov game stop <id> |
停止并清理对局 |
编辑器在预览半径内会创建仅当前管理员可见的隐形交互标记:左键选择对象,潜行右键打开属性菜单。菜单中的物品不能移动、拖拽、Shift 点击或数字键换位;删除仍需 /craftov editor confirm。validate 后带对象 ID 的 ERROR 会以红色叉号和悬浮说明显示,地图改动后旧报告会自动失效。
当前验证至少检查:
- 世界是否加载,地图是否有 Bounds。
- 最低 Spawn 与 Extraction 数量。
- 至少一个普通撤离点。
- 对象是否全部在 Bounds 内。
- 对象 ID 是否重复。
- LootTable 与条件撤离物品是否存在。
PAID/TIMED条件是否为非负整数。- Spawn 之间、Spawn 到 Extraction 的距离。
- Loot 重叠与 Extraction 区域重叠。
ERROR 会阻止 /craftov map enable。启动时已启用地图若验证失败,会保存一个禁用 revision,防止实例继续创建。
craftov.admin 是总管理权限。下面权限适合用 LuckPerms 分配给不同地图岗位:
| 权限 | 作用 |
|---|---|
craftov.editor |
允许无匹配分配进入 Game 的独立编辑组,并使用编辑器通用查看功能 |
craftov.editor.map |
创建地图、修改 Bounds、启用/禁用 |
craftov.editor.spawn |
编辑 Spawn |
craftov.editor.loot |
编辑 Loot 与 Loot Zone |
craftov.editor.ai |
编辑 AI Zone |
craftov.editor.extraction |
编辑 Extraction |
craftov.editor.poi |
编辑 POI |
craftov.editor.delete |
删除与批量删除 |
craftov.editor.save |
保存新 revision |
craftov.editor.rollback |
回滚 revision |
craftov.command.info |
/craftov help、info、tutorial |
craftov.lobby.play |
Lobby 选择地图与匹配 |
LuckPerms 示例:
/lp group admin permission set craftov.admin true
/lp group builder permission set craftov.editor true
/lp group builder permission set craftov.editor.map true
/lp group builder permission set craftov.editor.spawn true
/lp group builder permission set craftov.editor.loot true
LuckPerms 是 Game 的硬依赖;权限节点由 LuckPerms 分配和审计,Bukkit OP 只作为 LuckPerms 的超级管理员语义保留。
craftov.command.info 和 craftov.lobby.play 默认允许普通玩家,管理与编辑权限默认仅 OP。LuckPerms
对某个节点给出明确的 true 或 false 时以该结果为准;没有配置该节点时回退到上述默认值,
所以新服不需要先配权限就能使用帮助、教程和匹配。
当前真实提供:
%escapefromcraftov_map%
%escapefromcraftov_game_id%
%escapefromcraftov_game_state%
%escapefromcraftov_player_state%
%escapefromcraftov_team%
%escapefromcraftov_money%
%escapefromcraftov_level%
%escapefromcraftov_experience%
%escapefromcraftov_experience_to_next_level%
%escapefromcraftov_alive_players%
%escapefromcraftov_loot_value%
%escapefromcraftov_remaining_time%
%escapefromcraftov_extracted%
其中 loot_value 是玩家当前本局携行中 EscapeFromCraftov 物资的估算总价值,
remaining_time 是行动还剩的秒数,extracted 是该玩家在当前对局是否已经成功撤离。
level 是行动等级,experience 是累计历练,experience_to_next_level 是距离下一级还需要的历练。
玩家不在行动中、行动尚未开始或 PlaceholderAPI 只能拿到离线玩家时,相关值会留空,
不会用 0 或 false 冒充真实状态。
Game 和 Lobby 的数据库、Redis、网络与玩法配置都在各自的主配置中。数据库配置不再拆成多个文件。
Game 的 server.minimum-players 控制房间达到多少人后自动开始倒计时,server.start-countdown-seconds 控制倒计时长度。倒计时期间人数低于最低值会取消;人数重新满足后会重新开始。管理员仍可使用 /craftov game start <game> 手工开局。
Game 的 map-editor 节控制正式地图制作流程:
retained-revisions:旧 revision 数量。confirmation-seconds:危险操作确认时间。default-visibility-radius:进入编辑器的默认半径。visualization.refresh-ticks:渲染间隔。visualization.maximum-objects-per-frame:单帧上限。visualization.maximum-holograms-per-player:每位管理员同时显示的个人全息标签上限;选中和错误对象优先。validation.minimum-spawns/minimum-extractions:启用地图必须具备的出生点和撤离点数量;不足会产生 ERROR,不能启用。validation.minimum-loot-zones/minimum-ai-zones/minimum-pois:建议具备的物资区、AI 区和兴趣点数量;不足只产生 WARNING,适合纯 PvP 或低 PvE 地图,不会强行阻止启用。validation.minimum-spawn-distance/minimum-spawn-extraction-distance:出生点之间、出生点与撤离点之间的最小水平距离。
保存玩家消息与菜单文字。支持 Adventure MiniMessage。修改后需要重启;当前没有危险的 /reload 支持。
保存管理员编辑结果,包括:
schema-version
map-id / display-name / world
revision / enabled / metadata
bounds
spawns
loot-points / loot-zones
ai-zones
events(可选)
extractions
pois
ai-zones[].patrol-waypoints 是可选的有序脚部坐标列表;缺失或为空时保留随机巡逻:
ai-zones:
- id: warehouse_guard
enabled: true
bounds: {min-x: 200, min-y: 50, min-z: 200, max-x: 290, max-y: 80, max-z: 290}
ai-type: scav
minimum: 2
maximum: 4
respawn-seconds: 60
difficulty: 1.0
team: scav
patrol-waypoints:
- {x: 220, y: 64, z: 220}
- {x: 280, y: 64, z: 220}
- {x: 280, y: 64, z: 280}
- {x: 220, y: 64, z: 280}每区最多 32 点,坐标必须唯一并同时落在该 AI Zone 和地图 Bounds 内。验证还会检查已加载区块中的脚部安全性;未加载区块只产生待复核提示,验证和运行时都不会为了巡逻强制加载区块。已冻结路线只在 AI 进入 PATROL 时使用;进入追击会停止旧巡逻路径,RETURN 仍先回安全出生位置,再从保存的巡逻序号继续。同区 AI 以共享区域基准和稳定生成序号分散到不同初始点,Boss 事件独占的 AI Zone 也使用同一路线。所有 AI 仍共享每 100 ms 最多 8 次决策和 4 次新寻路的预算;未加载、寻路失败或预算耗尽均不会跳过作者指定的当前点。
events 是可选根字段;没有该字段的旧地图按空事件列表加载,原有行为不变。当前支持的事件类型是 HIGH_VALUE_TARGET:
events:
- id: warehouse_boss
enabled: true
display-name: 仓库高价值目标
type: HIGH_VALUE_TARGET
ai-zone-id: warehouse_guard
cache-loot-point-id: warehouse_cache
start-delay-seconds: 15
health-multiplier: 4.0
damage-multiplier: 1.5
protection-seconds: 30id必须在事件中唯一,也不能与其他地图对象 ID 冲突。enabled控制该事件是否参与本局;display-name是玩家可见名称;type当前只能是HIGH_VALUE_TARGET。ai-zone-id必须引用一个已启用的 AI Zone;cache-loot-point-id必须引用一个已启用、已经存在的 Loot Point。新配置中,同一个 AI Zone 或 Loot Point 不能被多个启用事件复用。start-delay-seconds范围是0..3600;health-multiplier是(0, 20]内的有限值;damage-multiplier是(0, 8]内的有限值;protection-seconds范围是0..300。
启用事件引用的 AI Zone 不参与普通补怪。事件从行动开始计时,延迟结束后只在已加载区块的安全落点生成一个 Boss,不会为了生成主动加载区块。区域区块尚未加载时,每个事件只保留一个低频重试任务,每 5 秒尝试一次,最多 60 次;耗尽后事件失败,不会留下无限重试。Boss 与普通 AI 共用每区 32、每局 128 的实体上限,也共用每 100 ms 最多 8 次 AI 决策和 4 次新寻路的预算;实体上的 game、zone、event PDC 必须同时匹配当前实例才会被事件运行时接受。
事件关联的是现有搜索缓存,不会创建第二套容器。Boss 死亡采用 first-wins,只结算一次且不会普通重生;完成时冻结合法击杀者当时的小队 UUID,并在 protection-seconds 内只允许该队搜索,之后向同局玩家公开。没有合法击杀者时立即公开。交互、搜索、恢复、展示、打开、翻页、拿取和物资源提交都会重新检查事件状态;事件未完成、失败或状态缺失时缓存一律保持锁定。
撤离点可用 EVENT_COMPLETED 将指定事件设为前置条件:
extractions:
- id: warehouse_event_exit
enabled: true
display-name: 仓库事件撤离点
bounds: {min-x: 80, min-y: -60, min-z: 68, max-x: 83, max-y: -58, max-z: 71}
type: NORMAL
duration-seconds: 10
conditions:
- type: EVENT_COMPLETED
event-id: warehouse_boss
route-global: true
eligible-spawn-groups: []选中撤离点后也可执行 /craftov editor extraction rule event <事件ID>;补全和执行均只接受当前草稿内已启用的事件。条件会在撤离开始和倒计时结束时实时复核同一局状态,只有 COMPLETED 放行;缺失、失败、未完成、已清理或跨局状态全部拒绝。该条件先于名额和付费授权执行,失效时不会先扣款。Sidebar 保留本队普通出口并追加事件锁定提示。带事件条件的出口不是路线保底,地图仍需为每个出生组配置无条件 NORMAL 出口。
事件不具备坐标或选区,因此不会伪装成普通 MapObject。进入地图编辑器后,可从 TrMenu 工具栏点击“高价值目标事件”,或使用 /craftov editor event list 查看事件及可点击的常用修改入口。完整命令包括:
event create <id> <ai-zone-id> <loot-point-id>:以安全默认倍率创建并启用事件。event name|delay|health|damage|protection <event-id> <value>:修改显示名和数值。event refs <event-id> <ai-zone-id> <loot-point-id>:重新绑定已启用、未被占用的 AI Zone 与 Loot Point。event enable|disable <event-id>:启停事件。event delete <event-id>:创建限时删除确认,随后执行/craftov editor confirm。
命令补全和执行都会重新读取当前草稿并验证引用;事件与普通对象共享 ID 命名空间。仍被事件使用的 AI Zone/Loot Point 不能被停用或删除,仍被任意 EVENT_COMPLETED 规则引用的事件也不能停用或删除,必须先显式解除引用。所有修改只进入个人草稿,支持现有 undo/redo,并在 /craftov editor save 验证成功后生成新 revision。旧版本仍保存在 maps/<map-id>/revisions/;YAML 可以用于审计和高级维护,但不再是事件配置的唯一入口。
EscapeFromCraftov 明确使用 Hibernate ORM + HikariCP + PostgreSQL,不使用 Spring Boot,也不使用 JPA 容器。
Hibernate 负责实体映射、事务 Session 和批处理;HikariCP 负责连接池。当前持久化包含档案、等级、余额、玩家设置、装扮、物资仓库、出战栏、行动物品与幂等结算。金币变动写入 craftov_economy_transactions,历练奖励写入 craftov_progression_transactions;两者都以 transaction ID 防止网络重试造成重复发放或重复扣除。Redis 只保存匹配、实例目录与临时分配,不替代 PostgreSQL。完整表结构与命名规则见 DATABASE.md。
database.table-prefix 可在自动建表时为所有表名与索引名统一添加前缀(默认空即不加),便于多套部署共用同一个库或 schema。前缀须以小写字母开头,仅含小写字母、数字、下划线,最长 20 字符;Lobby 与 Game 必须配置一致,已投产后修改前缀等于换一套全新表。
常用 HikariCP 配置均有注释:最大/最小连接、获取与校验超时、空闲回收、生命周期、Keepalive、泄漏检测、启动失败策略、事务隔离、初始化 SQL、内部查询隔离和 JMX。
常用 Hibernate 配置:
schema-action:开发可用update,生产建议validate。statement-batch-size:JDBC 写入批次。default-batch-fetch-size:关联批量读取。show-sql/format-sql:临时排障。generate-statistics:性能诊断,平时关闭。
不一定。游戏内编辑器是主要入口,YAML 用于存储、审计和备份。HIGH_VALUE_TARGET 事件可从 TrMenu 工具栏进入列表,并通过 /craftov editor event ... 完成创建、调参、重配引用、启停和删除。
需要。Game 的硬依赖是 LuckPerms、WorldEdit、DecentHolograms、PlaceholderAPI 和 TrMenu 3.12.5;Lobby 需要 TrMenu 3.12.5。缺少其中任何一个,Paper 会拒绝加载对应 EscapeFromCraftov 插件。/craftov editor wand 只是 WorldEdit 已安装后的第二套选区操作,不是替代依赖。
可以,各自有独立 Draft。但同一地图只有先保存的人成功;后保存的旧 revision 会被拒绝,必须重新进入后再合并修改。
执行 /craftov editor validate。ERROR 必须修复,WARNING 不阻止启用。
可以,上限由 game.max-instances 控制。每局捕获独立地图快照与世界副本。
不可以。Game 和 Lobby 都把 PostgreSQL 视为强依赖,连接失败会拒绝启动,避免运行中才丢数据。
插件保持启动并等待恢复,但匹配、跨服分配和实例目录不可用。长期玩家数据仍在 PostgreSQL。
确认 Java 25、Paper 1.21.11,并确认 Game 与 Lobby Jar 没有放在同一个服务端。查看日志中的具体启动阶段。
检查 database.host、端口、库名、账号、密码、schema 与 ssl-mode。远程 PostgreSQL 同时需要防火墙和 pg_hba.conf 放行。
确认两个位置都在当前地图世界,选区完整,并检查启动日志是否显示 Integration WorldEdit: FOUND。仍失败时使用 /craftov editor wand 重新设置两个点;如果 Game 启动日志显示依赖错误,先修复 WorldEdit 安装或版本,不要绕过硬依赖。
确认已 /craftov editor enter <map>、人在正确世界、对象类型没有被 hide,且 radius 足够大。再检查 Integration DecentHolograms: FOUND;依赖未正确加载时 Game 不会进入可编辑状态。
另一名管理员已经保存。不要覆盖磁盘文件;先 /craftov editor exit discard,重新进入最新 revision,再重做需要保留的修改。
确认地图源世界目录或 game.map-template-dir/<map-id>/ 存在。生产环境保持 allow-flat-fallback: false。
不要手工切换到 Lobby,也不要重启 Game。系统会使用倒计时结束时锁定的物资快照自动重试,不会重复入库。管理员应检查 PostgreSQL、Hikari 连接池和 Game 日志;恢复连接后,成功回调会自动完成撤离。若日志报告“既有死亡结算冲突”,数据库中的既有终态优先,系统不会再重复写入物资。
玩家会暂时保持无敌、背包为空且不能移动或拾取,避免在装备状态不明确时进入战斗。不要手工跨服或反复重连,系统会自动重试。若某件装备无法转换成 Minecraft 物品,原有出战装备会先安全退回物资仓库,完成后才取消本局并返回 Lobby。管理员应检查 Game 日志、数据库连接和物品定义;装备尚未确认退回时,插件不会提前放行玩家。
./gradlew clean build
./gradlew test构建产物:
game/build/libs/EscapeFromCraftovGame-<version>.jar
lobby/build/libs/EscapeFromCraftovLobby-<version>.jar
第三方运行库由 Paper 下载,五个硬依赖插件由服务器管理员单独安装;它们都不应出现在 EscapeFromCraftov Jar 内。
Paper
|
+-- game Game 插件、编辑器、实例世界、集成 Adapter
+-- lobby Lobby 插件、菜单与匹配
+-- core Hibernate、Redis、领域实现与统一地图 Domain
+-- api 公共服务、事件与值对象
地图代码分层:
core/map
ManualCraftovMap / MapObject
ManualMapEditor / EditorSession
MapObjectIndex / ManualMapValidator
CraftovMapSnapshot
game/plugin/editor
ManualMapStore / ManualMapRegistry / ManualMapService
EditorSelection / Visualization / Wand / Confirmation
ManualCraftovMapProvider
game/plugin/integration
WorldEdit / LuckPerms / DecentHolograms / PlaceholderAPI required adapters
core/bukkit
TrMenuBridge(公开 API、动态物品源、模板加载门禁,不打包依赖)
game/plugin/editor + game/plugin/loot
TrMenu 动作控制器(会话/权限/房间/距离校验)
lobby/menu
TrMenu 大厅控制器(Hibernate 仓库、设置和外观数据源)
Domain 不 import Bukkit 或第三方插件。Paper 世界访问、PDC、粒子和第三方 API 只在 Game Adapter 层。运行中对局消费的是创建时捕获的 API 快照,不读取当前可变地图注册表。
新增地图对象时必须同时处理:领域校验、不可变编辑操作、YAML 往返、Chunk 索引、可视化、命令、revision 测试和运行时编译。不要把逻辑塞进一个 God Class。
- 当前编辑器同时支持命令、TrMenu 虚拟工具栏、附近点击选择和动态属性菜单;选区批量启用/停用、物资组合、等级与删除均有命令入口。
- 只正式支持 Cuboid;WorldEdit Polygon 会变成包围盒。
- DecentHolograms 会标出预览半径内的地图对象,但默认每位管理员最多同时显示 32 个;选中和错误对象优先,避免 200+ Loot 地图产生无上限实体压力。
- 地图必须由管理员人工放置点位和划分区域;当前不提供自动扫描或自动生成正式地图配置。
- AI Zone 已生成原生 AI 实体并提供有界行为和可选的 32 点作者巡逻路线;
HIGH_VALUE_TARGETBoss 事件和EVENT_COMPLETED撤离条件均已接入游戏内编辑草稿、撤销/重做与 revision 保存流程。 - POI 已有本局运行时:每局稳定选出一个最高 Tier 团队侦察热点,以 250 ms/128 人 round-robin 扫描完成状态并投影到 Sidebar。它当前只提供行动目标与队伍可观测性,不发奖励、不落库,也不参与撤离或 Loot 门禁。
- Loot Point 已提供右键搜索与共享容器 UI。
- 仓库、出战栏、军需处、交易行、内建安全箱、倒地救援、局内二维携行整理、装备/物资损失和撤离结算已经闭环。二维位置当前是单局内存权威,跨局结算仍以唯一
ItemInstance为单位。 - 未在本仓库内运行五个硬依赖插件的完整 Paper 交互服,只验证了公开 API 编译与依赖解析;正式部署仍应检查每个插件的实际版本和启动日志。
下一阶段最值得优先完成:在现有作者巡逻路线和无奖励 POI 侦察目标之上,增加更多可控 AI 战术、可实际验收的动态事件与任务反馈;如果未来需要跨局保留仓库排列,再独立设计坐标持久化和迁移。这些都不会改变结算以唯一 ItemInstance 为事实单位的边界。