MOD 製作教程與 Lua API

Mods/
├── DemoCharacterMod/           ← 完整範例（數值+技能+受擊体+皮膚）
│   ├── mod.json                ← MOD 清单
│   ├── preview.jpg             ← 預覽图
│   ├── CharacterAsset/
│   │   └── allo.txt            ← 異特龍配置（包含4种MOD類型）
│   └── SkinsAsset/
│       └── Crooked mouth.png   ← 皮膚貼圖
│
├── DemoSkinsMod/               ← 纯皮膚 MOD 範例
│   ├── mod.json
│   ├── preview.jpg
│   └── SkinsAsset/
│       ├── allo_deser_allo.txt ← 皮膚脚本
│       └── deser_allo.png      ← 皮膚貼圖
│
└── MyFirstMod/                 ← 你的 MOD 根目錄
    ├── mod.json
    └── CharacterAsset/
        └── allo.txt

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

-- 修改異特龍的完整属性（*不可删除以下项目）
CharacterAsset = {
    name    = "異特龍",        -- 角色名称
    enable  = true,            -- 是否啟用角色
    jump    = false,           -- 是否允许跳跃（无匹配动画则报错）
    race    = "allo",          -- 種族標籤（*必填，唯一匹配键）
    ropoda  = 0,               -- 巢穴類型（-1=无, 0=兽脚类, 1=蜥脚类, 2=鸟臀目）
    ropode  = 0,               -- 蛋類型（-1=无, 0=兽脚类, 1=蜥脚类, 2=鸟臀目）
    volume  = 2,               -- 体型 0~5（轻→超级）
    rank    = 7,               -- 星级 0~12（S1~SS）
    branch  = 3,               -- 属种科目 0~25
    habit   = 0,               -- 习性（0=陆生, 1=亲水, 2=海爬, 3=水生, 4=两栖, 5=飞行）
    type    = 0,               -- 种类（0=食肉龍, 1=食草龍, 2=水生, 3=节肢, 4=哺乳, 5=飞行）
    taste   = 0,               -- 食性（0=食肉, 1=花草, 2=树叶, 3=杂食）
    spawn   = 0,               -- 繁殖方式（0=卵生, 1=胎生）
    health  = 26503.0,         -- 生命值
    hunger  = 12227.0,         -- 饥饿值
    water   = 3128.0,          -- 水分
    oxygen  = 474.0,           -- 氧气
    stamina = 100.0,           -- 耐力
    attack  = 2802.0,          -- 攻擊力
    defend  = 779.0,           -- 防御力
    pen     = 5,               -- 穿透等级 0~10
    ten     = 3,               -- 韧性等级 0~10
    restore = 266.0,           -- 恢复能力
    consume = 100.0,           -- 巡航消耗
    weight  = 3600.0,          -- 体重（公斤）
    speed   = 27.01,           -- 行走速度（km/h）
    swim    = 13.5,            -- 游泳速度（km/h）
    flying  = 0.0,             -- 飞行速度（km/h）
    runSpeed    = 54.01,       -- 奔跑速度（km/h）
    turnSpeed   = 0.61,        -- 转向灵活度（度/秒）
    growtime    = 1560.0,      -- 成长到成年所需时间（秒）
    ovumtime    = 1080.0,      -- 体内卵形成间隔（秒）
    hatching    = 2210.0,      -- 蛋孵化时间（秒）
    safe        = 1800.0,      -- 幼体保护期（秒）
    skill   = "LifeDrain,3;",  -- 出生自带 EX 技能
    gene    = "",              -- 出生自带基因
}

CharacterSkill = {
    attack1 = {
        Race         = "allo",      -- *必填* 種族標籤
        AttackOrder  = 1,           -- 攻擊序号（1=嘴1, 2=嘴2...）
        AttackType   = 0,           -- 攻擊方式 0~7（见下方枚举）
        DamageMode   = 0,           -- 傷害類型 0~2（见下方枚举）
        Area         = nil,         -- 可用区域 nil=不限, {0,1}=陆地+浅水
        AttackRange  = 1.0,         -- 攻擊碰撞半径（米）
        Modify       = 2.0,         -- 傷害修正系数（1=无修正）
        UseStamina   = 0.01,        -- 耐力消耗百分比（0=系统默认）
        TriggerSkill = "Scars,2;",  -- 命中时触发技能（格式: "名称,等级;"）
    },
    attack2 = {
        Race         = "allo",
        AttackOrder  = 2,
        AttackType   = 1,           -- 尾巴
        DamageMode   = 1,           -- AOE 範圍傷害
        AttackRange  = 3.0,
        Modify       = 0.8,
        UseStamina   = 0.03,
        TriggerSkill = "Blood,2;",
    },
}

CharacterHitGroup = {
    head = {
        Race              = "allo",
        PartType          = BODY_HEAD,
        PenetrationRate   = 0.6,    -- 渗透率 0~1（越大越易被穿透）
        DamageMultiplier  = 1.5,    -- 傷害倍率 0.5~2（>1 受伤更重）
    },
    body = {
        Race              = "allo",
        PartType          = BODY_BODY,
        PenetrationRate   = 0.05,   -- 几乎不穿透
        DamageMultiplier  = 0.8,    -- 减伤 20%
    },
    belly = {
        Race              = "allo",
        PartType          = BODY_BELLY,   -- 腹部（值=7）
        PenetrationRate   = 0.9,    -- 极高渗透
        DamageMultiplier  = 1.8,    -- 大幅提升受擊傷害
    },
}

CharacterGeneBuff = {
    -- 键 = 要覆写的现有基因 tag（TAG 从「基因/技能列表」页查询）
    Bleed = {
        Repeat  = "COVER",   -- 可选：覆盖规则
        Upgrade = "EXP",     -- 可选：升级方式
        With    = "",        -- 可选：附加效果 DSL，格式 tag,等级;
        Copes   = "",        -- 可选：克制对象 tag
        Effects = {          -- *必填* 每级數值表（覆写后原每级數值被整体替换）
            { Level = 1, Probability = 0.55, Effect = 0.03, Duration = 5 },
            { Level = 2, Probability = 0.65, Effect = 0.05, Duration = 7 },
        }
    }
}

CharacterGeneBuff = {
    -- ① 覆写现有基因 Metabolism（新陈代谢）的每级數值
    Metabolism = {
        Effects = {
            { Level = 1, Effect = 0.12, Skillful = 0   },
            { Level = 2, Effect = 0.18, Skillful = 100 },
        }
    },
    -- ② 覆写现有技能基因 Bleed（流血）的触发概率、數值與持续时间
    Bleed = {
        Effects = {
            { Level = 1, Probability = 0.55, Effect = 0.03, Duration = 5 },
            { Level = 2, Probability = 0.65, Effect = 0.05, Duration = 7 },
        }
    }
}

-- 在角色的 CharacterAsset 脚本里用 gene 字段让角色出生自带基因，格式：基因名,等级;
CharacterAsset = {
    race = "allo",
    gene = "Metabolism,2;",
}

CharacterSkin = {
    Race = "allo",                              -- *必填* 種族標籤
    Name = "Crooked mouth",                      -- *必填* 皮膚唯一名称（用于去重）
    Path = "SkinsAsset/Crooked mouth.png",       -- *必填* 貼圖路径（相对 MOD 根目錄）
}

MySkinMod/
├── mod.json
├── preview.jpg
└── SkinsAsset/
    ├── allo_crooked.txt   ← CharacterSkin { Race="allo", Name="Crooked mouth", ... }
    ├── crooked_allo.png   ← 貼圖檔案
    ├── rex_volcano.txt    ← 同一 MOD 可包含多个種族皮膚
    └── volcano_rex.png