MC Project working titleMC 项目 名称未定

01Overview概览

The MC Project (working title) is a first-person action MMORPG built on a Minecraft server: full-loot PvP zones, a player-driven economy and gear-defined classes in the tradition of Albion Online, with the dungeons, raid bosses and class roles of World of Warcraft. Two things separate it from a typical Minecraft server. Combat is per-bone: every hit is resolved against the target's skeleton, so where you hit matters. And the whole game is written down before it is built — 56 linked design pages that art, numbers and code all read from.

MC 项目（名称未定）是一款在 Minecraft 服务器上运行的第一人称动作 MMORPG：阿尔比恩式的全装备掉落 PVP 分区、玩家驱动的经济与「装备即职业」，加上魔兽世界式的副本、Boss 与职责分工。它和一般 Minecraft 服务器的区别有两点：战斗按骨骼判定，每一击都对着目标骨架结算，打在哪里是有区别的；整个游戏先写清楚再做，56 页互相引用的策划站是美术、数值和代码共同的依据。

Design pillars设计支柱

• Gear is your class — no character level. Weapons give Q / E / R, the off-hand gives F, armour pieces give T / Y / G; mastery lines level by use.装备即职业：没有角色等级。武器给 Q / E / R，副手给 F，防具给 T / Y / G；专精线靠使用升级。
• Where you hit matters — per-bone hit boxes with part multipliers and effect gauges: stun a head, disarm an arm, break a shield.打在哪里有区别：逐骨骼碰撞箱、部位倍率和积累条：打头眩晕、打臂卸力、打盾破盾。
• Risk is a map — four zone tiers (safe / contested / plunder / lawless) decide what you lose on death and what the land produces.风险画在地图上：四档分区（安全 / 纷争 / 掠夺 / 无法）决定死亡掉什么、土地产什么。
• Players make the economy — almost every item is player-crafted; regional markets do not connect; taxes are the gold sink.经济由玩家制造：几乎所有物品由玩家制造；地区集市互不连通；税费是金币回收口。
• Dungeons teach, bosses test — every wild-zone monster teaches one mechanic; each dungeon boss is the exam for that chapter.副本教学，Boss 验收：野外每种怪教一个机制，每本 Boss 就是该章的考卷。

Reference: Albion Online参考：阿尔比恩 Online

Albion Online is the structural reference — zone tiers, full loot, the regional order-book market, gear-based progression and open-world random dungeons. The pages below note where the design follows it and where it deliberately departs (first-person combat, body-part hits, WoW-style scripted dungeons).

《阿尔比恩 Online》是结构参考：分区、全掉落、地区挂单集市、装备成长和野外随机地牢。下面各页会标出哪些地方沿用它，哪些地方刻意不同（第一人称战斗、部位打击、魔兽式脚本副本）。

Albion Online screenshots © Sandbox Interactive GmbH, from the Steam store page; shown as design reference only.阿尔比恩截图 © Sandbox Interactive GmbH，来自 Steam 商店页，仅作设计参考。

What is playable today现在能玩到什么

02World世界

The world is one 10,000 × 10,000 pre-built terrain, Barggon, ringed by ocean so the sea is the border. Regions follow the terrain — mountains, rivers and coasts draw the zone lines — and each zone carries a safety tier and a tier range for monsters and resources.

世界是一张 10000 × 10000 的成品地形 Barggon，四面环海，海就是世界边界。分区顺着地形划：山脉、河流、海岸就是分区线，每个区带一个安全等级和一段怪物 / 资源 T 阶。

Version ladder版本抬梯

Launch opens the safe zone, the three contested zones and the Frozen Isle, capped at T5; the isle is the only source of T5 materials, so the highest risk holds the highest reward. Each later chapter opens a new top zone one tier higher and hands the old top tier down. Zone rules never change — only what the land produces moves.

开服开放安全区、三个纷争区和永冻雪岛，上限 T5；雪岛是 T5 材料的唯一产地，最高风险对应最高产出。之后每一章开一个高一阶的新顶端区，把旧顶端 T 阶下放。分区规则永不改，只有产出表在动。

Travel传送网

• Free teleports inside the safe zone; cross-zone travel costs gold (a gold sink). Paid random teleport drops you at a safe wild point of a chosen contested zone.安全区内免费传送；跨区收路费（金币回收口）。付费随机传送落到所选纷争区的安全野外点。
• No teleport points in plunder or lawless zones: you walk or ride in, so interception stays possible.掠夺区和无法区没有传送点，只能步行或骑行进入，保留拦截的可能。
• New players below T2 travel free; a 60-minute "return to city" button works only outside combat and outside red/black zones.T2 以下新手全部免费；60 分钟冷却的「回主城」只在非战斗、非红黑区可用。

03Combat战斗

Seven skill keys, all granted by equipment. The main hand fills Q / E / R, the off-hand fills F, and hat, chest and boots fill T / Y / G; each slot offers several candidate skills and you activate one — the Albion item-spell model, moved into a first-person action game. Left click is the basic attack, right click uses the off-hand. A full set carries up to 7 active and 5 passive skills.

七个技能键，全部由装备提供。主手给 Q / E / R，副手给 F，帽子、胸甲、鞋子给 T / Y / G；每个占位有多个候选技能，选一个激活——阿尔比恩的物品技能模型，搬进第一人称动作游戏。左键普攻，右键用副手。满装最多 7 个主动 + 5 个被动。

Hit the part, not the box打部位，不打盒子

Vanilla Minecraft gives every entity one bounding box. Here each entity has per-part hit boxes bound to its pose; melee swings sweep a capsule from hand to blade tip along the weapon's keyframed arc, and the first part it touches is the part you hit. Each part carries a damage multiplier and an effect gauge: hits fill the gauge, the gauge triggers the effect, then the part is immune for a window and its threshold grows, so a long fight settles at roughly one trigger per eight hits.

原版 Minecraft 每个实体只有一个碰撞盒。这里每个实体有绑定姿势的部位碰撞箱；近战挥砍时，从手到刀尖的胶囊体沿武器关键帧轨迹扫掠，碰到的第一个部位就是命中部位。每个部位有伤害倍率和效果积累条：命中累积，积满触发效果，然后进入免疫窗并抬高阈值，长战斗大约每 8 击触发一次。

Damage pipeline伤害结算管线

Ten damage types form a closed list — physical against armour, everything else against one resist stat. There is no true damage: a weakness is a negative resistance. Each type owns a colour and a shape so effects stay readable next to Minecraft terrain.

伤害类型是十种的闭口枚举：物理吃护甲，其余全部吃魔抗。没有真实伤害，弱点用负减免表达。每种类型有自己的颜色和形状，特效在 Minecraft 地形旁也能一眼分辨。

How it is implemented: TeaEngine实现：TeaEngine

TeaEngine is the team's own engine mod for the game — Fabric 1.21.1, Java 21 — and it owns combat end to end. Hit boxes are written into the model itself: a Blockbench group named _box:head is the head's collision box, so the artist who builds the model also defines what can be hit. The client sweeps those boxes frame by frame against the pose the player actually sees and reports which part it touched; the server checks the claim against a rest-pose envelope, the animation's contact window and range, and only then applies damage. The rule written into the design: the client measures, the server rules — and anti-cheat never costs game feel.

TeaEngine 是团队自研的游戏引擎模组（Fabric 1.21.1，Java 21），战斗从头到尾由它负责。碰撞盒直接写在模型里：Blockbench 里名为 _box:head 的组就是头部碰撞盒，做模型的美术同时定义了什么能被打到。客户端对玩家真正看到的姿势逐帧扫掠这些盒子，上报打到了哪个部位；服务端用静止位姿包络、动画的判定窗口和射程复核，通过才结算伤害。写进设计里的规则是：客户端量，服务端裁——反作弊不为它牺牲手感。

• Three layers, one authority — the Fabric server is the only game-logic authority and settles everything in memory within the tick; the client has zero authority; the Spring Boot backend owns persistent truth and cross-instance coordination and is never on a combat or movement call path.三层，一个权威：Fabric 服务端是唯一的游戏逻辑权威，tick 内内存结算；客户端零权威；Spring Boot 后端只管持久真相和跨实例协调，绝不出现在战斗或移动的调用链上。
• Skills are chains of atoms — a skill is a list of atoms with only two triggers, OnStart and OnSignal(name); wind-up and recovery are explicit Wait atoms, so new timings need no engine change. 18 atom types; the schema is validated at load and any error rejects the whole file rather than shipping a half-working skill.技能是原子链：一条技能就是一串原子，触发只有 OnStart 和 OnSignal(名字)，前后摇是显式的 Wait，加新时机不用改引擎。18 种原子；schema 在加载期校验，任一条不过整份不上，不让半套技能上线。
• Models straight from Blockbench — .bbmodel is converted to Bedrock geometry and animation and fed to a loader that has been validated in-game; one merged model is split into first- and third-person variants at pack time by tag, so artists maintain a single file.模型直接来自 Blockbench：.bbmodel 转成 Bedrock 几何和动画，喂给已实机验证的加载器；一份合并源模型在打包时按标签拆成第一 / 第三人称两份，美术只维护一个文件。
• Rig pose and root frame kept apart — the same clip is placed twice, once in camera space to draw and once at (eye position, facing) to judge; what you see is what is judged, with no separate reach knob.绑定位姿与 root 帧分离：同一份 clip 摆两次，一次在相机空间画，一次在（眼睛位置，朝向）判；看到的就是判定的，不留额外的 reach 旋钮。
• Debug is a first-class feature — a hit-box overlay shows the boxes appearing and vanishing mid-swing, the fastest way to check a contact window; per-part readouts print on hit.调试是正式功能：判定盒叠加层能看到盒子在挥击中途出现又消失，是确认判定窗口最快的办法；命中时打印部位读数。

client  swing
   ├─ play clip (first- or third-person variant of the same model)
   ├─ each frame inside the contact window: sweep the weapon box against every _box:* group in reach
   └─ hit → report { entity, part, tick, clip, frame }

server  verify
   ├─ cooldown · one settlement per target per swing
   ├─ range and angle against the rest-pose envelope of that entity
   ├─ claim inside this clip's contact window?
   └─ pass → damage pipeline (part multiplier → armour → type → status → crit)

04Classes & Growth职业与成长

Classes are mastery lines named after what the weapon does, not a choice made at character creation. Seven lines are specified, four ship first. Each line is tuned on seven dimensions where 100% is baseline; the numbers are coefficients, so every later value — skill multipliers, ranges, cooldowns, control durations — derives from base × coefficient.

职业是按武器命名的专精线，不是建号时的选择。定了 7 条线，首批 4 条。每条线在 7 个维度上定档，100% 为基准；数字就是系数，之后所有数值（倍率、射程、冷却、控制时长）都按「基准 × 系数」推导。

Armour is free of the weapon line: cloth, leather and plate each come in three named sets tuned defend / neutral / attack, and mixing across materials is allowed. Recommended pairings are only the baseline the numbers were checked against.

防具不绑定武器线：布甲、皮甲、重甲各有三套命名套系，按守 / 中 / 攻定档，跨材质混穿也允许。推荐搭配只是数值验算的基准。

No character level: three growth axes没有角色等级：成长三轴

Talents are three-way choices per rank and are meant to change how a skill behaves, not add flat numbers; a single flat option is allowed only at Grandmaster and capped at 3%. They do not count toward item power, so gates and matchmaking never see them.

天赋每个称位三选一，以改变技能行为为主而不是加裸数值；裸数值选项只允许在宗师档出现一条，幅度 ≤3%。天赋不计入物品强度，门槛和匹配看不到它。

In game (test server, Sep 2026)游戏内（测试服，2026.09）

The item window follows the design page: quality, item power, slot, weight and mastery level up top; then one row per skill slot with the candidates, the active one gold-framed and the ones above the weapon's tier locked; then the affixes written on the template. The HUD shows life, mana and stamina, the hotbar with LMB / RMB / Q E R / T Y F G slots, and a live-scanned minimap.

物品窗按策划页做：顶部是品质、物品强度、槽位、重量和穿戴等级；然后每个技能占位一行候选，激活的金框，超过武器 T 阶的上锁；下面是写死在模板上的词条。HUD 有生命、法力、体力三条，带 LMB / RMB / Q E R / T Y F G 槽位的快捷栏，和实时扫描的小地图。

05Economy & PvP经济与 PVP

Four zone tiers, one death rule each四档分区，各一条死亡规则

• Hostile flag — a 3-second cast toggles it; flagged players are red-named server-wide. Anyone attacked may hit back for 60 seconds without flagging. Healing a red name makes you red.敌对标记：3 秒施法切换；开启后全服红名。被攻击者 60 秒内可直接还手不变红。给红名加血自己也变红。
• Reputation runs 0 to −1000 in five ranks; hitting someone two bands weaker triples the loss; kills of the innocent in plunder zones cost −100. Any rank can be worked back with kills, quests, gathering and crafting, capped at +100 a day — never with gold.声望 0 到 −1000 分五档；打低自己两段以上的人扣分 ×3；掠夺区杀无辜 −100。任何档都能靠杀怪、任务、采集、制造洗白，每日上限 +100，不能用金币买。
• Knock-down protection — for 10 minutes after being downed, that player and their party cannot hurt you unless you attack first; "return to spawn" is available while downed, so corpse-camping does not pay.击倒保护：被击倒后 10 分钟内，该玩家及其队伍打不到你，除非你先动手；倒地时随时可「返回复活点」，守尸没有收益。
• Duels anywhere including cities: 1v1, knock-down wins, no loot, no durability, no reputation change.决斗任何地区包括城市：1v1，击倒即胜，无掉落、无耐久损失、无声望变化。

Market集市

An order book in every region, and regions do not connect: to buy a region's goods you stand in that region. Equipment is a real SKU — same item id and quality means the same stats — so gear aggregates, trades and charts like any stackable. Fees are the gold sink.

每个地区一个挂单集市，地区之间不连通：要买哪个地区的货，人就得在那个地区。装备是真正的 SKU，同 ID 同品质属性完全一致，所以装备可以像堆叠物一样聚合挂单、求购、看走势图。手续费是金币回收口。

Two keys to graduate毕业双钥匙

The T5 graduation set needs the D4 final boss's blueprint (do you know how to make it) and the Frozen Isle's exclusive material (do you have the stuff). The PvE dungeon road and the plunder-zone road need each other at the finish line; neither can be skipped.

T5 毕业装需要 D4 尾王的图纸（会不会造）和永冻雪岛的独占材料（有没有料）。PVE 副本线和掠夺区线在毕业点互相需要，谁也跳不过谁。

Guild hideouts公会驻地

• Plots exist only in plunder and lawless zones and are finite; a guild of level 4 may claim one and build on it with vanilla blocks.地块只在掠夺区和无法区，总量有限；公会 4 级可申请，用原版方块自由建造。
• 24-hour construction window when anyone can destroy it; afterwards invulnerable except during a self-chosen daily one-hour window, where attackers can break one of three stages per day. Unpaid upkeep drops the shield entirely.放置后 24 小时施工期任何人可拆；建成后常态无敌，只在自选的每日 1 小时脆弱窗口可被攻击，每天最多破 1 个阶段，共 3 阶段。欠维护费护盾全天失效。
• Destroyed hideouts return stored items by system mail; storage is never looted.驻地被毁后仓库物品走系统邮件寄回，不可被掠夺。

06Dungeon System副本体系

Dungeons follow the WoW pattern — waves, a mid-boss as the loudest beat, a final boss as the exam — inside an Albion-style economy where the 5-player dungeons carry blueprints and daily locks, and the random rifts carry unlocked farming.

副本走魔兽的结构：多波小怪、中途头目作为最响的一拍、终 Boss 作为验收；再放进阿尔比恩式经济里：5 人本带图纸和每日进度锁，随机裂隙负责无锁复刷。

Loot is per person and never rolled; more players means more yield, not a split. Entering over-geared cuts drops — one band over the gate halves them, two bands leaves only gold and mastery — so the current top dungeon stays the place to be.

掉落每人一份、不掷骰；人多产出更高而不是摊薄。超门槛递减：高 1 段掉落减半，高 2 段只给金币和专精经验，当前最高的本始终是该去的地方。

Roster总量盘子

Boss mechanic dictionaryBoss 机制词典

Every boss is assembled from a shared vocabulary plus one signature combination that no other boss repeats. Opposing constraints are stacked to force decisions: iron + share means you must group when you want to spread; ring + spread means the opposite.

每个 Boss 都从同一套词典取件，再加一个别的 Boss 不重复的招牌组合。用反向约束制造抉择：钢铁 + 分摊，想散必须聚；月环 + 分散，想聚必须散。

Test dimensions per chapter逐本考验维度

Active skills beyond the basic attack climb one per dungeon — 2, 3, 4, 5, then 6+ for raids — and every new skill is pulled from an unused dictionary entry, so no two chapters teach the same thing.

普攻之外的主动技逐本加一：2、3、4、5，团队本 6+；每个新技能都从词典里未用过的件取，两章不会教同一件事。

BossesBoss 立绘

Boss concept art produced for the project in the blocky style of the game; turnarounds feed the Blockbench modelling pipeline.Boss 概念图按游戏的方块风格为项目制作；三视图直接进 Blockbench 建模管线。

07Level · D1关卡 · D1

D1, the Cataclysm Vanguard Camp, is the first 5-player dungeon and the exam for chapter one. The whole layout obeys one sentence: walk 270° around the sunken yard, then jump into it from above. A burnt army camp on a river-valley terrace, the main path runs about 170 blocks around three sides of the hollow, and the beacon banner at its centre is seen three times — from the broken bridge, through gaps in the yard fence, and from the overlook before the drop.

D1 灾厄先遣营是第一个 5 人本，也是第一章的验收本。整个布局服从一句话：绕着洼地校场转 270°，最后从高处跳进去。河谷台地上一座被焚毁的军营，主线约 170 格绕洼地三面，中央的烽火大纛全程亮相三次：断桥观景位、校场栅栏的框景缺口、跳落前的观景台。

Whitebox route map (drag to rotate, wheel to zoom)路线图 · 3D 白模（拖拽旋转 · 滚轮缩放）

Blue = main route · grey dashed = branches and the drawbridge return · orange = doors, traps and drop · red = enemies and boss · purple = chests · one unit = one block. Whitebox only; the build server takes this as the brief.蓝 = 主路线 · 灰虚线 = 支路与吊桥回程 · 橙 = 门、陷阱、跳落口 · 红 = 怪物与 Boss · 紫 = 宝箱 · 1 单位 = 1 格。仅为白模，编辑服以此为准施工。

Top-down plan with layers2D 俯视图 · 图层可开关

Segments and beats分段与节拍

Slow start → teaching fight → breather → optional ambush → low-pressure corridor → mid-boss (the loudest beat) → breather → final boss. Two fights of the same intensity are never adjacent.

慢启动 → 教学拍 → 呼吸间 → 可选伏击 → 低压走廊 → 头目（最响的一拍）→ 呼吸间 → 终 Boss。不连排两场同强度战斗。

Rules the level keeps关卡守的规则

• Doors gate progress; no full clears. Group 1 locks door 1, group 2 locks door 2.门控推进，不做全区清怪：组1 锁门1，组2 锁门2。
• Spawn triggers sit a third of the way into a room, never at the door; reinforcements enter from a side door the player has already seen — nothing spawns behind you.刷怪触发线放在场地 1/3 深处，不做门口刷怪；增援从已亮相的侧门进场，不背后刷。
• Every high perch has a melee answer. Doors are hard locks with no parkour bypass.高台怪都有近战解法。门是硬锁，不能跑酷绕过。
• Borders are terrain — slopes and river terraces — never invisible walls.边界全部是地形高差，不做空气墙。
• Guidance is worn dirt path, paired torches at correct doorways, supply piles every 15–25 blocks; wrong turns stay dark. No doorway you cannot reach, no stair with nothing at the top.导引靠踩秃的土径、正路门洞两侧的成对火把、每 15–25 格一处补给堆；错路留暗。不摆到不了的门洞，不摆上去没东西的楼梯。

Final boss: the Vanguard Overseer终 Boss：先遣督战官

A tower shield and a great hammer. The four intro dimensions — basic attacks, three part lessons, add clearing, a light burst check — are all pre-taught by the camp's own monsters, so the boss is the test, not the surprise.

塔盾加巨锤。四维入门：基础攻击、部位三课、清杂、轻量爆发，全部在前面的小怪身上预教过，Boss 是验收而不是意外。

Cycle: basic ×2 → combo → basic ×2 → Siege Hammer, about 13 s, with two raiders summoned through the drawbridge gap every 20 s. A landed Siege Hammer brings the next wave 5 s early; a Hammer that hits a brazier ignites the weapon for 10 s. At 30% the boss enrages (+30% damage, +20% speed) and needs only 3 stacks to charge. Healing budget: 60% tank chip, 15% hammer misses and oil-trench burns, 15% add fire, 10% margin.

循环：普攻 ×2 → 盾锤连击 → 普攻 ×2 → 破城落锤，约 13 秒；每 20 秒从吊桥门缝召唤两名劫掠兵。落锤命中则下一波提前 5 秒；砸中火盆锤面引燃 10 秒。30% 狂暴（伤害 +30%、攻速 +20%），蓄势只需 3 层。治疗压力预算：坦克磨血 60%、落锤失误与火油沟 15%、召唤散伤 15%、余量 10%。

Element placement sheet (for the build server)要素点摆点单（编辑服施工用）

Twenty-six elements in total; the sheet plugs straight into the dungeon system's element table, so the level is data the build server places, not a hand-scripted map.

共 26 个要素，摆点单直接对接副本系统的要素表：关卡是编辑服按数据摆放的，不是手写脚本。

Heroic changes英雄档差异

• Group 1 gets a third scout on the gatehouse and reinforcement cap 2 → 4.组1 加第三只斥候在门楼上，增援上限 2 → 4。
• A second tripwire on the wall-top line, so both corridor lines carry a cost; the oil trench burns from the start of the boss fight.墙头线也加一道绊线，两条线都有代价；Boss 战开战火油沟即常燃。
• Mid-boss: 3 → 4 raiders, double charge, banner takes 10 hits. Boss: double hammer, banner-bearer add, larger healing budget.头目：劫掠兵 3 → 4，冲锋二连，战旗命中 6 → 10。Boss：落锤二连、旗手插入、预算上浮。

08Procedural · R1随机地牢 · R1

R1, the Cataclysm Rift, is the generated counterpart to the hand-built dungeons: every entry is a new map stitched from room templates by seed. Rifts open at random wild spots, are not on the map, and vanish if nobody enters within 30 minutes. A thin crack is a solo rift — one linear expedition; a wide maw is a trio rift — a 3×3 grid per floor with keystone doors, shortcuts and revisitable floors. The tier comes from the zone the entrance is in.

R1 灾厄裂隙是手工副本的生成版：每次进入都是按种子从房间模板拼出来的新地图。裂隙在野外随机位置出现、不上地图、30 分钟无人进入就消失。细缝是 1 人本，线型远征；巨口是 3 人本，每层九宫格，带钥石门、捷径和可回访的楼层。T 阶由入口所在区决定。

Ten hard constraints (linear mode)线型十条硬约束

Structure and one seed生成结构与一个种子

Room library v1 · 28 templates房间模板库 v1 · 28 间

Rooms are designed for stitching, not cut from the fixed dungeons: one rift skin, every door 3 wide and 3 high at the centre of a wall, every floor at zero. Each fighting room states its lesson, and each has two encounter sets, solo and trio, on the same geometry.

房间专为拼接设计，不是固定副本的碎片：统一裂隙皮肤，门口一律 3 宽 3 高开在墙正中，地面一律为零。每间战斗房写明考点，同一几何配 1 人档和 3 人档两套遭遇。

Full library: 1 entry, 8 combat, 2 breather, 2 treasure, 4 event, 5 elite pairs bound to their mid-bosses, 4 boss pairs with drop entries, 2 grid-only rooms. Zero new models: every prop, trap and monster is reused from the fixed dungeons, and event props are vanilla blocks.

全库：入口 1、战斗 8、呼吸 2、宝藏 2、事件 4、与头目绑定的精英房对 5、带跳落入场的 Boss 房对 4、网格专用 2。零新增模型：场景件、陷阱、怪物全部复用固定副本，事件道具用 MC 原生件。

From template to blocks从模板到方块

Rooms are authored as ASCII layers in a text file the generator reads directly: # stone brick, O blackstone pillar, x cover, _ void, A respawn anchor. Adding a room means adding a block of text; rooms without a template fall back to an auto-boxed shell.

房间用 ASCII 分层写在文本文件里，生成器直接读：# 石砖、O 黑石柱、x 掩体、_ 虚空、A 重生锚。加一间房就是加一段文本；没有模板的房间退回自动糊盒子。

room rb01
size 14 14
# 裂岩十字厅:中央岩柱 + 四象掩体。三个门(-X / +X / +Z),是支路的挂点房。
# 考点是"远近混编 · 借柱断线",所以柱子要真能挡住视线 —— 通到顶。
layer 1
  ################
  #..............#
  #..xx......xx..#
  #..xx......xx..#
  #..............#
  #.....OOOO.....#
  ......OOOO......
  ......OOOO......
  #.....OOOO.....#
  #..............#
  #..xx......xx..#
  #..xx......xx..#
  #..............#
  #..............#
  #..............#
  #######....#####
layer 2
  ################
  #..............#
  #..xx......xx..#
  #..xx......xx..#
  #..............#
  #.....OOOO.....#
  ......OOOO......
  ......OOOO......
  #.....OOOO.....#
  #..............#
  #..xx......xx..#
  #..xx......xx..#
  #..............#
  #..............#
  #..............#
  #######....#####
layer 3
  ################
  #..............#
  #..............#
  #..............#
  #..............#
  #.....OOOO.....#
  #.....OOOO.....#
  #.....OOOO.....#
  #.....OOOO.....#
  #..............#
  #..............#
  #..............#
  #..............#
  #..............#
  #..............#
  ################
end

The rift generator builds the layout, validates reachability, retries the seed three times on failure and falls back to a default layout; instances come from a world pool so entry does not stall the server.

裂隙生成器拼布局、校验连通性，失败换种子重试 3 次后回退默认布局；实例来自世界池，进入不卡服。

Rewards奖励与经济挂钩

• A new currency, rift shards, drops per cleared room, elite and boss, with a soft daily cap and an NPC exchange for material packs and cosmetics.新通货裂隙残晶：清房、精英、通关各掉一档，每日软上限，NPC 兑换材料包和外观。
• Per-person value per run (solo, T3 / T4 / T5): treasure 264 / 370 / 512, elite 139 / 194 / 269, boss 257 / 360 / 499 gold; trio about double. No blueprints — those stay in the 5-player dungeons.每人一份价值（1 人本，T3 / T4 / T5）：宝藏 264 / 370 / 512、精英 139 / 194 / 269、终 Boss 257 / 360 / 499 金；3 人本约两倍。不掉图纸，图纸只在 5 人本。
• Rifts have no lockout: they are the repeatable farm; 5-player dungeons are the daily progression.裂隙无进度锁，是可重复的 farm；5 人本负责每日进度。

09Pipeline & Management管线与项目管理

Engine and stack引擎与技术栈

Working rules written into the engine写进引擎的工作规则

• Validate, then apply — a config hot reload checks every entry first and abandons the whole reload on a single failure, because a half-applied config is worse than no reload.先校验后应用：配置热重载先检查每一条，任一条不过整次放弃，半套配置上线比不重载更糟。
• Property sheet is the single base-value source — MythicMobs was rejected because its own stats file would fight it; ArcartX was rejected because both patch the same HUD class with exclusive redirects.属性表是唯一的基础值来源：MythicMobs 因自带属性文件与此冲突被排除；ArcartX 因和引擎在同一个 HUD 类上用独占的 Redirect 被排除。
• Write the wrong turns down — the roadmap keeps a section of repeated mistakes (default values where the asset already states the truth; deriving coordinate conventions instead of adding a toggle and flipping it in game) so the next person does not repeat them.把走错的路写下来：路线图里专门有一节反复踩的坑（资产里写明了真值却给默认值；靠推导坐标约定而不是加个开关在游戏里切几下），下一个人不再重踩。

Design site as the source of truth策划站是唯一依据

Fifty-six linked pages: system specs, the numbers table, config tables, level pages and the art requirement board, plus 78 cross-role sync sheets between numbers, config, systems, art and code. Configuration tables read live values from the numbers table, so changing a base value updates every derived item. The numbers, item and skill definitions live in the backend database that the game reads.

56 页互相引用：系统策划、数值表、配置表、关卡页和美术需求板，加上 78 份数值 ↔ 配置 ↔ 系统 ↔ 美术 ↔ 开发的跨岗位同步单。配置表实时读数值表，改一个基准值整页派生数值跟着变。数值、物品和技能定义存在游戏读取的后端数据库里。

Project management: the design site is also the tracker项目管理：策划站同时是追踪板

The same site that holds the specs runs the project. A requirement board splits work into development and art, and every requirement lists the exact files it is delivered as — drop a file on its row and it is delivered. An asset library receives those files for acceptance (accepted or returned), a schedule turns dated requirements into a Gantt chart, a concept board holds references, and a milestone page merges code commits with art deliveries into one timeline.

放策划案的站点同时在管项目。需求板分开发和美术两块，每条需求下面列出它要交付的具体文件，把文件拖到那一行就算交付。资产库验收这些文件（入库或打回），排期把填了日期的需求变成甘特图，概念图板放参考，项目里程碑把代码提交和美术交付合成一条时间线。

Recreated from the live site (17 Sep 2026); numbers are the real board state that day. The site runs on the same backend as the game, so the requirement board, asset acceptance and the game’s item and skill data share one database.按 2026 年 9 月 17 日的线上站点重绘，数字是当天的真实板面。站点和游戏跑在同一个后端上，需求板、资产验收和游戏里的物品、技能数据共用一个数据库。

What runs today现在跑得通的

• Per-part hit detection in first and third person on the test server, with the hit-box overlay and part readouts used to tune contact windows.测试服上第一、第三人称的部位判定，用判定盒叠加层和部位读数调判定窗口。
• The Swordsman line: 12 skills and 6 states on a longsword configured from the class table; slot-based keys (Q / E / R main hand, F off-hand, T / Y / G armour) with per-slot candidate choice stored on the item.剑士线：一把按职业表配置的长剑，12 技能、6 状态；按槽位的键位（主手 Q / E / R、副手 F、防具 T / Y / G），每槽候选选择存在物品上。
• Vanilla-style HUD rebuilt from scratch: health, mana, stamina, hotbar, region banner, a live-scanned minimap with Xaero-accurate colours, world-space quest markers and screen-edge direction arrows.从零重做的原版风格 HUD：血量、法力、体力、快捷栏、地区提示、实时扫描的小地图（对齐 Xaero 配色）、世界内任务标记和屏幕边缘方向箭头。
• Item card and inventory modelled on the design pages (Minecraft × Albion layout); rich tooltips filled from templates sent on join and on hot reload.按策划页做的物品卡和背包（Minecraft × 阿尔比恩布局）；进服和热重载时下发模板，富提示按模板拼装。
• Blockbench camera animations play in game; one merged model splits into first- and third-person variants at pack time.Blockbench 的镜头动画在游戏里播放；一份合并源模型打包时拆成第一、第三人称两份。

Next下一步

• State → comparison operators → target filters → selection atoms → branching → affix atoms, in that order, because State underpins the other four and touches no damage code.State → 比较运算符 → Targets 筛选 → 选择原子 → Branch → 词条原子，按这个顺序，因为 State 是后四个的地基且不碰伤害管线。
• Third-person aiming: report the aim point and validate angle and range on the server.第三人称瞄准：上报瞄准点，服务端校验夹角和射程。
• Build D1 on the edit server from the placement sheet; author the remaining rift room templates.按摆点单在编辑服搭 D1；补齐其余裂隙房间模板。

Timeline时间线