/// /** * ### 🎈 实体对象 * * 在脚本引擎中，使用「实体对象」来操作和获取某一个实体的相关信息。 * * 该类**没有构造函数**，请使用下面的方法获取该类对象 * * - 从监听事件中获取 * - {@linkcode mc.getAllEntities()} * - {@linkcode mc.spawnMob()} * - {@linkcode mc.cloneMob()} * - 从其他API中获取 * * **注意**：不要**长期保存**一个实体对象\ * 当实体对象对应的实体被销毁时，对应的实体对象将同时释放。\ * 因此，如果有长期操作某个实体的需要，请通过上述途径获取实时的实体对象 * * @see [🎈 实体对象 API](https://docs.litebds.com/zh-Hans/#/LLSEPluginDevelopment/GameAPI/Entity) */ declare class Entity { /** 实体名称 */ readonly name: string /** 实体标准类型名 */ readonly type: string /** 实体的游戏内id */ readonly id: number /** 实体所在坐标 */ readonly pos: FloatPos /** 实体所在的方块坐标 */ readonly blockPos: IntPos /** 实体腿部所在坐标 */ readonly feetPos: FloatPos /** 实体最大生命值 */ readonly maxHealth: number /** 实体当前生命值 */ readonly health: number /** 实体是否能飞行 */ readonly canFly: boolean /** 实体是否能被冻结 */ readonly canFreeze: boolean /** 实体是否能看到天空 */ readonly canSeeDaylight: boolean /** 实体是否能拾取物品 */ readonly canPickupItems: boolean /** 实体是否悬空 */ readonly inAir: boolean /** 实体是否在水中 */ readonly inWater: boolean /** 实体是否在岩浆中 */ readonly inLava: boolean /** 实体是否在雨中 */ readonly inRain: boolean /** 实体是否在雪中 */ readonly inSnow: boolean /** 实体是否在墙上 */ readonly inWall: boolean /** 实体是否在水中或雨中 */ readonly inWaterOrRain: boolean /** 实体是否在世界中 */ readonly inWorld: boolean /** 实体当前速度 */ readonly speed: number /** 实体当前朝向 */ readonly direction: DirectionAngle /** 实体唯一标识符 */ readonly uniqueId: string /** 实体是否不可见 */ readonly isInvisible: boolean /** 实体是否在门户内 */ readonly isInsidePortal: boolean /** 实体是否信任 */ readonly isTrusting: boolean /** 实体是否接触到伤害方块 */ readonly isTouchingDamageBlock: boolean /** 实体是否着火 */ readonly isOnFire: boolean /** 实体是否在地面 */ readonly isOnGround: boolean /** 实体是否在热块上 */ readonly isOnHotBlock: boolean /** 实体是否在交易 */ readonly isTrading: boolean /** 实体是否正在骑行 */ readonly isRiding: boolean /** 实体是否在跳舞 */ readonly isDancing: boolean /** 实体是否在睡觉 */ readonly isSleeping: boolean /** 实体是否生气 */ readonly isAngry: boolean /** 实体是否为幼体 */ readonly isBaby: boolean /** 实体是否移动 */ readonly isMoving: boolean readonly posDelta: FloatPos /** * ### 传送实体至指定位置 * * @param pos 目标位置坐标 * @param rot 传送后实体的朝向，若缺省则与传送前朝向相同 * * @returns 是否成功传送 */ teleport(pos: IntPos | FloatPos, rot?: DirectionAngle): boolean /** * ### 传送实体至指定位置 * * @param x x坐标 * @param y y坐标 * @param z z坐标 * @param dimId 维度Id * @param rot 传送后实体的朝向，若缺省则与传送前朝向相同 * * @returns 是否成功传送 */ teleport( x: number, y: number, z: number, dimId: 0 | 1 | 2 | 3, rot?: DirectionAngle, ): boolean /** * ### 杀死指定实体 * * @returns 是否执行成功 */ kill(): boolean /** * ### 对实体造成伤害 * * 此处造成的伤害为真实伤害，无法被盔甲等保护装备减免 * * @param damage 对实体造成的伤害数值 * @param type 伤害类型（见{@linkcode ActorDamageCause}） * * @returns 是否造成伤害 */ hurt(damage: number, type?: number): boolean /** * ### 治愈实体 * * @param health 要回复的生命值 * * @returns 是否成功回复 */ // 正式版未实装 // heal(health: number): boolean; /** * ### 使指定实体着火 * * @param time 着火时长，单位秒 * * @returns 是否成功着火 */ setOnFire(time: number): boolean /** * ### 设置实体体积 * * @param scale 新的实体体积 * * @returns 实体是否成功缩放 */ // 正式版未实装 // setScale(scale: number): boolean; /** * ### 获取实体到指定坐标的距离 * * @param pos 目标位置 * * @returns 到坐标的距离（方块） */ // 正式版未实装 // distanceToPos(pos: IntPos | FloatPos): number; /** * ### 判断一个实体对象是不是玩家 * * @returns 当前实体对象是不是玩家 */ isPlayer(): boolean /** * ### 将实体对象转换玩家对象 * * 如果当前实体对象指向的是一个玩家，可以使用此函数将实体对象转换为玩家对象，以使用更多的玩家相关 API\ * 如果此实体对象指向的不是某个玩家，或者转换失败，则返回 `null` * * @returns 转换成的玩家对象，失败返回`null` */ toPlayer(): Player | null /** * ### 判断一个实体对象是不是掉落物实体 * * @returns 当前实体对象是不是掉落物实体 */ isItemEntity(): boolean /** * ### 获取掉落物实体中的物品对象 * * 如果当前实体对象是一个掉落物实体，可以使用此函数获取掉落物实体中的物品对象，以使用更多的物品相关 API\ * 如果此实体对象不是掉落物实体，或者获取失败，则返回 `null` * * @returns 获取到的物品对象，失败返回`null` */ toItem(): Item | null /** * ### 获取实体当前站立所在的方块 * * @returns 当前站立在的方块对象 */ getBlockStandingOn(): Block /** * ### 获取生物盔甲栏的容器对象 * * @returns 此实体盔甲栏对应的容器对象 */ getArmor(): Container /** * ### 判断生物是否拥有容器（盔甲栏除外） * * 如羊驼身上的箱子等，他们各自拥有一个属于自己的容器对象 * * @returns 这个生物实体是否拥有容器 */ hasContainer(): boolean /** * ### 获取生物所拥有的容器对象（盔甲栏除外） * * @returns 这个生物实体所拥有的容器对象 */ getContainer(): Container /** * ### 刷新生物物品栏、盔甲栏 * * 在修改生物物品之后，为了促使客户端生效，需要刷新生物所有的物品 * * @returns 是否成功刷新 */ refreshItems(): boolean /** * ### 为实体增加一个Tag * * @param tag 要增加的tag字符串 * * @returns 是否添加成功 */ addTag(tag: string): boolean /** * ### 为为实体移除一个Tag * * @param tag 要移除的tag字符串 * * @returns 是否移除成功 */ removeTag(tag: string): boolean /** * ### 检查实体是否拥有某个Tag * * @param tag 要检查的tag字符串 * * @returns 是否拥有这个Tag */ hasTag(tag: string): boolean /** * ### 返回实体拥有的所有Tag列表 * * @returns 实体所有的 tag 字符串列表 */ getAllTags(): string[] /** * ### 获取实体对应的NBT对象 * * @returns 实体的NBT对象 */ getNbt(): NbtCompound /** * ### 写入实体对应的NBT对象 * * @param nbt NBT对象 * * @returns 是否成功写入 */ setNbt(nbt: NbtCompound): boolean /** * @deprecated * @alias {@linkcode getNbt()} */ getTag(): NbtCompound /** * @deprecated * @alias {@linkcode setNbt()} */ setTag(nbt: NbtCompound): boolean | null /** * ### 获取视线方向实体 * * @param maxDistance 查找最大距离 * * @returns 视线方向实体，如果获取失败，返回 `null` */ getEntityFromViewVector(maxDistance?: number): Entity | null /** * ### 获取视线方向方块 * * @param includeLiquid 是否包含液态方块 * @param solidOnly 是否仅允许 `Solid` 类型的方块 * @param maxDistance 查找最大距离 * @param fullOnly 是否仅允许完整方块 * * @returns 视线方向方块，如果获取失败，返回 `null` */ getBlockFromViewVector( includeLiquid?: boolean, solidOnly?: boolean, maxDistance?: number, fullOnly?: boolean, ): Block | null /** * ### 快速执行Molang表达式 * * 关于Molang的详细使用方法，请参考 [MOLANG文档 bedrock.dev](https://bedrock.dev/zh/docs/stable/Molang) * * @param str Molang表达式 * * @returns 表达式执行结果 */ quickEvalMolangScript(str: string): number asPointer(): NativePointer | null /** * ### 缩放实体 * * @param scale 新的玩家实体 (整数) * * @returns 是否缩放成功 */ setScale(scale: number): boolean /** * ### 熄灭实体 * * @returns 是否熄灭成功 */ stopFire(): boolean /** * @deprecated * ### 获取实体到坐标的距离 * * @param pos 目标位置 * * @returns 到坐标的距离(方块) * */ distanceToPos(pos: Entity | Player | IntPos | FloatPos): number /** * * ### 获取实体到坐标的距离 * * @param pos 目标位置 * * @returns 到坐标的距离(方块) * */ distanceToSqr(pos: Entity | Player | IntPos | FloatPos): number /** * * ### 获取实体到坐标的距离 * * @param pos 目标位置 * * @returns 到坐标的距离(方块) * */ distanceTo(pos: Entity | Player | IntPos | FloatPos): number /** 设置生命值 */ setHealth(health: number): boolean /** 设置生命值上限 */ setMaxHealth(health: number): boolean /** * 设置伤害吸收属性 * @param value 新的值 * @returns 是否成功 */ setAbsorption(value: number): boolean /** * 设置攻击伤害属性 * @param value 新的值 * @returns 是否成功 */ setAttackDamage(value: number): boolean /** * 最大攻击伤害属性 * @param value 新的值 * @returns 是否成功 */ setMaxAttackDamage(value: number): boolean /** * 设置跟随范围 * @param value 新的值 * @returns 是否成功 */ setFollowRange(value: number): boolean /** * 设置击退抵抗属性 * @param value 新的值 * @returns 是否成功 */ setKnockbackResistance(value: 0 | 1): boolean /** * 设置幸运属性 * @param value 新的值 * @returns 是否成功 */ setLuck(value: number): boolean /** * 设置移动速度属性 * @param value 新的值 * @returns 是否成功 */ setMovementSpeed(value: number): boolean /** * 置水下移动速度属性 * @param value 新的值 * @returns 是否成功 */ setUnderwaterMovementSpeed(value: number): boolean /** * 设置岩浆上移动速度属性 * @param value 新的值 * @returns 是否成功 */ setLavaMovementSpeed(value: number): boolean /** * 使指定实体刷新消失 * @returns 是否成功执行 */ despawn(): boolean /** * 移除指定实体 * @returns 是否成功执行 */ remove(): boolean setPosDelta(arg1: FloatPos): boolean setPosDelta(arg1: number, arg2: number, arg3: number): boolean /** * 获取实体全部药水效果 * @returns 实体所有的药水效果id */ getAllEffects(): number[] /** * 为实体添加一个药水效果 * @param id 药水效果的id * @param tick 持续时间 * @param level 等级 * @param showParticles 是否显示粒子 * @returns 是否成功 */ addEffect(id: number, tick: number, level: number, showParticles: boolean): boolean /** * 为实体移除一个药水效果 * @param id 药水效果的id * @returns 是否成功 */ removeEffect(id: number): boolean } declare class LLSE_Entity extends Entity {}