🎁
🏆 导航菜单
🎪 扩展内容
🎯 沙盘引擎文档
🕹️ 文章及书籍&教程
🎖️ 外部的链接
🎁
🏆 导航菜单
🎪 扩展内容
🎯 沙盘引擎文档
🕹️ 文章及书籍&教程
🎖️ 外部的链接
言简意赅,这是每个模组根目录可选的附带文件,允许为模组提供一些前置文本数据。
它的作用:允许开发者通过GetGlobalVars("Startup")
获取此文件内的所有文本(内容只读,且并不限于json
文本格式,即使内部是一串诗歌也不会报错)。
通过此属性的机制,开发者可扩展实现许多前置功能(例如:专用服务端的前置配置,房间名、端口号、房间最大人数等)。
《沙盘引擎》默认是没有提供【专用服务器.bat】的启动配置文件。
这就导致,以Server.Bat
方式建立的服务器无法获取自定义配置,开发者可能希望制作一个json\txt
表的方式,让每次建立专用服务器时引擎知道该设置什么样的服务器名称、最大人数是多少,以及自定义端口等其他更多配置。
如果有类似这样的(或举一反三)相关需求,就可以利用此机制来做前置配置文件。
在模组根目录建立或打开Startup.json
文件,准备修改
将此文件内容修改成自己可解析的模式,这里可以使用json文本方式,根据需求自行编写一套数据表
{ "HostName": "Sandtable Engine Server", "Map": "helloworld", "MaxPlayers": 100, "Password": "", "RconPassword": "" }
确认正确编写后,在Main
场景的启动事件中,使用GetGlobalVars("Startup")
获取到Startup.json
内的文本信息,并转成自己想要的格式(如果是标准json文本,则会自动反序列化)
使用获取后的内容,按需求来编写逻辑代码
function OnScriptLoad() { if(IsServerMode()) { //因为示例是json文本,所以会自动序列化,可直接使用属性 let startup = GetGlobalVars("Startup"); DLog(startup.HostName); //"Sandtable Engine Server" } }
因为GetGlobalVars()
是模组全局生效的,所以可以在不同场景一直使用