Skip to content

S-🌏 游戏世界 ​

GameWorld 是整个游戏世界的主要接口,它提供了以下核心功能:

  • 控制环境:管理天气、物理重力、画面滤镜等全局场景属性
  • 实体管理:创建和搜索游戏中的实体对象
  • 事件系统:监听实体和玩家的碰撞、伤害、互动等事件

你可以通过全局对象 world 来使用这些功能。

类定义 ​

typescript
declare const world: GameWorld;
declare class GameWorld {
  //...
}

属性列表 ​

基础信息 ​

  • projectName : 本张地图名称,对应项目设置中的名称
  • serverId : 当前服务器 ID
  • currentTick : 世界当前的 Tick 计数
  • useOBB : 是否切换为 OBB 包围盒计算方式

物理系统 ​

天气效果 ​

雾效果 ​

雨天效果 ​

下雪效果 ​

光照系统 ​

音效系统 ​

方法 ​

聊天系统 ​

实体管理 ​

  • createEntity : 创建一个新实体 GameEntity 或复制一个现有的实体
  • entityQuota : 返回脚本当前仍可创建的实体数量
  • querySelector : 搜索满足条件的第一个实体
  • querySelectorAll : 搜索满足条件的所有实体,返回一个列表
  • searchBox : 搜索指定范围中的全部实体
  • raycast : 射线检测,返回碰到的实体或方块

区域管理 ​

物理系统 ​

音效与动画 ​

地图传送 ​

  • teleport : 地图组内传送能力,能够让玩家被传送到指定地图中

事件监听 ​

基础事件 ​

  • onTick : 这是世界的计时事件,每 64 毫秒触发一次,Tick 计数加 1
  • onPlayerJoin : 当玩家加入地图时触发
  • onPlayerLeave : 当玩家离开地图时触发
  • onChat : 当玩家在聊天窗口说话时触发

实体事件 ​

输入事件 ​

  • onPress : 当玩家按下按钮时触发
  • onRelease : 当玩家松开按钮时触发

战斗事件 ​

碰撞事件 ​

区域事件 ​

  • onEnter : 当玩家进入该区域时触发
  • onLeave : 当玩离开该区域时触发

商城事件 ​

接口定义 ​

事件接口 ​

配置接口 ​

枚举值 ​