meta data for this page
  •  

📚 差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

后一修订版		前一修订版
scripting:world:checkpoint [2023/08/01 13:34] – 创建 bibiboxsscripting:world:checkpoint [2025/08/16 06:05] (当前版本) – bibiboxs
行 1: 行 1:
 <markdown> <markdown>
 # World/Checkpoint # World/Checkpoint
 +> 注意：`Checkpoint`仅允许`Character`类型主动触发，如果`Character`正在驾驶\乘坐载具，则会在载具进入触发范围时**所有载具内角色**触发相关事件。
  
 ## Event ## Event
行 6: 行 7:
 ### OnCheckpointEntered( checkpoint,  character )  ### OnCheckpointEntered( checkpoint,  character ) 
  
-> 当角色进入检查点时触发，角色同一时间只能触发一个检查点。+> 当角色进入检查点时触发，角色同一时间可触发多个检查点（如果在范围内）。
 > >
  
行 65: 行 66:
 ### checkpoint.UUID ### checkpoint.UUID
  
-> 获取检查点UUID，这是由一串较长的字符串组成的全局唯一**文本ID**。+> 获取检查点UUID，这是由一串较长的字符串组成的全局唯一**文本ID**（实例化时自动赋值，非持久化数据）。
  
 ```javascript ```javascript
行 79: 行 80:
 ```javascript ```javascript
 checkpoint.Pos = Vector(0, 0, 0); checkpoint.Pos = Vector(0, 0, 0);
 +```
 +
 +
 +
 +### checkpoint.World
 +
 +> 设置检查点实例世界ID（不同世界将不可视\不可交互）。
 +
 +```javascript
 +checkpoint.World = 0; //int
 +```
 +
 +
 +
 +### checkpoint.Group
 +
 +> 设置检查点**实例组**（这是一个Entity基类通用属性）。
 +>
 +> 默认值`0`表示特殊组（无分组机制），如实例组不为0，则只有相同组的检查点和对象才会触发。
 +
 +```javascript
 +checkpoint.Group = 0; //int
 ``` ```
  
行 155: 行 178:
  
 ```javascript ```javascript
-function Checkpoint.Find( uuid: string ): Checkpoint+function Checkpoint.FindByUUID( uuid: string ): Checkpoint 
 +``` 
 + 
 + 
 + 
 +### Checkpoint.GetCount() 
 + 
 +> 获取当前所有存在检查点数量。 
 + 
 +```javascript 
 +function Checkpoint.GetCount(): int 
 +``` 
 + 
 + 
 + 
 +### Checkpoint.Get() 
 + 
 +> 获取当前存在的指定索引检查点，通常搭配`GetCount()`遍历使用。 
 + 
 +```javascript 
 +function Checkpoint.Get( index: int ): Checkpoint
 ``` ```
  
行 167: 行 210:
  
 ```javascript ```javascript
-function checkpoint.Remove()+function checkpoint.Remove( hasAnim: bool = true )
 ``` ```
 +
 +- `hasAnim`是否执行销毁动画（默认`true`），否则立即销毁
  
  
行 188: 行 233:
 } }
 ``` ```
 +
 +
 +
 +
 +
 +
 +
 +
  
  
 </markdown> </markdown>