转生系统使用说明¶
1. 系统概述¶
转生系统是 Mir3D 服务器的核心玩法之一，允许玩家在达到特定条件后进行“转生”。转生不仅是实力的象征，更能带来永久的属性提升、特殊的名字后缀以及专属的 Buff 加成。
本系统采用配置驱动设计，管理员可以通过修改 CSV 配置文件灵活调整转生的消耗、奖励和逻辑，无需修改服务器代码。
2. 玩家指南¶
2.1 转生收益¶
- 属性加成：每次转生都会增加永久的基础属性（如攻击、防御、体力等）。
- 专属称号：名字后会显示转生等级后缀，如
[1转]。 - 特殊 Buff：特定转生等级可解锁强力 Buff（需配置）。
- 等级重置：转生后等级可能会降低（视配置而定），体验重新升级的乐趣。
2.2 转生条件¶
转生通常需要满足以下一种或多种条件： * 角色等级：达到指定等级。 * 转生修为：拥有足够的转生修为值（通过经验兑换）。 * 货币消耗：金币或元宝。 * 物品消耗：特定的转生材料（如转生丹、证明书等）。
2.3 经验兑换修为¶
玩家可以将多余的经验值兑换为“转生修为”。 * 兑换方式：通过 NPC 对话进行兑换。 * 用途：转生修为是提升转生等级的核心资源。
3. 管理员配置¶
3.1 配置文件¶
转生系统的核心配置位于 System/Data/Rebirth/RebirthConfig.csv。
| 字段名 | 说明 | 示例 |
|---|---|---|
| RebirthLevel | 转生等级 (0-255) | 1 |
| NeedLevel | 需求角色等级 | 80 |
| NeedExp | 需求转生修为 | 100000 |
| NeedGold | 需求金币 | 1000000 |
| NeedGameGold | 需求元宝 | 100 |
| NeedItem | 需求物品名称 | 转生证明 |
| ItemCount | 需求物品数量 | 1 |
| DeLevel | 降级处理 (0=不降级, >0=降至该等级) | 1 |
| NameSuffix | 名字后缀 | (1转) |
| BuffID | 奖励 Buff ID (0=无) | 101 |
| BonusStats | 属性加成 (属性ID:值) | 4:10|5:10 |
3.2 GM 管理命令¶
管理员可以使用以下命令直接干预玩家的转生状态：
-
@设置转生等级
- 命令格式：
@设置转生等级 [玩家名] [等级] - 示例：
@设置转生等级 测试号 5 - 作用：直接将指定玩家的转生等级设置为目标值（0-255）。执行后会立即触发属性重新计算，如果玩家在线，名字后缀也会即时更新。
- 权限：管理员
- 命令格式：
-
@设置转生修为
- 命令格式：
@设置转生修为 [玩家名] [修为] - 示例：
@设置转生修为 测试号 10000 - 作用：直接将指定玩家的转生修为设置为目标值。用于处理数据异常或进行特殊补偿。
- 权限：管理员
- 命令格式：
-
@增加转生修为
- 命令格式：
@增加转生修为 [数量] - 示例：
@增加转生修为 5000 - 作用：给当前执行命令的管理员角色增加指定数量的转生修为（支持负数减少）。这是一个GM在线命令，只能由在线的管理员对自己使用。
- 权限：管理员
- 命令格式：
4. 脚本开发指南¶
4.1 变量支持¶
| 变量名 | 说明 |
|---|---|
<$REBORNLEVEL> |
玩家当前的转生等级 |
<$REBORNEXP> |
玩家当前的转生修为值 |
4.2 检测命令¶
-
CHECKREBORNLEVEL [操作符] [等级]
- 说明：检测玩家转生等级。
- 示例：
CHECKREBORNLEVEL > 5(检测是否大于 5 转)
-
CHECKREBORNEXP [操作符] [数值]
- 说明：检测玩家拥有的转生修为。
- 示例：
CHECKREBORNEXP >= 10000(修为是否足够 1万)
4.3 执行命令¶
-
REBORNUP
- 说明：执行转生升级逻辑。系统会自动检查 CSV 配置中的所有条件（等级、修为、金币、物品等），如果满足则扣除消耗并升级；如果不满足则提示错误。
- 示例：
REBORNUP
-
EXCHANGEREBORNEXP [消耗经验] [获得修为]
- 说明：将角色经验转换为转生修为。
- 示例：
EXCHANGEREBORNEXP 10000000 1000(扣除 1000万 经验，获得 1000 修为)
-
SHOWREBORNINFO
- 说明：向客户端发送下一级转生的详细需求信息（通常用于弹窗显示）。
- 示例：
SHOWREBORNINFO
5. 盟重省转生脚本解析 (Script Analysis)¶
以下是对 盟重省\6430-阿布.txt 脚本的详细解析，展示了如何使用上述命令构建一个完整的转生 NPC。
5.1 脚本功能概览¶
该脚本实现了一个名为“阿布”的转生 NPC，主要提供以下功能： 1. 信息展示：显示玩家当前的转生等级和修为。 2. 修为兑换：提供多个档位的经验兑换修为选项（10万、50万、100万）。 3. 转生升级：执行转生操作，并处理最高等级限制。 4. 需求查询：允许玩家查询下一级转生的详细需求。
5.2 核心代码片段解析¶
主界面与信息显示¶
[@MAIN]
#SAY
勇士 [<$角色名字>]，欢迎来到转生殿堂！<br>
当前转生等级：[<$REBORNLEVEL>] 转<br>
当前转生修为：[<$REBORNEXP>] 点<br>
...
<#SO:1>查询转生信息<#SO/><#SO:2>兑换转生修为<#SO/><#SO:3>进行转生升级<#SO/>...
<$REBORNLEVEL> 和 <$REBORNEXP> 变量动态显示玩家状态。
* 提供三个主要功能入口。
经验兑换修为¶
[@2_1]
#IF
#ACT
EXCHANGEREBORNEXP 100000 1
Break
#SAY
兑换成功！消耗10万经验，获得1点修为。<br>
当前转生修为：[<$REBORNEXP>] 点...
#ELSESAY
兑换失败！经验不足，需要10万经验。...
EXCHANGEREBORNEXP 100000 1 命令，尝试扣除 100,000 经验并增加 1 点转生修为。
* 命令内部会自动检查经验是否足够，若不足则跳转到 #ELSESAY（如果支持）或提示错误。在此脚本中，#IF 下直接调用，说明该命令可能在执行失败时会有返回值供 #IF 判断，或者脚本逻辑假设总是成功执行（注意：标准用法通常建议配合 CHECKEXP，但此命令设计为原子操作，可能自带检测）。注：根据脚本逻辑，这里直接调用，建议在 EXCHANGEREBORNEXP 前加上 CHECKEXP 以获得更友好的提示，或者依赖命令内部的提示。
转生升级与限制检查¶
[@3_1]
#IF
CHECKREBORNLEVEL >= 13
#ACT
Break
#SAY
你已经达到最高转生等级 [道祖境]，无法继续转生！...
D:\CQYH\Mir3D_Code_GitHub\Documentation\manual\mkdocs\docs\master\rebirth_system.md
#IF
#ACT
REBORNUP
Break
#SAY
转生成功！恭喜你完成转生！<br>
当前转生等级：[<$REBORNLEVEL>] 转...
#ELSESAY
转生失败！条件不足，请查看转生需求。...
CHECKREBORNLEVEL >= 13 检查是否达到最高等级（道祖境），防止溢出或错误操作。
* 使用 REBORNUP 命令尝试升级。该命令会自动读取 CSV 配置，检查所有条件（金币、材料等）。
* 如果 REBORNUP 执行成功，显示成功信息；失败则提示条件不足。
查询转生需求¶
* 调用SHOWREBORNINFO，向客户端发送专门的转生需求面板，展示下一级所需的具体材料和属性加成预览。
5.3 完整脚本参考¶
该脚本位于：Database\System\Envir\NPCs\Maps\盟重省\6430-阿布.txt