物体 Object / default / SA - GTAMODX开发文档

sa · 扩展 default · SCM 原生命令

共 87 条。写法见 Lua / Redux。

创建物体

CREATE_OBJECT · 0107

Object.Create

在坐标用指定模型创建物体。

0107 CREATE_OBJECT
in: modelId, x, y, z
out: handle

删除物体

DELETE_OBJECT · 0108

Object.Delete

销毁物体并腾内存。

0108 DELETE_OBJECT
in: self

取朝向

GET_OBJECT_HEADING · 0176

Object.GetHeading

取物体朝向（Z 角）。

0176 GET_OBJECT_HEADING
in: self
out: heading

设朝向

SET_OBJECT_HEADING · 0177

Object.SetHeading

设物体朝向（Z 角）。

0177 SET_OBJECT_HEADING
in: self, heading

取坐标

GET_OBJECT_COORDINATES · 01BB

Object.GetCoordinates

取物体坐标。

01BB GET_OBJECT_COORDINATES
in: self
out: x, y, z

设坐标

SET_OBJECT_COORDINATES · 01BC

Object.SetCoordinates

把物体放到指定坐标。

01BC SET_OBJECT_COORDINATES
in: self, x, y, z

可卸载

MARK_OBJECT_AS_NO_LONGER_NEEDED · 01C4

Object.MarkAsNoLongerNeeded

允许游戏按需删除，并从任务清理列表移除。

01C4 MARK_OBJECT_AS_NO_LONGER_NEEDED
in: self

任务结束不删

DONT_REMOVE_OBJECT · 01C7

Object.DontRemove

从任务清理列表移除，任务结束不删。

01C7 DONT_REMOVE_OBJECT
in: self

无偏移创建

CREATE_OBJECT_NO_OFFSET · 029B

Object.CreateNoOffset

无偏移创建物体。

029B CREATE_OBJECT_NO_OFFSET
in: modelId, x, y, z
out: handle

是否在屏上

IS_OBJECT_ON_SCREEN · 02CC

Object.IsOnScreen

用在 if：物体是否可见（在屏上）。

02CC IS_OBJECT_ON_SCREEN
in: self

旋转到角度

ROTATE_OBJECT · 034D

Object.Rotate

从一角转到另一角，可选碰撞。

034D ROTATE_OBJECT
in: self, fromAngle, toAngle, collisionCheck

滑向坐标

SLIDE_OBJECT · 034E

Object.Slide

滑向目标坐标；到位时条件真。

034E SLIDE_OBJECT
in: self, posX, posY, posZ, speedX, speedY, speedZ, collisionCheck

相对车放置

PLACE_OBJECT_RELATIVE_TO_CAR · 035C

Object.PlaceRelativeToCar

相对车辆偏移放置。

035C PLACE_OBJECT_RELATIVE_TO_CAR
in: self, vehicle, xOffset, yOffset, zOffset

可被瞄准

MAKE_OBJECT_TARGETTABLE · 035D

Object.MakeTargetable

是否可被自动瞄准。

035D MAKE_OBJECT_TARGETTABLE
in: self, state

是否损坏

HAS_OBJECT_BEEN_DAMAGED · 0366

Object.HasBeenDamaged

用在 if：物体是否损坏。

0366 HAS_OBJECT_BEEN_DAMAGED
in: self

设线速度

SET_OBJECT_VELOCITY · 0381

Object.SetVelocity

设物体线速度。

0381 SET_OBJECT_VELOCITY
in: self, xSpeed, ySpeed, zSpeed

碰撞检测

SET_OBJECT_COLLISION · 0382

Object.SetCollision

开关物体碰撞检测。

0382 SET_OBJECT_COLLISION
in: self, state

叠加速度

ADD_TO_OBJECT_VELOCITY · 038C

Object.AddToVelocity

给线速度叠加向量（0381）。

038C ADD_TO_OBJECT_VELOCITY
in: self, x, y, z

可被推动

SET_OBJECT_DYNAMIC · 0392

Object.SetDynamic

是否可被物理推动。

0392 SET_OBJECT_DYNAMIC
in: self, state

句柄是否有效

DOES_OBJECT_EXIST · 03CA

Object.DoesExist

用在 if：句柄是否有效物体。

03CA DOES_OBJECT_EXIST
in: handle

偏移世界坐标

GET_OFFSET_FROM_OBJECT_IN_WORLD_COORDS · 0400

Object.GetOffsetInWorldCoords

取带偏移的世界坐标。

0400 GET_OFFSET_FROM_OBJECT_IN_WORLD_COORDS
in: self, xOffset, yOffset, zOffset
out: x, y, z

最后绘制

SET_OBJECT_DRAW_LAST · 0418

Object.SetDrawLast

是否总画在其它物体之上。

0418 SET_OBJECT_DRAW_LAST
in: self, state

设旋转

SET_OBJECT_ROTATION · 0453

Object.SetRotation

设 XYZ 旋转。

0453 SET_OBJECT_ROTATION
in: self, x, y, z

记录碰撞

SET_OBJECT_RECORDS_COLLISIONS · 04D9

Object.SetRecordsCollisions

启用物体碰撞记录。

04D9 SET_OBJECT_RECORDS_COLLISIONS
in: self, state

是否发生碰撞

HAS_OBJECT_COLLIDED_WITH_ANYTHING · 04DA

Object.HasCollidedWithAnything

用在 if：是否发生过碰撞。

04DA HAS_OBJECT_COLLIDED_WITH_ANYTHING
in: self

靠近 2D

LOCATE_OBJECT_2D · 04E5

Object.Locate2D

用在 if：是否靠近指定坐标。

04E5 LOCATE_OBJECT_2D
in: self, x, y, xRadius, yRadius, drawSphere

靠近 3D

LOCATE_OBJECT_3D · 04E6

Object.Locate3D

用在 if：是否靠近指定点。

04E6 LOCATE_OBJECT_3D
in: self, x, y, z, xRadius, yRadius, zRadius, drawSphere

是否在水中

IS_OBJECT_IN_WATER · 04E7

Object.IsInWater

用在 if：是否在水中。

04E7 IS_OBJECT_IN_WATER
in: self

是否在 2D 区

IS_OBJECT_IN_AREA_2D · 04E9

Object.IsInArea2D

用在 if：是否在 2D 区域内。

04E9 IS_OBJECT_IN_AREA_2D
in: self, leftBottomX, leftBottomY, rightTopX, rightTopY, drawSphere

是否在 3D 区

IS_OBJECT_IN_AREA_3D · 04EA

Object.IsInArea3D

用在 if：是否在 3D 区域内。

04EA IS_OBJECT_IN_AREA_3D
in: self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, drawSphere

与车无碰撞

SORT_OUT_OBJECT_COLLISION_WITH_CAR · 050E

Object.SortOutCollisionWithCar

指定车与该物体无碰撞。

050E SORT_OUT_OBJECT_COLLISION_WITH_CAR
in: self, handle

冻结位置

FREEZE_OBJECT_POSITION · 0550

Object.FreezePosition

冻结物体位置。

0550 FREEZE_OBJECT_POSITION
in: self, state

可见 interior

SET_OBJECT_AREA_VISIBLE · 0566

Object.SetAreaVisible

物体可见于哪个 interior。

0566 SET_OBJECT_AREA_VISIBLE
in: self, areaId

取线速度

GET_OBJECT_VELOCITY · 059F

Object.GetVelocity

取线速度 XYZ。

059F GET_OBJECT_VELOCITY
in: self
out: x, y, z

叠加角速度

ADD_TO_OBJECT_ROTATION_VELOCITY · 05A1

Object.AddToRotationVelocity

相对质心叠加角速度。

05A1 ADD_TO_OBJECT_ROTATION_VELOCITY
in: self, x, y, z

设角速度

SET_OBJECT_ROTATION_VELOCITY · 05A2

Object.SetRotationVelocity

设角速度（带帧同步）。

05A2 SET_OBJECT_ROTATION_VELOCITY
in: self, x, y, z

是否静止

IS_OBJECT_STATIC · 05A3

Object.IsStatic

用在 if：是否静止。

05A3 IS_OBJECT_STATIC
in: self

取角速度

GET_OBJECT_ROTATION_VELOCITY · 05A6

Object.GetRotationVelocity

取角速度。

05A6 GET_OBJECT_ROTATION_VELOCITY
in: self
out: x, y, z

相对叠加速度

ADD_VELOCITY_RELATIVE_TO_OBJECT_VELOCITY · 05A7

Object.AddVelocityRelative

设物体线速度。

05A7 ADD_VELOCITY_RELATIVE_TO_OBJECT_VELOCITY
in: self, x, y, z

取速率

GET_OBJECT_SPEED · 05A8

Object.GetSpeed

取物体速率。

05A8 GET_OBJECT_SPEED
in: self
out: speed

烧焦外观

SET_OBJECT_RENDER_SCORCHED · 0654

Object.SetRenderScorched

外观烧焦。

0654 SET_OBJECT_RENDER_SCORCHED
in: self, state

附着到车

ATTACH_OBJECT_TO_CAR · 0681

Object.AttachToCar

附着到车上。

0681 ATTACH_OBJECT_TO_CAR
in: self, handle, xOffset, yOffset, zOffset, xRotation, yRotation, zRotation

分离

DETACH_OBJECT · 0682

Object.Detach

分离物体（可选旋转与力）。

0682 DETACH_OBJECT
in: self, pitch, heading, strength, applyTurnForce

是否附着中

IS_OBJECT_ATTACHED · 0685

Object.IsAttached

用在 if：是否附着中。

0685 IS_OBJECT_ATTACHED
in: self

附着到物体

ATTACH_OBJECT_TO_OBJECT · 069A

Object.AttachToObject

附着到另一物体。

069A ATTACH_OBJECT_TO_OBJECT
in: self, handle, xOffset, yOffset, zOffset, xRotation, yRotation, zRotation

附着到角色

ATTACH_OBJECT_TO_CHAR · 069B

Object.AttachToChar

附着到角色。

069B ATTACH_OBJECT_TO_CHAR
in: self, handle, xOffset, yOffset, zOffset, xRotation, yRotation, zRotation

取生命

GET_OBJECT_HEALTH · 071E

Object.GetHealth

取物体生命。

071E GET_OBJECT_HEALTH
in: self
out: health

设生命

SET_OBJECT_HEALTH · 071F

Object.SetHealth

设物体生命。

071F SET_OBJECT_HEALTH
in: self, health

砸碎

BREAK_OBJECT · 0723

Object.Break

砸碎物体。

0723 BREAK_OBJECT
in: self, intensity

显隐

SET_OBJECT_VISIBLE · 0750

Object.SetVisible

显隐物体。

0750 SET_OBJECT_VISIBLE
in: self, state

播放动画

PLAY_OBJECT_ANIM · 075A

Object.PlayAnim

播放物体动画。

075A PLAY_OBJECT_ANIM
in: self, animationName, animationFile, frameDelta, lockF, loop

取绳高

GET_ROPE_HEIGHT_FOR_OBJECT · 0796

Object.GetRopeHeight

取绳索高度。

0796 GET_ROPE_HEIGHT_FOR_OBJECT
in: self
out: height

设绳高

SET_ROPE_HEIGHT_FOR_OBJECT · 0797

Object.SetRopeHeight

设绳索高度。

0797 SET_ROPE_HEIGHT_FOR_OBJECT
in: self, height

抓住绳上实体

GRAB_ENTITY_ON_ROPE_FOR_OBJECT · 0798

Object.GrabEntityOnRope

抓住绳上实体。

0798 GRAB_ENTITY_ON_ROPE_FOR_OBJECT
in: self
out: vehicle, char, object

释放绳上实体

RELEASE_ENTITY_FROM_ROPE_FOR_OBJECT · 0799

Object.ReleaseEntityFromRope

从绳上释放实体。

0799 RELEASE_ENTITY_FROM_ROPE_FOR_OBJECT
in: self

取四元数

GET_OBJECT_QUATERNION · 07C3

Object.GetQuaternion

取四元数。

07C3 GET_OBJECT_QUATERNION
in: self
out: x, y, z, w

设四元数

SET_OBJECT_QUATERNION · 07C4

Object.SetQuaternion

设四元数。

07C4 SET_OBJECT_QUATERNION
in: self, x, y, z, w

碰撞伤害效果

SET_OBJECT_COLLISION_DAMAGE_EFFECT · 07F7

Object.SetCollisionDamageEffect

是否可被摧毁。

07F7 SET_OBJECT_COLLISION_DAMAGE_EFFECT
in: self, state

关卡设计坐标

GET_LEVEL_DESIGN_COORDS_FOR_OBJECT · 080A

Object.GetLevelDesignCoords

取关卡设计坐标。

080A GET_LEVEL_DESIGN_COORDS_FOR_OBJECT
in: self, nth
out: x, y, z

改坐标保旋转

SET_OBJECT_COORDINATES_AND_VELOCITY · 0815

Object.SetCoordinatesAndVelocity

改坐标且不改旋转。

0815 SET_OBJECT_COORDINATES_AND_VELOCITY
in: self, x, y, z

连接 LOD

CONNECT_LODS · 0827

Object.ConnectLods

远处显示的 LOD 物体。

0827 CONNECT_LODS
in: self, lodObject

是否被拍照

HAS_OBJECT_BEEN_PHOTOGRAPHED · 0833

Object.HasBeenPhotographed

用在 if：是否被拍过照。

0833 HAS_OBJECT_BEEN_PHOTOGRAPHED
in: self

动画速度

SET_OBJECT_ANIM_SPEED · 0836

Object.SetAnimSpeed

物体动画播放速度。

0836 SET_OBJECT_ANIM_SPEED
in: self, animationName, speed

是否在播动画

IS_OBJECT_PLAYING_ANIM · 0837

Object.IsPlayingAnim

用在 if：是否在播指定动画。

0837 IS_OBJECT_PLAYING_ANIM
in: self, animationName

取动画进度

GET_OBJECT_ANIM_CURRENT_TIME · 0839

Object.GetAnimCurrentTime

取动画进度。

0839 GET_OBJECT_ANIM_CURRENT_TIME
in: self, animationName
out: time

设动画进度

SET_OBJECT_ANIM_CURRENT_TIME · 083A

Object.SetAnimCurrentTime

设动画进度（0 起）。

083A SET_OBJECT_ANIM_CURRENT_TIME
in: self, animationName, time

仅玩家可伤

SET_OBJECT_ONLY_DAMAGED_BY_PLAYER · 0875

Object.SetOnlyDamagedByPlayer

仅玩家能伤害该物体。

0875 SET_OBJECT_ONLY_DAMAGED_BY_PLAYER
in: self, state

设缩放

SET_OBJECT_SCALE · 08D2

Object.SetScale

设缩放。

08D2 SET_OBJECT_SCALE
in: self, scale

倾斜 2D 区

IS_OBJECT_IN_ANGLED_AREA_2D · 08E3

Object.IsInAngledArea2D

用在 if：是否在倾斜 2D 区内。

08E3 IS_OBJECT_IN_ANGLED_AREA_2D
in: self, leftBottomX, leftBottomY, rightTopX, rightTopY, angle, drawSphere

倾斜 3D 区

IS_OBJECT_IN_ANGLED_AREA_3D · 08E4

Object.IsInAngledArea3D

用在 if：是否在倾斜 3D 区内。

08E4 IS_OBJECT_IN_ANGLED_AREA_3D
in: self, leftBottomX, leftBottomY, leftBottomZ, rightTopX, rightTopY, rightTopZ, angle, drawSphere

可偷取搬运

SET_OBJECT_AS_STEALABLE · 08E9

Object.SetAsStealable

是否可拾取搬运。

08E9 SET_OBJECT_AS_STEALABLE
in: self, state

是否被武器打伤

HAS_OBJECT_BEEN_DAMAGED_BY_WEAPON · 08FF

Object.HasBeenDamagedByWeapon

用在 if：是否被指定武器/伤害类型打伤。

08FF HAS_OBJECT_BEEN_DAMAGED_BY_WEAPON
in: self, weaponType

清武器伤害记录

CLEAR_OBJECT_LAST_WEAPON_DAMAGE · 0900

Object.ClearLastWeaponDamage

清上次造成伤害的武器 ID。

0900 CLEAR_OBJECT_LAST_WEAPON_DAMAGE
in: self

门锁

LOCK_DOOR · 0905

Object.LockDoor

门锁在当前角，实体可推开一次。

0905 LOCK_DOOR
in: self, state

设质量

SET_OBJECT_MASS · 0906

Object.SetMass

设质量。

0906 SET_OBJECT_MASS
in: self, mass

取质量

GET_OBJECT_MASS · 0907

Object.GetMass

取质量。

0907 GET_OBJECT_MASS
in: self
out: mass

设转动惯量

SET_OBJECT_TURN_MASS · 0908

Object.SetTurnMass

设转动惯量。

0908 SET_OBJECT_TURN_MASS
in: self, turnMass

取转动惯量

GET_OBJECT_TURN_MASS · 0909

Object.GetTurnMass

取转动惯量。

0909 GET_OBJECT_TURN_MASS
in: self
out: turnMass

吊车可吊

WINCH_CAN_PICK_OBJECT_UP · 0916

Object.WinchCanPickUp

是否可被磁力吊车吊起。

0916 WINCH_CAN_PICK_OBJECT_UP
in: self, state

是否已可动

HAS_OBJECT_BEEN_UPROOTED · 095B

Object.HasBeenUprooted

用在 if：是否已被 0392 设为可动。

095B HAS_OBJECT_BEEN_UPROOTED
in: self

brain 触发半径

IS_OBJECT_WITHIN_BRAIN_ACTIVATION_RANGE · 0977

Object.IsWithinBrainActivationRange

用在 if：是否在外部脚本触发半径内。

0977 IS_OBJECT_WITHIN_BRAIN_ACTIVATION_RANGE
in: self

取模型

GET_OBJECT_MODEL · 0984

Object.GetModel

取模型索引。

0984 GET_OBJECT_MODEL
in: self
out: model

淡出删除

REMOVE_OBJECT_ELEGANTLY · 09A2

Object.RemoveElegantly

淡出并释放内存。

09A2 REMOVE_OBJECT_ELEGANTLY
in: self

伤害免疫

SET_OBJECT_PROOFS · 09CA

Object.SetProofs

设各类伤害免疫。

09CA SET_OBJECT_PROOFS
in: self, bulletProof, fireProof, explosionProof, collisionProof, meleeProof

模型是否匹配

DOES_OBJECT_HAVE_THIS_MODEL · 09CC

Object.DoesHaveThisModel

用在 if：模型是否匹配。

09CC DOES_OBJECT_HAVE_THIS_MODEL
in: self, modelId

是否与世界相交

IS_OBJECT_INTERSECTING_WORLD · 09FC

Object.IsIntersectingWorld

用在 if：创建/改坐标后是否有东西进入过该位置。

09FC IS_OBJECT_INTERSECTING_WORLD
in: self

吸引行人

ENABLE_DISABLED_ATTRACTORS_ON_OBJECT · 0A0A

Object.EnableDisabledAttractors

是否吸引行人与之交互。

0A0A ENABLE_DISABLED_ATTRACTORS_ON_OBJECT
in: self, state

物体 Object

On this page