找回密码
 注册/Sign up
搜索
查看: 344|回复: 0

[教程] [教程] cgmsv LUA 脚本开发入门:模块加载与事件回调

[复制链接]

发表于 2026-10-25 17:48:07 | 显示全部楼层 |阅读模式
cgmsv LUA 脚本开发入门:模块加载与事件回调

(原创教程,写给刚接触 cgmsv LUA 的 GM 和开发者)

一、LUA 模块放哪里
服务端 lua 脚本位于 gmsv/lua/Modules/ 目录(不同端略有差异)。
cgmsv 启动时按顺序加载全部 .lua 模块;运行中也可以通过 GM 后台或控制台热加载,无需重启服务端。

二、模块基本结构
一个模块本质上就是一个 lua 文件,通常:
1. 定义模块名(用于识别和注册)。
2. 注册事件回调(NLG.RegisterCallback 系列)。
3. 定义事件处理函数。

三、常用接口(以 NLG 开头)
- NLG.RegisterCallback(事件名, 处理函数):注册某个游戏事件。
- NLG.SystemMessage(idx, msg):给指定玩家发送系统消息。
- 其他接口(物品发放、坐标传送等)在不同版本间有差异,写脚本前先看服务端自带示例模块(如 itemMall.lua、gmBridge.lua),照着最稳。

四、最小可运行示例
function OnPlayerLogin(idx)
    NLG.SystemMessage(idx, "欢迎回来!")
end
NLG.RegisterCallback("login", OnPlayerLogin)

保存为 hello.lua 放到 Modules 目录,重启或热加载后,玩家上线即可收到系统消息。

五、常见坑
1. 编码:多数端要求 lua 文件为 GBK 编码(无 BOM),用 UTF-8 保存中文可能乱码。
2. 回调函数名不要与系统保留名冲突。
3. 改完 lua 记得重载或重启 cgmsv,否则不生效。
4. 事件名拼写以服务端源码/示例为准,不同版本略有差异。

希望对新人有所帮助,欢迎留言交流。
您需要登录后才可以回帖 登录 | 注册/Sign up

本版积分规则

手机版|cgmsv引擎论坛

GMT+8, 2026-11-16 08:05 , Processed in 0.027902 second(s), 2 queries , Gzip On, Redis On.

Powered by Discuz! X3.5

© 2001-2026 Discuz! Team.

快速回复 返回顶部 返回列表