挖矿功能的实现需要同时配置地图参数、触发文件和随机产出脚本，三者缺一不可。只写一个挖矿命令无法让玩家真正挖出矿石，必须让引擎识别到“当前地图允许挖矿”，并在玩家挥动锄头时调用对应的物品产出逻辑。
##地图挖矿开关与爆率文件
挖矿功能的第一层控制在地图属性中。服务端M2Server的地图配置里有一个“允许挖矿”选项，勾选后该地图才会响应玩家的挖矿动作。同一界面还有两个关键参数：矿石选择因子和挖矿触发爆率。矿石选择因子决定随机数的取值范围，挖矿触发爆率文件决定随机数落在哪个区间时产出哪件物品。
爆率文件通常存放在Envir目录下的MineList或类似名称的文本中，格式为物品名称加概率值。引擎在玩家每次挖矿时生成一个随机数，然后对照爆率文件逐行判断，随机数落在哪一行物品的概率范围内就产出该物品。爆率文件的概率总和不需要与矿石选择因子完全一致，但因子大小直接影响产出频率，因子越大随机数范围越宽，单位时间内挖到物品的次数越少。
##挖矿触发脚本的调用方式
地图事件触发是让挖矿产出装备或特殊物品的核心手段。在Envir目录下的MapEvent.txt文件中添加挖矿触发规则，格式包含地图编号、坐标范围、触发类型、物品条件、组队要求、触发概率和调用的脚本标签。
以在任意地图挖矿时随机获得物品为例，MapEvent.txt中的配置行格式为：地图编号-1-1-1:13:*:021:@MapEventMine。其中地图编号替换为实际地图号，两个-1表示任意坐标，3代表挖矿动作，星号表示不限定物品，0表示不需要组队，1为触发概率值，最后的@MapEventMine是QFunction-0.txt中的脚本标签名称。
这段配置的作用是：玩家在该地图任意位置执行挖矿动作时，引擎以设定概率调用QFunction-0.txt中的@MapEventMine脚本段。触发概率的数字越大机率越低，范围从0到999999，设为0时表示百分之百触发。
##随机产出脚本的编写
在QFunction-0.txt中编写挖矿触发脚本，通过GetRandomText命令从外部文本文件中随机抽取一行物品名称，再用GIVE命令将物品发放给玩家。脚本结构如下：
```
[@MapEventMine]
#IF
#ACT
GetRandomText.\QuestDiary\触发文件\挖矿随机物品.txtS7
GIVE<$STR(S7)>1
SendMsg0[提示]：玩家[<$USERNAME>]在%M的%X%Y处挖矿，意外获得了[<$STR(S7)>]！
break
```
GetRandomText从指定路径的文本文件中随机读取一行内容，存入变量S7。挖矿随机物品.txt文件中每行写一件物品名称，引擎每次触发时随机抽取一行。GIVE命令将抽到的物品发放到玩家背包。SENDMSG0为全服公告，SENDMSG5为个人提示。
如果需要控制产出概率，可以在#IF段加入RANDOM命令。RANDOM30表示万分之三十的概率触发，RANDOM10表示万分之十，数值越小概率越低。也可以将多段脚本写入同一个QFunction触发段，用不同的RANDOM值控制不同品质物品的产出。
##挖矿脚本的变异玩法
除常规产出矿石外，挖矿触发脚本还可以实现多种特殊效果。挖矿时触发传送将玩家送入隐藏地图，在#ACT段使用MAPMOVE命令将玩家移动到指定地图编号，配合SENDMSG公告提示“挖破了某处大门进入了隐藏地图”。
挖矿时触发惩罚效果，用KILL命令直接击杀玩家，配合公告“日夜不停挖矿最终体力不支”。挖矿时触发刷怪，用MONGEN命令在玩家当前位置生成怪物，适合制作“挖到封印怪物”的玩法。
这些变异玩法的实现方式与常规产出完全一致，区别仅在于#ACT段执行的命令不同。触发文件和QFunction脚本的配置方式不变，只需替换#ACT中的执行命令即可。
##自动挖矿脚本的实现思路
自动挖矿脚本与挖矿触发脚本是两套不同的机制。触发脚本控制的是“挖出什么东西”，自动挖矿脚本控制的是“角色自动执行挖矿动作”。自动挖矿脚本通常包含回城、自动存物、自动售物、锄头购买等辅助功能模块。
自动挖矿的核心逻辑是检测背包空位和锄头数量，当条件满足时循环执行挖矿命令。脚本中使用条件判断检测包裹空位，空位不足时触发回城流程，找到仓库NPC执行自动存物，再找铁匠铺老板购买锄头补充消耗品。部分自动挖矿脚本还包含废矿判断逻辑，当背包中废矿数量超过设定值时自动使用废矿或回城处理。
自动挖矿脚本通过挂机系统的脚本编辑功能写入，使用全局脚本、挂机脚本的分段结构，在全局脚本中定义回城条件和总控流程，在挂机脚本中定义具体执行动作。脚本中的物品名称和NPC坐标需要替换为服务端实际数据，名称不匹配会导致脚本无法正常执行。
##引擎差异与配置要点
不同引擎对挖矿功能的支持方式存在差异。部分引擎在地图属性中直接提供“允许挖矿”勾选框，勾选后即可启用基础挖矿功能。另一些引擎需要在MapInfo.txt中手动添加挖矿参数，或通过MapQuest_def文件夹中的地图任务脚本单独配置。
GOM引擎和HeroM2引擎的挖矿触发配置逻辑基本一致，MapEvent.txt的格式通用。触发概率的单位为万分比，RANDOM30对应千分之三。物品产出脚本中的物品名称必须与服务端Item.txt中的名称完全一致，包括空格和符号。脚本文件保存时必须使用ANSI编码，UTF-8编码会导致引擎无法识别脚本内容。
测试时先用GM命令将角色传送至已开启挖矿的地图，装备锄头后执行挖矿动作，观察是否触发产出和公告。如果挖矿动作正常但无产出，检查MapEvent.txt中的地图编号是否与实际地图一致。如果产出物品名称显示乱码，检查爆率文件和物品列表文件的编码格式。
##地图挖矿开关与爆率文件
挖矿功能的第一层控制在地图属性中。服务端M2Server的地图配置里有一个“允许挖矿”选项，勾选后该地图才会响应玩家的挖矿动作。同一界面还有两个关键参数：矿石选择因子和挖矿触发爆率。矿石选择因子决定随机数的取值范围，挖矿触发爆率文件决定随机数落在哪个区间时产出哪件物品。
爆率文件通常存放在Envir目录下的MineList或类似名称的文本中，格式为物品名称加概率值。引擎在玩家每次挖矿时生成一个随机数，然后对照爆率文件逐行判断，随机数落在哪一行物品的概率范围内就产出该物品。爆率文件的概率总和不需要与矿石选择因子完全一致，但因子大小直接影响产出频率，因子越大随机数范围越宽，单位时间内挖到物品的次数越少。
##挖矿触发脚本的调用方式
地图事件触发是让挖矿产出装备或特殊物品的核心手段。在Envir目录下的MapEvent.txt文件中添加挖矿触发规则，格式包含地图编号、坐标范围、触发类型、物品条件、组队要求、触发概率和调用的脚本标签。
以在任意地图挖矿时随机获得物品为例，MapEvent.txt中的配置行格式为：地图编号-1-1-1:13:*:021:@MapEventMine。其中地图编号替换为实际地图号，两个-1表示任意坐标，3代表挖矿动作，星号表示不限定物品，0表示不需要组队，1为触发概率值，最后的@MapEventMine是QFunction-0.txt中的脚本标签名称。
这段配置的作用是：玩家在该地图任意位置执行挖矿动作时，引擎以设定概率调用QFunction-0.txt中的@MapEventMine脚本段。触发概率的数字越大机率越低，范围从0到999999，设为0时表示百分之百触发。
##随机产出脚本的编写
在QFunction-0.txt中编写挖矿触发脚本，通过GetRandomText命令从外部文本文件中随机抽取一行物品名称，再用GIVE命令将物品发放给玩家。脚本结构如下：
```
[@MapEventMine]
#IF
#ACT
GetRandomText.\QuestDiary\触发文件\挖矿随机物品.txtS7
GIVE<$STR(S7)>1
SendMsg0[提示]：玩家[<$USERNAME>]在%M的%X%Y处挖矿，意外获得了[<$STR(S7)>]！
break
```
GetRandomText从指定路径的文本文件中随机读取一行内容，存入变量S7。挖矿随机物品.txt文件中每行写一件物品名称，引擎每次触发时随机抽取一行。GIVE命令将抽到的物品发放到玩家背包。SENDMSG0为全服公告，SENDMSG5为个人提示。
如果需要控制产出概率，可以在#IF段加入RANDOM命令。RANDOM30表示万分之三十的概率触发，RANDOM10表示万分之十，数值越小概率越低。也可以将多段脚本写入同一个QFunction触发段，用不同的RANDOM值控制不同品质物品的产出。
##挖矿脚本的变异玩法
除常规产出矿石外，挖矿触发脚本还可以实现多种特殊效果。挖矿时触发传送将玩家送入隐藏地图，在#ACT段使用MAPMOVE命令将玩家移动到指定地图编号，配合SENDMSG公告提示“挖破了某处大门进入了隐藏地图”。
挖矿时触发惩罚效果，用KILL命令直接击杀玩家，配合公告“日夜不停挖矿最终体力不支”。挖矿时触发刷怪，用MONGEN命令在玩家当前位置生成怪物，适合制作“挖到封印怪物”的玩法。
这些变异玩法的实现方式与常规产出完全一致，区别仅在于#ACT段执行的命令不同。触发文件和QFunction脚本的配置方式不变，只需替换#ACT中的执行命令即可。
##自动挖矿脚本的实现思路
自动挖矿脚本与挖矿触发脚本是两套不同的机制。触发脚本控制的是“挖出什么东西”，自动挖矿脚本控制的是“角色自动执行挖矿动作”。自动挖矿脚本通常包含回城、自动存物、自动售物、锄头购买等辅助功能模块。
自动挖矿的核心逻辑是检测背包空位和锄头数量，当条件满足时循环执行挖矿命令。脚本中使用条件判断检测包裹空位，空位不足时触发回城流程，找到仓库NPC执行自动存物，再找铁匠铺老板购买锄头补充消耗品。部分自动挖矿脚本还包含废矿判断逻辑，当背包中废矿数量超过设定值时自动使用废矿或回城处理。
自动挖矿脚本通过挂机系统的脚本编辑功能写入，使用全局脚本、挂机脚本的分段结构，在全局脚本中定义回城条件和总控流程，在挂机脚本中定义具体执行动作。脚本中的物品名称和NPC坐标需要替换为服务端实际数据，名称不匹配会导致脚本无法正常执行。
##引擎差异与配置要点
不同引擎对挖矿功能的支持方式存在差异。部分引擎在地图属性中直接提供“允许挖矿”勾选框，勾选后即可启用基础挖矿功能。另一些引擎需要在MapInfo.txt中手动添加挖矿参数，或通过MapQuest_def文件夹中的地图任务脚本单独配置。
GOM引擎和HeroM2引擎的挖矿触发配置逻辑基本一致，MapEvent.txt的格式通用。触发概率的单位为万分比，RANDOM30对应千分之三。物品产出脚本中的物品名称必须与服务端Item.txt中的名称完全一致，包括空格和符号。脚本文件保存时必须使用ANSI编码，UTF-8编码会导致引擎无法识别脚本内容。
测试时先用GM命令将角色传送至已开启挖矿的地图，装备锄头后执行挖矿动作，观察是否触发产出和公告。如果挖矿动作正常但无产出，检查MapEvent.txt中的地图编号是否与实际地图一致。如果产出物品名称显示乱码，检查爆率文件和物品列表文件的编码格式。