Initial import of HEROLL source and design documents

2026-10-26 16:05:39 +08:00
commit fdb55672c1
1846 changed files with 290692 additions and 0 deletions
@@ -0,0 +1,117 @@
+# NPC好感与特殊养成商店：原作设计与规则
+
+版本：HEROLL 2.0.1 原作还原文档 v1.0。
+
+## 1. 功能定位
+
+NPC系统通过好感档改变对话、服饰与收益参数，并包含独立签到轮次和特殊养成商店。好感档与特殊商店的属性升级不能合并成一条等级。
+
+## 2. 主要状态
+
+下面是开发阅读所需的概念状态，属于开发映射，不要求与原作内部字段同名。
+
+| 状态 | 用途 |
+| --- | --- |
+| NPC好感档 | 决定对话服饰收益 |
+| 签到组轮次日序 | 决定当日奖励 |
+| 特殊属性等级 | 按商店条目记录 |
+
+## 3. 功能规则
+
+### 3.1 好感收益
+
+好感1配置金币收益参数1.1、钻石获得概率参数5及槽位品质数组。好感2对应1.2和10；对话性格与服饰也随档不同。金币收益与钻石概率不能使用同一个计算字段。
+
+### 3.2 NPC签到
+
+签到以组、轮次、开始日和日序定位奖励，与全局活动签到类型分开。
+
+### 3.3 特殊属性商店
+
+攻击升级条目权重30、基础增加1、增长1，等级上限字段-1。原表的两个金币字段注明不使用，因此本版不以它们写升级价格公式。
+
+## 4. 操作流程
+
+以下顺序用于拆解功能；涉及未确认的结算时机，以本章末尾具体缺口为准。
+
+1. 显示当前好感档与该档对话、服饰及收益。
+2. 签到按NPC签到轮次定位奖励。
+3. 特殊商店按升级项展示属性成长，与好感进度分开。
+
+## 5. 关键数值与计算
+
+| 项目 | 数值 | 状态 |
+| --- | --- | --- |
+| NPC好感1：金币倍率字段1.1、钻石获得概率字段5；缩放及生效时机仍需消费者 | likePoint=1；goldUP=1.1；diaUP=5；slotRarity=0,1,-1,2,-1；ingameDiscount=0 | 原作配置确认 |
+| 特殊商店攻击升级：权重30、基础与增量1；maxLevel=-1不自动解释无限 | isEnabled=True；probabilityWeight=30；baseAdditionalValue=1；additionalValue=1；maxLevel=-1 | 原作配置确认 |
+
+### NPC好感档（全表）
+
+| ID | 名称/键 | likePoint | 金币收益参数 | 钻石概率参数 | ingameDiscount |
+| --- | --- | --- | --- | --- | --- |
+| 0 | likePoint0 | 0 | 1 | 0 | 0 |
+| 1 | likePoint1 | 1 | 1.1 | 5 | 0 |
+| 2 | likePoint2 | 2 | 1.2 | 10 | 0 |
+| 3 | likePoint3 | 3 | 1.3 | 15 | 0 |
+| 4 | likePoint4 | 4 | 1.4 | 20 | 5 |
+| 5 | likePoint5 | 5 | 1.5 | 20 | 10 |
+| 6 | likePoint7 | 6 | 1.6 | 20 | 15 |
+
+### 特殊养成商店（全表）
+
+| ID | 名称/键 | 配置启用标志 | probabilityWeight | baseAdditionalValue | additionalValue | 等级上限（负值语义需消费者） |
+| --- | --- | --- | --- | --- | --- | --- |
+| 1 | 攻击力修练 | True | 30 | 1 | 1 | -1 |
+| 2 | 防禦力修练 | True | 30 | 0.3 | 0.3 | -1 |
+| 3 | 生命值修练 | True | 30 | 6 | 6 | -1 |
+| 4 | 命中率修练 | True | 30 | 2 | 2 | -1 |
+| 5 | 迴避率修练 | True | 30 | 5 | 5 | -1 |
+| 6 | 背包最佳化 | True | 10 | 0.2 | 0.2 | 10 |
+| 7 | 複製药水 | True | 10 | 6 | 1 | 10 |
+| 8 | 闪电呼唤 | True | 10 | 11 | 1 | 10 |
+
+## 6. 原作中文内容
+
+中文名称和效果使用原作文本；{0}、{B}等占位符未确认绑定时保留，文字不能代替参数公式。
+
+| 来源表 | ID | 名称 | 效果/条件文本 |
+| --- | --- | --- | --- |
+| deokjashop | 1 | 攻击力修练 | 于竞技场使勇士的攻击力 / 永久增加{0}。 |
+| deokjashop | 2 | 防禦力修练 | 于竞技场使勇士的防禦力 / 永久增加{0}。 |
+| deokjashop | 3 | 生命值修练 | 于竞技场使勇士的生命值上限 / 永久增加{0}。 |
+| deokjashop | 4 | 命中率修练 | 于竞技场使勇士的命中率 / 永久增加{0}。 |
+| deokjashop | 5 | 迴避率修练 | 于竞技场使勇士的迴避率 / 永久增加{0}。 |
+| deokjashop | 6 | 背包最佳化 | 可携带药水的重量上限 / 增加{0}。 |
+| deokjashop | 7 | 複製药水 | 使用药水时， / 以{0}%机率不消耗药水。 |
+| deokjashop | 8 | 闪电呼唤 | 使用药水时， / 以{0}%机率召唤闪电。 / (伤害：攻击力的{1}%) |
+
+## 7. 开发权威表
+
+| 配置用途 | 权威原字段表 | 记录数 | 开发阅读表 |
+| --- | --- | --- | --- |
+| NPC好感档 | [deoksun.csv](./deoksun.csv) | 7 | [中文目录](./deoksun-中文目录.csv) |
+| NPC签到轮次 | [deoksunattendance.csv](./deoksunattendance.csv) | 28 | [中文目录](./deoksunattendance-中文目录.csv) |
+| 特殊养成商店 | [deokjashop.csv](./deokjashop.csv) | 8 | [中文目录](./deokjashop-中文目录.csv) |
+
+[执行规则](./执行规则.csv) · [状态字段](./状态字段.csv) · [验收样例](./验收样例.csv) · [字段字典](./字段字典.csv) · [关联全局配置](./关联全局配置.csv)
+
+全局键按模块名称关联收录；其具体含义优先以正文已确认的规则为准。
+
+| 配置键 | 原值 |
+| --- | --- |
+| DeokjaShopCoinNeed | 1000, 500, 20000 |
+
+## 8. 开发验收与禁止误写
+
+| 输入 | 检查内容 | 预期 |
+| --- | --- | --- |
+| 读取deoksun中StringId=likePoint1 | 查询本条配置并核对界面/配置输出 | likePoint=1；goldUP=1.1；diaUP=5；slotRarity=0,1,-1,2,-1；ingameDiscount=0 |
+| 读取deokjashop中StringId=attackUpgrade | 查询本条配置并核对界面/配置输出 | isEnabled=True；probabilityWeight=30；baseAdditionalValue=1；additionalValue=1；maxLevel=-1 |
+
+验收样例覆盖已经确认的值；流程中的未知分支不能以本表通过代替规则确认。数值表内的空值、0和-1分别保留；升级数组不默认使用玩家等级作为索引。
+
+## 9. 当前待补充边界
+
+好感获得方式、收益缩放、特殊商店实际价格和-1上限的语义尚待确认。
+
+[返回总纲](../局外玩法设计文档_HEROLL_原作_v1.0.md) · [阅读规范](../文档规范与阅读说明.md)