---
title: "物体实体 Entity Object"
description: "物体透明度、扩展变量与 renderObject"
---
---
title: 物体实体 Entity Object
description: 物体透明度、扩展变量与 renderObject
---
`sa` · 扩展 `CLEO+` · 需 CLEO + CLEO+
物体相关。入口见 [entity](/docs/cleo/sa/plus/entity)。写法见 [Lua](/docs/cleo/syntax) / [Redux](/docs/cleo/syntax-redux)。
## 透明度
设物体模型透明度 0–255。
```text
0D11 SET_OBJECT_MODEL_ALPHA
in: self, alpha
```
```lua
setObjectModelAlpha(obj, 255)
```
```js
Object.setModelAlpha(self, alpha)
```
## 创建 / 脚本控制
在坐标创建不进存档的物体；可选偏移/贴地。
```text
0E01 CREATE_OBJECT_NO_SAVE
in: modelId, x, y, z, useOffset, useGround
out: handle
```
```lua
local obj = createObjectNoSave(modelId, x, y, z, false, true)
```
```js
const handle = Object.createNoSave(modelId, x, y, z, useOffset, useGround)
```
物体是否脚本控制。用在 `if` 里。
```text
0E0C IS_OBJECT_SCRIPT_CONTROLLED
in: self
```
```lua
if isObjectScriptControlled(obj) then
end
```
```js
if (Object.isScriptControlled(self)) {
}
```
标记物体为脚本控制。
```text
0E0D MARK_OBJECT_AS_NEEDED
in: self
```
```lua
markObjectAsNeeded(obj)
```
```js
Object.markAsNeeded(self)
```
## 扩展变量
给物体挂扩展变量。用在 `if` 里。
```text
0E1A INIT_EXTENDED_OBJECT_VARS
in: self, identifier, totalVars
```
```lua
initExtendedObjectVars(obj, "AUTO", 2)
```
```js
Object.initExtendedVars(self, identifier, totalVars)
```
写物体扩展变量。用在 `if` 里。
```text
0E1B SET_EXTENDED_OBJECT_VAR
in: self, identifier, varNumber, value
```
```lua
setExtendedObjectVar(obj, "AUTO", 0, 1)
```
```js
Object.setExtendedVar(self, identifier, varNumber, value)
```
读物体扩展变量。用在 `if` 里。
```text
0E1C GET_EXTENDED_OBJECT_VAR
in: self, identifier, varNumber
out: value
```
```lua
local v = getExtendedObjectVar(obj, "AUTO", 0)
```
```js
const value = Object.getExtendedVar(self, identifier, varNumber)
```
## 物理 / 伤害
取模型质心到底座的距离。
```text
0E71 GET_OBJECT_CENTRE_OF_MASS_TO_BASE_OF_MODEL
in: self
out: distance
```
```lua
local d = getObjectCentreOfMassToBaseOfModel(obj)
```
```js
const distance = Object.getDistanceFromCenterOfMassToBaseOfModel(self)
```
物体是否未贴实心且未淹没。用在 `if` 里。
```text
0E94 IS_OBJECT_REALLY_IN_AIR
in: self
```
```lua
if isObjectReallyInAir(obj) then
end
```
```js
if (Object.isReallyInAir(self)) {
}
```
对物体模拟指定伤害与武器类型。
```text
0E95 SIMULATE_OBJECT_DAMAGE
in: self, damage, weaponType
```
```lua
simulateObjectDamage(obj, 50.0, weaponType)
```
```js
Object.simulateDamage(self, damage, weaponType)
```
取物体伤害抗性。
```text
0EAE GET_OBJECT_PROOFS
in: self
out: bullet, fire, explosion, collision, melee
```
```lua
local b, f, e, c, m = getObjectProofs(obj)
```
```js
const { bullet, fire, explosion, collision, melee } = Object.getProofs(self)
```
取物体 randomSeed。
```text
0ECA GET_OBJECT_RANDOM_SEED
in: self
out: randomSeed
```
```lua
local seed = getObjectRandomSeed(obj)
```
```js
const randomSeed = Object.getRandomSeed(self)
```
## 挂 renderObject
在物体上挂 renderObject（普通 modelId）。
```text
0F03 CREATE_RENDER_OBJECT_TO_OBJECT
in: self, modelId, x, y, z, rx, ry, rz
out: renderobject
```
```lua
local ro = createRenderObjectToObject(obj, modelId, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0)
```
```js
const renderobject = Object.createRenderObjectToObject(self, modelId, x, y, z, rx, ry, rz)
```
在物体上挂 specialModel 的 renderObject。
```text
0F04 CREATE_RENDER_OBJECT_TO_OBJECT_FROM_SPECIAL
in: self, specialModel, x, y, z, rx, ry, rz
out: renderobject
```
```lua
local ro = createRenderObjectToObjectFromSpecial(obj, specialModel, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0)
```
```js
const renderobject = Object.createRenderObjectToObjectFromSpecial(
self, specialModel, x, y, z, rx, ry, rz
)
```