### 一、3K引擎毒素武器核心原理
3K引擎（SKYM2）的毒素武器实现机制与Hero引擎存在显著差异。根据，其核心逻辑分为**配置文件定义**与**脚本触发**两大模块：
1. **基础毒素框架**：通过`D:\Mirserver\Mir200\Envir\UserData\PoisonWeapon.txt`定义武器基础毒素参数，如：
```
屠龙 90 10 10 5
```
- **参数解析**：
| 参数顺序 | 含义 | 阈值说明 |
|----------|---------------------|------------------------------|
| 1 | 武器名称 | 需与数据库ItemName一致 |
| 2 | 触发成功率（%） | 100为必触发，90即90%概率 |
| 3 | 每次攻击减HP值 | 基础伤害，可叠加 |
| 4 | 毒素持续基础时间（秒） | 实际时间=基础+扩展随机值 |
| 5 | 扩展时间随机范围 | 例：5代表1-5秒随机 |
2. **触发逻辑增强**：需结合`QFunction-0.txt`脚本实现**攻击时触发毒素状态**，例如在3K引擎中可通过`[@Attack]`段添加：
```
[@Attack]
#IF
CHECKITEMW 屠龙
RANDOM 90 --匹配PoisonWeapon.txt中90%成功率
#ACT
PlayEffect 中毒特效编号
AddHP -10 --减HP值
```
此为Hero引擎兼容写法，3K引擎需结合`HITMON`命令实现更复杂逻辑（见后文）。
---
### 二、全毒武器属性实现步骤
#### **1. 基础毒素配置**
- **步骤1**：定位至服务端目录`D:\Mirserver\Mir200\Envir\UserData`，创建或编辑`PoisonWeapon.txt`，按格式添加武器：
```
倚天剑 100 50 20 10 --100%触发，每次减50HP，持续20+1~10秒
```
*注：若需多段毒素（如红毒+绿毒），需独立定义两种武器并关联脚本。*
- **步骤2**：在`ItemDescList.txt`中添加武器描述，提升玩家感知：
```
倚天剑=\243/天下第一毒剑\251/★全屏中毒★\253/攻击必触发50HP/秒毒素，持续20-30秒
```
使用`\243`等颜色代码增强视觉效果。
#### **2. 脚本触发强化（3K引擎专属）**
3K引擎需通过**地图参数**与**攻击事件**双重控制：
- **地图参数绑定**：在`MapInfo.txt`中为目标地图添加`HITMON`指令：
```
[0 比奇省] HITMON(@OnPoisonAttack)
```
- **攻击事件脚本**：在`QFunction-0.txt`中编写：
```
[@OnPoisonAttack]
#IF
CHECKHITMONNAME --检测被攻击目标
CHECKITEMW 倚天剑
#ACT
CHANGEPKPOINT +500 --增加PK值（可选）
M.AddBuff 21 300 --添加编号21的毒素Buff，持续300秒
SENDMSG 0 [全毒武器]玩家%s使用倚天剑触发剧毒！
```
此处`M.AddBuff`为3K引擎扩展命令，需确认引擎支持。
#### **3. 毒素叠加与抗性机制**
- **叠加规则**：
- **同类覆盖**：同一武器多次触发，持续时间重置，伤害值取最大值。
- **异类叠加**：不同武器（如红毒+绿毒）可同时生效，需在`PoisonWeapon.txt`中定义多个条目。
- **抗性设置**：通过`M2Server->选项->功能设置->毒素抗性`调整全局参数：
| 参数项 | 建议值 | 说明 |
|-----------------|-----------|-------------------------------|
| 毒素伤害减免率 | 20% | 玩家通过装备提升抗性后生效 |
| 最大叠加层数 | 3层 | 防止无限叠加失衡 |
---
### 三、高级应用：复合毒素与特效融合
#### **1. 多段毒素（红毒+绿毒）**
- **红毒配置**（持续掉HP）：
```
赤血剑 80 30 15 5
```
- **绿毒配置**（降低防御）：
```
碧玉剑 70 0 15 5
```
在脚本中通过`M.HumanHP -30`与`M.DecDefense 10`分别实现效果。
#### **2. 特效与音效联动**
- **客户端配置**：
1. 在`Effect.wzl`中导入中毒特效素材（编号需与脚本中的`PlayEffect`一致）。
2. 修改`Sound.lst`关联中毒音效：
```
1000: \sound\poison.wav
```
- **脚本调用**：
```
#ACT
PlayEffect 1000
PlaySound 1000
```
#### **3. 毒素与BUFF系统整合**
通过3K引擎的`BUFF系统`实现动态效果：
```
[@Attack]
#IF
CHECKITEMW 倚天剑
#ACT
AddBuff 6 1 120 "中毒:每3秒损失5%HP" --参数：BuffID、生效间隔（秒）、持续时间、描述
```
此Buff会每3秒触发一次扣血，与`PoisonWeapon.txt`的基础毒素形成复合效果。
---
### 四、调试与常见问题
#### **1. 必检项列表**
| 问题现象 | 排查方向 | 解决方案 |
|---------------------|-----------------------------------|-----------------------------------|
| 武器无毒素效果 | 1. PoisonWeapon.txt路径错误<br>2. 武器名称拼写不匹配 | 检查路径大小写，核对ItemName |
| 触发概率异常 | RANDOM值与文件成功率不一致 | 同步修改脚本与配置文件 |
| 客户端无特效 | Effect.wzl编号冲突或资源未加载 | 使用WIL编辑器验证素材ID |
| 服务器崩溃 | 脚本中AddHP值过大导致数值溢出 | 限制单次扣血≤目标当前HP的20% |
#### **2. 性能优化建议**
- **负载控制**：在`M2Server->性能参数`中限制每秒最大毒素计算次数（建议≤500次/秒）。
- **数据库优化**：对频繁调用的武器字段（如毒伤值）添加索引。
3K引擎（SKYM2）的毒素武器实现机制与Hero引擎存在显著差异。根据，其核心逻辑分为**配置文件定义**与**脚本触发**两大模块：
1. **基础毒素框架**：通过`D:\Mirserver\Mir200\Envir\UserData\PoisonWeapon.txt`定义武器基础毒素参数，如：
```
屠龙 90 10 10 5
```
- **参数解析**：
| 参数顺序 | 含义 | 阈值说明 |
|----------|---------------------|------------------------------|
| 1 | 武器名称 | 需与数据库ItemName一致 |
| 2 | 触发成功率（%） | 100为必触发，90即90%概率 |
| 3 | 每次攻击减HP值 | 基础伤害，可叠加 |
| 4 | 毒素持续基础时间（秒） | 实际时间=基础+扩展随机值 |
| 5 | 扩展时间随机范围 | 例：5代表1-5秒随机 |
2. **触发逻辑增强**：需结合`QFunction-0.txt`脚本实现**攻击时触发毒素状态**，例如在3K引擎中可通过`[@Attack]`段添加：
```
[@Attack]
#IF
CHECKITEMW 屠龙
RANDOM 90 --匹配PoisonWeapon.txt中90%成功率
#ACT
PlayEffect 中毒特效编号
AddHP -10 --减HP值
```
此为Hero引擎兼容写法，3K引擎需结合`HITMON`命令实现更复杂逻辑（见后文）。
---
### 二、全毒武器属性实现步骤
#### **1. 基础毒素配置**
- **步骤1**：定位至服务端目录`D:\Mirserver\Mir200\Envir\UserData`，创建或编辑`PoisonWeapon.txt`，按格式添加武器：
```
倚天剑 100 50 20 10 --100%触发，每次减50HP，持续20+1~10秒
```
*注：若需多段毒素（如红毒+绿毒），需独立定义两种武器并关联脚本。*
- **步骤2**：在`ItemDescList.txt`中添加武器描述，提升玩家感知：
```
倚天剑=\243/天下第一毒剑\251/★全屏中毒★\253/攻击必触发50HP/秒毒素，持续20-30秒
```
使用`\243`等颜色代码增强视觉效果。
#### **2. 脚本触发强化（3K引擎专属）**
3K引擎需通过**地图参数**与**攻击事件**双重控制：
- **地图参数绑定**：在`MapInfo.txt`中为目标地图添加`HITMON`指令：
```
[0 比奇省] HITMON(@OnPoisonAttack)
```
- **攻击事件脚本**：在`QFunction-0.txt`中编写：
```
[@OnPoisonAttack]
#IF
CHECKHITMONNAME --检测被攻击目标
CHECKITEMW 倚天剑
#ACT
CHANGEPKPOINT +500 --增加PK值（可选）
M.AddBuff 21 300 --添加编号21的毒素Buff，持续300秒
SENDMSG 0 [全毒武器]玩家%s使用倚天剑触发剧毒！
```
此处`M.AddBuff`为3K引擎扩展命令，需确认引擎支持。
#### **3. 毒素叠加与抗性机制**
- **叠加规则**：
- **同类覆盖**：同一武器多次触发，持续时间重置，伤害值取最大值。
- **异类叠加**：不同武器（如红毒+绿毒）可同时生效，需在`PoisonWeapon.txt`中定义多个条目。
- **抗性设置**：通过`M2Server->选项->功能设置->毒素抗性`调整全局参数：
| 参数项 | 建议值 | 说明 |
|-----------------|-----------|-------------------------------|
| 毒素伤害减免率 | 20% | 玩家通过装备提升抗性后生效 |
| 最大叠加层数 | 3层 | 防止无限叠加失衡 |
---
### 三、高级应用：复合毒素与特效融合
#### **1. 多段毒素（红毒+绿毒）**
- **红毒配置**（持续掉HP）：
```
赤血剑 80 30 15 5
```
- **绿毒配置**（降低防御）：
```
碧玉剑 70 0 15 5
```
在脚本中通过`M.HumanHP -30`与`M.DecDefense 10`分别实现效果。
#### **2. 特效与音效联动**
- **客户端配置**：
1. 在`Effect.wzl`中导入中毒特效素材（编号需与脚本中的`PlayEffect`一致）。
2. 修改`Sound.lst`关联中毒音效：
```
1000: \sound\poison.wav
```
- **脚本调用**：
```
#ACT
PlayEffect 1000
PlaySound 1000
```
#### **3. 毒素与BUFF系统整合**
通过3K引擎的`BUFF系统`实现动态效果：
```
[@Attack]
#IF
CHECKITEMW 倚天剑
#ACT
AddBuff 6 1 120 "中毒:每3秒损失5%HP" --参数：BuffID、生效间隔（秒）、持续时间、描述
```
此Buff会每3秒触发一次扣血，与`PoisonWeapon.txt`的基础毒素形成复合效果。
---
### 四、调试与常见问题
#### **1. 必检项列表**
| 问题现象 | 排查方向 | 解决方案 |
|---------------------|-----------------------------------|-----------------------------------|
| 武器无毒素效果 | 1. PoisonWeapon.txt路径错误<br>2. 武器名称拼写不匹配 | 检查路径大小写，核对ItemName |
| 触发概率异常 | RANDOM值与文件成功率不一致 | 同步修改脚本与配置文件 |
| 客户端无特效 | Effect.wzl编号冲突或资源未加载 | 使用WIL编辑器验证素材ID |
| 服务器崩溃 | 脚本中AddHP值过大导致数值溢出 | 限制单次扣血≤目标当前HP的20% |
#### **2. 性能优化建议**
- **负载控制**：在`M2Server->性能参数`中限制每秒最大毒素计算次数（建议≤500次/秒）。
- **数据库优化**：对频繁调用的武器字段（如毒伤值）添加索引。