meta data for this page
📚 差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录前一修订版后一修订版 | 前一修订版 | ||
scripting:world:character [2025/01/01 14:38] – bibiboxs | scripting:world:character [2025/07/26 15:41] (当前版本) – bibiboxs | ||
---|---|---|---|
行 41: | 行 41: | ||
function OnCharacterPropChange( character: Character, oldProp: Prop, newProp: Prop ) | function OnCharacterPropChange( character: Character, oldProp: Prop, newProp: Prop ) | ||
``` | ``` | ||
- | |||
- | |||
- | |||
- | ### OnCharacterPropCountChange( character, oldCount, newCount ) | ||
- | |||
- | > 当角色背包池总数(`character.PropCount`)发生变化时调用。 | ||
- | > | ||
行 166: | 行 159: | ||
### ==Vehicle交互事件== | ### ==Vehicle交互事件== | ||
- | > 有关角色与拾取物的交互行为,具体内容请访问[Vehicle文档](scripting/ | + | > 有关角色与载具的交互行为,具体内容请访问[Vehicle文档](scripting/ |
行 289: | 行 282: | ||
> 设置角色透明度(0~255),默认值是`255`。 | > 设置角色透明度(0~255),默认值是`255`。 | ||
+ | > | ||
+ | > **注意:此方法不会修改手持物品透明度(`character.PropAlpha`)。`** | ||
```javascript | ```javascript | ||
character.Alpha = 255; //int | character.Alpha = 255; //int | ||
- | ``` | ||
- | |||
- | |||
- | |||
- | ### character.AlphaEntire | ||
- | |||
- | > 设置角色透明度变化是否包含全部子对象(例如:手持道具),默认值是`false`。 | ||
- | |||
- | ```javascript | ||
- | character.AlphaEntire = false; | ||
``` | ``` | ||
行 438: | 行 423: | ||
### character.AITarget | ### character.AITarget | ||
- | > 为当前角色设置一个AI目标**对象**,详情参考[《CharacterAI》文档](scripting/ | + | > 为当前角色设置一个AI目标**对象**,详情参考[《CharacterAI》文档](developer/ |
> | > | ||
> **注意:当前属性被设置成为`null`的值后,属性`AITargetPos`将被设置为`default`,==两种Target属性只能同时存在一个==。** | > **注意:当前属性被设置成为`null`的值后,属性`AITargetPos`将被设置为`default`,==两种Target属性只能同时存在一个==。** | ||
行 450: | 行 435: | ||
### character.AITargetPos | ### character.AITargetPos | ||
- | > 为当前角色设置一个AI目标**坐标**,详情参考[《CharacterAI》文档](scripting/ | + | > 为当前角色设置一个AI目标**坐标**,详情参考[《CharacterAI》文档](developer/ |
> | > | ||
> **注意:当前属性被设置成为`null`的值后,属性`AITargetPos`将被设置为`VECTOR_NULL`(常量,表示无意义\空坐标),==两种Target属性只能同时存在一个==。** | > **注意:当前属性被设置成为`null`的值后,属性`AITargetPos`将被设置为`VECTOR_NULL`(常量,表示无意义\空坐标),==两种Target属性只能同时存在一个==。** | ||
行 462: | 行 447: | ||
### character.AIState | ### character.AIState | ||
- | > 为当前角色设置一个AI状态(行为\性格),详情参考[《CharacterAI》文档](scripting/ | + | > 为当前角色设置一个AI状态(行为\性格),详情参考[《CharacterAI》文档](developer/ |
```javascript | ```javascript | ||
行 472: | 行 457: | ||
### character.AIMoveState | ### character.AIMoveState | ||
- | > 为当前角色设置一个AI移动行为状态(自动\行走\奔跑),详情参考[《CharacterAI》文档](scripting/ | + | > 为当前角色设置一个AI移动行为状态(自动\行走\奔跑),详情参考[《CharacterAI》文档](developer/ |
```javascript | ```javascript | ||
行 482: | 行 467: | ||
### character.AIDistance | ### character.AIDistance | ||
- | > 为当前角色设置一个AI距离属性(不同AI状态有不同的意义),详情参考[《CharacterAI》文档](scripting/ | + | > 为当前角色设置一个AI距离属性(不同AI状态有不同的意义),详情参考[《CharacterAI》文档](developer/ |
```javascript | ```javascript | ||
行 577: | 行 562: | ||
```javascript | ```javascript | ||
character.AdditionSpeedMultiplier = 1.0; | character.AdditionSpeedMultiplier = 1.0; | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### character.SwimMultiplier | ||
+ | |||
+ | > 设置角色**游泳速度**倍数(相对于`character.Speed`),默认为`0.6`。 | ||
+ | |||
+ | ```javascript | ||
+ | character.SwimMultiplier= 0.3; | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### character.CrouchMultiplier | ||
+ | |||
+ | > 设置角色**蹲下速度**倍数(相对于`character.Speed`),默认为`0.8`。 | ||
+ | |||
+ | ```javascript | ||
+ | character.CrouchMultiplier = 0.8; | ||
``` | ``` | ||
行 597: | 行 602: | ||
```javascript | ```javascript | ||
character.ActionContinue; | character.ActionContinue; | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### character.IsAI | ||
+ | |||
+ | > 获取角色是否为NPC(AI)。 | ||
+ | |||
+ | ```javascript | ||
+ | character.IsAI: | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### character.IsPlayer | ||
+ | |||
+ | > 获取角色是否为玩家控制的角色。 | ||
+ | |||
+ | ```javascript | ||
+ | character.IsPlayer: | ||
``` | ``` | ||
行 974: | 行 999: | ||
```javascript | ```javascript | ||
character.PropCount = 0; | character.PropCount = 0; | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### character.PropAlpha | ||
+ | |||
+ | > 设置**角色手持物品**透明度,默认值是`255`。 | ||
+ | |||
+ | ```javascript | ||
+ | character.PropAlpha = 255; | ||
``` | ``` | ||
行 1420: | 行 1455: | ||
- **node:**角色节点位置(索引) | - **node:**角色节点位置(索引) | ||
- **isLocal:**是否获取本地空间结果 | - **isLocal:**是否获取本地空间结果 | ||
+ | |||
+ | |||
+ | |||
+ | ### character.SetMount() | ||
+ | |||
+ | > 设置角色骑乘对象,如果设置为`null`表示取消骑乘。 | ||
+ | > | ||
+ | > 在**驾驶、死亡、目标死亡**等情况下,会自动取消骑乘。 | ||
+ | |||
+ | ```javascript | ||
+ | function character.SetMount( target: Character, localPos: Vector = null ) | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ### character.GetMount() | ||
+ | |||
+ | > 获取角色骑乘对象。 | ||
+ | |||
+ | ```javascript | ||
+ | function character.GetMount(): | ||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||