这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录前一修订版后一修订版 | 前一修订版 | ||
scripting:native:main [2023/09/18 21:39] – bibiboxs | scripting:native:main [2024/03/31 16:57] (当前版本) – bibiboxs | ||
---|---|---|---|
行 34: | 行 34: | ||
```javascript | ```javascript | ||
let pos = Vector(0, 0, 10); //X, Y, Z | let pos = Vector(0, 0, 10); //X, Y, Z | ||
+ | |||
+ | //Extend | ||
+ | pos.magnitude; | ||
+ | pos.normalized; | ||
``` | ``` | ||
行 65: | 行 69: | ||
- `Point`:射线检测坐标(如没有产生碰撞,则坐标即是默认终点) | - `Point`:射线检测坐标(如没有产生碰撞,则坐标即是默认终点) | ||
- `Entity`:射线碰撞实体(如果对象不是标准的`Entity`实体,或对象为**静态模型(本地静态模型)**,则返回为`null`) | - `Entity`:射线碰撞实体(如果对象不是标准的`Entity`实体,或对象为**静态模型(本地静态模型)**,则返回为`null`) | ||
+ | |||
+ | |||
+ | |||
+ | ### VectorPoint() | ||
+ | |||
+ | > 坐标点结构类型,表示一组由**坐标、旋转、缩放**三个Vector类型组成的对象,并且包含一个**Tag标签**以供可选筛选。 | ||
+ | > | ||
+ | > 此类型只有坐标记录的功能,通常用于地图编辑器(ID5物体)与脚本的可见预设坐标交互。 | ||
+ | > | ||
+ | > 使用此结构时**不应该使用**`new VectorPoint| VectorPoint()`这类方法,而是应该使用`AddVectorPoint()`等方法增加到后台。 | ||
+ | > | ||
+ | > **注意:结构内的三种Vector类型虽然命名不同,但均是以`Vector`作为属性类型,因此在某些情况下可以忽略命名问题。** | ||
+ | |||
+ | - `Tag`:筛选标签(可空`"" | ||
+ | - `Pos`:坐标(Vector,不可空,至少要有一个) | ||
+ | - `Angle`:旋转角度(Vector,可空) | ||
+ | - `Scale`:缩放(Vector,可空) | ||
行 195: | 行 216: | ||
> | > | ||
> 任何情况下,使用此方法都将**直接断开当前服务器并建立新的服务器**,请确保相关数据提前保存。 | > 任何情况下,使用此方法都将**直接断开当前服务器并建立新的服务器**,请确保相关数据提前保存。 | ||
+ | > | ||
+ | > **补充:如果不填写任何参数,则表示加载到初始入口世界(`Main`世界)。** | ||
+ | > | ||
+ | > **==注意:我们建议不指定固定的端口号,而是使用`Mod.json -> NetworkPort`机制设定模组端口,并设置当前方法参数`Port=0`(自动识别模组`NetworkPort`)。==** | ||
```javascript | ```javascript | ||
行 285: | 行 310: | ||
- | ### CheckServerMode() | + | ### IsServerMode() |
- | > 获取当前是否为**服务端模式**(仅作为服务器启动)。 | + | > 获取当前是否为**服务端模式**(仅作为专用服务器启动,通常由`bat`格式扩展)。 |
> | > | ||
```javascript | ```javascript | ||
- | function | + | function |
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### IsNewPlayer() | ||
+ | |||
+ | > 判断当前是否为**玩家初次进入此模组**。 | ||
+ | |||
+ | ```javascript | ||
+ | function IsNewPlayer(): bool | ||
``` | ``` | ||
行 421: | 行 456: | ||
``` | ``` | ||
+ | |||
+ | |||
+ | ### GetMapCount() | ||
+ | |||
+ | > 获取当前用户本地地图数量,可使用`filter`进行条件过滤。 | ||
+ | |||
+ | ```javascript | ||
+ | function GetMapCount( filter: int = 0 ): int | ||
+ | ``` | ||
+ | |||
+ | | 过滤Filter | 说明 | ||
+ | | ---------- | ---------------------------- | | ||
+ | | 0 | 默认全部(模组> | ||
+ | | 1 | 只获取模组内置地图 | ||
+ | | 2 | 只获取`Map`地图目录 | ||
+ | | 3 | 只获取`Map\Download`地图目录 | | ||
+ | |||
+ | |||
+ | |||
+ | ### GetMapByIndex() | ||
+ | |||
+ | > 获取当前用户**指定索引**本地地图**文件名称**,通常搭配`GetMapCount()`遍历使用,可使用`filter`进行条件过滤。 | ||
+ | |||
+ | ```javascript | ||
+ | function GetMapByIndex( index: int, filter: int = 0 ): string | ||
+ | ``` | ||
+ | |||
+ | ```javascript | ||
+ | let mapCount = GetMapCount(); | ||
+ | for(let i=0; | ||
+ | { | ||
+ | DLog(i + ">" | ||
+ | } | ||
+ | ``` | ||
+ | |||
+ | |||
+ | ### GenerateUUID() | ||
+ | |||
+ | > 生成一段唯一的UUID字符串(GUID)。 | ||
+ | > | ||
+ | > 在绝大部分情况下,由此方法生成的UUID应该是全球唯一的。 | ||
+ | |||
+ | ```javascript | ||
+ | function GenerateUUID(): | ||
+ | ``` | ||
行 429: | 行 509: | ||
```javascript | ```javascript | ||
function DistancePoint( pos: Vector, pos2: Vector ): float | function DistancePoint( pos: Vector, pos2: Vector ): float | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### OverlapEntity() | ||
+ | |||
+ | > 在指定位置**检测并记录范围检测世界实体**(某坐标指定范围内所有对象),可用于检测指定位置的范围内实体对象(基于`Entity`的核心对象)。 | ||
+ | > | ||
+ | > 如果只希望获取`Entity`基础类型中其中的一个或多个子类,可使用`filter`参数进行筛选(位操作)。 | ||
+ | > | ||
+ | > **注意:此方法只用于单次记录,==并返回检测到的数量==,应搭配使用`OverlapEntityByIndex()`获取具体索引的对象实例。** | ||
+ | > | ||
+ | > ==(此方法在World\Client脚本有隔离机制,无须担心结果重叠覆盖问题)== | ||
+ | |||
+ | ```javascript | ||
+ | function OverlapEntity( pos: Vector, radius: float, filter: int = 0 ): int | ||
+ | ``` | ||
+ | |||
+ | | 过滤(Filter) | 说明 | ||
+ | | -------------- | ---------- | | ||
+ | | 0 | 默认全部 | ||
+ | | 1 | Model | | ||
+ | | 2 | Character | ||
+ | | 4 | Vehicle | ||
+ | | 8 | Pickup | ||
+ | | 16 | Checkpoint | | ||
+ | |||
+ | ```javascript | ||
+ | //Only check ' | ||
+ | OverlapEntity(Vector(0, | ||
+ | //or | ||
+ | OverlapEntity(Vector(0, | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### OverlapEntityByIndex() | ||
+ | |||
+ | > 获取由`OverlapEntity()`记录后的**指定索引实例**,如不存在或已销毁则返回`null`。 | ||
+ | > | ||
+ | > **注意:此方法使用前必须执行一次`OverlapEntity()`,以此获取最新的范围内检测信息。** | ||
+ | > | ||
+ | > ==(此方法在World\Client脚本有隔离机制,无须担心结果重叠覆盖问题)== | ||
+ | |||
+ | ```javascript | ||
+ | function OverlapEntityByIndex( index: int ): Entity | ||
+ | ``` | ||
+ | |||
+ | ```javascript | ||
+ | let count = OverlapEntity(Vector(0, | ||
+ | if(count > 0) | ||
+ | { | ||
+ | DLog(i + " | ||
+ | } | ||
``` | ``` | ||
行 445: | 行 579: | ||
DLog(InPoly(Vector(0, | DLog(InPoly(Vector(0, | ||
``` | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### GetLanguage() | ||
+ | |||
+ | > 获取**当前[引擎语言](developer/ | ||
+ | > | ||
+ | > **例如:沙盘引擎本体支持A语言,但当前模组可能仅支持B语言,此时返回的是A语言的标准英文名称。** | ||
+ | > | ||
+ | > ==通常情况下,开发者应该主动参考此方法获得的语言名称。此方法也会在游戏启动时自动识别`GetSystemLanguage()`系统语言兼容。== | ||
+ | |||
+ | ```javascript | ||
+ | function GetLanguage(): | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### GetModLanguage() | ||
+ | |||
+ | > 获取**当前[模组语言](developer/ | ||
+ | > | ||
+ | > **例如:沙盘引擎默认暂不支持A语言,但当前模组支持B语言,此时返回的是B语言的标准英文名称。** | ||
+ | |||
+ | ```javascript | ||
+ | function GetLanguage(): | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### GetSystemLanguage() | ||
+ | |||
+ | > 获取**当前[系统识别语言](developer/ | ||
+ | > | ||
+ | |||
+ | ```javascript | ||
+ | function GetLanguage(): | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### GetLanguageText() | ||
+ | |||
+ | > 获取[游戏语言文件](developer/ | ||
+ | |||
+ | ```javascript | ||
+ | function GetLanguageText( key: string, params: any... ): string | ||
+ | function GetLanguageText( key: string, index: int = 0, params: any... ): string | ||
+ | ``` | ||
+ | |||
+ | - `key`:游戏语言文件内的完整路径 | ||
+ | - `index`:可省略参数,表示语言结构数组索引,默认或省略为`0` | ||
+ | - `params`:如果目标语言文本拥有`{0}{1}{2}`占位替换符号,可以根据索引填写后续参数 | ||
+ | |||
+ | > 此方法的使用扩展性比较强,几乎可覆盖大多数多语言文本需求。 | ||
+ | > | ||
+ | > 同时为了方便开发者减少代码量,这里提供了一个简单的映射方法`_Language()`,与此函数作用完全相同。 | ||
+ | |||
+ | ```javascript | ||
+ | GetLanguageText(" | ||
+ | _Language(" | ||
+ | |||
+ | _Language(" | ||
+ | _Language(" | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### GetVectorPointCount() | ||
+ | |||
+ | > 获取当前世界所有满足`Tag`标签筛选的`VectorPoint`坐标点**数量**。 | ||
+ | |||
+ | ```javascript | ||
+ | function GetVectorPointCount( tag: string = "" | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### GetVectorPoint() | ||
+ | |||
+ | > 获取当前世界所有满足`Tag`标签筛选的`VectorPoint`坐标点**对象**,通常搭配`GetVectorPointCount()`遍历使用。 | ||
+ | > | ||
+ | > **具体`VectorPoint`数值对象参考本文上方`Type`部分。** | ||
+ | > | ||
+ | > **==注意:通过此方法获取的对象可进行set修改其内部属性,仅限本地使用,不会同步到其他客户端。==** | ||
+ | |||
+ | ```javascript | ||
+ | function GetVectorPoint( tag: string, index: int = 0 ): VectorPoint | ||
+ | ``` | ||
+ | |||
+ | ```javascript | ||
+ | //Test Code | ||
+ | let tag = " | ||
+ | let count = GetVectorPointCount(tag); | ||
+ | for(let i=0; | ||
+ | { | ||
+ | DLog(GetVectorPoint(tag, | ||
+ | } | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### AddVectorPoint() | ||
+ | |||
+ | > 增加一条指定`Tag`标签的`VectorPoint`坐标点**对象**,如果不需要`Tag`标签也可以留空(这会导致无法通过`RemoveVectorPoint()`针对删除)。 | ||
+ | |||
+ | ```javascript | ||
+ | function AddVectorPoint( tag: string, pos: Vector, angle: Vector = null, scale: Vector = null ): VectorPoint | ||
+ | ``` | ||
+ | |||
+ | ```javascript | ||
+ | //Test Code | ||
+ | AddVectorPoint("", | ||
+ | AddVectorPoint(" | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### RemoveVectorPoint() | ||
+ | |||
+ | > 移除**所有**符合指定`Tag`标签条件的`VectorPoint`坐标点**对象**(也可以留空`Tag`标签,会删除所有没有`Tag`标签的坐标点对象)。 | ||
+ | |||
+ | ```javascript | ||
+ | function RemoveVectorPoint( tag: string = "" | ||
+ | ``` | ||
+ | |||
+ | ```javascript | ||
+ | //Test Code | ||
+ | RemoveVectorPoint(); | ||
+ | RemoveVectorPoint(" | ||
+ | ``` | ||
+ | |||
+ | |||
+ | ### FormatRichText() | ||
+ | > 格式化指定文本为引擎富文本(并非传统意义的`Richtext`),这将使一段文本执行以下操作:**链接地址标蓝、@玩家名(高亮)、# | ||
+ | |||
+ | ```javascript | ||
+ | function FormatRichText( text: string, onlyEmoji: bool = false ) | ||
+ | ``` | ||
+ | |||
+ | - **onlyEmoji:**如果设置为`true`,则`# | ||
+ | |||
+ | ```javascript | ||
+ | FormatRichText("# | ||
+ | FormatRichText("# | ||
+ | ``` | ||
+ | |||
+ | |||