教程

本站的参考页面一次只讲一个文件、一个字段或一个 API。内容教程则从空数据包开始，做到能在游戏里看见结果，这样在逐个查字段之前，先把这些表如何拼在一起看清楚。

先读开发模式，准备复现问题的环境，并了解模块性能分析界面。后面的内容教程再开始搭建示例包。

示例包

所有教程都在扩展同一个位于 example 命名空间下的小型内容包。前面几篇是一条线，每一篇都假定它依赖的页面已经完成（双修那篇挂在第二篇后面，只用到同一个包里已有的定义）；后面几篇各自独立，只用到这个包里已有的那几个定义。按物品或方块认领的那几张表和别的定义一样放在这个包里，条目 id 就是 example:<路径>。整组教程结束时，它长这样：

data/example/
├── mxt/
│   ├── element/common.json                  Element named by the qi aura
│   ├── element/fire.json                    Element for the fire spirit root
│   ├── element/water.json                   The second element a reaction needs
│   ├── element_reaction/steam_burst.json     What happens once both attachments add up
│   ├── resource/qi.json                     The stored value
│   ├── resource/azure_mastery.json          Mastery of a technique, a plain value
│   ├── aura/qi.json                         The aura the value carries, and its realm chain entry
│   ├── realm_stage/qi_condensation.json     Realm chain
│   ├── realm_stage/foundation.json
│   ├── realm_stage/core_formation.json
│   ├── cultivation/meditation.json     What the player does to absorb aura
│   ├── cultivation/dual_meditation.json  Only yields beside a friend holding a manual
│   ├── aura_zone/common_land.json           Where the aura is
│   ├── aura_zone/misty_valley.json          A denser zone (aura environment tutorial)
│   ├── spirit_root/fire_root.json           Granted by a pill
│   ├── spirit_root/fire_common_root.json    Two elements with shares (spirit root tutorial)
│   ├── physique/sword_bone.json             Attributes, exclusion tags, damage multipliers
│   ├── progression/azure_breath_1.json      The technique's mastery chain
│   ├── progression/azure_breath_2.json
│   ├── progression/azure_breath_3.json
│   ├── technique/azure_breath.json
│   ├── ability/qi_bolt.json                 An active ability
│   ├── ability/qi_recovery.json             A triggered ability
│   ├── ability/spark.json                   An ability a talisman inscribes
│   ├── ability/sword_aura.json              The ability that launches a sword aura
│   ├── ability/blade_storage.json           A storage ability: slots and cooldown
│   ├── artifact/blade_sheath.json           Claims an item and hangs the storage ability on it
│   ├── ability/azure_sword_mount.json       The vehicle: speed, seats, fuel, looks
│   ├── ability/azure_sword_flight.json      The flying skill: which hand, and its own price
│   ├── artifact/azure_sword.json            Claims the sword and declares the vehicle on it
│   ├── curse/qi_backlash.json               A timed curse: on_apply, per-tick, stacking
│   ├── talisman/flame_sigil.json            The talisman: abilities + capacity + costs
│   ├── formation/spirit_gathering_array.json Structure, upkeep, buff module
│   ├── formation/ward_array.json            Protection + attack modules
│   ├── secret_realm/trial_realm.json      A pocket world template
│   ├── tribulation/heavenly_gate.json       The trial a breakthrough starts
│   ├── forging_method/light_strike.json     One strike: meter shift, cost, cooldown
│   ├── forging_method/heavy_strike.json
│   ├── forging_method/quench.json           A strike that only moves the meter down
│   ├── forging_method/temper.json           A strike that only moves it up
│   ├── forging_blueprint/spirit_sword.json  Materials, target band, quality ladder
│   ├── quality/common.json             Quality tiers: chain identity, next tier, step cost
│   ├── quality/refined.json
│   ├── quality/flawless.json
│   ├── medicinal_property/nourish.json      The properties the pills are built from
│   ├── medicinal_property/calm.json
│   ├── spirit_herb/herb_a.json              Main herb, auxiliary herb and catalyst
│   ├── spirit_herb/herb_c.json
│   ├── spirit_herb/herb_d.json
│   ├── alchemy_furnace/basic.json           Furnace specification: slots, capacity, cooling
│   ├── alchemy_wall_material/basic_wall.json  How hot one wall block may get
│   ├── heat_source/magma_block.json         What a heating block supplies
│   ├── pill/qi_pill.json                   What the pill does: dose action, toxicity, overdose
│   ├── pill_binding/qi_pill.json            Which items are that pill, and their cap and cooldown
│   ├── pill/warming_pill.json               A second pill
│   ├── pill_binding/warming_pill.json
│   ├── technique_binding/azure_manual.json
│   ├── trigger/azure_mastery_from_kill.json  A kill raises mastery
│   ├── trigger/azure_mastery_signal.json    A signal of your own raises it too
│   ├── contract_type/spirit_familiar.json   Conditions, costs and caps for one beast
│   ├── creature_profile/spirit_beast.json   The beast's own mastery chain
│   ├── currency/spirit_coin.json            An item that is money, and what it exchanges for
│   ├── item_aura/spirit_stone.json          Items that act as cultivation fuel
│   ├── item_binding/qi_pill.json            Rules attached to real items
│   ├── item_binding/root_pellet.json
│   ├── weapon_binding/spirit_sword.json     Weapon attributes and the three combat hooks
│   ├── tool_binding/smith_hammer.json       Which methods a tool item unlocks
│   ├── blueprint_binding/sword_manual.json  Which blueprints a blueprint item offers
│   └── block_aura/spirit_stone_ore.json     Blocks that emit aura
├── recipe/talisman/flame_sigil.json         The formula the drawing workstation shows
├── tags/entity_type/contract/spirit_familiar.json  Narrows which entities it accepts
└── (kubejs/startup_scripts/mxt_items.js)    The items themselves, registered by KubeJS
    (kubejs/server_scripts/mxt_costs.js)     A cost only a script can answer
    (kubejs/server_scripts/mxt_signals.js)   Publishing a trigger signal of your own

教程列表

教程	你会搭建	什么时候读
开发模式	调试环境与模块性能分析界面：开启记录、排序、滚动与查看最近 240 tick 的耗时。	开始制作内容，或需要复现与定位问题时。
定义灵气与境界	一个元素、一个灵气数值、一条线性境界链、一个修炼行为和一个最小的灵气区域——核心修炼循环。	需要让玩家能够修炼并突破时。
编写双修功法	一条只有身边有人时才出成果的修炼法门：判据怎么拼、两个人各自怎么进得去、对方走开时停不停。	基础循环已经跑通，想让"两个人一起修"成为一条规则时。
定义元素反应	第二种元素认领哪些伤害类型，以及两种附着各攒够之后做什么。	基础循环已经跑通，想让两种元素碰在一起时真发生点什么时。
定义灵气环境	分层灵气区域、方块灵气、物品燃料、噪声、波动、雾效和 HUD 条。	基础循环已经跑通，想让世界参与进来时。
定义灵根与体质	一条带元素占比的灵根、一条只在特定灵根下授予的体质，以及持有与生效的区别。	想让身体本身决定修炼倍率与伤害倍率时。
KubeJS 创建物品并绑定行为	由脚本注册的真实物品，加上四张绑定表，以及让它们有玩法意义的配方。	需要自己的丹药、武器或手册时。
KubeJS 绑定行为	四张绑定表各自的钩子：什么时候执行、受什么限制、条件与先后怎么算。	物品已经能用了，想精确控制它什么时候做什么时。
发布触发器信号	一条自定义触发器信号：脚本发布它，数据包规则或另一段脚本消费它。	想让"游戏里发生了某件事"变成自己的一条信号时。
定义品质链	一条三档品质阶梯：链名写在哪、升级的代价写在哪、怎么给物品定档。	想让同一件物品有高低之分时。
编写消耗	四种代价类型各自扣什么、`{ "id": …, "amount": … }` 这个简写展开成哪一种，以及一次动作里的几笔什么时候整笔回退。	你已经写过一条 `costs`，想弄清楚它到底怎么扣、扣不动时会怎样时。
定义技能	一个主动技能、一个触发技能，以及授予它们的方式。	想给玩家一个花灵气的地方时。
放出一道剑气	一个用 `mxt:spawn_sword_aura` 甩出飞行剑气的技能：颜色、尺寸、寿命，以及它撞上东西时做什么。	想让技能打出一个看得见的飞行物时。
定义功法与晋级	一条三级进度链、衡量熟练度的数值，以及让熟练度涨起来的几条路。	技能已经能授予，想让功法随使用往上爬时。
定义阵法	一座按结构激活、每周期收维持费的阵法：增益、灵气域、攻击与守御模块，以及阵盘。	想让玩家搭出会运转的东西时。
定义秘境	一份能开出独立实例维度的秘境模板：生成、边界、落点、认领与时限。	想要一次性或可认领的小世界时。
定义符箓	把技能铭刻到载体上、灌注灵气、右键发动，以及手持与展示架的两套规则。	想让法术能被带在身上时。
编写画符配方	画符工作站里展示的那张符方：符形怎么画、判分看什么、完成度命中的档位与产出。	想把"铭刻"那条手工路接进自己的内容包时。
定义天劫	一条突破时启动的天劫时间线：前摇、节拍、带颜色的雷击与成败结果。	想让突破有风险时。
定义诅咒	一条按时间或信号发作、可以叠层、可以解毒的诅咒。	想给玩家一个会持续发作的状态时。
锻造法器	一条能跑通的锻造产线：手法、工具绑定、图纸物品，以及锻打条、目标区间、收尾模式、品质阶梯与失败结算。	想让玩家把东西"打"出来，而不是合成出来时。
炼制丹药	手搭一座 3×3×3 部件丹炉，写一条按药性判定的丹方，用供热方块把炉温升到目标区间并收下成品。	想自己造丹药与热源方块时。
契约灵兽	一份契约类型：谁签得了、代价多少、两个上限、几条命令，以及召回与灵兽袋。	想把别的模组的兽收成自己的时。
定义货币	把物品定义成货币：面值、什么时候这一栈不算钱、兑换条目，以及兑换站怎么用它。	想让物品真的能当钱花时。
储物与灵器	灵力容器那件东西的形状与边界，以及挂在它下面的两篇子教程。	想让物品能装东西、或者想让它能飞时。
储物	一条挂在物品上的储物技能：格数怎么算、箱子存在哪、怎么预填。	想让物品能装东西时。
飞行法器	一件会飞的物品：载具定义、御器之术、起剑落地与灵气燃料的两笔账。	想让玩家御剑飞行时。
裂隙	用方块与命令架起会传送的裂隙：目标维度、颜色、连通与落点。	想在维度之间开一条自己的路时。

约定

命名空间。 所有示例都使用 example。把它改成你自己整合包或内容包的 ID，并保持文件的 ID 与它们之间的引用同步。
生效方式。 MiXianTu 的 43 张数据包注册表都是 Minecraft 在世界加载时读取的，所以 /reload 不会重新读取。修改数据包文件后，请退回标题界面重新打开世界（或重启服务器）。
解析失败的文件会阻止加载存档。 没有上一份快照可以退回：为了防止世界数据损坏，只要有定义解码失败，世界就会一直加载不了，直到该文件被修好。日志会给出文件名和 Codec 错误，所以要留一份正在编辑的文件的最后可用副本。
版本。 这些页面跟随模组的当前开发版本（不在文档里写死版本号，以你装的那份 Jar 为准），版本仍在开发中、数据包格式尚未冻结；字段变化时，参考页面也会随之更新。

示例包​

教程列表​

约定​

延伸阅读​

示例包

教程列表

约定

延伸阅读