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() | 该进度是否会显示 | 布尔值 |
M1hono
Wudji