--- title: "角色 Char" description: "角色创建 / 位置 / 载具 / 状态 / 武器" --- --- title: 角色 Char description: 角色创建 / 位置 / 载具 / 状态 / 武器 --- `sa` · 扩展 `default` · SCM 原生命令共 252 条。写法见 [Lua](/docs/cleo/syntax) / [Redux](/docs/cleo/syntax-redux)。 ## 创建角色在指定位置创建角色，使用给定模型与 pedtype。 ```text 009A CREATE_CHAR in: pedType, modelId, x, y, z out: handle ``` ```lua local handle = createChar(pedType, modelId, x, y, z) ``` ```js Char.create(pedType, modelId, x, y, z) ``` ## 删除角色从游戏和任务清理列表移除角色并释放内存。 ```text 009B DELETE_CHAR in: self ``` ```lua deleteChar(self) ``` ```js Char.delete(self) ``` ## 取坐标返回角色坐标。 ```text 00A0 GET_CHAR_COORDINATES in: self out: x, y, z ``` ```lua local x, y, z = getCharCoordinates(self) ``` ```js Char.getCoordinates(self) ``` ## 设坐标把角色放到指定位置。 ```text 00A1 SET_CHAR_COORDINATES in: self, x, y, z ``` ```lua setCharCoordinates(self, x, y, z) ``` ```js Char.setCoordinates(self, x, y, z) ``` ## 是否在 2D 区域用在 if：角色是否在指定 2D 区域内。 ```text 00A3 IS_CHAR_IN_AREA_2D in: self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere ``` ```lua isCharInArea2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere) ``` ```js Char.isInArea2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere) ``` ## 是否在 3D 区域用在 if：角色是否在指定 3D 区域内。 ```text 00A4 IS_CHAR_IN_AREA_3D in: self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere ``` ```lua isCharInArea3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere) ``` ```js Char.isInArea3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere) ``` ## 存当前车辆返回角色当前车辆并加入任务清理列表（另见 03C0、0811、0484）。 ```text 00D9 STORE_CAR_CHAR_IS_IN in: self out: handle ``` ```lua local handle = storeCarCharIsIn(self) ``` ```js Char.storeCarIsIn(self) ``` ## 是否在指定车用在 if：角色是否在指定车辆中。 ```text 00DB IS_CHAR_IN_CAR in: self, vehicle ``` ```lua isCharInCar(self, vehicle) ``` ```js Char.isInCar(self, vehicle) ``` ## 是否在指定车型用在 if：角色是否驾驶指定模型车辆。 ```text 00DD IS_CHAR_IN_MODEL in: self, modelId ``` ```lua isCharInModel(self, modelId) ``` ```js Char.isInModel(self, modelId) ``` ## 是否在任意车用在 if：角色是否拥有车辆（含开关门过程，未必已坐稳）。 ```text 00DF IS_CHAR_IN_ANY_CAR in: self ``` ```lua isCharInAnyCar(self) ``` ```js Char.isInAnyCar(self) ``` ## 任意方式在 2D 点用在 if：角色是否在坐标点 2D 半径内。 ```text 00EC LOCATE_CHAR_ANY_MEANS_2D in: self, x, y, xRadius, yRadius, drawSphere ``` ```lua locateCharAnyMeans2D(self, x, y, xRadius, yRadius, drawSphere) ``` ```js Char.locateAnyMeans2D(self, x, y, xRadius, yRadius, drawSphere) ``` ## 徒步在 2D 点用在 if：角色是否徒步在坐标点 2D 半径内。 ```text 00ED LOCATE_CHAR_ON_FOOT_2D in: self, x, y, xRadius, yRadius, drawSphere ``` ```lua locateCharOnFoot2D(self, x, y, xRadius, yRadius, drawSphere) ``` ```js Char.locateOnFoot2D(self, x, y, xRadius, yRadius, drawSphere) ``` ## 车内在 2D 点用在 if：角色是否在车内且位于坐标点 2D 半径内。 ```text 00EE LOCATE_CHAR_IN_CAR_2D in: self, x, y, xRadius, yRadius, drawSphere ``` ```lua locateCharInCar2D(self, x, y, xRadius, yRadius, drawSphere) ``` ```js Char.locateInCar2D(self, x, y, xRadius, yRadius, drawSphere) ``` ## 停下任意 2D 用在 if：角色是否已停在坐标点 2D 半径内。 ```text 00EF LOCATE_STOPPED_CHAR_ANY_MEANS_2D in: self, x, y, xRadius, yRadius, drawSphere ``` ```lua locateStoppedCharAnyMeans2D(self, x, y, xRadius, yRadius, drawSphere) ``` ```js Char.locateStoppedAnyMeans2D(self, x, y, xRadius, yRadius, drawSphere) ``` ## 停下徒步 2D 用在 if：角色是否徒步停在坐标点 2D 半径内。 ```text 00F0 LOCATE_STOPPED_CHAR_ON_FOOT_2D in: self, x, y, xRadius, yRadius, drawSphere ``` ```lua locateStoppedCharOnFoot2D(self, x, y, xRadius, yRadius, drawSphere) ``` ```js Char.locateStoppedOnFoot2D(self, x, y, xRadius, yRadius, drawSphere) ``` ## 停下车内 2D 用在 if：角色是否在车内停在坐标点 2D 半径内。 ```text 00F1 LOCATE_STOPPED_CHAR_IN_CAR_2D in: self, x, y, xRadius, yRadius, drawSphere ``` ```lua locateStoppedCharInCar2D(self, x, y, xRadius, yRadius, drawSphere) ``` ```js Char.locateStoppedInCar2D(self, x, y, xRadius, yRadius, drawSphere) ``` ## 相对角色任意 2D 用在 if：角色是否在另一角色 2D 半径内。 ```text 00F2 LOCATE_CHAR_ANY_MEANS_CHAR_2D in: self, target, xRadius, yRadius, drawSphere ``` ```lua locateCharAnyMeansChar2D(self, target, xRadius, yRadius, drawSphere) ``` ```js Char.locateAnyMeansChar2D(self, target, xRadius, yRadius, drawSphere) ``` ## 相对角色徒步 2D 用在 if：角色是否徒步在另一角色 2D 半径内。 ```text 00F3 LOCATE_CHAR_ON_FOOT_CHAR_2D in: self, target, xRadius, yRadius, drawSphere ``` ```lua locateCharOnFootChar2D(self, target, xRadius, yRadius, drawSphere) ``` ```js Char.locateOnFootChar2D(self, target, xRadius, yRadius, drawSphere) ``` ## 相对角色车内 2D 用在 if：角色是否在车内且位于另一角色 2D 半径内。 ```text 00F4 LOCATE_CHAR_IN_CAR_CHAR_2D in: self, otherChar, xRadius, yRadius, drawSphere ``` ```lua locateCharInCarChar2D(self, otherChar, xRadius, yRadius, drawSphere) ``` ```js Char.locateInCarChar2D(self, otherChar, xRadius, yRadius, drawSphere) ``` ## 任意方式在 3D 点用在 if：角色是否在坐标点 3D 半径内。 ```text 00FE LOCATE_CHAR_ANY_MEANS_3D in: self, x, y, z, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateCharAnyMeans3D(self, x, y, z, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateAnyMeans3D(self, x, y, z, xRadius, yRadius, zRadius, drawSphere) ``` ## 徒步在 3D 点用在 if：角色是否徒步在坐标点 3D 半径内。 ```text 00FF LOCATE_CHAR_ON_FOOT_3D in: self, x, y, z, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateCharOnFoot3D(self, x, y, z, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateOnFoot3D(self, x, y, z, xRadius, yRadius, zRadius, drawSphere) ``` ## 车内在 3D 点用在 if：角色是否在车内且位于坐标点 3D 半径内。 ```text 0100 LOCATE_CHAR_IN_CAR_3D in: self, x, y, z, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateCharInCar3D(self, x, y, z, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateInCar3D(self, x, y, z, xRadius, yRadius, zRadius, drawSphere) ``` ## 停下任意 3D 用在 if：角色是否已停在坐标点 3D 半径内。 ```text 0101 LOCATE_STOPPED_CHAR_ANY_MEANS_3D in: self, x, y, z, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateStoppedCharAnyMeans3D(self, x, y, z, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateStoppedAnyMeans3D(self, x, y, z, xRadius, yRadius, zRadius, drawSphere) ``` ## 停下徒步 3D 用在 if：角色是否徒步停在坐标点 3D 半径内。 ```text 0102 LOCATE_STOPPED_CHAR_ON_FOOT_3D in: self, x, y, z, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateStoppedCharOnFoot3D(self, x, y, z, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateStoppedOnFoot3D(self, x, y, z, xRadius, yRadius, zRadius, drawSphere) ``` ## 停下车内 3D 用在 if：角色是否在车内停在坐标点 3D 半径内。 ```text 0103 LOCATE_STOPPED_CHAR_IN_CAR_3D in: self, x, y, z, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateStoppedCharInCar3D(self, x, y, z, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateStoppedInCar3D(self, x, y, z, xRadius, yRadius, zRadius, drawSphere) ``` ## 相对角色任意 3D 用在 if：角色是否在另一角色 3D 半径内。 ```text 0104 LOCATE_CHAR_ANY_MEANS_CHAR_3D in: self, target, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateCharAnyMeansChar3D(self, target, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateAnyMeansChar3D(self, target, xRadius, yRadius, zRadius, drawSphere) ``` ## 相对角色徒步 3D 用在 if：角色是否徒步在另一角色 3D 半径内。 ```text 0105 LOCATE_CHAR_ON_FOOT_CHAR_3D in: self, target, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateCharOnFootChar3D(self, target, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateOnFootChar3D(self, target, xRadius, yRadius, zRadius, drawSphere) ``` ## 相对角色车内 3D 用在 if：角色是否在车内且位于另一角色 3D 半径内。 ```text 0106 LOCATE_CHAR_IN_CAR_CHAR_3D in: self, target, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateCharInCarChar3D(self, target, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateInCarChar3D(self, target, xRadius, yRadius, zRadius, drawSphere) ``` ## 加弹药若角色持有该武器，则增加指定弹药量。 ```text 0114 ADD_AMMO_TO_CHAR in: self, weaponType, ammo ``` ```lua addAmmoToChar(self, weaponType, ammo) ``` ```js Char.addAmmo(self, weaponType, ammo) ``` ## 是否死亡用在 if：句柄无效或角色已死（wasted）。 ```text 0118 IS_CHAR_DEAD in: handle ``` ```lua isCharDead(handle) ``` ```js Char.isDead(handle) ``` ## 车内创建角色在车辆驾驶座创建角色。 ```text 0129 CREATE_CHAR_INSIDE_CAR in: vehicle, pedType, modelId out: handle ``` ```lua local handle = createCharInsideCar(vehicle, pedType, modelId) ``` ```js Char.createInsideCar(vehicle, pedType, modelId) ``` ## 是否在区域用在 if：角色是否在指定地图区域内。 ```text 0154 IS_CHAR_IN_ZONE in: self, zone ``` ```lua isCharInZone(self, zone) ``` ```js Char.isInZone(self, zone) ``` ## 取朝向返回角色朝向角（Z 角）。 ```text 0172 GET_CHAR_HEADING in: self out: heading ``` ```lua local heading = getCharHeading(self) ``` ```js Char.getHeading(self) ``` ## 设朝向设置角色朝向角（Z 角）。 ```text 0173 SET_CHAR_HEADING in: self, heading ``` ```lua setCharHeading(self, heading) ``` ```js Char.setHeading(self, heading) ``` ## 碰到物体用在 if：角色是否与指定物体碰撞。 ```text 0179 IS_CHAR_TOUCHING_OBJECT in: self, object ``` ```lua isCharTouchingObject(self, object) ``` ```js Char.isTouchingObject(self, object) ``` ## 设弹药设置角色指定武器的弹药量。 ```text 017B SET_CHAR_AMMO in: self, weaponType, ammo ``` ```lua setCharAmmo(self, weaponType, ammo) ``` ```js Char.setAmmo(self, weaponType, ammo) ``` ## 生命是否更高用在 if：角色生命是否高于指定值。 ```text 0184 IS_CHAR_HEALTH_GREATER in: self, health ``` ```lua isCharHealthGreater(self, health) ``` ```js Char.isHealthGreater(self, health) ``` ## 徒步在 2D 区域用在 if：角色是否徒步在指定 2D 区域内。 ```text 01A1 IS_CHAR_IN_AREA_ON_FOOT_2D in: self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere ``` ```lua isCharInAreaOnFoot2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere) ``` ```js Char.isInAreaOnFoot2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere) ``` ## 车内在 2D 区域用在 if：角色是否在车内且位于指定 2D 区域内。 ```text 01A2 IS_CHAR_IN_AREA_IN_CAR_2D in: self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere ``` ```lua isCharInAreaInCar2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere) ``` ```js Char.isInAreaInCar2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere) ``` ## 停下在 2D 区域用在 if：角色是否已停在指定 2D 区域内。 ```text 01A3 IS_CHAR_STOPPED_IN_AREA_2D in: self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere ``` ```lua isCharStoppedInArea2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere) ``` ```js Char.isStoppedInArea2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere) ``` ## 停下徒步 2D 区域用在 if：角色是否徒步停在指定 2D 区域内。 ```text 01A4 IS_CHAR_STOPPED_IN_AREA_ON_FOOT_2D in: self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere ``` ```lua isCharStoppedInAreaOnFoot2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere) ``` ```js Char.isStoppedInAreaOnFoot2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere) ``` ## 停下车内 2D 区域用在 if：角色是否在车内停在指定 2D 区域内。 ```text 01A5 IS_CHAR_STOPPED_IN_AREA_IN_CAR_2D in: self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere ``` ```lua isCharStoppedInAreaInCar2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere) ``` ```js Char.isStoppedInAreaInCar2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere) ``` ## 徒步在 3D 区域用在 if：角色是否徒步在指定 3D 区域内。 ```text 01A6 IS_CHAR_IN_AREA_ON_FOOT_3D in: self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere ``` ```lua isCharInAreaOnFoot3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere) ``` ```js Char.isInAreaOnFoot3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere) ``` ## 车内在 3D 区域用在 if：角色是否在车内且位于指定 3D 区域内。 ```text 01A7 IS_CHAR_IN_AREA_IN_CAR_3D in: self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere ``` ```lua isCharInAreaInCar3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere) ``` ```js Char.isInAreaInCar3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere) ``` ## 停下在 3D 区域用在 if：角色是否已停在指定 3D 区域内。 ```text 01A8 IS_CHAR_STOPPED_IN_AREA_3D in: self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere ``` ```lua isCharStoppedInArea3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere) ``` ```js Char.isStoppedInArea3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere) ``` ## 停下徒步 3D 区域用在 if：角色是否徒步停在指定 3D 区域内。 ```text 01A9 IS_CHAR_STOPPED_IN_AREA_ON_FOOT_3D in: self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere ``` ```lua isCharStoppedInAreaOnFoot3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere) ``` ```js Char.isStoppedInAreaOnFoot3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere) ``` ## 停下车内 3D 区域用在 if：角色是否在车内停在指定 3D 区域内。 ```text 01AA IS_CHAR_STOPPED_IN_AREA_IN_CAR_3D in: self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere ``` ```lua isCharStoppedInAreaInCar3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere) ``` ```js Char.isStoppedInAreaInCar3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere) ``` ## 给武器给角色指定武器及弹药量。 ```text 01B2 GIVE_WEAPON_TO_CHAR in: self, weaponType, ammo ``` ```lua giveWeaponToChar(self, weaponType, ammo) ``` ```js Char.giveWeapon(self, weaponType, ammo) ``` ## 设当前武器设置角色当前手持武器。 ```text 01B9 SET_CURRENT_CHAR_WEAPON in: self, weaponType ``` ```lua setCurrentCharWeapon(self, weaponType) ``` ```js Char.setCurrentWeapon(self, weaponType) ``` ## 标记不再需要允许游戏按需删除角色，并在适用时移出任务清理列表。 ```text 01C2 MARK_CHAR_AS_NO_LONGER_NEEDED in: self ``` ```lua markCharAsNoLongerNeeded(self) ``` ```js Char.markAsNoLongerNeeded(self) ``` ## 不随任务删除从任务清理列表移除角色，任务结束时不会被删。 ```text 01C5 DONT_REMOVE_CHAR in: self ``` ```lua dontRemoveChar(self) ``` ```js Char.dontRemove(self) ``` ## 乘客位创建用指定模型在车辆乘客座创建角色。 ```text 01C8 CREATE_CHAR_AS_PASSENGER in: vehicle, pedType, modelId, seat out: handle ``` ```lua local handle = createCharAsPassenger(vehicle, pedType, modelId, seat) ``` ```js Char.createAsPassenger(vehicle, pedType, modelId, seat) ``` ## 相对车辆任意 2D 用在 if：角色是否在车辆 2D 半径内。 ```text 0202 LOCATE_CHAR_ANY_MEANS_CAR_2D in: self, vehicle, xRadius, yRadius, drawSphere ``` ```lua locateCharAnyMeansCar2D(self, vehicle, xRadius, yRadius, drawSphere) ``` ```js Char.locateAnyMeansCar2D(self, vehicle, xRadius, yRadius, drawSphere) ``` ## 相对车辆徒步 2D 用在 if：角色是否徒步在车辆 2D 半径内。 ```text 0203 LOCATE_CHAR_ON_FOOT_CAR_2D in: self, vehicle, xRadius, yRadius, drawSphere ``` ```lua locateCharOnFootCar2D(self, vehicle, xRadius, yRadius, drawSphere) ``` ```js Char.locateOnFootCar2D(self, vehicle, xRadius, yRadius, drawSphere) ``` ## 相对车辆车内 2D 用在 if：角色是否在车内且位于车辆 2D 半径内。 ```text 0204 LOCATE_CHAR_IN_CAR_CAR_2D in: self, handle, xRadius, yRadius, drawSphere ``` ```lua locateCharInCarCar2D(self, handle, xRadius, yRadius, drawSphere) ``` ```js Char.locateInCarCar2D(self, handle, xRadius, yRadius, drawSphere) ``` ## 相对车辆任意 3D 用在 if：角色是否在车辆 3D 半径内。 ```text 0205 LOCATE_CHAR_ANY_MEANS_CAR_3D in: self, vehicle, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateCharAnyMeansCar3D(self, vehicle, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateAnyMeansCar3D(self, vehicle, xRadius, yRadius, zRadius, drawSphere) ``` ## 相对车辆徒步 3D 用在 if：角色是否徒步在车辆 3D 半径内。 ```text 0206 LOCATE_CHAR_ON_FOOT_CAR_3D in: self, vehicle, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateCharOnFootCar3D(self, vehicle, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateOnFootCar3D(self, vehicle, xRadius, yRadius, zRadius, drawSphere) ``` ## 相对车辆车内 3D 用在 if：角色是否在车内且位于车辆 3D 半径内。 ```text 0207 LOCATE_CHAR_IN_CAR_CAR_3D in: self, vehicle, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateCharInCarCar3D(self, vehicle, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateInCarCar3D(self, vehicle, xRadius, yRadius, zRadius, drawSphere) ``` ## 设生命设置角色生命值。 ```text 0223 SET_CHAR_HEALTH in: self, health ``` ```lua setCharHealth(self, health) ``` ```js Char.setHealth(self, health) ``` ## 取生命返回角色生命值。 ```text 0226 GET_CHAR_HEALTH in: self out: health ``` ```lua local health = getCharHealth(self) ``` ```js Char.getHealth(self) ``` ## 徒步碰到物体用在 if：角色是否徒步与指定物体碰撞。 ```text 023B IS_CHAR_TOUCHING_OBJECT_ON_FOOT in: self, object ``` ```lua isCharTouchingObjectOnFoot(self, object) ``` ```js Char.isTouchingObjectOnFoot(self, object) ``` ## 动画组设置角色动画组。 ```text 0245 SET_ANIM_GROUP_FOR_CHAR in: self, animGroup ``` ```lua setAnimGroupForChar(self, animGroup) ``` ```js Char.setAnimGroup(self, animGroup) ``` ## 是否停下用在 if：角色是否未在移动。 ```text 02A0 IS_CHAR_STOPPED in: self ``` ```lua isCharStopped(self) ``` ```js Char.isStopped(self) ``` ## 仅玩家可伤让角色免疫除玩家外的一切伤害。 ```text 02A9 SET_CHAR_ONLY_DAMAGED_BY_PLAYER in: self, state ``` ```lua setCharOnlyDamagedByPlayer(self, state) ``` ```js Char.setOnlyDamagedByPlayer(self, state) ``` ## 伤害免疫设置角色各类免疫。 ```text 02AB SET_CHAR_PROOFS in: self, bulletProof, fireProof, explosionProof, collisionProof, meleeProof ``` ```lua setCharProofs(self, bulletProof, fireProof, explosionProof, collisionProof, meleeProof) ``` ```js Char.setProofs(self, bulletProof, fireProof, explosionProof, collisionProof, meleeProof) ``` ## 是否在屏上用在 if：角色是否可见。 ```text 02CB IS_CHAR_ON_SCREEN in: self ``` ```lua isCharOnScreen(self) ``` ```js Char.isOnScreen(self) ``` ## 区域内是否开火用在 if：角色是否在指定 2D 区域内开过火。 ```text 02D6 IS_CHAR_SHOOTING_IN_AREA in: self, leftBottomX, leftBottomY, topRightX, topRightY, drawSphere ``` ```lua isCharShootingInArea(self, leftBottomX, leftBottomY, topRightX, topRightY, drawSphere) ``` ```js Char.isShootingInArea(self, leftBottomX, leftBottomY, topRightX, topRightY, drawSphere) ``` ## 是否当前武器用在 if：角色是否手持指定类型武器。 ```text 02D8 IS_CURRENT_CHAR_WEAPON in: self, weaponType ``` ```lua isCurrentCharWeapon(self, weaponType) ``` ```js Char.isCurrentWeapon(self, weaponType) ``` ## 是否开火中用在 if：角色是否正在开火。 ```text 02E0 IS_CHAR_SHOOTING in: self ``` ```lua isCharShooting(self) ``` ```js Char.isShooting(self) ``` ## 射击精度影响角色用武器攻击时的命中频率。 ```text 02E2 SET_CHAR_ACCURACY in: self, accuracy ``` ```lua setCharAccuracy(self, accuracy) ``` ```js Char.setAccuracy(self, accuracy) ``` ## 是否指定模型用在 if：角色模型 ID 是否等于给定模型 ID。 ```text 02F2 IS_CHAR_MODEL in: self, modelId ``` ```lua isCharModel(self, modelId) ``` ```js Char.isModel(self, modelId) ``` ## 被武器击中用在 if：角色是否被指定武器击中过。 ```text 031D HAS_CHAR_BEEN_DAMAGED_BY_WEAPON in: self, weaponType ``` ```lua hasCharBeenDamagedByWeapon(self, weaponType) ``` ```js Char.hasBeenDamagedByWeapon(self, weaponType) ``` ## 爆头肢解肢解角色。 ```text 0321 EXPLODE_CHAR_HEAD in: self ``` ```lua explodeCharHead(self) ``` ```js Char.explodeHead(self) ``` ## 流血让角色流血。 ```text 0332 SET_CHAR_BLEEDING in: self, state ``` ```lua setCharBleeding(self, state) ``` ```js Char.setBleeding(self, state) ``` ## 显隐设置角色是否可见。 ```text 0337 SET_CHAR_VISIBLE in: self, state ``` ```lua setCharVisible(self, state) ``` ```js Char.setVisible(self, state) ``` ## 优雅移除淡出移除角色并释放内存。 ```text 034F REMOVE_CHAR_ELEGANTLY in: self ``` ```lua removeCharElegantly(self) ``` ```js Char.removeElegantly(self) ``` ## 保持原地受攻击时让角色保持原位。 ```text 0350 SET_CHAR_STAY_IN_SAME_PLACE in: self, state ``` ```lua setCharStayInSamePlace(self, state) ``` ```js Char.setStayInSamePlace(self, state) ``` ## 加护甲按指定值增加护甲，上限 100。 ```text 035F ADD_ARMOUR_TO_CHAR in: self, amount ``` ```lua addArmourToChar(self, amount) ``` ```js Char.addArmor(self, amount) ``` ## 从车拉到坐标把角色从车里拉出并放到指定位置。 ```text 0362 WARP_CHAR_FROM_CAR_TO_COORD in: self, x, y, z ``` ```lua warpCharFromCarToCoord(self, x, y, z) ``` ```js Char.warpFromCarToCoord(self, x, y, z) ``` ## 是否看见目标用在 if：角色能否看见目标角色。 ```text 0364 HAS_CHAR_SPOTTED_CHAR in: self, target ``` ```lua hasCharSpottedChar(self, target) ``` ```js Char.hasSpottedChar(self, target) ``` ## 瞬移进车把角色放进指定车辆。 ```text 036A WARP_CHAR_INTO_CAR in: self, vehicle ``` ```lua warpCharIntoCar(self, vehicle) ``` ```js Char.warpIntoCar(self, vehicle) ``` ## 创建随机角色在指定坐标创建模型与 pedtype 随机的角色。 ```text 0376 CREATE_RANDOM_CHAR in: x, y, z out: handle ``` ```lua local handle = createRandomChar(x, y, z) ``` ```js Char.createRandom(x, y, z) ``` ## 动画速度让角色按指定速度播放动画。 ```text 0393 SET_CHAR_ANIM_SPEED in: self, animName, animSpeed ``` ```lua setCharAnimSpeed(self, animName, animSpeed) ``` ```js Char.setAnimSpeed(self, animName, animSpeed) ``` ## 不可拖出车锁定在车内的角色。 ```text 039E SET_CHAR_CANT_BE_DRAGGED_OUT in: self, state ``` ```lua setCharCantBeDraggedOut(self, state) ``` ```js Char.setCantBeDraggedOut(self, state) ``` ## 是否男性用在 if：角色是否为男性。 ```text 03A3 IS_CHAR_MALE in: self ``` ```lua isCharMale(self) ``` ```js Char.isMale(self) ``` ## 取车不保存返回角色车辆句柄且不标记为脚本占用，游戏随时可删（另见 00D9、0811、0484）。 ```text 03C0 STORE_CAR_CHAR_IS_IN_NO_SAVE in: self out: handle ``` ```lua local handle = storeCarCharIsInNoSave(self) ``` ```js Char.storeCarIsInNoSave(self) ``` ## 设现金设置角色现金，决定死后掉落金额。 ```text 03FE SET_CHAR_MONEY in: self, amount ``` ```lua setCharMoney(self, amount) ``` ```js Char.setMoney(self, amount) ``` ## 取武器弹药获取角色指定武器的弹药量。 ```text 041A GET_AMMO_IN_CHAR_WEAPON in: self, weaponType out: ammo ``` ```lua local ammo = getAmmoInCharWeapon(self, weaponType) ``` ```js Char.getAmmoInWeapon(self, weaponType) ``` ## 瞬移乘客座把角色放进车辆乘客座。 ```text 0430 WARP_CHAR_INTO_CAR_AS_PASSENGER in: self, handle, seat ``` ```lua warpCharIntoCarAsPassenger(self, handle, seat) ``` ```js Char.warpIntoCarAsPassenger(self, handle, seat) ``` ## 精神病杀手设置角色是否为精神病杀手。 ```text 0433 SET_CHAR_IS_CHRIS_CRIMINAL in: self, state ``` ```lua setCharIsChrisCriminal(self, state) ``` ```js Char.setIsChrisCriminal(self, state) ``` ## 爆头致命设置角色是否免疫爆头。 ```text 0446 SET_CHAR_SUFFERS_CRITICAL_HITS in: self, state ``` ```lua setCharSuffersCriticalHits(self, state) ``` ```js Char.setSuffersCriticalHits(self, state) ``` ## 是否坐在指定车用在 if：角色是否坐在指定车辆中。 ```text 0448 IS_CHAR_SITTING_IN_CAR in: self, vehicle ``` ```lua isCharSittingInCar(self, vehicle) ``` ```js Char.isSittingInCar(self, vehicle) ``` ## 是否坐在任意车用在 if：角色是否坐在任意车辆中。 ```text 0449 IS_CHAR_SITTING_IN_ANY_CAR in: self ``` ```lua isCharSittingInAnyCar(self) ``` ```js Char.isSittingInAnyCar(self) ``` ## 是否徒步用在 if：角色是否徒步且未占用车辆。 ```text 044B IS_CHAR_ON_FOOT in: self ``` ```lua isCharOnFoot(self) ``` ```js Char.isOnFoot(self) ``` ## 附着到车炮塔把角色放到车辆炮塔位以便射击。 ```text 0464 ATTACH_CHAR_TO_CAR in: self, vehicle, xOffset, yOffset, zOffset, heading, headingRange, weaponType ``` ```lua attachCharToCar(self, vehicle, xOffset, yOffset, zOffset, heading, headingRange, weaponType) ``` ```js Char.attachToCar(self, vehicle, xOffset, yOffset, zOffset, heading, headingRange, weaponType) ``` ## 脱离炮塔把角色移出炮塔模式（0464）。 ```text 0465 DETACH_CHAR_FROM_CAR in: self ``` ```lua detachCharFromCar(self) ``` ```js Char.detachFromCar(self) ``` ## 清武器伤害记录清除角色最近一次武器伤害记录（见 031D）。 ```text 0467 CLEAR_CHAR_LAST_WEAPON_DAMAGE in: self ``` ```lua clearCharLastWeaponDamage(self) ``` ```js Char.clearLastWeaponDamage(self) ``` ## 跟随者数量返回角色所在小队成员数（01DE）。 ```text 046D GET_NUMBER_OF_FOLLOWERS in: self out: number ``` ```lua local number = getNumberOfFollowers(self) ``` ```js Char.getNumberOfFollowers(self) ``` ## 取当前武器返回角色当前手持武器类型。 ```text 0470 GET_CURRENT_CHAR_WEAPON in: self out: weaponType ``` ```lua local weaponType = getCurrentCharWeapon(self) ``` ```js Char.getCurrentWeapon(self) ``` ## 相对物体任意 2D 用在 if：角色是否在物体 2D 半径内。 ```text 0471 LOCATE_CHAR_ANY_MEANS_OBJECT_2D in: self, object, xRadius, yRadius, drawSphere ``` ```lua locateCharAnyMeansObject2D(self, object, xRadius, yRadius, drawSphere) ``` ```js Char.locateAnyMeansObject2D(self, object, xRadius, yRadius, drawSphere) ``` ## 相对物体徒步 2D 用在 if：角色是否徒步在物体 2D 半径内。 ```text 0472 LOCATE_CHAR_ON_FOOT_OBJECT_2D in: self, object, xRadius, yRadius, drawSphere ``` ```lua locateCharOnFootObject2D(self, object, xRadius, yRadius, drawSphere) ``` ```js Char.locateOnFootObject2D(self, object, xRadius, yRadius, drawSphere) ``` ## 相对物体车内 2D 用在 if：角色是否在车内且位于物体 2D 半径内。 ```text 0473 LOCATE_CHAR_IN_CAR_OBJECT_2D in: self, object, xRadius, yRadius, drawSphere ``` ```lua locateCharInCarObject2D(self, object, xRadius, yRadius, drawSphere) ``` ```js Char.locateInCarObject2D(self, object, xRadius, yRadius, drawSphere) ``` ## 相对物体任意 3D 用在 if：角色是否在物体 3D 半径内。 ```text 0474 LOCATE_CHAR_ANY_MEANS_OBJECT_3D in: self, object, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateCharAnyMeansObject3D(self, object, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateAnyMeansObject3D(self, object, xRadius, yRadius, zRadius, drawSphere) ``` ## 相对物体徒步 3D 用在 if：角色是否徒步在物体 3D 半径内。 ```text 0475 LOCATE_CHAR_ON_FOOT_OBJECT_3D in: self, object, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateCharOnFootObject3D(self, object, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateOnFootObject3D(self, object, xRadius, yRadius, zRadius, drawSphere) ``` ## 相对物体车内 3D 用在 if：角色是否在车内且位于物体 3D 半径内。 ```text 0476 LOCATE_CHAR_IN_CAR_OBJECT_3D in: self, object, xRadius, yRadius, zRadius, drawSphere ``` ```lua locateCharInCarObject3D(self, object, xRadius, yRadius, zRadius, drawSphere) ``` ```js Char.locateInCarObject3D(self, object, xRadius, yRadius, zRadius, drawSphere) ``` ## 是否在摩托上用在 if：角色是否骑着摩托车。 ```text 047A IS_CHAR_ON_ANY_BIKE in: self ``` ```lua isCharOnAnyBike(self) ``` ```js Char.isOnAnyBike(self) ``` ## 是否看见尸体用在 if：角色是否看见指定类型尸体。 ```text 0480 CAN_CHAR_SEE_DEAD_CHAR in: self, pedType ``` ```lua canCharSeeDeadChar(self, pedType) ``` ```js Char.canSeeDeadChar(self, pedType) ``` ## 闭嘴设置角色能否说话。 ```text 0489 SHUT_CHAR_UP in: self, state ``` ```lua shutCharUp(self, state) ``` ```js Char.shutUp(self, state) ``` ## 卸全部武器移除角色全部武器。 ```text 048F REMOVE_ALL_CHAR_WEAPONS in: self ``` ```lua removeAllCharWeapons(self) ``` ```js Char.removeAllWeapons(self) ``` ## 是否持有武器用在 if：角色是否持有指定武器。 ```text 0491 HAS_CHAR_GOT_WEAPON in: self, weaponType ``` ```lua hasCharGotWeapon(self, weaponType) ``` ```js Char.hasGotWeapon(self, weaponType) ``` ## 是否在船上用在 if：角色是否在开船。 ```text 04A7 IS_CHAR_IN_ANY_BOAT in: self ``` ```lua isCharInAnyBoat(self) ``` ```js Char.isInAnyBoat(self) ``` ## 是否在直升机用在 if：角色是否在开直升机。 ```text 04A9 IS_CHAR_IN_ANY_HELI in: self ``` ```lua isCharInAnyHeli(self) ``` ```js Char.isInAnyHeli(self) ``` ## 是否在飞机用在 if：角色是否在飞机上。 ```text 04AB IS_CHAR_IN_ANY_PLANE in: self ``` ```lua isCharInAnyPlane(self) ``` ```js Char.isInAnyPlane(self) ``` ## 是否在水中用在 if：角色是否在水中。 ```text 04AD IS_CHAR_IN_WATER in: self ``` ```lua isCharInWater(self) ``` ```js Char.isInWater(self) ``` ## 取武器槽返回指定武器槽的武器类型、弹药与模型。 ```text 04B8 GET_CHAR_WEAPON_IN_SLOT in: self, slot out: weaponType, weaponAmmo, weaponModel ``` ```lua local weaponType, weaponAmmo, weaponModel = getCharWeaponInSlot(self, slot) ``` ```js Char.getWeaponInSlot(self, slot) ``` ## 偏移世界坐标返回带偏移的角色坐标。 ```text 04C4 GET_OFFSET_FROM_CHAR_IN_WORLD_COORDS in: self, xOffset, yOffset, zOffset out: x, y, z ``` ```lua local x, y, z = getOffsetFromCharInWorldCoords(self, xOffset, yOffset, zOffset) ``` ```js Char.getOffsetInWorldCoords(self, xOffset, yOffset, zOffset) ``` ## 是否被拍照用在 if：角色是否被拍过照。 ```text 04C5 HAS_CHAR_BEEN_PHOTOGRAPHED in: self ``` ```lua hasCharBeenPhotographed(self) ``` ```js Char.hasBeenPhotographed(self) ``` ## 是否在飞行器用在 if：角色是否在飞行器中。 ```text 04C8 IS_CHAR_IN_FLYING_VEHICLE in: self ``` ```lua isCharInFlyingVehicle(self) ``` ```js Char.isInFlyingVehicle(self) ``` ## 锁定位置设置角色位置是否保持不变。 ```text 04D7 FREEZE_CHAR_POSITION in: self, state ``` ```lua freezeCharPosition(self, state) ``` ```js Char.freezePosition(self, state) ``` ## 是否溺水控制角色是否会在水中溺水。 ```text 04D8 SET_CHAR_DROWNS_IN_WATER in: self, state ``` ```lua setCharDrownsInWater(self, state) ``` ```js Char.setDrownsInWater(self, state) ``` ## 取护甲返回角色护甲值。 ```text 04DD GET_CHAR_ARMOUR in: self out: armor ``` ```lua local armor = getCharArmour(self) ``` ```js Char.getArmor(self) ``` ## 等世界碰撞用在 if：是否在等世界碰撞加载。 ```text 04F0 IS_CHAR_WAITING_FOR_WORLD_COLLISION in: self ``` ```lua isCharWaitingForWorldCollision(self) ``` ```js Char.isWaitingForWorldCollision(self) ``` ## 附着到物体以炮塔模式把角色附着到指定物体。 ```text 04F4 ATTACH_CHAR_TO_OBJECT in: self, handle, xOffset, yOffset, zOffset, heading, headingRange, weaponType ``` ```lua attachCharToObject(self, handle, xOffset, yOffset, zOffset, heading, headingRange, weaponType) ``` ```js Char.attachToObject(self, handle, xOffset, yOffset, zOffset, heading, headingRange, weaponType) ``` ## 创建 SWAT 绳降创建沿绳索下降的角色。 ```text 0503 CREATE_SWAT_ROPE in: pedType, modelId, x, y, z out: handle ``` ```lua local handle = createSwatRope(pedType, modelId, x, y, z) ``` ```js Char.createSwatRope(pedType, modelId, x, y, z) ``` ## 被角色打伤用在 if：角色是否被另一角色打伤过。 ```text 051A HAS_CHAR_BEEN_DAMAGED_BY_CHAR in: self, handle ``` ```lua hasCharBeenDamagedByChar(self, handle) ``` ```js Char.hasBeenDamagedByChar(self, handle) ``` ## 被车撞伤用在 if：角色是否被指定车辆撞伤过。 ```text 051B HAS_CHAR_BEEN_DAMAGED_BY_CAR in: self, handle ``` ```lua hasCharBeenDamagedByCar(self, handle) ``` ```js Char.hasBeenDamagedByCar(self, handle) ``` ## 劫车时留车被劫车时让角色留在车内（可被“绑架”带走）。 ```text 0526 SET_CHAR_STAY_IN_CAR_WHEN_JACKED in: self, state ``` ```lua setCharStayInCarWhenJacked(self, state) ``` ```js Char.setStayInCarWhenJacked(self, state) ``` ## 碰到车辆用在 if：角色是否与车辆碰撞。 ```text 0547 IS_CHAR_TOUCHING_VEHICLE in: self, handle ``` ```lua isCharTouchingVehicle(self, handle) ``` ```js Char.isTouchingVehicle(self, handle) ``` ## 车内可被射击让角色在车内免疫伤害。 ```text 054A SET_CHAR_CAN_BE_SHOT_IN_VEHICLE in: self, state ``` ```lua setCharCanBeShotInVehicle(self, state) ``` ```js Char.setCanBeShotInVehicle(self, state) ``` ## 清伤害来源清上次伤害来源实体。 ```text 054E CLEAR_CHAR_LAST_DAMAGE_ENTITY in: self ``` ```lua clearCharLastDamageEntity(self) ``` ```js Char.clearLastDamageEntity(self) ``` ## 卸指定武器从角色身上移除该武器。 ```text 0555 REMOVE_WEAPON_FROM_CHAR in: self, weaponType ``` ```lua removeWeaponFromChar(self, weaponType) ``` ```js Char.removeWeapon(self, weaponType) ``` ## 随机驾驶员在车辆中创建驾驶员。 ```text 0560 CREATE_RANDOM_CHAR_AS_DRIVER in: vehicle out: handle ``` ```lua local handle = createRandomCharAsDriver(vehicle) ``` ```js Char.createRandomAsDriver(vehicle) ``` ## 随机乘客在车辆乘客座创建随机角色。 ```text 0561 CREATE_RANDOM_CHAR_AS_PASSENGER in: vehicle, seat out: handle ``` ```lua local handle = createRandomCharAsPassenger(vehicle, seat) ``` ```js Char.createRandomAsPassenger(vehicle, seat) ``` ## 永不被瞄准设置角色是否不被自动瞄准锁定。 ```text 0568 SET_CHAR_NEVER_TARGETTED in: self, state ``` ```lua setCharNeverTargetted(self, state) ``` ```js Char.setNeverTargeted(self, state) ``` ## 是否在警车用在 if：角色是否驾驶警车。 ```text 056C IS_CHAR_IN_ANY_POLICE_VEHICLE in: self ``` ```lua isCharInAnyPoliceVehicle(self) ``` ```js Char.isInAnyPoliceVehicle(self) ``` ## 角色是否存在用在 if：句柄是否为有效角色句柄。 ```text 056D DOES_CHAR_EXIST in: handle ``` ```lua doesCharExist(handle) ``` ```js Char.doesExist(handle) ``` ## 冻结且不加载碰撞冻结位置且不加载碰撞。 ```text 0575 FREEZE_CHAR_POSITION_AND_DONT_LOAD_COLLISION in: self, state ``` ```lua freezeCharPositionAndDontLoadCollision(self, state) ``` ```js Char.freezePositionAndDontLoadCollision(self, state) ``` ## 碰撞加载标志是否为该角色加载碰撞。 ```text 0588 SET_LOAD_COLLISION_FOR_CHAR_FLAG in: self, state ``` ```lua setLoadCollisionForCharFlag(self, state) ``` ```js Char.setLoadCollisionFlag(self, state) ``` ## 是否蹲下用在 if：角色是否蹲下。 ```text 0597 IS_CHAR_DUCKING in: self ``` ```lua isCharDucking(self) ``` ```js Char.isDucking(self) ``` ## 倾斜 2D 区域用在 if：角色是否在倾斜 2D 区域内。 ```text 05F6 IS_CHAR_IN_ANGLED_AREA_2D in: self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere ``` ```lua isCharInAngledArea2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere) ``` ```js Char.isInAngledArea2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere) ``` ## 倾斜 2D 徒步用在 if：角色是否徒步在倾斜 2D 区域内。 ```text 05F7 IS_CHAR_IN_ANGLED_AREA_ON_FOOT_2D in: self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere ``` ```lua isCharInAngledAreaOnFoot2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere) ``` ```js Char.isInAngledAreaOnFoot2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere) ``` ## 倾斜 2D 车内用在 if：角色是否在车内且位于倾斜 2D 区域内。 ```text 05F8 IS_CHAR_IN_ANGLED_AREA_IN_CAR_2D in: self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere ``` ```lua isCharInAngledAreaInCar2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere) ``` ```js Char.isInAngledAreaInCar2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere) ``` ## 停下倾斜 2D 用在 if：角色是否停在倾斜 2D 区域内。 ```text 05F9 IS_CHAR_STOPPED_IN_ANGLED_AREA_2D in: self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere ``` ```lua isCharStoppedInAngledArea2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere) ``` ```js Char.isStoppedInAngledArea2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere) ``` ## 停下徒步倾斜 2D 用在 if：角色是否徒步停在倾斜 2D 区域内。 ```text 05FA IS_CHAR_STOPPED_IN_ANGLED_AREA_ON_FOOT_2D in: self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere ``` ```lua isCharStoppedInAngledAreaOnFoot2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere) ``` ```js Char.isStoppedInAngledAreaOnFoot2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere) ``` ## 停下车内倾斜 2D 用在 if：角色是否在静止车内且位于倾斜 2D 区域内。 ```text 05FB IS_CHAR_STOPPED_IN_ANGLED_AREA_IN_CAR_2D in: self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere ``` ```lua isCharStoppedInAngledAreaInCar2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere) ``` ```js Char.isStoppedInAngledAreaInCar2D(self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere) ``` ## 倾斜 3D 区域用在 if：角色是否在倾斜 3D 区域内。 ```text 05FC IS_CHAR_IN_ANGLED_AREA_3D in: self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere ``` ```lua isCharInAngledArea3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere) ``` ```js Char.isInAngledArea3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere) ``` ## 倾斜 3D 徒步用在 if：角色是否徒步在倾斜 3D 区域内。 ```text 05FD IS_CHAR_IN_ANGLED_AREA_ON_FOOT_3D in: self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere ``` ```lua isCharInAngledAreaOnFoot3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere) ``` ```js Char.isInAngledAreaOnFoot3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere) ``` ## 倾斜 3D 车内用在 if：角色是否在车内且位于倾斜 3D 区域内。 ```text 05FE IS_CHAR_IN_ANGLED_AREA_IN_CAR_3D in: self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere ``` ```lua isCharInAngledAreaInCar3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere) ``` ```js Char.isInAngledAreaInCar3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere) ``` ## 停下倾斜 3D 用在 if：角色是否停在倾斜 3D 区域内。 ```text 05FF IS_CHAR_STOPPED_IN_ANGLED_AREA_3D in: self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere ``` ```lua isCharStoppedInAngledArea3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere) ``` ```js Char.isStoppedInAngledArea3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere) ``` ## 停下徒步倾斜 3D 用在 if：角色是否徒步停在倾斜 3D 区域内。 ```text 0600 IS_CHAR_STOPPED_IN_ANGLED_AREA_ON_FOOT_3D in: self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere ``` ```lua isCharStoppedInAngledAreaOnFoot3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere) ``` ```js Char.isStoppedInAngledAreaOnFoot3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere) ``` ## 停下车内倾斜 3D 用在 if：角色是否在静止车内且位于倾斜 3D 区域内。 ```text 0601 IS_CHAR_STOPPED_IN_ANGLED_AREA_IN_CAR_3D in: self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere ``` ```lua isCharStoppedInAngledAreaInCar3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere) ``` ```js Char.isStoppedInAngledAreaInCar3D(self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere) ``` ## 是否在出租车用在 if：角色是否驾驶出租车。 ```text 0602 IS_CHAR_IN_TAXI in: self ``` ```lua isCharInTaxi(self) ``` ```js Char.isInTaxi(self) ``` ## 决策器为角色设置决策器。 ```text 060B SET_CHAR_DECISION_MAKER in: self, handleOrTemplate ``` ```lua setCharDecisionMaker(self, handleOrTemplate) ``` ```js Char.setDecisionMaker(self, handleOrTemplate) ``` ## 感知范围设置指定角色（句柄 -1 时为全部任务角色）的视听范围。 ```text 060F SET_SENSE_RANGE in: handle, range ``` ```lua setSenseRange(handle, range) ``` ```js Char.setSenseRange(handle, range) ``` ## 是否播动画用在 if：角色是否正在播指定动画。 ```text 0611 IS_CHAR_PLAYING_ANIM in: self, animationName ``` ```lua isCharPlayingAnim(self, animationName) ``` ```js Char.isPlayingAnim(self, animationName) ``` ## 动画播放开关设置动画是否播放。 ```text 0612 SET_CHAR_ANIM_PLAYING_FLAG in: self, animationName, flag ``` ```lua setCharAnimPlayingFlag(self, animationName, flag) ``` ```js Char.setAnimPlayingFlag(self, animationName, flag) ``` ## 动画进度返回角色动画进度，范围 0.0–1.0。 ```text 0613 GET_CHAR_ANIM_CURRENT_TIME in: self, animationName out: time ``` ```lua local time = getCharAnimCurrentTime(self, animationName) ``` ```js Char.getAnimCurrentTime(self, animationName) ``` ## 设动画进度设置角色动画播放到哪一段，1 为完整。 ```text 0614 SET_CHAR_ANIM_CURRENT_TIME in: self, animationName, time ``` ```lua setCharAnimCurrentTime(self, animationName, time) ``` ```js Char.setAnimCurrentTime(self, animationName, time) ``` ## 执行动作序列把角色指派到指定动作序列。 ```text 0618 PERFORM_SEQUENCE_TASK in: self, sequence ``` ```lua performSequenceTask(self, sequence) ``` ```js Char.performSequence(self, sequence) ``` ## 碰撞开关设置是否启用角色碰撞检测。 ```text 0619 SET_CHAR_COLLISION in: self, state ``` ```lua setCharCollision(self, state) ``` ```js Char.setCollision(self, state) ``` ## 动画总时长返回动画时长（毫秒，浮点）。 ```text 061A GET_CHAR_ANIM_TOTAL_TIME in: self, animationName out: totalTime ``` ```lua local totalTime = getCharAnimTotalTime(self, animationName) ``` ```js Char.getAnimTotalTime(self, animationName) ``` ## 吸引点创建在吸引点创建角色。 ```text 0621 CREATE_CHAR_AT_ATTRACTOR in: pedType, modelId, attractor, task out: handle ``` ```lua local handle = createCharAtAttractor(pedType, modelId, attractor, task) ``` ```js Char.createAtAttractor(pedType, modelId, attractor, task) ``` ## 脚本任务状态返回角色指定脚本任务的状态。 ```text 062E GET_SCRIPT_TASK_STATUS in: self, task out: status ``` ```lua local status = getScriptTaskStatus(self, task) ``` ```js Char.getScriptTaskStatus(self, task) ``` ## 是否在脚本吸引点用在 if：角色是否在脚本吸引点。 ```text 0642 IS_CHAR_AT_SCRIPTED_ATTRACTOR in: self, handle ``` ```lua isCharAtScriptedAttractor(self, handle) ``` ```js Char.isAtScriptedAttractor(self, handle) ``` ## 序列进度获取角色任务序列进度（由 0618 启动）。 ```text 0646 GET_SEQUENCE_PROGRESS in: self out: progress ``` ```lua local progress = getSequenceProgress(self) ``` ```js Char.getSequenceProgress(self) ``` ## 清看向清除角色看向任务，停止看目标。 ```text 0647 CLEAR_LOOK_AT in: self ``` ```lua clearLookAt(self) ``` ```js Char.clearLookAt(self) ``` ## 跟随节点阈值距离设置角色对事件作出反应的范围。 ```text 0648 SET_FOLLOW_NODE_THRESHOLD_DISTANCE in: self, range ``` ```lua setFollowNodeThresholdDistance(self, range) ``` ```js Char.setFollowNodeThresholdDistance(self, range) ``` ## 取模型返回角色模型。 ```text 0665 GET_CHAR_MODEL in: self out: modelId ``` ```lua local modelId = getCharModel(self) ``` ```js Char.getModel(self) ``` ## 清任务清除角色任务，让其停下当前行为。 ```text 0687 CLEAR_CHAR_TASKS in: self ``` ```lua clearCharTasks(self) ``` ```js Char.clearTasks(self) ``` ## 附着到摩托把角色附着到摩托上。 ```text 06A7 ATTACH_CHAR_TO_BIKE in: self, vehicle, xOffset, yOffset, zOffset, heading, headingRange, pitchRange, weaponType ``` ```lua attachCharToBike(self, vehicle, xOffset, yOffset, zOffset, heading, headingRange, pitchRange, weaponType) ``` ```js Char.attachToBike(self, vehicle, xOffset, yOffset, zOffset, heading, headingRange, pitchRange, weaponType) ``` ## 过场藏武器隐藏角色全部武器。 ```text 06AB HIDE_CHAR_WEAPON_FOR_SCRIPTED_CUTSCENE in: self, state ``` ```lua hideCharWeaponForScriptedCutscene(self, state) ``` ```js Char.hideWeaponForScriptedCutscene(self, state) ``` ## 取速度返回角色移动速度。 ```text 06AC GET_CHAR_SPEED in: self out: speed ``` ```lua local speed = getCharSpeed(self) ``` ```js Char.getSpeed(self) ``` ## 移出小队把角色移出当前小队。 ```text 06C9 REMOVE_CHAR_FROM_GROUP in: self ``` ```lua removeCharFromGroup(self) ``` ```js Char.removeFromGroup(self) ``` ## 是否小队成员用在 if：角色是否为指定小队成员。 ```text 06EE IS_GROUP_MEMBER in: self, handle ``` ```lua isGroupMember(self, handle) ``` ```js Char.isGroupMember(self, handle) ``` ## 是否小队长用在 if：角色是否为指定小队队长。 ```text 06EF IS_GROUP_LEADER in: self, handle ``` ```lua isGroupLeader(self, handle) ``` ```js Char.isGroupLeader(self, handle) ``` ## 附近是否有人用在 if：附近是否有其他角色。 ```text 06FF ARE_ANY_CHARS_NEAR_CHAR in: self, radius ``` ```lua areAnyCharsNearChar(self, radius) ``` ```js Char.isNearAnyChars(self, radius) ``` ## 丢物体让角色丢下物体。 ```text 070B DROP_OBJECT in: self, state ``` ```lua dropObject(self, state) ``` ```js Char.dropObject(self, state) ``` ## 是否举着物体用在 if：角色是否在举起指定物体。 ```text 0737 IS_CHAR_HOLDING_OBJECT in: self, handle ``` ```lua isCharHoldingObject(self, handle) ``` ```js Char.isHoldingObject(self, handle) ``` ## 是否被捕用在 if：角色是否已被逮捕。 ```text 0741 HAS_CHAR_BEEN_ARRESTED in: self ``` ```lua hasCharBeenArrested(self) ``` ```js Char.hasBeenArrested(self) ``` ## 通知受尊敬朋友设置通知受尊敬朋友。 ```text 074E SET_INFORM_RESPECTED_FRIENDS in: self, radius, _p3 ``` ```lua setInformRespectedFriends(self, radius, _p3) ``` ```js Char.setInformRespectedFriends(self, radius, _p3) ``` ## 是否响应事件用在 if：角色是否在响应指定 ped 事件。 ```text 074F IS_CHAR_RESPONDING_TO_EVENT in: self, event ``` ```lua isCharRespondingToEvent(self, event) ``` ```js Char.isRespondingToEvent(self, event) ``` ## 优先瞄准目标让自动瞄准更倾向锁定此角色。 ```text 0770 SET_CHAR_IS_TARGET_PRIORITY in: self, state ``` ```lua setCharIsTargetPriority(self, state) ``` ```js Char.setIsTargetPriority(self, state) ``` ## 设关系设置角色与 ped 类型的关系。 ```text 077A SET_CHAR_RELATIONSHIP in: self, relationshipType, pedType ``` ```lua setCharRelationship(self, relationshipType, pedType) ``` ```js Char.setRelationship(self, relationshipType, pedType) ``` ## 清关系清除角色与 ped 类型的关系。 ```text 077B CLEAR_CHAR_RELATIONSHIP in: self, relationshipType, toPedType ``` ```lua clearCharRelationship(self, relationshipType, toPedType) ``` ```js Char.clearRelationship(self, relationshipType, toPedType) ``` ## 清全部关系清除角色全部指定类型关系。 ```text 077C CLEAR_ALL_CHAR_RELATIONSHIPS in: self, relationshipType ``` ```lua clearAllCharRelationships(self, relationshipType) ``` ```js Char.clearAllRelationships(self, relationshipType) ``` ## 立即清任务立即清除角色全部任务，回到空闲。 ```text 0792 CLEAR_CHAR_TASKS_IMMEDIATELY in: self ``` ```lua clearCharTasksImmediately(self) ``` ```js Char.clearTasksImmediately(self) ``` ## 从进度执行序列从指定进度执行动作序列。 ```text 07A0 PERFORM_SEQUENCE_TASK_FROM_PROGRESS in: self, sequence, startTaskIndex, endTaskIndex ``` ```lua performSequenceTaskFromProgress(self, sequence, startTaskIndex, endTaskIndex) ``` ```js Char.performSequenceFromProgress(self, sequence, startTaskIndex, endTaskIndex) ``` ## 下一移动状态设置后续无路程参数任务时角色如何前往目的地。 ```text 07A1 SET_NEXT_DESIRED_MOVE_STATE in: moveState ``` ```lua setNextDesiredMoveState(moveState) ``` ```js Char.setNextDesiredMoveState(moveState) ``` ## 递归序列进度取递归序列进度。 ```text 07A4 GET_SEQUENCE_PROGRESS_RECURSIVE in: self out: _p2, _p3 ``` ```lua local _p2, _p3 = getSequenceProgressRecursive(self) ``` ```js Char.getSequenceProgressRecursive(self) ``` ## 是否在探照灯返回正在瞄准该角色的探照灯句柄。 ```text 07A9 IS_CHAR_IN_ANY_SEARCHLIGHT in: self out: handle ``` ```lua local handle = isCharInAnySearchlight(self) ``` ```js Char.isInAnySearchlight(self) ``` ## 听玩家小队指令是否听从玩家小队指令。 ```text 07CB LISTEN_TO_PLAYER_GROUP_COMMANDS in: self, state ``` ```lua listenToPlayerGroupCommands(self, state) ``` ```js Char.listenToPlayerGroupCommands(self, state) ``` ## 射击频率设置角色攻击频率。 ```text 07DD SET_CHAR_SHOOT_RATE in: self, rate ``` ```lua setCharShootRate(self, rate) ``` ```js Char.setShootRate(self, rate) ``` ## 格斗风格设置角色格斗风格与招式。 ```text 07FE GIVE_MELEE_ATTACK_TO_CHAR in: self, style, move ``` ```lua giveMeleeAttackToChar(self, style, move) ``` ```js Char.giveMeleeAttack(self, style, move) ``` ## 最高优先事件获取角色当前 ped 事件。 ```text 080E GET_CHAR_HIGHEST_PRIORITY_EVENT in: self out: event ``` ```lua local event = getCharHighestPriorityEvent(self) ``` ```js Char.getHighestPriorityEvent(self) ``` ## 取正在用的车存下角色正在乘坐或进入的车辆句柄（另见 00D9、03C0、0484）。 ```text 0811 GET_CAR_CHAR_IS_USING in: self out: handle ``` ```lua local handle = getCarCharIsUsing(self) ``` ```js Char.getCarIsUsing(self) ``` ## 大致原地设置角色是否不远追受害者（近战或进射程）。 ```text 0816 SET_CHAR_KINDA_STAY_IN_SAME_PLACE in: self, state ``` ```lua setCharKindaStayInSamePlace(self, state) ``` ```js Char.setKindaStayInSamePlace(self, state) ``` ## 是否在空中用在 if：角色是否在空中。 ```text 0818 IS_CHAR_IN_AIR in: self ``` ```lua isCharInAir(self) ``` ```js Char.isInAir(self) ``` ## 离地高度返回角色离地高度。 ```text 0819 GET_CHAR_HEIGHT_ABOVE_GROUND in: self out: height ``` ```lua local height = getCharHeightAboveGround(self) ``` ```js Char.getHeightAboveGround(self) ``` ## 持枪姿势设置角色持枪姿势风格。 ```text 081A SET_CHAR_WEAPON_SKILL in: self, skill ``` ```lua setCharWeaponSkill(self, skill) ``` ```js Char.setWeaponSkill(self, skill) ``` ## 设速度向量设置角色速度。 ```text 083C SET_CHAR_VELOCITY in: self, x, y, z ``` ```lua setCharVelocity(self, x, y, z) ``` ```js Char.setVelocity(self, x, y, z) ``` ## 取速度向量获取角色速度。 ```text 083D GET_CHAR_VELOCITY in: self out: x, y, z ``` ```lua local x, y, z = getCharVelocity(self) ``` ```js Char.getVelocity(self) ``` ## 设旋转设置角色旋转。 ```text 083E SET_CHAR_ROTATION in: self, x, y, z ``` ```lua setCharRotation(self, x, y, z) ``` ```js Char.setRotation(self, x, y, z) ``` ## 造成伤害降低角色生命。 ```text 0851 DAMAGE_CHAR in: self, amount, damageArmour ``` ```lua damageChar(self, amount, damageArmour) ``` ```js Char.damage(self, amount, damageArmour) ``` ## 允许蹲下设置角色能否蹲下。 ```text 0856 SET_CHAR_ALLOWED_TO_DUCK in: self, state ``` ```lua setCharAllowedToDuck(self, state) ``` ```js Char.setAllowedToDuck(self, state) ``` ## 可见 interior 设置角色所在室内。 ```text 0860 SET_CHAR_AREA_VISIBLE in: self, areaId ``` ```lua setCharAreaVisible(self, areaId) ``` ```js Char.setAreaVisible(self, areaId) ``` ## 死后掉武器设置角色死后是否掉落武器。 ```text 087E SET_CHAR_DROPS_WEAPONS_WHEN_DEAD in: self, state ``` ```lua setCharDropsWeaponsWhenDead(self, state) ``` ```js Char.setDropsWeaponsWhenDead(self, state) ``` ## 永不离队阻止角色离开所属小队。 ```text 087F SET_CHAR_NEVER_LEAVES_GROUP in: self, state ``` ```lua setCharNeverLeavesGroup(self, state) ``` ```js Char.setNeverLeavesGroup(self, state) ``` ## 附着朝向限制设置附着在物体或车辆上的角色朝向限制。 ```text 0887 SET_HEADING_LIMIT_FOR_ATTACHED_CHAR in: self, heading, headingRange ``` ```lua setHeadingLimitForAttachedChar(self, heading, headingRange) ``` ```js Char.setHeadingLimitForAttached(self, heading, headingRange) ``` ## 死亡坐标取角色死亡坐标。 ```text 0889 GET_DEAD_CHAR_COORDINATES in: self out: x, y, z ``` ```lua local x, y, z = getDeadCharCoordinates(self) ``` ```js Char.getCoordinatesOfDied(self) ``` ## 取 ped 类型获取角色 ped 类型。 ```text 089F GET_PED_TYPE in: self out: pedType ``` ```lua local pedType = getPedType(self) ``` ```js Char.getPedType(self) ``` ## 使用过出入口在坐标半径内定位入口标记并绑定角色，设置室内 ID；玩家控制时还会设天空色。 ```text 08AD SET_CHAR_HAS_USED_ENTRY_EXIT in: self, x, y, radius ``` ```lua setCharHasUsedEntryExit(self, x, y, radius) ``` ```js Char.setHasUsedEntryExit(self, x, y, radius) ``` ## 最大生命设置角色最大生命。 ```text 08AF SET_CHAR_MAX_HEALTH in: self, maxHealth ``` ```lua setCharMaxHealth(self, maxHealth) ``` ```js Char.setMaxHealth(self, maxHealth) ``` ## 摩托不被撞落设置碰撞时角色是否始终留在摩托上。 ```text 08C6 SET_CHAR_CAN_BE_KNOCKED_OFF_BIKE in: self, stayOnBike ``` ```lua setCharCanBeKnockedOffBike(self, stayOnBike) ``` ```js Char.setCanBeKnockedOffBike(self, stayOnBike) ``` ## 设坐标不传小队设置角色坐标，不传送其小队其余成员。 ```text 08C7 SET_CHAR_COORDINATES_DONT_WARP_GANG in: self, x, y, z ``` ```lua setCharCoordinatesDontWarpGang(self, x, y, z) ``` ```js Char.setCoordinatesDontWarpGang(self, x, y, z) ``` ## 防弹衣角色只播上半身受伤动画，腿部中弹仍可跑。 ```text 093B SET_CHAR_BULLETPROOF_VEST in: self, state ``` ```lua setCharBulletproofVest(self, state) ``` ```js Char.setBulletproofVest(self, state) ``` ## 仅上半身受伤动画是否只用上半身受伤动画。 ```text 0946 SET_CHAR_USES_UPPERBODY_DAMAGE_ANIMS_ONLY in: self, state ``` ```lua setCharUsesUpperbodyDamageAnimsOnly(self, state) ``` ```js Char.setUsesUpperbodyDamageAnimsOnly(self, state) ``` ## 说上下文语音类似 05C1，但返回说了哪句，且不作为任务运行。 ```text 0947 SET_CHAR_SAY_CONTEXT in: self, phrase out: _p3 ``` ```lua local _p3 = setCharSayContext(self, phrase) ``` ```js Char.setSayContext(self, phrase) ``` ## 所在室内名获取角色所在室内名称。 ```text 094B GET_NAME_OF_ENTRY_EXIT_CHAR_USED in: self out: interiorName ``` ```lua local interiorName = getNameOfEntryExitCharUsed(self) ``` ```js Char.getNameOfEntryExitUsed(self) ``` ## 所用入口位置返回角色进入当前室内所用入口标记的坐标与朝向。 ```text 094C GET_POSITION_OF_ENTRY_EXIT_CHAR_USED in: self out: x, y, z, heading ``` ```lua local x, y, z, heading = getPositionOfEntryExitCharUsed(self) ``` ```js Char.getPositionOfEntryExitCharUsed(self) ``` ## 是否在说话用在 if：角色是否正在播任意语音。 ```text 094D IS_CHAR_TALKING in: self ``` ```lua isCharTalking(self) ``` ```js Char.isTalking(self) ``` ## 禁用语音阻止播放任何角色语音。 ```text 094E DISABLE_CHAR_SPEECH in: self, stopNow ``` ```lua disableCharSpeech(self, stopNow) ``` ```js Char.disableSpeech(self, stopNow) ``` ## 启用语音若用 094E 关掉过痛呼，则重新启用。 ```text 094F ENABLE_CHAR_SPEECH in: self ``` ```lua enableCharSpeech(self) ``` ```js Char.enableSpeech(self) ``` ## 卡在车底用在 if：角色是否卡在车底。 ```text 095D IS_CHAR_STUCK_UNDER_CAR in: self ``` ```lua isCharStuckUnderCar(self) ``` ```js Char.isStuckUnderCar(self) ``` ## 保留任务设置任务清理后角色是否保留任务（实质跳过清理）。 ```text 0961 SET_CHAR_KEEP_TASK in: self, state ``` ```lua setCharKeepTask(self, state) ``` ```js Char.setKeepTask(self, state) ``` ## 是否游泳用在 if：角色是否在游泳。 ```text 0965 IS_CHAR_SWIMMING in: self ``` ```lua isCharSwimming(self) ``` ```js Char.isSwimming(self) ``` ## 游泳状态取角色游泳状态。 ```text 0966 GET_CHAR_SWIM_STATE in: self out: state ``` ```lua local state = getCharSwimState(self) ``` ```js Char.getSwimState(self) ``` ## 开始面部说话让角色张嘴像在说话。 ```text 0967 START_CHAR_FACIAL_TALK in: self, duration ``` ```lua startCharFacialTalk(self, duration) ``` ```js Char.startFacialTalk(self, duration) ``` ## 停止面部说话停止角色张嘴说话动作。 ```text 0968 STOP_CHAR_FACIAL_TALK in: self ``` ```lua stopCharFacialTalk(self) ``` ```js Char.stopFacialTalk(self) ``` ## 无偏移设坐标按身体中心而非脚底放置角色坐标。 ```text 0972 SET_CHAR_COORDINATES_NO_OFFSET in: self, x, y, z ``` ```lua setCharCoordinatesNoOffset(self, x, y, z) ``` ```js Char.setCoordinatesNoOffset(self, x, y, z) ``` ## 死在车里角色死后仍留在车内。 ```text 0982 SET_CHAR_FORCE_DIE_IN_CAR in: self, state ``` ```lua setCharForceDieInCar(self, state) ``` ```js Char.setForceDieInCar(self, state) ``` ## 丢第二物体丢下第二物体。 ```text 09A1 DROP_SECOND_OBJECT in: self, state ``` ```lua dropSecondObject(self, state) ``` ```js Char.dropSecondObject(self, state) ``` ## 嗑药状态设置角色嗑药状态。 ```text 09A7 SET_CHAR_DRUGGED_UP in: self, state ``` ```lua setCharDruggedUp(self, state) ``` ```js Char.setDruggedUp(self, state) ``` ## 头是否缺失用在 if：角色头部是否被爆掉。 ```text 09A8 IS_CHAR_HEAD_MISSING in: self ``` ```lua isCharHeadMissing(self) ``` ```js Char.isHeadMissing(self) ``` ## 是否在火车用在 if：角色是否在火车上。 ```text 09AE IS_CHAR_IN_ANY_TRAIN in: self ``` ```lua isCharInAnyTrain(self) ``` ```js Char.isInAnyTrain(self) ``` ## 击杀后信号设置角色击杀后是否做信号手势。 ```text 09B5 SET_CHAR_SIGNAL_AFTER_KILL in: self, state ``` ```lua setCharSignalAfterKill(self, state) ``` ```js Char.setSignalAfterKill(self, state) ``` ## 被警察通缉设置警察是否追击该角色。 ```text 09B6 SET_CHAR_WANTED_BY_POLICE in: self, state ``` ```lua setCharWantedByPolice(self, state) ``` ```js Char.setWantedByPolice(self, state) ``` ## 设坐标不传队无偏移本命令是 0972 与 08C7 的组合。 ```text 09BC SET_CHAR_COORDINATES_DONT_WARP_GANG_NO_OFFSET in: self, x, y, z ``` ```lua setCharCoordinatesDontWarpGangNoOffset(self, x, y, z) ``` ```js Char.setCoordinatesDontWarpGangNoOffset(self, x, y, z) ``` ## 用地图吸引点用在 if：角色是否在使用地图 attractor。 ```text 09C5 IS_CHAR_USING_MAP_ATTRACTOR in: self ``` ```lua isCharUsingMapAttractor(self) ``` ```js Char.isUsingMapAttractor(self) ``` ## 下车保持位置把角色从车辆中移除。 ```text 09C9 REMOVE_CHAR_FROM_CAR_MAINTAIN_POSITION in: self, vehicle ``` ```lua removeCharFromCarMaintainPosition(self, vehicle) ``` ```js Char.removeFromCarMaintainPosition(self, vehicle) ``` ## 重要上下文语音说重要上下文语音。 ```text 09D5 SET_CHAR_SAY_CONTEXT_IMPORTANT in: self, phrase, overrideSilence, ignoreMute, frontEnd out: saidVariant ``` ```lua local saidVariant = setCharSayContextImportant(self, phrase, overrideSilence, ignoreMute, frontEnd) ``` ```js Char.setSayContextImportant(self, phrase, overrideSilence, ignoreMute, frontEnd) ``` ## 脚本语音脚本语音。 ```text 09D6 SET_CHAR_SAY_SCRIPT in: self, _p2, _p3, _p4, _p5 ``` ```lua setCharSayScript(self, _p2, _p3, _p4, _p5) ``` ```js Char.setSayScript(self, _p2, _p3, _p4, _p5) ``` ## 是否正在上车用在 if：角色是否正在上车但尚未入座。 ```text 09DE IS_CHAR_GETTING_IN_TO_A_CAR in: self ``` ```lua isCharGettingInToACar(self) ``` ```js Char.isGettingInToACar(self) ``` ## 取 interior 返回角色所在室内 ID。 ```text 09E8 GET_CHAR_AREA_VISIBLE in: self out: areaId ``` ```lua local areaId = getCharAreaVisible(self) ``` ```js Char.getAreaVisible(self) ``` ## 前方是否看见用在 if：角色能否在正前方看见另一角色。 ```text 09ED HAS_CHAR_SPOTTED_CHAR_IN_FRONT in: self, handle ``` ```lua hasCharSpottedCharInFront(self, handle) ``` ```js Char.hasSpottedCharInFront(self, handle) ``` ## 跟随节点忽略高度跟随节点时忽略高度差。 ```text 09F4 IGNORE_HEIGHT_DIFFERENCE_FOLLOWING_NODES in: self, state ``` ```lua ignoreHeightDifferenceFollowingNodes(self, state) ``` ```js Char.ignoreHeightDifferenceFollowingNodes(self, state) ``` ## 翻车时下车控制角色是否在车翻到起火前尝试下车。 ```text 09F6 SET_CHAR_GET_OUT_UPSIDE_DOWN_CAR in: self, state ``` ```lua setCharGetOutUpsideDownCar(self, state) ``` ```js Char.setGetOutUpsideDownCar(self, state) ``` ## 脚本语音静音类似 0489，但静音更多内容，含环境语音（待确认）。 ```text 0A09 SHUT_CHAR_UP_FOR_SCRIPTED_SPEECH in: self, state ``` ```lua shutCharUpForScriptedSpeech(self, state) ``` ```js Char.shutUpForScriptedSpeech(self, state) ``` ## 碰到另一角色用在 if：角色是否碰到另一角色。 ```text 0A1B IS_CHAR_TOUCHING_CHAR in: self, other ``` ```lua isCharTouchingChar(self, other) ``` ```js Char.isTouchingChar(self, other) ``` ## 死后武器持久角色死后生成的拾取物在被玩家捡起前不会消失。 ```text 0A27 SET_DEATH_WEAPONS_PERSIST in: self, state ``` ```lua setDeathWeaponsPersist(self, state) ``` ```js Char.setDeathWeaponsPersist(self, state) ``` ## 游泳速度设置角色游泳速度，并改变游泳动画速度。 ```text 0A28 SET_SWIM_SPEED in: self, speed ``` ```lua setSwimSpeed(self, speed) ``` ```js Char.setSwimSpeed(self, speed) ``` ## 是否附着任意车用在 if：角色是否在任意车辆炮塔位。 ```text 0A32 IS_CHAR_ATTACHED_TO_ANY_CAR in: self ``` ```lua isCharAttachedToAnyCar(self) ``` ```js Char.isAttachedToAnyCar(self) ``` ## 取附着车辆返回角色附着的车辆。 ```text 0A33 STORE_CAR_CHAR_IS_ATTACHED_TO_NO_SAVE in: self out: handle ``` ```lua local handle = storeCarCharIsAttachedToNoSave(self) ``` ```js Char.storeCarIsAttachedToNoSave(self) ```