Menü
介绍 DST 额外物品包 mod 的文件结构。当用户询问 mod 结构、文件组织或想了解 mod 如何组织时调用。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
通过对比当前分支与合适基准引用（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]