跳转至

Box3Zone / GameZone 区域

这是一个服务端API

该API仅在服务端脚本使用

查阅官方文档
查阅官方文档(Arena)
查阅社区文档(Arena)
/ 用于检测实体进入或离开某个区域。 也可以用来设置环境参数,如雾、雨、天、雪、风、重力等定义区域内的环境参数

未证实

似乎现在的区域就是原来的触发器改名而来,但未得到证实
原因是 / 的注释为:

Triggers can be used to detect when an object enters some zone or leaves.

属性

bounds: /
该区域的立方体空间区域
selector: /
区域使用的选择器,该区域的效果/事件只能作用在满足该选择器的实体上
massScale:
实体在该区域内质量mass的缩放
force: / :
实体在该区域内每tick都会受到的作用力
fogEnabled:
是否在该区域内启用单独的雾
fogColor: /
该区域内雾的颜色
fogStartDistance:
该区域内雾的起始距离
fogHeightOffset:
该区域内雾高度
fogHeightFalloff:
该区域内的雾衰减速率
fogDensity:
该区域内的均匀雾量
fogMax:
该区域内的最大雾量
snowEnabled:
是否在该区域内启用单独的雪
snowDensity: :
该区域的雪密度
snowSizeLo:
该区域雪花最小尺寸
snowSizeHi:
该区域雪花最大尺寸
snowFallSpeed:
该区域雪花下落速率
snowSpinSpeed:
该区域雪花自旋速度
snowColor: /
该区域雪花颜色
snowTexture:
该区域雪花纹理,格式为'snow/*.part'
rainEnabled:
是否在该区域内启用单独的雨
rainDensity:
该区域的雨密度
rainDirection: /
该区域雨的方向
rainSpeed:
该区域雨点下落速率
rainSizeLo:
该区域雨点最小尺寸
rainSizeHi:
该区域雨点最大尺寸
rainInterference:
该区域雨扰流幅度
rainColor: /
该区域雨点颜色
skyEnabled:
是否在该区域内启用单独的天空光照
skyMode: 'natural' | 'manual'

该区域内光照模式

skySunPhase:
该区域内太阳运行阶段,按照timeOfDay = (sunPhase + sunFrequency * tick) % 1公式计算

skySunFrequency: : 该区域内太阳在天空中移动的频率。 数值越高,太阳运动越快

skyLunarPhase: 该区域内月亮的相位,范围\([0, 1]\)

skySunDirection: /
该区域内太阳的方向
skySunLight: /
该区域内太阳的光照颜色
skyLeftLight: /
skyRightLight: /
skyBottomLight: /
skyTopLight: /
skyFrontLight: /
skyBackLight: /
该区域内太阳分别在-x+x-y+y-z+z方向的光照颜色

方法

entities(): [] / []
获取该区域内所有的实体
remove():
移除该区域

事件

onEnter: / < / >
nextEnter: / < / >
当实体进入(或未来)触发的事件
onLeave: / < / >
nextLeave: / < / >
当实体离开(或未来)触发的事件

评论区