工程参考/配置文件/Public/StoreMapItem.txt
StoreMapItem.txt 定义藏宝图类物品：第 1 列是条目编号，第 2 到 5 列是物品大类、品质、子类型与地图索引，第 6 到 8 列是图标资源名与带 $1$ 占位符的名称、说明，第 9、10 列是等级需求与适用规则，第 11、12 列是目标点坐标，第 13 到 15 列是场景 ID、生长点类型与使用脚本。样本 1 条数据记录、15 列。
文件位置与生效
| 项目 | 说明 |
|---|---|
| 运行文件 | ../Public/Config/StoreMapItem.txt，相对于服务端工作目录；客户端从资源目录读取同名文件。
|
| 读取程序 | 客户端 GMDataBase.cpp 把 DBC_ITEM_STOREMAP（id 118）注册到 “StoreMapItem.txt”，Obj_Item.cpp 按编号查表生成藏宝图物品；服务端 ItemTable::InitStoreMapTable 通过 FILE_STORE_MAP_ITEM（../Public/Config/StoreMapItem.txt）加载 |
| 生效方法 | 正常保存并停服后，重启读取此文件的 Server；客户端需要随资源更新并重启客户端。当前检索未发现单独重载本文件的可用入口。 |
| 样本格式 | GB18030-compatible，CRLF。保留原编码；源码读取器不会自动把中文转为 UTF-8。
|
客户端结构 _DBC_ITEM_STOREMAP 只定义到第 10 列（nID、nClass、nQuality、nType、nIndex、szIcon、szName、szDesc、nLevelRequire、nRule），后面用注释 “//... NOT CARE” 标明客户端不关心；服务端 ItemTable::InitStoreMapTable 的枚举则覆盖第 1 到 15 列（TBIndex 到 TBUseScript），因此第 11 到 15 列是服务端专用的坐标、场景、生长点与脚本信息。
第 1 列是主键，两边都按它查询；第 2 列 6 对应藏宝图（客户端 IC_STOREMAP / ICLASS_STOREMAP 注释为“藏宝图”）。第 11、12 列是 FLOAT 坐标，写小数不要写成分数；这里只有 X 与 Z，没有 Y 坐标列。第 6 到 8 列是字符串，写入的是资源名与文本，不要用数字代替。
文件格式
首行是类型行：INT INT INT INT INT STRING STRING STRING INT INT FLOAT FLOAT INT INT INT；第二行是列名行，程序跳过其内容；从第三行开始读取数据。各列用真实 Tab 分隔，保留首列、空列及行尾，不用空格代替。数据行行首 # 表示注释，分号不是此表的注释规则。首列为空的行被跳过；不足的尾列补为空值，多余列不参与本页字段读取。空整数和非数字经 atoi 可能成为 0，空字符串仍为空，不把解析成功当作业务合法。第一列须唯一，重复会触发读取器错误。
字段详解
列号从 1 开始，源码列下标从 0 开始。
| 字段与类型 | 含义与修改要点 | 缺项或特殊值 |
|---|---|---|
第 1 列INT：index |
藏宝图条目编号（主键）。客户端 Obj_Item.cpp 与服务端都按它查询；不是物品在背包里的位置。 | 空首列使数据行被跳过；须唯一。 |
第 2 列INT：class |
物品大类。6 对应藏宝图（客户端 IC_STOREMAP / ICLASS_STOREMAP 注释为“藏宝图”）；样本第 2 列为 6。 | 空为 0。 |
第 3 列INT：quality |
物品品质。 | 空为 0。 |
第 4 列INT：type |
物品子类型，在大类之下再细分。 | 空为 0。 |
第 5 列INT：Mapindex |
地图索引，指向藏宝图对应的地图。 | 空为 0。 |
第 6 列STRING：资源 |
图标资源名，客户端结构里对应 szIcon；样本为 Ability_Creature_Cursed_01。 | 空表示没有图标资源。 |
第 7 列STRING：name$1$ |
物品名称，客户端结构里对应 szName；$1$ 是客户端格式化占位符，只供阅读。 | 空值原样存入。 |
第 8 列STRING：说明文字$1$ |
物品说明文字，客户端结构里对应 szDesc；$1$ 是客户端格式化占位符，只供阅读。 | 空值原样存入。 |
第 9 列INT：等级 |
使用或装备该藏宝图所需的等级，客户端结构里对应 nLevelRequire。 | 空为 0。 |
第 10 列INT：适应规则 |
适用规则编号，客户端结构里对应 nRule、服务端枚举为 TBRulerID。 | 空为 0。 |
第 11 列FLOAT：X坐标 |
藏宝图指向的目标点 X 坐标，浮点值。 | 空为 0。 |
第 12 列FLOAT：Z坐标 |
藏宝图指向的目标点 Z 坐标，浮点值。没有 Y 坐标列。 | 空为 0。 |
第 13 列INT：SceneID |
目标所在场景 ID，服务端枚举为 TBSceneID。与第 5 列地图索引不是同一个东西。 | 空为 0。 |
第 14 列INT：生长点类型 |
目标生长点的类型，服务端枚举为 TBGrowPointType。 | 空为 0。 |
第 15 列INT：脚本编号 |
使用该藏宝图时触发的脚本编号，服务端枚举为 TBUseScript。 | 空为 0。 |
常用修改实例
示例为局部教学片段，先备份原运行文件，再修改对应行并保留其余配置。教学值不是程序默认值。 以下代码块保留真实 Tab；本地示例文件保留原样本编码、中文表头与 CRLF。网页文字使用浏览器编码显示，不表示运行文件应改存 UTF-8。
把 60000001 号藏宝图的等级需求从 1 改成 2
修改前：
INT INT INT INT INT STRING STRING STRING INT INT FLOAT FLOAT INT INT INT index class quality type Mapindex 资源 name$1$ 说明文字$1$ 等级 适应规则 X坐标 Z坐标 SceneID 生长点类型 脚本编号 60000001 6 0 0 1 Ability_Creature_Cursed_01 太湖宝藏图 这是个藏宝图 1 6 10 10 4 10 5000
修改后：
INT INT INT INT INT STRING STRING STRING INT INT FLOAT FLOAT INT INT INT index class quality type Mapindex 资源 name$1$ 说明文字$1$ 等级 适应规则 X坐标 Z坐标 SceneID 生长点类型 脚本编号 60000001 6 0 0 1 Ability_Creature_Cursed_01 太湖宝藏图 这是个藏宝图 2 6 10 10 4 10 5000
按第一列定位 60000001 号条目（样本里唯一一条记录，“太湖宝藏图”）。样本第 9 列等级为 1，改为 2。只改第 9 列，保留 15 列。本片段含类型行、列名行与该行，不能覆盖整表。
该列是等级需求，改完需要重启服务端（客户端侧需要更新资源后重启）才会生效。
验证与排查
重启后在游戏里取得该藏宝图，核对名称、说明、图标与等级需求显示，再按藏宝图提示确认目标场景与坐标是否指向预期位置；服务端侧关注坐标、场景与脚本是否正确触发。样本只有一条记录，新增条目时编号不能与已有条目重复。失败时恢复备份并重启。
藏宝图专表
本表只描述藏宝图（生长点）这一类物品，普通物品不在这里登记；物品模板本身在 CommonItem.txt 一类表里。第 2 列 6 是藏宝图大类的取值依据（客户端 IC_STOREMAP / ICLASS_STOREMAP）。
客户端只用到前 10 列
客户端 _DBC_ITEM_STOREMAP 结构在第 10 列之后直接标注 “//... NOT CARE”，第 11 到 15 列的坐标、场景、生长点类型与脚本由服务端使用。改这几列不会影响客户端显示，但会影响服务端寻点。
两端都要同步
同一份文件被客户端与服务端读取；只更新一侧会出现“能看到图但寻点不对”或相反的情况。
关联与依据
Public/CommonItem.txt · Public/ItemRule.txt
其他配置及整理状态 · 服务端外网设置 · Lua 接口索引
Common/ServerBase/FileDef.h：实际加载、解析、字段使用或示例关联依据Server/Server/GameServer/Server/Item/ItemTable.cpp：实际加载、解析、字段使用或示例关联依据Client/Client/Common/TDDBC_Struct.h：实际加载、解析、字段使用或示例关联依据Client/Client/Game/DBC/GMDataBase.cpp：实际加载、解析、字段使用或示例关联依据Client/Client/Game/Object/Item/Obj_Item.cpp：实际加载、解析、字段使用或示例关联依据Client/Client/Game/Object/Item/Obj_Item_StoreMap.cpp：实际加载、解析、字段使用或示例关联依据resources/Public/Config/StoreMapItem.txt：实际加载、解析、字段使用或示例关联依据
本页核对 FileDef.h 的 FILE_STORE_MAP_ITEM、ItemTable::InitStoreMapTable 的列枚举（TBIndex 到 TBUseScript）、客户端 TDDBC_Struct.h 的 _DBC_ITEM_STOREMAP 结构与 DBC_ITEM_STOREMAP 注册项，以及 Obj_Item.cpp 的查表用法；未启动游戏、服务端或数据库，坐标与寻点效果需要实测。
