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 : 当玩离开该区域时触发

商城事件

接口定义

事件接口

配置接口

枚举值