课时 18 · 环境架设与工程结构

本课的代码跑在 996 引擎里，用到的是服务端接口（changeexp、 SetInt 这类），在线运行器里没有这些函数。每个函数的签名都能在文档检索里按名字查到原文。

本课目标

能独立架设单机服务端并进入游戏。

知识讲解

环境准备流程：下载 996 新三端引擎与服务端程序 → 按说明配置数据库与账号 → 启动服务端 → 客户端连接进入游戏。进入开发环节前，重点了解脚本目录结构与重载机制。

搭建教程：

下载官方HUB工具，下载地址：https://huiyue.996yinqing.com/engineDownload?tab=1
使用HUB工具下载版本库

下载解压版本库，内部自带一份“基础版导入HUB说明.docx”，可按详细步骤搭建，不过我们是搭建LUA版本，需要对Lua端勾选上如下：
下载本机数据

下载地址：https://engine-doc.996m2.com/web/#/91/196794
启动引擎。配置自己的数据库端口，数据库名，数据端口一定要对上。先保存再启动游戏服务。
启动游戏
由于官方提供的是TXT的版本，服务端Market_Def文件夹下可能没有QFunction-0.lua文件，需自己创建一个。并在里面添加一个事件比如login玩家登录触发等，测试一下是否正常，如果login不触发可检查M2=>选项=>gameData配置在面板将“合并QFQM触发”勾选上，退出游戏重新，看M2是否有打印触发消息

QF示例

function startup()
release_print("服务端启动触发")
end
function login(actor)
release_print("玩家",actor,"登录触发")
end
function playdie(actor,hitter)
release_print("死亡")
realive(actor)
end
function run(actor)
release_print("run")
end

脚本重载：服务端脚本按文件组织，QFunction-0 是核心脚本文件之一。修改脚本后执行重载，引擎在重载完成后触发 qfloadend 全局函数——它是「重载后触发」接口，常用于打印加载完成信息或做初始化。

示例：QFunction-0 重载后触发

function qfloadend()
    release_print('QFunction-0重载后触发')
end

来源：本地文档触发\系统\QFunction-0重载后触发.md。

release_print 是「打印消息到控制台」接口，接收任意多个参数，把内容输出到服务端控制台，是最常用的调试输出手段。

来源：本地文档接口\系统\打印消息到控制台.md。

练习任务

完成单机架设并进入游戏；在 QFunction-0 中写好 qfloadend 函数，执行脚本重载，观察控制台输出，验证重载生效。

参考：验收要点

服务端能正常启动，客户端可进入游戏；
重载后控制台出现「QFunction-0重载后触发」字样；
修改脚本并重载后，新逻辑立即生效（无需重启服务端）。