GOM传奇充值与拍卖行脚本编写指南 实操代码与部署技巧

一、GOM传奇脚本核心基础 充值与拍卖行脚本认知

GOM引擎脚本以.txt或.lua格式为主，核心通过“条件判断-功能执行-反馈提示”逻辑实现需求。充值脚本聚焦支付对接与道具发放，拍卖行脚本侧重物品上架、竞价与成交结算，二者均需适配GOM专属函数与变量规则。

1. 脚本制作核心前提：工具与环境适配

无需复杂工具，但基础环境需达标，避免后续调试受阻：

- 编辑工具：基础用记事本，专业推荐Notepad++，开启“显示所有字符”功能，便于排查空格、换行等隐藏错误；

- 引擎确认：确保服务器使用GOM引擎（版本号建议1108及以上），进入M2引擎“关于”界面可查看，低版本需升级以支持支付接口函数；

- 素材准备：提前整理道具ID（如元宝ID为1001）、地图ID、支付接口参数（商户号、密钥），可通过GOM引擎“物品数据库”“地图列表”查询。

2. 两类脚本核心功能与关联逻辑

充值与拍卖行脚本虽功能不同，但均需关联玩家数据与引擎接口，核心逻辑如下：

脚本类型

核心功能模块

依赖GOM核心函数

充值脚本

支付接口对接、金额验证、元宝发放、充值记录

PayNotice、Give、SaveVar、SendMsg

拍卖行脚本

物品上架审核、竞价触发、价格更新、成交转移

CheckItem、GetHumanItem、ChangeItemOwner、SetVar

二、GOM传奇充值脚本制作全流程 从接口到发放

充值脚本核心是实现“玩家支付-接口回调-道具到账”的闭环，以“元宝充值”为例，按“接口配置-脚本编写-部署测试”步骤操作。

1. 前置准备：支付接口配置与参数获取

先完成支付接口与GOM引擎的关联，确保支付信息能被脚本识别：

1. 接口申请：从正规支付平台（如Payjs、易支付）获取商户号、API密钥、回调地址，回调地址格式为“http://服务器IP:端口/PayBack.aspx”；

2. 引擎配置：打开M2引擎，进入“功能设置-支付配置”，填写商户号、密钥，回调地址与平台一致，勾选“启用支付通知”，保存后重启引擎；

3. 变量定义：在“Envir/Variable.txt”中添加充值记录变量，如“HumanRechargeRecord”，用于存储玩家充值金额与时间。

2. 充值脚本编写：完整代码与逻辑解析

GOM充值脚本常用.txt格式，以“@充值10元”命令触发为例，代码分“触发入口-支付验证-道具发放”三部分：

（1）脚本触发入口与金额判断

定义命令触发标签，判断玩家是否重复提交支付，代码如下：

[@main]
#IF
CheckVar HUMAN 支付中 > 0
#SAY
您有一笔支付正在处理中，请稍后再试！\
当前状态：等待支付确认
#ELSEACT
SetVar HUMAN 支付中 1
;调用支付接口，金额10元（单位：分，故为1000）
PayNotice 1000 1 0 0 0 0 0
SendMsg 6 充值请求已提交，请在支付页面完成付款！


（2）支付回调与道具发放核心代码

支付成功后，接口会触发“@PayBack”标签，在此完成元宝发放与记录，代码示例：

[@PayBack]
#IF
CheckArg 0 = 1 ;Arg0=1表示支付成功
#ACT
;Arg1为支付金额（分），转换为元后发放元宝（1元=10元宝）
Give 元宝 <$Arg1/100*10>
;记录充值信息（角色名|金额|时间）
SaveVar HUMAN HumanRechargeRecord <$USERNAME>|$Arg1/100|<$TIME>
SendMsg 6 恭喜！10元充值成功，100元宝已发放至背包！
GuildNoticeMsg 146 0 玩家〖$USERNAME〗成功充值10元，获赠100元宝！
#ELSEACT
SendMsg 6 支付失败，请检查网络后重新尝试！
#IF
;无论成败，重置支付状态
#ACT
SetVar HUMAN 支付中 0


3. 脚本部署与测试：确保流程通顺

- 部署路径：将脚本文件命名为“Recharge.txt”，复制至服务器“Mir200/Envir/Scripts”文件夹，在M2引擎“脚本管理”中加载该脚本；

- 命令绑定：进入M2“用户命令”，添加“@充值10元”，脚本文件选择“Recharge.txt”，脚本标签填“@main”；

- 测试要点：用测试账号输入“@充值10元”，完成支付后检查元宝是否到账，查看“Variable.txt”确认充值记录是否保存。

三、GOM传奇拍卖行脚本制作 上架到成交全逻辑

拍卖行脚本需实现“玩家上架-他人竞价-到期成交”功能，核心依赖物品判断、变量存储与定时触发，以“自由竞价”模式为例编写。

1. 核心变量与存储设计

用全局变量存储拍卖信息，避免服务器重启丢失数据，变量定义如下：

- AuctionCount：拍卖物品总数，用于生成唯一拍卖ID；

- Auction_<ID>_Info：单条拍卖信息，格式“物品ID|数量|起拍价|当前价|卖家|买家|结束时间”；

- AuctionUser_<USERNAME>：玩家上架的拍卖ID列表。

2. 物品上架模块：审核与信息存储

玩家通过NPC触发上架，脚本需判断物品合法性（非绑定、可交易），代码示例：

[@AuctionUp]
#IF
;判断玩家是否携带物品（以背包第1格为例）
CheckItemInBag 0 1
#ACT
;获取物品信息（ID、名称、是否绑定）
GetItemInfo 0 ItemID ItemName ItemBind
#IF
CheckVar ItemBind = 1
#SAY
绑定物品无法上架拍卖，请选择可交易物品！
#ELSEACT
;获取玩家输入的起拍价和拍卖时长（单位：分钟）
InputString 起拍价（元宝） 100
InputString 拍卖时长（分钟） 60
Goto @AuctionUp_Confirm


确认信息后存储拍卖数据，扣除玩家物品，代码如下：

[@AuctionUp_Confirm]
#ACT
;生成唯一拍卖ID
IncVar Global AuctionCount 1
local AuctionID = <$GLOBAL(AuctionCount)>
;计算结束时间（当前时间+时长）
local EndTime = <$TIME> + <$INPUT1>*60
;存储拍卖信息
SetVar Global Auction_<$AuctionID>_Info <$ItemID>|1|<$INPUT0>|<$INPUT0>|<$USERNAME>|无|<$EndTime>
;记录玩家上架物品
SetVar HUMAN AuctionUser_<$USERNAME> <$AuctionID>,<$HUMAN(AuctionUser_<$USERNAME>)>
;扣除玩家物品
TakeItem 0 1
SendMsg 6 物品【<$ItemName>】上架成功！起拍价<$INPUT0>元宝，拍卖时长<$INPUT1>分钟。


3. 竞价与成交模块：价格更新与物品转移

其他玩家可通过拍卖列表触发竞价，脚本判断出价是否高于当前价，代码示例：

[@AuctionBid]
#ARG 1 AuctionID ;传入拍卖ID
#ACT
;读取该拍卖信息
GetVar Global Auction_<$AuctionID>_Info Info
;拆分信息为数组（用“|”分割）
SplitStr <$Info> | ItemID NowPrice Seller Buyer EndTime
#IF
CheckGold <$NowPrice+10> ;出价需比当前价高10元宝
CheckTime <$EndTime> > <$TIME> ;拍卖未结束
#ACT
;扣除出价元宝
TakeGold <$NowPrice+10>
;更新当前价与买家
SetVar Global Auction_<$AuctionID>_Info <$ItemID>|1|<$NowPrice+10>|<$USERNAME>|<$EndTime>
SendMsg 6 竞价成功！当前【<$ItemName>】价格更新为<$NowPrice+10>元宝。
;给卖家发送提示
SendMsg 6 <$USERNAME> 对您的【<$ItemName>】出价<$NowPrice+10>元宝！
#ELSEACT
SendMsg 6 竞价失败！请确保元宝充足且出价高于当前价。


4. 定时成交与物品发放：自动执行逻辑

通过GOM引擎“定时触发”功能，每1分钟检查一次拍卖状态，到期自动成交：

[@AuctionCheck]
#ACT
local MaxID = <$GLOBAL(AuctionCount)>
;循环遍历所有拍卖物品
for i=1 to MaxID
GetVar Global Auction_<$i>_Info Info
SplitStr <$Info> | ItemID NowPrice Seller Buyer EndTime
#IF
CheckTime <$EndTime> <= <$TIME>
CheckStr <$Buyer> 不等于 无
#ACT
;给买家发放物品
Give <$ItemID> 1 <$Buyer>
;给卖家发放元宝（扣除10%手续费）
GiveGold <$NowPrice*0.9> <$Seller>
SendMsg 6 <$Buyer> 您竞价的【<$ItemName>】已成交，物品已发放！
SendMsg 6 <$Seller> 您的【<$ItemName>】拍卖成交，获得<$NowPrice*0.9>元宝（扣除10%手续费）
;删除拍卖记录
DelVar Global Auction_<$i>_Info
#ELSEIF
CheckTime <$EndTime> <= <$TIME>
#ACT
;无买家时物品返还卖家
Give <$ItemID> 1 <$Seller>
SendMsg 6 <$Seller> 您的【<$ItemName>】拍卖到期未成交，物品已返还。
DelVar Global Auction_<$i>_Info
#NEXT


定时设置：在M2引擎“定时触发”中添加任务，触发间隔1分钟，脚本标签填“@AuctionCheck”。

四、两类脚本常见问题与解决方法

1. 充值脚本：支付无响应或道具不到账

- 接口参数错误：检查M2引擎“支付配置”中商户号、密钥是否与平台一致，回调地址是否能被外网访问，可通过“支付平台日志”查看是否有回调请求；

- 函数使用错误：GOM引擎“PayNotice”函数参数顺序为“金额（分）|支付类型|商品ID|扩展参数1|扩展参数2|扩展参数3|扩展参数4”，勿颠倒顺序；

- 变量未重置：若玩家支付失败后无法再次发起，检查“@PayBack”标签中是否有“SetVar HUMAN 支付中 0”，确保状态重置。

2. 拍卖行脚本：物品上架失败或竞价异常

- 物品判断疏漏：脚本中需添加“CheckItemCanTrade”函数判断物品是否可交易，避免非交易物品上架，代码示例“CheckItemCanTrade 0 1”；

- 变量存储错误：全局变量需用“SetVar Global”，玩家变量用“SetVar HUMAN”，勿混淆导致数据丢失；

- 定时任务未生效：确认M2引擎“定时触发”中任务已勾选“启用”，触发间隔设置合理，避免过短导致服务器卡顿。

五、脚本优化与管理：提升稳定性

1. 增加容错机制：应对异常场景

- 充值脚本：添加背包空间判断，避免元宝发放失败，代码“CheckBagSize > 0”；

- 拍卖行脚本：上架时判断物品价值，设置最低起拍价（如“CheckInput 0 > 10”），防止恶意低价。

2. 规范文件管理：便于后续维护

1. 命名规则：按“功能-模块-版本”命名，如“Recharge-10yuan-V1.txt”“Auction-Bid-V1.txt”；

2. 注释清晰：关键代码后添加注释，如“;Arg0=1支付成功，0失败”，便于后期修改；

3. 定期备份：每日备份“Scripts”文件夹与“Variable.txt”，避免脚本误删或数据丢失。

GOM传奇充值与拍卖行脚本的核心是“函数正确调用+数据精准存储”。充值脚本重点做好支付接口对接与回调处理，拍卖行脚本则需完善物品流转与定时逻辑。通过按步骤编写代码、细致测试与规范管理，两类脚本可稳定运行，既满足玩家交易需求，也为服务器运营提供支撑。