🎁
🏆 导航菜单
🎪 扩展内容
🎯 沙盘引擎文档
🕹️ 文章及书籍&教程
🎖️ 外部的链接
🎁
🏆 导航菜单
🎪 扩展内容
🎯 沙盘引擎文档
🕹️ 文章及书籍&教程
🎖️ 外部的链接
这是本文档旧的修订版!
原生脚本是一个内置的通用脚本功能类,此分类下还有更多通用的扩展工具类。
此文档内所代码均可在Client和World脚本及其子脚本直接进行使用。
标注原生(Native)类型的常量、类型、事件、函数方法等,它们都基于原生
Native
类。在脚本开发时可省略前缀
Native.XXXX
,而直接使用XXXX
即可。
三维坐标默认“空”坐标。
由于
Vector
是一个值类型,所以表示为空时不应该直接设为null
,在通常情况下应该使用常量代替。
const VECTOR_NULL = Vector3(-128000, -128000, -128000);
三维坐标结构类型,沙盘引擎世界坐标的通用形式,其中Y轴表示高度。
let pos = Vector(0, 0, 10); //X, Y, Z
x
:X轴数值(左右)y
:Y轴数值(上下)z
:Z轴数值(前后)颜色结构类型,表示一种RGBA组成的颜色,默认情况下
A=255
(可省略)。
let newColor = Color(255, 255, 255, 255); //R, G, B, A let newColor2 = Color(255, 255, 255); //R, G, B, A=255
r
:颜色数值g
:颜色数值b
:颜色数值a
:透明度数值(只读)射线检测函数的返回值,属性可获取射线检测结果(是否碰撞、最终坐标、检测实体等)。
IsHit
:是否碰撞射线Point
:射线检测坐标(如没有产生碰撞,则坐标即是默认终点)Entity
:射线碰撞实体(如果对象不是标准的Entity
实体,或对象为静态模型(本地静态模型),则返回为null
)当游戏配置(通过
SetGameOption
被绑定过的)发生主动更新时触发(或有数值被改变)。每次客户端脚本加载完成时,都会自动触发一次(
optionKey==null
)。
function OnGameOptionUpdate( optionKey: string )
function OnGameOptionUpdate( optionKey ) { if(optionKey == null) { //如果参数==null,表示不是由某个选项更新触发,而是引擎主动刷新 DLog("Force Update."); return; } //如果不为空,则OptionKey返回具体哪个选项发生更新 DLog("OnGameOptionUpdate: " + optionKey); }
卸载当前引擎,回到沙盘引擎初始界面。
注意:通常情况下,可以考虑优先将【退出游戏】操作替换为此方法,而不是直接
QuitGame()
关闭游戏。
function UnloadMod()
退出游戏,关闭沙盘引擎程序。
function QuitGame()
输出标准控制台信息(白色文本)。
function DLog("Hello World!");
输出警告类型控制台信息(黄色文本)。
function DWarn("Hello World!");
输出错误类型控制台信息(红色文本)。
function DError("Hello World!");
加载脚本目录下其他脚本文件(js)。
目标脚本将被续写在当前代码的作用域,共享当前环境(World或Client脚本)的代码及变量,开发者要自行分配隔离World\Client脚本,避免混用。
此方法适合对目录规范有需求的开发者,或者制作模块化功能、插件时使用。
function LoadScript( path: string )
path
:脚本目录下的 同级或子级 脚本文件路径(例如:"Test/MyCode.js")//路径规则 LoadScript("Test/MyCode.js"); //正确,读取Test目录下的MyCode.js LoadScript("Test/MyCode"); //正确,读取Test目录下的MyCode.js(可忽略".js") LoadScript("MyCode.js"); //正确,读取脚本目录下的MyCode.js LoadScript("../MyCode.js"); //错误,安全性考虑无法使用层级符号 //举例 //Main脚本 LoadScript("Test.js") TestAction(); //正常执行,执行Test.js脚本下的TestAction() /* 扩展解释:如果Main脚本原有一个TestAction()方法,但是后续加载了Test.js脚本,那么执行的应该是Test.js脚本的,因为后续加载覆写了早期方法 */ //Test.js function TestAction() { DLog("TestMode"); }
建立一个当前模组的服务器\房间世界。
任何情况下,使用此方法都将直接断开当前服务器并建立新的服务器,请确保相关数据提前保存。
function CreateHost( map: string, script: string, port: int = 0, address: string = "", userData: string = "", additional: bool = true ): bool //是否建立成功
载入并创建一个地图为“test2”且脚本为“Main2”的服务器。
CreateHost("test2", "Main2");
载入并创建一个地图为“test2”且脚本为“Main2”,端口指定为8195的服务器(0为默认端口,并非随机端口)。
默认端口配置文件:Mod.json
["NetworkPort": 8192]
。
CreateHost("test2", "Main2", 8195);
载入并创建一个地图为“test2”且脚本为“Main2”,端口随意,但使用SteamP2P网络的房间(地址参数填写
steam
)。
CreateHost("test2", "Main2", 0, "steam");
UserData
参数可传递给服务器一个前置字符串参数(长度限制0~256,可用Json扩展),可提前告知服务器一些【玩家自身】自定义信息。(World脚本可用player.UserData读取内容)
CreateHost("test2", "Main2", 0, "", "TestStringOrJson...");
additional
参数可指定是否使用地图附加内容(例如:地图内创建的载具),默认为true
,如果只希望加载纯净的地图则设置为false
。
CreateHost("test2", "Main2", 0, "", "", false);
连接并加载到指定的多人游戏服务器,开发者应自行编写代码,确保参数信息正确。
任何情况下,使用此方法都将直接断开当前服务器并尝试连接到新的服务器。
function ConnectHost(address: string, port: int = 0, password: string = "", userData: string = "")
尝试连接并加载到指定IP地址的服务器
方法与CreateHost部分相同,
0
表示默认端口,服务器密码可空
UserData
参数可传递给服务器一个前置字符串参数(长度限制0~256,可用Json扩展),可提前告知服务器一些【玩家自身】自定义信息(World脚本可用player.UserData读取内容)
ConnectHost("127.0.0.1");
断开当前正在连接的服务器\房间\世界,并回到入口场景(
Main
)。任何情况下,使用此方法都将直接断开当前服务器。
function Disconnect()
断开当前正在连接的服务器\房间\世界,并尝试重新连接到上次的服务器(如果没有记录,则不会生效)。
任何情况下,使用此方法都将直接断开当前服务器。
function Reconnect()
获取当前是否为服务端模式(仅作为专用服务器启动,通常由
bat
格式扩展)。
function IsServerMode(): bool
获取游戏启动至此已运行的时间(秒)。
function GetEngineTickCount(): float
获取模组启动至此已运行的时间(秒)。
如果期间发生了延迟加载、重载模组等情况,此时间也会被随之重置。
function GetModTickCount(): float
获取系统时间。
返回格式会按照
yyyy-MM-dd|HH:mm:ss
进行字符串处理,开发者可通过split
得到的数组获取单独的值。
function GetDateTime(): string
获取Unix时间戳(格林威治时间1970年01月01日00时00分00秒)。
function GetDateTime(): int
获取系统信息
json
格式。你可以在合规的范围内使用这些非隐私的信息,以来进行如游戏配置自适应、反作弊等操作。
function GetDeviceInfo(): Json
设置一个全局变量(可跨脚本使用),支持绝大部分类型的JavaScript变量(如:数组、对象等)。
此功能可善用扩展,例如:菜单界面设置【服务器名称、服务器模式等】全局变量对象,待服务器加载完毕事件读取,并根据数值来修改逻辑。
如果一个全局变量不再使用,可以将其设置为
value = null
删除全局变量。
function SetGlobalVars( key: string, value: any )
//设置一个字符串类型的全局变量 SetGlobalVars("myWebsite", "www.abc.com"); //设置一个JavaScript扩展对象全局变量 SetGlobalVars("createServerConfig", { serverName: "服务器名称", gameMode: 1, openPVP: false });
读取一个全局变量(可跨脚本使用),支持绝大部分类型的JavaScript变量(如:数组、对象等)。
如指定
key
不存在则返回null
。
function GetGlobalVars( key: string ): any
//设置一个JavaScript扩展对象全局变量 SetGlobalVars("createServerConfig", { serverName: "服务器名称", gameMode: 1, openPVP: false }); //读取时可正常进行读取 let getConfig = GetGlobalVars("createServerConfig"); DLog("serverName: " + getConfig.serverName);
获取当前加载的脚本名称。
function GetScriptName(): string
获取当前加载的地图名称(并非地图文件名,而是地图名),可用作判定特定地图。
function GetMapName(): string
获取两个坐标点之间的距离,单位是沙盘引擎世界距离。
function DistancePoint( pos: Vector, pos2: Vector ): float
获取某个点是否在多边形点范围内(X\Z是否在某片2D形状范围内)。
注意:此方法判断坐标系只需要X\Z轴,Y轴数值可以忽略(最低要求输入3个多边形点,最多支持8个多边形点验证)。
function InPoly( pos: Vector, p1: Vector, p2: Vector, p3: Vector, p4: Vector = null, p5: Vector = null, p6: Vector = null, p7: Vector = null, p8: Vector = null ): bool
DLog(InPoly(Vector(0, 0, 0), Vector(-10, 0, -10), Vector(-10, 0, 10), Vector(10, 0, 10), Vector(10, 0, -10))); //返回true