Menú
介绍 DST 额外物品包 mod 的文件结构。当用户询问 mod 结构、文件组织或想了解 mod 如何组织时调用。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
通过对比当前分支与合适基准引用（PR 分支优先使用 PR base，否则使用用户指定基准或 `master`）、检查差异，并把变更行为整理成最小可行的游戏内检查清单，为这个 Don't Starve Together 模组生成手动测试计划，同时同步写入仓库根目录 `test.md`。当用户要求测试计划、QA 清单、验证步骤、回归清单，或询问如何在没有自动化测试的情况下手动测试 DST 模组改动时使用。
为这个 Don't Starve Together 模组规划、撰写或配套截图准备语雀对外文档时使用。通过对照用户提供的对外日志、git log/PR、现有语雀页面结构和源码行为，生成按语雀页面拆分的玩家可读正文、截图占位和最少 DST 控制台截图指令；适用于更新日志、食物、建筑、工具、鲜活世界等页面，默认直接在对话中输出可复制 Markdown，只有用户明确要求时才生成 docx 或尝试直接更新语雀。
Read Don't Starve Together base-game scripts, this mod's files, and animation resource references when implementing or verifying DST APIs and prefab behavior. Use when code depends on DST components, prefabs, widgets, stategraphs, AnimState bank/build/symbol names, or when Codex needs to inspect a game's item animation contents.
Generate commit messages or changelog text for this project. Use when the task is to inspect git changes, summarize diffs, or draft Conventional Commit messages on Windows/PowerShell.
Explain the structure of the dst_additional_item_package mod. Use when the task is to orient within this repository, find where features live, or recall naming conventions and core directories.
生成 git commit 信息或 changelog。先通过 git 指令将变更写到 _diff.md，再读取 _diff.md 生成内容。Windows 下 git diff 会卡死，且 PowerShell 重定向会导致乱码，必须使用 [System.IO.File]::WriteAllText 方法。
| name | mod-structure |
| description | 介绍 DST 额外物品包 mod 的文件结构。当用户询问 mod 结构、文件组织或想了解 mod 如何组织时调用。 |
本技能提供了 DST（饥荒联机版）额外物品包 mod 的文件结构概览。
| 文件 | 描述 |
|---|---|
| modmain.lua | 主 mod 配置文件 - 预加载资源和注册物品 |
| modinfo.lua | Mod 元数据 - 名称、描述、作者、配置选项 |
| package.json | Node.js 包配置，用于构建工具和脚本 |
| README.md | 项目文档和用户反馈 |
| TODO.md | 开发待办事项列表 |
本 mod 的所有自定义内容都使用 aip 前缀命名，这是识别 mod 内容的关键标识：
aip_ 开头（如 aip_divine_rapier, aip_gourd）aipc_ 开头（如 aipc_action, aipc_orbit_driver）AIP_ 开头（如 AIP_DOU_SCEPTER, AIP_DOU_TOTEM）aip 开头（如 aipPrint, aipSpawnPrefab）在开发模组时，遵循以下查找顺序：
aip 开头，直接在 mod 的 scripts/ 目录中查找-- mod 内容（在 scripts/ 中查找）
aip_divine_rapier -- 预制件
aipc_action -- 组件
aipPrint() -- 工具函数
-- 游戏内容（使用 dst_reader 查找）
inst.components.health -- DST 原生组件
AddRecipe2() -- DST 原生 API
TUNING.NIGHTSWORD_DAMAGE -- DST 原生配置
包含 mod 的所有 Lua 脚本：
prefabs/ - 物品和实体预制件（200+ 个文件）
components/ - 提供功能的自定义组件
brains/ - 生物的 AI 大脑
behaviours/ - 生物行为
hooks/ - 游戏集成的事件钩子
configurations/ - Mod 配置文件
aipStory/ - 故事文本（中文/英文）
美术和设计文件：
编译后的游戏图片：
导出的动画文件（Spriter 格式）：
生成工具和资源：
文档：
Mod 按类别提供额外物品：
Mod 选项在 modinfo.lua 中定义：
在开发过程中，查看代码变更时必须使用 git diff --no-pager 命令：
git diff --no-pager
使用 --no-pager 参数的原因：
常用命令：
# 查看所有变更
git diff --no-pager
# 查看特定文件的变更
git diff --no-pager scripts/prefabs/aip_divine_rapier.lua
# 查看暂存区的变更
git diff --cached --no-pager
# 查看最近一次提交的变更
git show --no-pager HEAD
本 mod 的核心辅助工具是 aipUtils.lua，其中定义了 60+ 个全局辅助函数。在进行任何代码开发或修改时，必须遵循以下规范：
当代码中出现 _G.aip 开头的函数调用时，必须首先检查该函数是否已在 aipUtils.lua 中定义。避免重复实现已存在的功能。
表格操作：
| 函数 | 描述 |
|---|---|
aipCountTable(tbl) | 计算表格元素数量 |
aipInTable(tbl, match) | 查询元素是否在表格中 |
aipFlattenTable(originTbl) | 打平表格 |
aipTableRemove(tbl, item) | 从表格中移除元素 |
aipTableSlice(tbl, start, len) | 表格切片 |
aipTableConcat(tbl1, tbl2) | 合并表格 |
aipTableIndex(tbl, item) | 查找元素索引 |
aipFilterTable(originTbl, filterFn) | 过滤表格 |
aipCloneTable(originTbl) | 复制表格 |
aipFilterKeysTable(originTbl, keys) | 按 key 过滤 |
aipTableKeys(tbl) | 获取所有 key |
aipTableMap(tbl, fn) | Map 遍历表格 |
调试输出：
| 函数 | 描述 |
|---|---|
aipPrint(...) | 基础打印 |
aipStr(...) | 字符串拼接 |
aipTypePrint(...) | 带类型打印 |
位置与距离：
| 函数 | 描述 |
|---|---|
aipGetAngle(src, tgt) | 获取角度 (0~360) |
aipAngleDist(sourcePos, angle, distance) | 按角度前进 |
aipDiffAngle(a1, a2) | 计算角度偏差 |
aipToAngle(srcAngle, tgtAngle, step) | 角度过渡 |
aipDist(p1, p2, includeY) | 两点距离 |
实体查找：
| 函数 | 描述 |
|---|---|
aipFindNearEnts(inst, prefabNames, distance, includeInv) | 查找附近实体 |
aipFindNearPlayers(inst, dist) | 查找附近玩家 |
aipFindCloseEnt(inst, targetList) | 查找最近实体 |
aipFindEnt(...) | 查找单个实体 |
aipFindEnts(...) | 查找多个实体 |
aipCountEnts(...) | 统计实体数量 |
aipFindRandomEnt(...) | 随机查找实体 |
生成与移除：
| 函数 | 描述 |
|---|---|
aipSpawnPrefab(inst, prefab, tx, ty, tz) | 生成预制件 |
aipReplacePrefab(inst, prefab, ...) | 替换预制件 |
aipRemove(inst) | 移除实体 |
aipGetOne(inst) | 获取单个物品 |
aipCopy(item) | 复制物品 |
aipFlingItem(loot, pt, config) | 丢弃物品 |
位置计算：
| 函数 | 描述 |
|---|---|
aipGetSpawnPoint(startPT, distance, onGround) | 获取可生成点 |
aipFindNearbyOcean(pt, dist) | 找海边点 |
aipIsNaturalPoint(pt) | 检查自然地皮 |
aipGetSecretSpawnPoint(...) | 获取隐秘生成点 |
aipFindRandomPointInOcean(...) | 随机海上点 |
aipFindRandomPointInLand(emptyDistance) | 随机陆地点 |
aipValidateOceanPoint(pt, radius, prefabRadius) | 验证海点 |
aipGetTopologyPoint(tag, prefab, dist) | 拓扑点查找 |
其他工具：
| 函数 | 描述 |
|---|---|
aipGetModConfig(key) | 获取 Mod 配置 |
aipGetAnimation(inst) | 获取动画名 |
aipGetAnimState(inst) | 获取 AnimState |
aipJoin(strList, spliter) | 字符串拼接 |
aipSplit(str, spliter) | 字符串分割 |
aipCanAttack(target, attacker, keepTarget) | 检查可攻击 |
aipIsShadowCreature(inst) | 检查暗影生物 |
aipRandomLoot(lootTbl) | 随机概率抽取 |
aipChance(chance, inst, bonus) | 概率判定 |
aipRPC(funcName, ...) | 服务端 RPC |
aipRPCClient(funcName, ...) | 客户端 RPC |
aipGetActionableItem(doer) | 获取可交互物品 |
aipQueue(tasks) | 任务队列 |
当需要实现新功能时，应优先：
如需在 aipUtils.lua 中添加新函数，应遵循：
function _G.aipXXX(...) 格式定义Mod 使用多语言系统支持中文和英文：
在 modinfo.lua 中定义语言选项：
{
name = "language",
label = Lang("Language", "语言"),
options = {
{description = "中文", data = "chinese"},
{description = "English", data = "english"},
-- ... 其他语言
},
default = "english",
}
在各个预制件文件中使用 LANG_MAP 定义多语言文本：
local LANG_MAP = {
english = {
NAME = "Divine Rapier",
DESC = "The combination of light and dark",
REC_DESC = "Fusing the power of both...",
},
chinese = {
NAME = "圣剑",
DESC = "光与暗的结合",
REC_DESC = "融合两者的力量...",
},
}
local language = aipGetModConfig("language")
local LANG = LANG_MAP[language] or LANG_MAP.english
使用 DST 的 STRINGS 全局表注册文本：
STRINGS.NAMES.AIP_DIVINE_RAPIER = LANG.NAME
STRINGS.CHARACTERS.GENERIC.DESCRIBE.AIP_DIVINE_RAPIER = LANG.DESC
STRINGS.RECIPE_DESC.AIP_DIVINE_RAPIER = LANG.REC_DESC
对于复杂内容（如食物），使用独立语言文件：
local LANG_MAP = {
english = {
EGG_PANCAKE = {
NAME = "Egg Pancake",
DESC = "Too many eggs!",
},
-- ...
},
chinese = {
EGG_PANCAKE = {
NAME = "蛋饼",
DESC = "鸡蛋太多了！",
},
-- ...
},
}
return LANG_MAP
在预制件中引用：
local LANG_MAP = require("prefabs/foods_lang")
local LANG = LANG_MAP[language] or LANG_MAP.english
aipStory/ 目录包含故事文本的中文和英文版本，通过 require 加载。
Mod 使用统一的配方系统管理所有物品配方：
recpiesHooker.lua 是配方管理的核心文件：
local language = _G.aipGetModConfig("language")
local additional_weapon = _G.aipGetModConfig("additional_weapon") == "open"
local additional_survival = _G.aipGetModConfig("additional_survival") == "open"
根据配置决定是否启用配方：
local function recWeapon(...)
if not additional_weapon then
return
end
return rec(...)
end
local function rec(name, tech, filters, ingredients, placerOrConfig)
local config = {}
if type(placerOrConfig) == "table" then
config = placerOrConfig
else
config.placer = placerOrConfig
end
config.atlas = config.atlas or "images/inventoryimages/"..name..".xml"
AddRecipe2(name, ingredients, tech, config, filterNames)
AddRecipeToFilter(name, "AIP_FILTERS")
end
配方按类别组织：
recWeapon) - 需要启用武器选项recSurvival) - 需要启用生存选项recDress) - 需要启用服饰选项rec) - 不受分类限制基础武器配方：
recWeapon("aip_fish_sword", TECH.SCIENCE_TWO,
{ CRAFTING_FILTERS.WEAPONS },
{Ingredient("pondfish", 1), Ingredient("nightmarefuel", 2), Ingredient("rope", 1)})
建筑配方（带放置器）：
rec("aip_igloo", TECH.SCIENCE_TWO,
{ CRAFTING_FILTERS.STRUCTURES },
{Ingredient("ice", 21), Ingredient("carrot", 1), Ingredient("twigs", 2)},
"aip_igloo_placer")
自定义科技树配方：
recWeapon("aip_divine_rapier", TECH.AIP_DOU_TOTEM,
{ CRAFTING_FILTERS.WEAPONS, CRAFTING_FILTERS.MAGIC },
{
Ingredient("aip_oldone_hand", 1, "images/inventoryimages/aip_oldone_hand.xml"),
Ingredient("aip_living_friendship", 1, "images/inventoryimages/aip_living_friendship.xml"),
},
{ nounlock=true })
custom_tech_tree.lua 实现自定义科技树：
AddNewTechTree("AIP_DOU_SCEPTER") -- 神秘权杖科技树
AddNewTechTree("AIP_DOU_TOTEM") -- 联结图腾科技树
在预制件中添加科技树：
env.AddPrototyperDef("aip_dou_scepter", {
icon_atlas = "images/inventoryimages/aip_dou_tech.xml",
icon_image = "aip_dou_tech.tex",
is_crafting_station = true,
action_str = "SCULPTING",
filter_text = _G.STRINGS.UI.CRAFTING_STATION_FILTERS.SCULPTING,
})
Mod 使用自定义过滤器组织配方：
AddRecipeFilter({
name = "AIP_FILTERS",
atlas = "images/inventoryimages/aip_particles_bottle.xml",
image = "aip_particles_bottle.tex"
})
配方支持根据配置调整参数：
武器伤害和使用次数：
local USES_MAP = {
less = 200,
normal = 400,
much = 1000,
}
local DAMAGE_MAP = {
less = TUNING.NIGHTSWORD_DAMAGE / 68 * 22,
normal = TUNING.NIGHTSWORD_DAMAGE / 68 * 33,
large = TUNING.NIGHTSWORD_DAMAGE / 68 * 44,
}
local weapon_uses = aipGetModConfig("weapon_uses")
local weapon_damage = aipGetModConfig("weapon_damage")
TUNING.AIP_DIVINE_RAPIER_USES = USES_MAP[weapon_uses]
TUNING.AIP_DIVINE_RAPIER_DAMAGE = DAMAGE_MAP[weapon_damage]