更新日志¶

本文档记录了小丑引擎的所有重要更新、修复和优化内容。

v2.7.17 (2026-02-26)¶

✨ 新功能¶

玛法探宝 — 罗盘系统¶

新增罗盘寻宝玩法。通过活动获得蒙尘的罗盘，擦拭后获得普通罗盘或秘藏罗盘，按指引前往指定地图坐标寻宝，可获得经验、宝箱、怪物或物品等奖励。

v2.7.16 (2026-02-22)¶

✨ 新功能¶

天下第一称号系统优化¶

优化天下第一称号申请逻辑，确保称号唯一性和申请流程合理性。

核心改进¶

战力检测优化
修改战力判断条件从 > 改为 >=
允许当前战力第一的玩家申请称号（即使还未申请）
解决"我是第一但无法申请"的问题
称号唯一性保障
新增 DelTitleEx 命令支持删除指定玩家的称号
申请成功时自动剥夺上一任天下第一的称号
防止多人同时拥有同一天下第一称号
重复申请拦截
增加 CheckHaveTitle 检测，已拥有称号的玩家无法重复申请
提示"你已经是天下第一了，无需重复申请"

天下第一称号编号¶

职业	称号编号	称号名称	排行榜编号
战士	151	战士之王	7
法师	152	法神	8
道士	153	道尊	9
刺客	154	暗影之主	10
弓手	155	神射手	11
龙枪	156	龙战士	37

申请流程示例（法师）¶

方案1：使用 CHECKCALC 比较变量（当前实现）

#IF
CheckClass 法师
CheckTitle 152
#ACT
Break
#SAY
你已经是天下第一法师了！<br>无需重复申请称号。

#IF
CheckClass 法师
CHECKCALC <$PLAYERCOMBAT> >= <$TOP1_法师_战力>
#ACT
DelTitleEx <$TOP1_法师_名字> 152
GiveTitle 152 0
UseTitle 152
NowVarSort 8 1
SENDMSG 5 恭喜<$USERNAME>成为天下第一法师！
GlobalMessage "恭喜<$USERNAME>成为天下第一法师！战力值：<$PLAYERCOMBAT>" TRUE

方案2：使用检测玩家战力命令（固定值判断）

#IF
CheckClass 法师
检测玩家战力 >= 5000
#ACT
GiveTitle 152 0
UseTitle 152
#SAY
恭喜你成为天下第一法师！

两种方案对比： - 方案1：动态比较排行榜数据，适合竞争性称号系统 - 方案2：固定战力门槛，适合成就类称号系统

系统变量¶

天下第一排行榜变量（按职业）

职业	名字变量	战力变量	说明
战士	`<$TOP1_战士_名字>`	`<$TOP1_战士_战力>`	当前天下第一战士的信息
法师	`<$TOP1_法师_名字>`	`<$TOP1_法师_战力>`	当前天下第一法师的信息
道士	`<$TOP1_道士_名字>`	`<$TOP1_道士_战力>`	当前天下第一道士的信息
刺客	`<$TOP1_刺客_名字>`	`<$TOP1_刺客_战力>`	当前天下第一刺客的信息
弓手	`<$TOP1_弓手_名字>`	`<$TOP1_弓手_战力>`	当前天下第一弓手的信息
龙枪	`<$TOP1_龙枪_名字>`	`<$TOP1_龙枪_战力>`	当前天下第一龙枪的信息

玩家信息变量

变量	说明	用途
`<$PLAYERCOMBAT>`	当前玩家的战力值	用于战力比较
`<$USERNAME>`	当前玩家的角色名	用于消息显示

随机属性转移系统 — 新增脚本命令¶

新增一套完整的随机属性转移与剔除脚本命令，支持中文命令名称。

执行命令（#ACT）¶

命令	格式	说明
`装备转移随机属性`	`装备转移随机属性背包格位部位名称`	将背包装备的随机属性转移到身上装备
`装备删除随机属性`	`装备删除随机属性词条索引部位名称`	按索引（0-3）删除身上装备的随机属性词条
`装备转移并删除`	`装备转移并删除背包格位部位名称`	转移属性后自动删除背包装备（含保护检查）

检测命令（#IF）¶

命令	格式	说明
`检测是否穿戴装备`	`检测是否穿戴装备部位名称`	检测指定部位是否穿戴装备
`检测背包格位`	`检测背包格位格位物品分类`	检测背包格位是否为指定类型装备
`检测背包随机属性`	`检测背包随机属性格位`	检测背包格位装备是否有随机属性
`检测转移随机类型`	`检测转移随机类型格位部位名称`	预检查属性能否转移（类型冲突/数量上限）

系统变量¶

变量	说明
`<$随机属性数量(部位)>`	获取身上装备的随机属性词条数量（0-4）
`<$随机属性N描述(部位)>`	获取第N条随机属性的文字描述（N=1-4）

装备转移并删除 — 保护检查¶

执行前自动检查背包装备的特殊属性（灵魂绑定、铸魂、神佑、祈祷、灵石、升级、精炼、铭文、绑定、锁定），任一命中则中止并提示玩家。

地图禁止使用物品¶

地图数据新增 禁止使用物品 字段，支持配置地图内禁止使用的物品列表
玩家在该地图使用被禁止的物品时，系统提示"当前地图禁止使用该物品"

NPC脚本 CheckType 中文指令扩展¶

新增4个检测命令的中文别名，与已有英文指令功能一致：

中文命令	对应英文	说明
`检测是否穿戴装备`	CheckWearEquip	检测指定部位穿戴
`检测背包格位`	CheckBagSlot	检测背包格位装备类型
`检测背包随机属性`	CheckBagRandomAttr	检测背包装备随机属性
`检测转移随机类型`	CheckTransferType	检测属性转移可行性

🐛 修复¶

NPC对话选项点击无反应¶

修复脚本中使用 检测判断 做数值比较时静默失败的问题
原因：检测判断 映射到 CheckType.Check（任务标识检测），不支持三参数数值比较
修复：将脚本中 90 处 检测判断 替换为 检测计算（CHECKCALC），支持 左值操作符右值 格式

📝 文档¶

新增随机属性转移系统使用说明，含命令详解、参数说明、与已有命令对比、完整脚本示例
新增 NPC脚本命令对比分析文档

v2.7.15 (2026-02-22)¶

🔒 安全¶

动态混淆与完整性校验¶

每次 Release 构建自动随机生成混淆种子和混淆等级，增加逆向破解难度
程序启动时执行运行时完整性校验，验证失败静默退出
新增一键安全构建脚本

IP登录限制¶

封堵IP伪造漏洞，不再信任客户端声明的IP，统一使用TCP连接真实IP
新增同IP在线角色数限制，超过上限拒绝进入游戏
修复IPv6场景下IP解析错误

配置项 (Setup.ini → [General])¶

配置项	类型	默认值	说明
启用IP登录限制	bool	true	是否启用同IP角色数限制
单IP最大角色数	int	2	同一IP最多几个角色同时在线（最小值1）

🐛 修复¶

挂机铭文技能双重伤害¶

新版挂机系统中同一技能编号的铭文版和无铭文版均被执行，造成双重伤害
受影响技能：半月弯刀、疾光电影、寒冰咆哮、火墙真红印、逐日开疆印、野蛮冲撞等

元素王座副本¶

修复元素王座副本（冰之王、岩之王、虚空之王）相关逻辑问题

🧹 优化¶

御兽拖动调试日志改为受开关控制，减少日志输出量
移除不再需要的测试部署脚本

v2.7.14 (2026-02-12)¶

✨ 新功能¶

雕色石配置系统¶

CSV配置支持: 新增雕色石消耗配置文件 Database/System/物品数据/雕色石配置.csv，支持灵活配置不同颜色转换的消耗数量
配置热重载: 支持通过"重载灵石相关"按钮热更新配置，无需重启服务器
颜色转换矩阵: 支持9种孔洞颜色（无孔、红、黄、蓝、绿、紫、灰、橙、褐）之间的自由转换
消耗数量自定义: 每种颜色转换可独立配置雕色石消耗数量（0-255个）

配置文件格式¶

列名	说明
CurrentColor	当前孔洞颜色编号 (0-8)
ToRed	改为红色需要的雕色石数量
ToYellow	改为黄色需要的雕色石数量
ToBlue	改为蓝色需要的雕色石数量
ToGreen	改为绿色需要的雕色石数量
ToPurple	改为紫色需要的雕色石数量
ToGray	改为灰色需要的雕色石数量
ToOrange	改为橙色需要的雕色石数量
ToBrown	改为褐色需要的雕色石数量

默认配置特点¶

黄色万能: 任何颜色改为黄色统一只需10个雕色石
黄色起点: 从黄色改为任何颜色也只需10个雕色石
稀有色高消耗: 绿色、灰色、褐色互转最高需235个雕色石
单孔优惠: 单孔装备改为黄色只需5个（系统特殊处理）

🔧 优化¶

程序关闭流程优化¶

状态标志管理: 新增 _正在执行关闭流程 和 _允许窗体关闭 标志，防止重复触发关闭流程
智能关闭判断: 区分服务运行中和已停止两种状态，提供不同的关闭提示
异步等待机制:
等待服务器主线程结束(): 带超时（120秒）和进度日志的线程等待
等待自动保存结束(): 确保数据保存完成，每5秒输出等待进度
数据完整性保障:
执行最终数据导出(): 确保数据完整保存并导出到本地
失败时不强制关闭，给用户处理机会
WebAPI优雅关闭: 新增 Program.停止WebAPI服务Async() 方法，支持带超时的优雅关闭
按钮状态恢复: 失败时自动恢复启动、停止、保存按钮的可用状态
错误处理增强: 完善异常捕获和日志记录，提供详细的错误提示

修改文件¶

GameServer_Dev/窗口/主窗口.cs - WinForms主窗口关闭逻辑
GameServer_Dev/窗口/SMain.cs - DevExpress主窗口关闭逻辑
GameServer_Dev/杂项/Program.cs - WebAPI服务停止方法

📝 文档¶

新增雕色石系统完整文档（配置说明、技术实现、消耗逻辑分析）
新增程序关闭崩溃问题修复记录文档

v2.7.13 (2026-02-03)¶

✨ 新功能¶

装备属性系统重构¶

怪物极品概率覆盖: 支持在怪物配置中单独设置极品装备概率和词条数量概率，覆盖装备属性默认配置
套装属性屏蔽: 支持在装备属性配置中指定某些属性不出现在特定套装装备上

怪物配置新增字段¶

字段	类型	说明
极品装备概率	float	0~1，0表示使用装备属性默认值
生成一条属性概率	int	百分比，四项总和应为100
生成两条属性概率	int	百分比
生成三条属性概率	int	百分比
生成四条属性概率	int	百分比

配置完整性校验¶

加载期警告: 怪物加载时自动校验极品概率配置完整性
配置了极品概率但未配置词条概率时，输出提示日志
词条概率总和非100时，输出提示日志

🐛 修复¶

装备属性系统¶

热重载竞态条件: 修复运行时热重载配置时可能使用旧概率表的竞态条件

📝 文档¶

新增装备属性系统使用指南 (guide/装备属性系统.md)

v2.7.12 (2026-01-31)¶

✨ 新功能¶

技能编辑器¶

主编辑器: 新增主编辑器，用于统一管理技能、符文、Buff、陷阱等多种技能相关配置
配置编辑器入口: 实现打开各配置编辑器的命令，提升使用便捷性与工作流
数据目录: 编辑器改为从固定目录读取数据，优化文件管理与结构
界面说明: 为各编辑器补充清晰描述，便于用户理解与使用

v2.7.11 (2026-01-24)¶

✨ 新功能¶

沙巴克攻城系统增强¶

多种攻沙模式: 新增4种攻沙模式配置，满足不同运营需求

模式	说明	参战行会
0-报名模式	今天报名，明天攻城	仅报名行会
1-指定日期	单次指定日期攻沙	所有行会
2-每天攻沙	每天固定时间攻沙	所有行会
3-每周攻沙	每周固定星期几攻沙	所有行会

UI配置界面: 新增攻沙模式下拉框和星期选择控件
NPC脚本变量: 新增 <$攻沙模式>、<$攻沙模式名称>、<$攻沙星期> 变量
攻城取消公告: 无行会参战时发送"沙巴克攻城战因无行会参战而取消"公告

NPC脚本命令汇总¶

命令类型	命令	说明
检测	`IsCastleWar`	检测当前是否攻城状态
检测	`CheckCalc <$CASTLEGUILD> == <$GUILDNAME>`	检测是否沙城成员
检测	`CheckCalc <$CASTLELORD> == <$USERNAME>`	检测是否沙城城主
执行	`StartCastleWar`	开启攻城战
执行	`StopCastleWar`	关闭攻城战

配置示例 (Setup.ini)¶

[General]
攻沙模式=3
攻沙星期=6
攻沙开始时间小时=20
攻沙开始时间分钟=0
攻沙结束时间小时=22
攻沙结束时间分钟=0

🐛 修复¶

玩家系统¶

出售物品逻辑: 修复出售物品时的逻辑问题
挖矿骑乘处理: 优化挖矿时的骑乘状态处理

v2.7.10 (2026-01-18)¶

✨ 新功能¶

外挂验证系统完善¶

验证通过双重提示: 验证通过后同时发送系统消息（右下角）和顶部公告（屏幕顶部），绿色显示"验证通过"
NPC脚本命令支持: 新增5个验证系统动作命令和3个检测命令

动作命令¶

命令	英文命令	参数	说明
延期验证	DELAYVERIFY	[分钟数]	VIP玩家延期验证时间
跳过验证	SKIPVERIFY	无	VIP玩家跳过当前验证
重置验证失败	RESETVERIFYFAIL	无	重置验证失败次数
设置验证开关	SETVERIFY	[0/1]	管理员设置验证豁免
清除验证失败	CLEARVERIFYFAIL	无	管理员清除验证失败次数

检测命令¶

命令	英文命令	参数	说明
检测验证状态	CHECKVERIFY	无	检测玩家是否正在验证中
检测今日延期次数	CHECKDELAYCOUNT	[比较符] [次数]	检测今日延期次数
检测验证失败次数	CHECKVERIFYFAIL	[比较符] [次数]	检测验证失败次数

NPC脚本示例¶

[@验证服务]
#IF
检测验证状态
#ACT
Break
#SAY
您当前正在进行安全验证！<br>请回答验证问题，或使用以下功能：<#SO:1>跳过当前验证<#SO/>
#ELSESAY
这里是安全验证服务~<br>您可以延期验证时间！<#SO:2>延期验证(2倍时间)<#SO/><#SO:3>重置失败次数<#SO/>

[@验证服务_1]
#ACT
跳过验证
goto @验证服务
Break

[@验证服务_2]
#ACT
延期验证 120
#SAY
验证时间已延期120分钟！<br>请安心游戏~

[@验证服务_3]
#ACT
重置验证失败
#SAY
验证失败次数已重置！

持久化字段¶

今日验证延期次数: 记录玩家今日使用延期功能的次数
验证延期重置日期: 跨天自动重置延期次数
验证豁免开关: 管理员设置的验证豁免标志

v2.7.9 (2026-01-12)¶

✨ 新功能¶

怪物跑动系统¶

怪物能否跑动: 新增怪物跑动配置，支持BOSS等特殊怪物追击时跑动
跑动BUFF编号: 跑动时自动添加指定BUFF，停止跑动时自动移除
奔跑速度属性: 怪物支持独立的奔跑速度配置（属性编号19）

怪物数据配置示例¶

{
  "怪物名字": "血手",
  "怪物编号": 350,
  "怪物能否跑动": true,
  "跑动BUFF编号": 15098,
  "怪物基础": [
    { "属性": 18, "数值": 13 },
    { "属性": 19, "数值": 11 }
  ]
}

属性说明¶

属性	编号	说明
行走速度	18	怪物行走时的移动速度
奔跑速度	19	怪物跑动时的移动速度

v2.7.8 (2026-01-11)¶

🐛 修复¶

伤害计算优化¶

减伤计算模式改进: 将减伤计算从相加模式改为相乘模式
旧模式: 减伤效果简单相加，可能导致100%减伤
新模式: 减伤效果相乘叠加，确保总是有伤害穿透
设置最低伤害阈值，防止零伤害情况

玩家复活系统对齐¶

复活方式参数支持:复活代码逻辑完善
支持多种复活方式: 回城复活(方式3)、原地复活(消耗镇魔秘药)
根据地图配置(秘药使用属性)发送不同的复活选项
物品ID 100001 (镇魔秘药) 用于原地复活消耗

🧹 清理¶

移除多个无用的文档和分析文件

v2.7.7 (2026-01-10)¶

✨ 新功能¶

沙巴克系统增强¶

巅峰城主雕像功能: 增强城主雕像功能和日志记录
城主雕像显示当前占领行会信息
添加详细的操作日志便于调试
沙巴克公告栏: 新增沙巴克公告栏功能
支持查看沙巴克相关公告
城主发福利功能: 新增城主发放福利的功能
城主可向行会成员发放奖励

掉落系统优化¶

无归属掉落支持: 更新掉落逻辑以支持无归属掉落
特定场景下物品掉落无归属限制
铭文格式验证: 添加铭文格式验证功能
自动验证铭文配置格式正确性
更新相关日志记录

NPC系统增强¶

守卫实例优化: 增强守卫实例和NPC生成逻辑
添加调试日志便于问题排查

🧹 清理¶

移除多个无用的配置和分析文档
精简城主雕像相关逻辑代码
删除无用代码并更新沙巴克攻城命令

v2.7.6 (2026-01-05)¶

✨ 新功能¶

游戏服务器管理界面增强¶

怪物视图功能: 新增怪物视图导航链接，在 MonsterView.cs 中添加复活时间的格式化显示
增强用户界面功能，提供更丰富的游戏信息展示
支持查看怪物复活时间信息
龙卫配置视图: 新增龙卫配置视图及相关界面元素
在 SMain.cs 中新增龙卫配置视图的链接处理逻辑
添加相应的导航栏项和图标资源（SMain.resx）
提供完整的龙卫配置管理界面

🐛 修复¶

珍宝商店配置标准化¶

字段规范化: 统一珍宝商品配置文件字段格式，移除旧字段，采用标准字段结构
字段变更: 从旧字段限量数量迁移到新字段限量份数（代码自动兼容转换）
字段精简: 保留必要的核心字段，移除不必要的未知参数字段
修复无效值: 将补充参数=63（无效值）修复为标准限定职业值（0-6）
影响范围: 所有43个珍宝商品配置文件已完成字段标准化
修复普通商品过期问题: 修复活动页面=0的普通商品因设置了具体活动时间导致客户端误判过期的问题
问题原因: 客户端可能检查活动时间，即使服务端只在活动页面=1时检查
解决方案: 将所有活动页面=0的商品的活动开始/结束时间设置为默认值（0001-01-01T00:00:00）
修复文件数: 35个珍宝商品配置文件

📝 文档¶

珍宝商店字段分析文档¶

新增必须字段分析:
详细列出10个核心必须字段及其说明
列出5个可选字段及其默认值
提供字段验证规则和自动处理逻辑说明
说明新旧字段映射关系（限量数量 → 限量份数/原始限量）

v2.7.5 (2025-12-24)¶

✨ 新功能¶

添加聚灵珠装载等级限制并优化自动更换逻辑

🐛 修复¶

修复部分BUG

v2.7.4 (2025-12-22)¶

✨ 新功能¶

BOSS刷新查询¶

新增玩家命令 @BOSS刷新：查询全部或指定BOSS的存活状态、死亡状态与刷新倒计时
新增NPC脚本动作命令（英文/中文）：
QUERYBOSSALL / 查询所有BOSS：输出全部BOSS刷新信息
QUERYBOSS <怪物名字> / 查询指定BOSS <怪物名字>：输出指定BOSS详细信息（示例：查询指定BOSS 尸王）
简单示例脚本：Database/System/Envir/NPCs/Maps/盟重省/4748-新手引导员.txt

v2.7.3 (2025-12-20)¶

✨ 新功能¶

NPC 召唤系统增强¶

NpcGenEx 命令自动弹窗支持¶

功能说明: NpcGenEx 命令新增第6个参数，支持召唤 NPC 时自动弹出对话框
适用场景: 随身 NPC、临时 NPC、物品使用召唤 NPC 等
兼容性: 完全向后兼容，不提供第6个参数时默认不自动弹窗

中英文命令格式¶

英文命令格式:

NpcGenEx <NPC编号> <唯一ID> <地图编号或*> <坐标/坐标组或*> <存活秒数> <自动弹窗>

中文命令格式:

生成临时NPC <NPC编号> <唯一ID> <地图编号或*> <坐标/坐标组或*> <存活秒数> <自动弹窗>

参数说明¶

参数位置	参数名	说明	示例值
1	NPC编号	NPC 模板编号	`8613`
2	唯一ID	自定义唯一标识(用于 DelNpcGen，必须 > 0)	`888888`
3	地图编号	地图编号或 `*`(当前地图)	`*` / `143`
4	坐标/坐标组	坐标(`x,y`)或坐标组(`x,y\|x,y`)，`*`=玩家面前一格	`*` / `300,280`
5	存活秒数	NPC 存活时间(秒)	`30` / `60`
6	自动弹窗	`1`=自动弹出对话框, `0`=不弹窗	`1`

实际应用示例¶

示例1: 物品使用召唤 NPC(自动弹窗)

文件路径: Server_Container/Database/System/Envir/Core/Items/其他/隐身NPC.txt

[@_USEITEM(2103)]
;物品使用召唤NPC功能(支持自动弹窗)
;NPC编号8613=会员使者(与物品使用事件.lua使用相同NPC)

#IF

#ACT
DelNpcGen 8613
NpcGenEx 8613 8613 * * 30 1
TopMessage "召唤NPC成功！" FALSE
BREAK

示例2: 中文命令格式(随身生成)

#ACT
删除临时NPC 8613
生成临时NPC 8613 8613 * * 30 1

示例3: 固定坐标生成(不弹窗)

#ACT
NpcGenEx 4773 888888 143 300,280 60 0

示例4: 当前地图/玩家身边(自动弹窗)

#ACT
NpcGenEx 8613 100001 * * 300 1

技术实现细节¶

守卫实例扩展: 新增 需要自动弹窗、弹窗目标玩家、弹窗触发时间、创建者 属性
自动弹窗处理: 在守卫处理逻辑中添加 处理自动弹窗() 方法
脚本支持: 优先调用 Lua 脚本，然后尝试 TXT 脚本
网络通信: 通过 同步交互结果 封包发送对话内容给客户端

注意事项¶

自动弹窗只触发一次，之后需要玩家手动点击 NPC 对话
如果目标玩家死亡或离线，自动弹窗会被取消
NPC 存活时间到期后会自动删除
使用 DelNpcGen <唯一ID> 可以手动删除已召唤的 NPC
唯一ID 重复会导致不刷新，建议每次生成使用不同唯一ID

v2.7.2 (2025-12-19)¶

✨ 新功能¶

数据迁移工具 (DataMigration)¶

YH_Service 数据迁移: 新增完整的数据迁移工具，支持将月灵Data.db 数据迁移到小丑引擎Data.db 格式
核心数据迁移策略: 采用核心数据迁移策略，只迁移玩家相关数据，其他系统数据保持为空
CLI 命令支持:
analyze - 分析数据文件结构
compare - 对比两个数据文件
export - 导出数据为 JSON 格式
migrate - 执行数据迁移

迁移的核心类型¶

类型	说明
角色数据	玩家角色信息
账号数据	玩家账号信息
装备数据	玩家装备信息
物品数据	玩家物品信息
技能数据	玩家技能信息
宠物数据	玩家宠物信息
Buff数据	玩家Buff信息

v2.7.1 (2025-12-17)¶

✨ 新功能¶

游戏服务器 (GameServer)¶

装备升级自定义几率: 新增 开启自定义防具升级几率 / 自定义防具升级几率 配置，支持自定义概率覆盖配置表概率
防具升级逻辑优化: 角色防具升级 支持配置表概率与自定义概率覆盖，补充成功/失败日志与 +6 以上全服公告
九段之力首饰BUFF: 新增首饰升级BUFF刷新逻辑

v2.7.0 (2025-12-16)¶

✨ 新功能¶

账号服务器 (AccountServer) 增强¶

多门票端口支持: 支持配置多个门票发送端口，实现向多个游戏服务器同时发送门票（多区同开支持）
服务功能开关: 新增运行时功能控制开关
关闭账号注册：暂停新用户注册
关闭密码找回：暂停密码找回功能
关闭账号登录：暂停账号验证登录
关闭门票发送：暂停向游戏服发送门票
关闭游戏登录：暂停进入游戏请求
配置持久化: 所有设置项（包括端口列表、功能开关）支持保存到 Setup.ini，启动时自动加载
协议兼容性:
支持专用登录网关协议格式
支持自定义通讯协议字符前缀

游戏服务器 (GameServer)¶

神器系统: 新增 创造神器 GM命令，支持直接生成指定属性的装备或随机属性装备
聚灵珠系统升级:
自动轮换: 当聚灵珠经验已满时，自动从背包中寻找未满的聚灵珠进行更换（优先选择低持久）
经验加成: 聚灵珠经验计算支持 110% 总经验加成模式（需配置开启）
在线功能完善:
完善 在线功能.cs 窗口视图，增强道具发放、定点刷怪、邮件发送等功能的交互体验

🐛 修复¶

聚灵珠经验BUG: 修复聚灵珠经验与玩家经验叠加而非瓜分的问题（严重平衡性BUG）
修复前：玩家100% + 聚灵珠40% = 总产出140%
修复后：玩家60% + 聚灵珠40% = 总产出100% (或根据配置实现 110% 加成)

⚡ 优化¶

UI 交互: 账号服务器主界面重构，增加端口列表管理和功能开关控制面板
配置界面: 游戏服务器 ConfigInfoView 更新，集成上述新配置项的管理
新增 启用聚灵珠自动更换 配置文件

配置文件示例 (Setup.ini)¶

# 聚灵珠经验分配配置
启用聚灵珠经验分配=True
# 设置为45%时，结合系统110%加成，可实现(玩家65%+聚灵珠45%)的分配模式
聚灵珠经验百分比=45
启用聚灵珠自动更换=True

v2.6.0 (2025-12-15)¶

✨ 新功能¶

礼包码与CDK系统重构¶

CDK管理器增强: 添加线程安全锁保护，支持统一奖励发放服务
礼包码管理器: 新增可多次使用的礼包码系统，支持使用次数限制、每角色限领、有效期验证
推荐人管理器: 新增推荐码绑定和推广返点功能
玩家充值时推荐人获得：元宝 + 累计充值 + 推广点
默认返点比例5%（可配置）
奖励发放服务: 统一的奖励发放接口，支持金币、元宝、物品、游戏时间
CDK礼包码管理界面: 新增WinForms管理界面，支持CDK和礼包码的可视化管理

属性集合系统¶

全属性加成: 新增属性集合概念，支持"全属性+X"批量加成
全属性 = 攻击+魔法+道术+刺术+弓术+防御+魔防（7种属性）
全攻击 = 攻击+魔法+道术+刺术+弓术（5种攻击属性）
全防御 = 防御+魔防（2种防御属性）
随机属性扩展: 支持在attribute.csv中配置集合属性
Param1支持: allAttribute/全属性、allAttack/全攻击、allDefense/全防御

🐛 修复¶

修复元宝2位小数存储问题（元宝存储值需乘以100）
修复神圣石配置加载失败问题
修复CDK数据和礼包码数据模板类数据表检测问题

⚡ 优化¶

CDK和礼包码数据通过系统数据网关统一加载
充值.cs和使用CDK.cs代码逻辑对齐，使用统一服务类
添加安全验证：格式验证、频率限制、安全日志

v2.5.0 (2024-04-26)¶

✨ 新功能¶

列表更新字段加密: 增加列表更新字段加密,需要配套帐号网关 (需更新帐号服务器后联系客服转换数据)。
CheckOnline: 新增 CheckOnline 玩家名 检测玩家是否在线。
自定义防具升级属性: 防具升级加的属性现在从文件 装备升级.csv 读取, 支持自定义。
临时转换属性: 对象属性增加 临时转换属性=999, 用来做属性中转。
特攻天赋: 特攻天赋生效, 灼烧强化buff编号1136, 流血强化buff编号2601。
地图禁止条件: 地图增加部分禁止条件 (详情见地图参数设置)。
灵石合成规则: 修改为从 灵石配置.csv 读取。

🐛 修复¶

修复铭文刻印小退即可生效 BUG。
修复排行榜按经验排行错误。
修复新版龙卫增减伤问题。
修复死亡后 buff 还可以触发 BUG。
修复 GiveItemIdx 加属性不实时更新问题。
修复 GiveItem 装备无法绑定问题。
修复铭文技能重载时玩家使用技能有几率掉线。

⚡ 优化¶

优化帐号数据结构。
更改门票验签 key。
脚本发送邮件有物品时发送日志。
优化玩家卡顿问题。

v2.4.0 (2024-04-13)¶

✨ 新功能¶

调整临时属性: 增加脚本调整人物临时属性。
数据重载: 增加重载功能 (勋章洗练表、灵石相关包含雕色)。
指定人物触发: 增加指定人物触发字段命令 .HCall 角色名字段名。
全服提问: 增加全服提问 Gmexecute StartQuest @触发字段。
倒计时触发: 增加倒计时触发脚本命令。
文本行数获取: 增加 GetStringPos 获取字符串在文本中行数。
公会建设: 增加公会建设相关变量。
杀人触发: 增加杀人触发 killplay。
延时占领: 沙巴克增加延时占领设置 (设置页面)。
孔色传承: 添加高级孔色传承和高级精炼传承。
切换攻击模式: 增加脚本切换攻击模式命令 ChangeAttatckMode 0-6。
清技能CD: 增加清技能CD命令 @清技能CD * (可直接清全部玩家, 星号可换成指定角色名)。

🐛 修复¶

修复觉醒不扣角色经验问题。
修复三职业升级武器不放项链会出现其他 3 职业属性。
修复错误操作: 玩家分解物品不再掉线。
修复一个可能会被刷金币的 BUG。

⚡ 优化¶

装备锁改为只可对装备加锁 (物品加锁有问题)。
扩展地图 "强制攻击模式" 参数。
ThrowItem 公告坐标改为游戏坐标。
挂机时不再触发传送法阵进入下一层。
手动切换地图挂机自动停止。
调整 ChangeLevel 命令保留当前经验。
调整 GiveItem 系列命令大整改, 物品自动堆叠, 背包满则掉地上。
数据查看界面增加编号。
优化角色清理命令。

v2.3.0 (2024-03-23)¶

✨ 新功能¶

GM 日志: 增加 GM 命令保存单独日志。
怪物属性: 增加怪物固定掉血和固定攻击伤害。
检测安全区: 增加检测角色是否在安全区 INSAFEZONE。
装备触发: 增加装备附加 BUFF, 穿卸装备触发。

🐛 修复¶

修复瞬间掉血保护、防具升级勾选不能保存、队伍队长拾取。
过滤断网回调弹窗错误。
修复转移属性加成错误。
修复 buff 轮询触发 lua 问题。

⚡ 优化¶

修改召唤宠物增加出生等级, 为 0 则等于技能等级。
增加其他重载功能。
调整普通祝福油设为 0 几率时无法继续提升, 且提示玩家。
防具升级几率增加自定义配置 (如果关闭则按配置文件读取神佑精华数量, 需要配套 item_armor.txt)。
优化地图放物品归属问题。

历史版本¶

v2.5.0 (2024-12-14) (预告/测试版)¶

新增 Lua 脚本热重载功能
新增副本难度选择系统
新增自动拾取过滤配置

v2.4.0 (2024-11-20) (预告/测试版)¶

新增公会战系统
新增跨服聊天功能
新增装备分解系统

v2.3.0 (2024-10-15) (预告/测试版)¶

新增宠物系统
新增称号系统
新增成就系统

命令类型	命令	格式	说明
检测命令	`CheckClass`	`CheckClass [职业名]`	检测玩家职业（战士/法师/道士/刺客/弓手/龙枪）
检测命令	`CheckTitle`	`CheckTitle [称号编号]`	检测玩家是否拥有指定称号
检测命令	`检测玩家战力`	`检测玩家战力 [操作符] [数值]`	检测角色战力值（支持 >、>=、<、<=、=、<>）
检测命令	`检测玩家攻击力`	`检测玩家攻击力 [操作符] [数值]`	根据职业自动取对应最大攻击属性
检测命令	`CHECKCALC`	`CHECKCALC <左值> 操作符 <右值>`	数值比较检测（支持变量比较）
执行命令	`DelTitleEx`	`DelTitleEx [玩家名] [称号编号]`	删除指定玩家的称号（支持离线）
执行命令	`GiveTitle`	`GiveTitle [称号编号] [持续时间]`	赠送称号（0=永久）
执行命令	`UseTitle`	`UseTitle [称号编号]`	激活/使用称号
执行命令	`NowVarSort`	`NowVarSort [排行榜编号] [名次]`	更新排行榜数据

更新日志¶

v2.7.17 (2026-02-26)¶

✨ 新功能¶

玛法探宝 — 罗盘系统¶

v2.7.16 (2026-02-22)¶

✨ 新功能¶

天下第一称号系统优化¶

核心改进¶

相关脚本命令¶

天下第一称号编号¶

申请流程示例（法师）¶

系统变量¶

随机属性转移系统 — 新增脚本命令¶

执行命令（#ACT）¶

检测命令（#IF）¶

系统变量¶

装备转移并删除 — 保护检查¶

地图禁止使用物品¶

NPC脚本 CheckType 中文指令扩展¶

🐛 修复¶

NPC对话选项点击无反应¶

📝 文档¶

v2.7.15 (2026-02-22)¶

🔒 安全¶

动态混淆与完整性校验¶

IP登录限制¶

配置项 (Setup.ini → [General])¶

🐛 修复¶

挂机铭文技能双重伤害¶

元素王座副本¶

🧹 优化¶

v2.7.14 (2026-02-12)¶

✨ 新功能¶

雕色石配置系统¶

配置文件格式¶

默认配置特点¶

相关文档¶

🔧 优化¶

程序关闭流程优化¶

修改文件¶

📝 文档¶

v2.7.13 (2026-02-03)¶

✨ 新功能¶

装备属性系统重构¶

怪物配置新增字段¶

配置完整性校验¶

🐛 修复¶

装备属性系统¶

📝 文档¶

v2.7.12 (2026-01-31)¶

✨ 新功能¶

技能编辑器¶

v2.7.11 (2026-01-24)¶

✨ 新功能¶

沙巴克攻城系统增强¶

NPC脚本命令汇总¶

配置示例 (Setup.ini)¶

🐛 修复¶

玩家系统¶

v2.7.10 (2026-01-18)¶

✨ 新功能¶

外挂验证系统完善¶

动作命令¶

检测命令¶

NPC脚本示例¶

持久化字段¶

v2.7.9 (2026-01-12)¶

✨ 新功能¶

怪物跑动系统¶

怪物数据配置示例¶

属性说明¶

v2.7.8 (2026-01-11)¶

🐛 修复¶

伤害计算优化¶

玩家复活系统对齐¶

🧹 清理¶

v2.7.7 (2026-01-10)¶

✨ 新功能¶

沙巴克系统增强¶

掉落系统优化¶