雪舞：维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态

2026-09-10T07:53:46Z

维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态

新页面

{{DISPLAYTITLE:工程参考/配置文件/Public/RandShop}}
__NOTOC__
<div class="config-file-reference" style="max-width:1200px;margin:0 auto;line-height:1.8;color:#29343a;font-family:Arial,'Microsoft YaHei',sans-serif;letter-spacing:0;overflow-wrap:anywhere;">
[[首页|首页]] · [[工程参考/配置文件索引|配置文件索引]] · [[工程参考/配置文件修改约定|修改约定]]

RandShop 目录是随机 NPC 商店的商品池。ShopTable 只决定哪家店随机、抽出几件、用哪种货币；具体候选物品在对应 INI。15 个样本文件共用同一套读取规则，集中在本页说明。不要按文件名猜测用途，也不要把未引用的 petskillshop.ini 当成已上架商店。

[[#文件位置与生效|位置与生效]] · [[#文件格式|文件格式]] · [[#字段详解|字段详解]] · [[#常用修改实例|修改实例]]

== 文件位置与生效 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | 项目
! scope="col" style="width:76%;text-align:left;background:#edf3f2;padding:8px;" | 说明
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 运行文件
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">../Public/Config/RandShop/</code> 下各 INI，路径写在 ShopTable 第 14 列，相对于 Server 工作目录。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Server 在 ShopTable 第 13 列非 0 时按第 14 列路径加载；NPC 场景 shop0..shop3 绑定后抽选上架
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 生效方法
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 与 ShopTable 一起备份。停服后修改实际 Public 副本，再重启 Server。当前检索范围未发现独立重载。客户端不读这些 INI。改权重后须重新绑定或刷新动态商店才抽新列表。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 样本格式
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GB18030-compatible</code>，<code style="white-space:normal;overflow-wrap:anywhere;">CRLF</code>。保留原编码；源码读取器不会自动把中文转为 UTF-8。
|}

=== 怎样接到 ShopTable ===
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | ShopTable 列
! scope="col" style="width:76%;text-align:left;background:#edf3f2;padding:8px;" | 对随机店的作用
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 13 列非 0
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 跳过表内 50 组商品，改读第 14 列 INI。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 14 列路径
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 例如 ../Public/Config/RandShop/60wufang.ini，大小写按实际路径。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 12 列 Num
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 抽出件数 nCountForSell，不是 INI 的 Total。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 第 8 列货币
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 金币/交子仍用物品基础价；善恶值等用 INI 的 Value。
|}

加载时按 [General] Total 读取 Merchandise0..Merchandise(Total-1)。随后 NPC 初始化若填写 shop0..shop3，会复制该店并按权重抽出 Num 件上架。只调用 DispatchShopItem 打开静态表、NPC 没有动态商店时，随机店货架标记全为未出售，结果是空店。

=== 系列成员 ===
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="width:34%;text-align:left;background:#edf3f2;padding:8px;" | 文件
! scope="col" style="width:42%;text-align:left;background:#edf3f2;padding:8px;" | 商店编号与货币
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | 样本要点
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/60wufang.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店 75，1 金币
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 14，抽出 5，Odds；60 级武防图样池
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/70wufang.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店 76，1 金币
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 24，抽出 10，Odds；70 级武防图样池
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/80wufang.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店 77，1 金币
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 38，抽出 15，Odds；80 级武防图样池
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/90wufang.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店 78，1 金币
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 52，抽出 20，Odds；90 级武防图样池
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/100wufang.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店 79，1 金币
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 66，抽出 25，Odds；100 级武防图样池
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/randgemshop.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店 101，1 金币
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 20，抽出 5，Odds；随机宝石
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/dazaotu.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店 103，1 金币
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 80，抽出 5，Odds；打造图
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/shanedian.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店 104，2 善恶值
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 84，抽出 10，Odds；善恶值商品；购买用显式 Value
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/xunluozawu.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店 105，1 金币
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 21，抽出 5，混用；Merchandise0 为 odds，其余为 Odds
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/shide.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店 106，2 善恶值
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 9，抽出 5，odds；键名全小写；Total=9 但还有 Merchandise9
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/miaojiang_randgemshop.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店 109，1 金币
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 6，抽出 3，Odds；苗疆宝石，Rebate=7
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/qiongzhou_randgemshop.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店 110，1 金币
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 9，抽出 3，Odds；琼州宝石
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/huanglong_randgemshop.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店 111，1 金币
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 5，抽出 3，Odds；黄龙宝石，Rebate=7
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/shuhe_randgemshop.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店 186，1 金币
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 20，抽出 2，Odds；蜀河宝石
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Public/RandShop/petskillshop.ini</code>
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 商店无，—
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Total 9，抽出 —，Odds；当前 ShopTable 未引用
|}

== 文件格式 ==
使用 [节名] 与 Key=Value，节名和键名区分大小写，保持节标题位于行首。用单独一行分号写注释，保留原编码及 CRLF 换行；重复节或键取先匹配项，不依赖后写覆盖。缺项、空值与 0 分别按下表处理。

== 字段详解 ==
模板 [n] 表示从 0 开始的序号，写入时应展开为实际数字；不是字面键名。

=== [General] ===
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="width:34%;text-align:left;background:#edf3f2;padding:8px;" | 字段与类型
! scope="col" style="width:42%;text-align:left;background:#edf3f2;padding:8px;" | 含义与修改要点
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | 缺项或特殊值
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Total</code> 整数，商品池条数
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 循环 0..Total-1 读取对应 Merchandise 节。样本须从 0 连续编号。超过 1024 先截成 1024，再按 BYTE 作为列表长度，256 会变成 0。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 缺项断言失败。shide.ini 写 Total=9 却另有 Merchandise9，第 10 条不会加载。
|}

=== [Merchandise[n]] ===
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="width:34%;text-align:left;background:#edf3f2;padding:8px;" | 字段与类型
! scope="col" style="width:42%;text-align:left;background:#edf3f2;padding:8px;" | 含义与修改要点
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | 缺项或特殊值
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">ID</code> 整数，物品模板编号
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | n 从 0 到 Total-1。须能在对应物品表查到。不是商店编号、GUID 或背包格。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 缺项断言。0 会在后续类型解析中视为空物品。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">CountPerUnit</code> 整数，每单位件数
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 一次购买得到的件数。金币/交子计价再乘该件数。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 缺项断言。小于 0 改为 1，大于 100 改为 100。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Count</code> 整数，库存上限
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 加载后的有限库存。0 改为 -1 表示不按有限库存。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 缺项断言。静态下发 MaxNumber 仍为 -1，有限库存主要在动态店。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Odds</code> 字符串再转浮点，相对权重
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 键名必须是 Odds。抽选权重为 AppearRate×rand()。读不到则为 0。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 大小写敏感。shide.ini 与 xunluozawu.ini 的 Merchandise0 写成 odds，当前读成 0。缺项不断言，权重为 0。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Value</code> 整数，显式单价
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 善恶值等非金币/交子货币使用本值。金币/交子购买忽略它，改用物品基础价。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 缺项断言。60wufang 的 1000 不会改金币价。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">Rebate</code> 整数，折扣分母
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 缺项或非正数按 100。BuyRate=100/Rebate，再参与售价。样本部分宝石店为 7。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 不是百分比写法。0 或负数记日志后改回 100。
|}

== 常用修改实例 ==
示例为局部教学片段，先备份原运行文件，再修改对应行并保留其余配置。教学值不是程序默认值。

=== 把 60 级武防随机池第一件图样的出现权重从 1 改为 10 ===
修改前：
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">[General]
Total=14
[Merchandise0]
ID=30300006
Count=1
CountPerUnit=1
Odds=1
Value=1000</pre>

修改后：
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">[General]
Total=14
[Merchandise0]
ID=30300006
Count=1
CountPerUnit=1
Odds=10
Value=1000</pre>

在完整 60wufang.ini 中定位 [Merchandise0]，确认 ID=30300006（金顶枣阳槊图样）。只把 Odds=1 改成 Odds=10，保留 Count、CountPerUnit、Value、Total=14 以及 Merchandise1..13。键名必须是 Odds，不能写成 odds。本片段去掉了原行尾中文注释，编辑原文件时保留注释和编码。

该文件由 ShopTable 商店 75 引用，货币为金币，抽出数量 5。Odds 是相对权重，只有 NPC 绑定动态商店并执行抽选后才影响哪 5 件出现；金币购买仍用物品基础价 6000，不读 Value=1000。隔离加载确认该条 AppearRate 由 1 变为 10。实际窗口和每次刷新结果需要实测。

== 验证与排查 ==
启动无 RandomShop 读取断言。商店 75 池 14 条、抽出 5，Merchandise0 的 Odds 为 10。NPC 须在场景初始化 shop0..shop3 绑定 75 后打开，确认图样仍在池中且权重变化。odds 小写不会生效。空店先查是否走了静态表而不是动态店。恢复 INI 与 ShopTable 后重启。

=== 抽选 ===
权重为 Odds×rand()，选出 Num 件。全为 0 时比较用严格大于，结果是池中前 Num 件。不能把单次刷新当成概率证明。

=== 键名 ===
节名、键名大小写必须与源码一致：General、Merchandise0、Odds、Rebate。IniFile 用 strncmp，odds 不等于 Odds。

=== 未引用文件 ===
petskillshop.ini 当前检索范围未发现 ShopTable 或其他启动路径引用。只有把第 14 列指过来才会加载。

打开接口仍是 [[Lua接口/服务端/DispatchShopItem|DispatchShopItem]]，ShopId 是 ShopTable 第一列，不是 INI 文件名。

== 关联与依据 ==
[[工程参考/配置文件/Public/ShopTable.txt|Public/ShopTable.txt]] · [[工程参考/配置文件/Public/ShopSceneLimiti.txt|Public/ShopSceneLimiti.txt]] · [[工程参考/配置文件/Public/CommonItem.txt|Public/CommonItem.txt]]

[[工程参考/配置文件索引|其他配置及整理状态]] · [[工程参考/服务端外网设置|服务端外网设置]] · [[Lua接口/服务端函数索引|Lua 接口索引]]

* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Other/ShopManager.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Other/ShopManager.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Obj/Obj_Monster.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Obj/MonsterManager.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/ServerBase/Ini.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/ServerBase/Ini.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/ServerBase/FileDef.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/GameDefine2.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/60wufang.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/70wufang.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/80wufang.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/90wufang.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/100wufang.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/randgemshop.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/dazaotu.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/shanedian.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/xunluozawu.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/shide.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/miaojiang_randgemshop.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/qiongzhou_randgemshop.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/huanglong_randgemshop.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/shuhe_randgemshop.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/RandShop/petskillshop.ini</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">resources/Public/Config/ShopTable.txt</code>：实际加载、解析、字段使用或示例关联依据

原始 IniFile 与 LoadRandShopFromIni 隔离测试，覆盖 Total、Odds 大小写、缺 Rebate 与显式 Rebate。抽选、NPC 绑定和购买为源码核对；未启动游戏。
</div>
[[Category:工程参考]]

工程参考/配置文件/Public/RandShop - 版本历史

雪舞：​维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态

雪舞：维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态