15.4 WorldJS 和 ServerJS
一、WorldJS
WorldJS允许你获取、修改当前世界的一些信息，而ServerJS允许你操作当前服务器中的一些内容
1、属性
| 属性 | 描述 | 返回值 |
|---|---|---|
side | 返回当前运行环境[1] | ScriptType |
gameRules | 返回游戏规则效果内容[2] | GameRulesJS |
server | 返回ServerJS | ServerJS |
time | 获取游戏总时间 | 长整型 |
localTime | 获取游戏日时间 | 长整型 |
dimension | 返回游戏维度名 | 字符串 |
overworld | 返回当前世界是否为主世界 | 布尔型 |
daytime | 返回当前世界是否为白天 | 布尔型 |
raining | 返回当前世界天气是否为雨天 | 布尔型 |
thundering | 返回当前世界天气是否为雷暴 | 布尔型 |
rainStrength | 返回当前世界下雨强度 | 浮点型 |
players | 返回当前世界玩家列表 | EntityArrayList |
entities | 返回当前世界实体列表 | EntityArrayList |
[1]：值可以为client/server
[2]：见本节末GameRulesJS
2、函数
| 函数 | 描述 | 返回值 |
|---|---|---|
getBlock(整形 x, 整形 y, 整形 z) | 返回指定坐标方块 | BlockContainerJS |
getBlock(BlockPos pos) | 返回指定坐标方块 | BlockContainerJS |
getBlock(BlockEntity blockEntity) | 返回指定坐标方块 | BlockContainerJS |
createExplosion(浮点型 x, 浮点型 y, 浮点型 z) | 新建爆炸 | ExplosionJS[3] |
createEntity(命名空间id) | 新建实体 | EntityJS[4] |
spawnLightning(浮点型 x, 浮点型 y, 浮点型 z, 布尔值 是否只有效果, nullable EntityJS 玩家对象) | 生成闪电 | void |
spawnLightning(浮点型 x, 浮点型 y, 浮点型 z, 布尔值 是否只有效果) | 生成闪电 | void |
spawnFireworks(浮点型 x, 浮点型 y, 浮点型 z, FireworksJS 烟花) | 生成烟花 | void |
[3]：见15.3 ExplosionJS 部分
[4]：见15.2 EntityJS部分
二、ServerJS
1、属性
| 属性 | 描述 | 返回值 |
|---|---|---|
overworld | 返回ServerWorldJS | ServerWorldJS[5] |
worlds | 返回ServerWorldJS列表 | List |
running | 返回服务器是否正在运行 | 布尔值 |
hardcore | 返回服务器是否为极限模式 | 布尔值 |
singlePlayer | 返回是否为单人模式 | 布尔值 |
dedicated | 返回是否为"纯"服务器端(?) | 布尔值 |
motd | 返回服务器的motd | 字符串 |
players | 返回当前服务器玩家列表 | EntityArrayList |
entities | 返回当前服务器实体列表 | EntityArrayList |
2、函数
| 函数 | 描述 | 返回值 |
|---|---|---|
stop() | 停止当前服务器 | void |
getLevel(字符串 维度名称) | 返回给定维度 | WorldJS |
getPlayer(UUID uuid) | 返回给定UUID的玩家 | nullable ServerPlayerJS |
getPlayer(字符串 玩家名称) | 返回给定名称的玩家 | nullable ServerPlayerJS |
getEntities(字符串 过滤器[6]) | 返回符合给定过滤器的实体列表 | EntityArrayList |
getAdvancement(命名空间id) | 返回给定成就 | AdvancementJS[7] |
sendDataToAll(字符串 通道, nullable any 数据) | 向所有玩家发送数据[8] | void |
setMotd(Component motd) | 设置服务器motd | void |
getName() | 返回服务器名称 | Text |
getDisplayName() | 返回服务器显示名称[9] | Text |
tell(Component 消息) | 向服务器所有玩家发送消息 | void |
setStatusMessage(Component 消息) | 设置服务器所有玩家的状态栏消息 | void |
[5]：见本节末ServerWorldJS
[6]：形如"@e[type=minecraft:clicken]"等
[7]：见本节末AdvancementJS
[8]：见16 网络包
[9]：这里指从服务器后台执行命令时括号中显示的“名称”
三、GameRulesJS
| 函数 | 描述 | 返回值 |
|---|---|---|
getString(字符串 游戏规则) | 返回指定游戏规则的值 | 字符串 |
getBoolean(字符串 游戏规则) | 返回指定游戏规则的值 | 布尔型 |
getInt(字符串 游戏规则) | 返回指定游戏规则的值 | 整形 |
set(字符串 游戏规则, Object 值) | 设置指定游戏规则的值 | void |
四、AdvancementJS
| 属性 | 描述 | 返回值 |
|---|---|---|
displayText | 返回进度文本 | Text |
title | 返回进度标题 | Text |
description | 返回进度描述 | Text |
| 函数 | 描述 | 返回值 |
|---|---|---|
addChild(AdvancementJS a) | 添加子进度 | void |
hasDisplay() | 该进度是否会显示 | 布尔值 |