MOD / Lua API

MOD 製作教程與 Lua API

学习如何建立 MOD、編寫 Lua 配置脚本、修改角色數值，并理解優先级與沙箱限制。

1. 快速開始

1.1 建立 MOD 資料夾

在遊戲 Mods/ 目錄下新建一个資料夾，名称即为你的 MOD 名：

平台	Mods 目錄路径
Windows	`遊戲安装目錄/MesozoicDawn_Data/StreamingAssets/Mods/`
Linux Server	`遊戲安装目錄/MesozoicDawn_Data/StreamingAssets/Mods/`
Android	`内部存储/Android/data/com.../files/Mods/`
iOS	`应用沙盒/Documents/Mods/`

Mods/
└── MyFirstMod/          ← 你的 MOD 根目錄
    ├── mod.json         ← MOD 元信息清单（推薦）
    └── CharacterAsset/  ← 放置 Lua 脚本
        └── allo.txt     ← 修改異特龍的配置

1.2 建立 mod.json（推薦）

{
  "Name": "MyFirstMod",
  "Author": "你的名字",
  "Version": "1.0",
  "SupportedVersion": "0.6.*",
  "Priority": 0,
  "Description": "我的第一个 MOD"
}

1.3 編寫你的第一个 Lua 脚本

在 CharacterAsset/allo.txt 中写入：

-- 修改異特龍的生命值和攻擊力
CharacterAsset = {
    race    = "allo",       -- 種族標籤（必须是遊戲内已有種族）
    health  = 30000.0,       -- 生命值
    damage  = 350.0,         -- 攻擊力
    speed   = 30.0,          -- 移动速度（km/h，系统自动换算）
}

1.4 在遊戲中啟用

启动遊戲，进入登入界面后點擊 MOD 管理。
點擊 載入 MOD 扫描本地 MOD。
找到你的 MOD，點擊啟用。
點擊儲存退出 MOD 管理界面。
加入服务器后，修改的數值即刻生效。

2. 角色數值修改

角色數值配置用于修改遊戲内生物的各项属性。所有可用字段必须填写在 Lua 脚本的 CharacterAsset 表中，未填写的字段将保持遊戲原始设定。

基础與分类设置

字段	說明
`race`	必须填写。修改的種族標籤。
`name`	角色显示名称。
`volume`	角色体型分类 0~5。
`habit`	生活习性 0~5（0=陆生，1=亲水，3=水生...）。
`type`	角色种类 0~5（0=食肉龍，1=食草龍...）。

生存與戰鬥數值

字段	說明
`health`	最大生命值上限。
`stamina`	最大耐力储存值。耗尽后无法冲刺或强攻。
`hunger` / `water`	最大饥饿與水分储备。
`attack` / `defend`	基础攻擊力與基础躯干防御力。
`pen` / `ten`	攻擊穿透等级與防御韧性等级。

3. 技能修改與部位受击

3.1 技能配置模板

CharacterSkill = {
    bite = {
        Race        = "allo",   -- *必填* 種族標籤
        AttackName  = "撕咬",    -- 攻擊名称
        AttackOrder = 1,         -- 攻擊序号
        AttackType  = 0,         -- 0=嘴巴, 1=尾巴, 2=践踏
        DamageMode  = 0,         -- 0=单体, 1=范围(AOE)
        AttackRange = 1.5,       -- 攻擊碰撞半径（米）
        Modify      = 1.5,       -- 傷害修正系数
    }
}

3.2 受击判定覆写 (Hitbox)

通过 CharacterHitGroup 改变異特龍頭部所承受的易伤比：

CharacterHitGroup = {
    head = {
        Race              = "allo",
        PartType          = 0,     -- 常量部位对应：0=頭部
        PenetrationRate   = 0.6,   -- 装甲渗透率加强
        DamageMultiplier  = 1.5,   -- 受到傷害加倍！
    }
}

4. 高级：環境與管理機制

優先機制 (Priority)

当多个 MOD 修改同一種族的同一字段时，Priority 數值越大，越后执行，也就越容易成为最终生效结果。默认值为 0。

Lua 沙箱安全機制

os、io：禁止系统命令與檔案读写。
dofile、package：禁止执行任意本地檔案或外部动态库。

伺服器端管理

管理員可使用 /modReload 重新載入目前配置檔案中的數值、技能和皮肤配置。不支持新增種族，该项仍需重啟服务器。