meta data for this page
  •  

📚 差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
scripting:world:core [2025/08/28 02:49] bibiboxsscripting:world:core [2025/12/03 10:50] (当前版本) bibiboxs
行 328: 行 328:
 ### SetTime() ### SetTime()
  
-> 设置当前游戏世界时间。+> 设置当前世界时间。
 > >
 > **注意:每次加载新世界场景后,时间都将重新替换为【地图文件配置——默认时间】。** > **注意:每次加载新世界场景后,时间都将重新替换为【地图文件配置——默认时间】。**
行 340: 行 340:
 ### GetWorldTime() ### GetWorldTime()
  
-> 获取游戏世界时间实例(`WorldTime`)。+> 获取当前世界时间实例(`WorldTime`)。
  
 ```javascript ```javascript
行 351: 行 351:
 ### SetWorldTimeRate() ### SetWorldTimeRate()
  
-> 设置当前游戏世界时间速率(游戏时间每分钟的时间间隔),默认为`1.0`。+> 设置游戏世界时间速率(游戏时间每分钟的时间间隔),默认为`1.0`。
 > >
 > 此方法是`SetGameRule("timerate")`的快捷API。 > 此方法是`SetGameRule("timerate")`的快捷API。
行 365: 行 365:
 ### GetWorldTimeRate() ### GetWorldTimeRate()
  
-> 获取游戏世界时间速率(游戏时间每分钟的时间间隔)。+> 获取世界时间速率(游戏时间每分钟的时间间隔)。
  
 ```javascript ```javascript
行 375: 行 375:
 ### SetWorldWeather() ### SetWorldWeather()
  
-> 设置游戏世界天气,具体参考[天气ID](reference/instances)文档。+> 设置世界天气,具体参考[天气ID](reference/instances)文档。
 > >
 > **注意:每次加载新世界场景后,天气都将重新替换为【地图文件配置——随机天气(天气池)】。** > **注意:每次加载新世界场景后,天气都将重新替换为【地图文件配置——随机天气(天气池)】。**
行 387: 行 387:
 ### GetWorldWeather() ### GetWorldWeather()
  
-> 获取游戏世界天气。+> 获取世界天气。
  
 ```javascript ```javascript
行 397: 行 397:
 ### GetRandomWorldWeather() ### GetRandomWorldWeather()
  
-> 随机获取游戏世界天气,获取方式根据参数决定。+> 随机获取世界天气,获取方式根据参数决定。
  
 ```javascript ```javascript
行 409: 行 409:
 ### SetWorldGravity() ### SetWorldGravity()
  
-> 设置游戏世界物理重力,分别为`横向X、纵向Y、前后Z`,默认为`Vector(0.0, -1.0, 0.0)`(正常下落的引力,且没有方向偏移)。+> 设置世界物理重力,分别为`横向X、纵向Y、前后Z`,默认为`Vector(0.0, -1.0, 0.0)`(正常下落的引力,且没有方向偏移)。
  
 ```javascript ```javascript
行 419: 行 419:
 ### GetWorldGravity() ### GetWorldGravity()
  
-> 获取游戏世界物理重力。+> 获取世界物理重力。
  
 ```javascript ```javascript
行 429: 行 429:
 ### SetWorldBrightness() ### SetWorldBrightness()
  
-> 设置游戏世界亮度偏移,默认为`1.0`。+> 设置世界亮度偏移,默认为`1.0`。
  
 > 对于特定的场景或游戏玩法(如丧尸游戏),开发者可能希望将此值调低以营造更好的黑夜效果。 > 对于特定的场景或游戏玩法(如丧尸游戏),开发者可能希望将此值调低以营造更好的黑夜效果。
行 441: 行 441:
 ### GetWorldBrightness() ### GetWorldBrightness()
  
-> 获取游戏世界亮度偏移。+> 获取世界亮度偏移。
  
 ```javascript ```javascript
行 452: 行 452:
 ### SetWorldColor() ### SetWorldColor()
  
-> 设置游戏世界叠加色调,默认为白色`Color(255, 255, 255)`。+> 设置世界叠加色调,默认为白色`Color(255, 255, 255)`。
 > >
  
行 463: 行 463:
 ### GetWorldColor() ### GetWorldColor()
  
-> 获取游戏世界叠加色调。+> 获取世界叠加色调。
  
 ```javascript ```javascript
行 473: 行 473:
 ### SetWorldFogColor() ### SetWorldFogColor()
  
-> 设置游戏世界雾颜色,默认为白色`Color(180, 180, 180)`。+> 设置世界雾颜色,默认为白色`Color(180, 180, 180)`。
  
 > 此方法是`SetGameRule("fogcolor")`的快捷方法。 > 此方法是`SetGameRule("fogcolor")`的快捷方法。
行 485: 行 485:
 ### GetWorldFogColor() ### GetWorldFogColor()
  
-> 获取游戏世界雾颜色。+> 获取世界雾颜色。
  
 ```javascript ```javascript
行 495: 行 495:
 ### SetWorldSolarColor() ### SetWorldSolarColor()
  
-> 设置游戏世界日月颜色(太阳&月亮),默认为淡黄色`Color(255, 253, 235)`。+> 设置世界日月颜色(太阳&月亮),默认为淡黄色`Color(255, 253, 235)`。
  
 ```javascript ```javascript
行 505: 行 505:
 ### GetWorldSolarColor() ### GetWorldSolarColor()
  
-> 获取游戏世界日月颜色(太阳&月亮)。+> 获取世界日月颜色(太阳&月亮)。
  
 ```javascript ```javascript
行 515: 行 515:
 ### SetWorldSolarScale() ### SetWorldSolarScale()
  
-> 设置游戏世界日月尺寸缩放(太阳&月亮),默认为`1.0`,限制范围`0.0~10.0`。+> 设置世界日月尺寸缩放(太阳&月亮),默认为`1.0`,限制范围`0.0~10.0`。
  
 ```javascript ```javascript
行 525: 行 525:
 ### GetWorldSolarScale() ### GetWorldSolarScale()
  
-> 获取游戏世界日月尺寸缩放(太阳&月亮)。+> 获取世界日月尺寸缩放(太阳&月亮)。
  
 ```javascript ```javascript
行 535: 行 535:
 ### SetWorldCloudColor() ### SetWorldCloudColor()
  
-> 设置游戏世界云层颜色,默认为浅灰色`Color(180, 180, 180)`。+> 设置世界云层颜色,默认为浅灰色`Color(180, 180, 180)`。
  
 ```javascript ```javascript
行 545: 行 545:
 ### GetWorldCloudColor() ### GetWorldCloudColor()
  
-> 获取游戏世界**云层颜色**。+> 获取世界**云层颜色**。
  
 ```javascript ```javascript
行 555: 行 555:
 ### SetWorldCloudDensity() ### SetWorldCloudDensity()
  
-> 设置游戏世界**云层密度(强度)**,默认为`0.5`,限制范围`0.0~1.0`。+> 设置世界**云层密度(强度)**,默认为`0.5`,限制范围`0.0~1.0`。
  
 ```javascript ```javascript
行 565: 行 565:
 ### GetWorldCloudDensity() ### GetWorldCloudDensity()
  
-> 获取游戏世界**云层密度(强度)**。+> 获取世界**云层密度(强度)**。
  
 ```javascript ```javascript
行 575: 行 575:
 ### SetSkybox() ### SetSkybox()
  
-> 设置游戏世界天空盒,默认为`0`。+> 设置世界天空盒,默认为`0`。
  
 ```javascript ```javascript
行 585: 行 585:
 ### GetSkybox() ### GetSkybox()
  
-> 获取游戏世界天空盒。+> 获取世界天空盒。
  
 ```javascript ```javascript
行 595: 行 595:
 ### SetSkyboxColor() ### SetSkyboxColor()
  
-> 设置游戏世界天空盒叠加色调,默认为`Color(128, 128, 128)`。+> 设置世界天空盒叠加色调,默认为`Color(128, 128, 128)`。
  
 ```javascript ```javascript
行 605: 行 605:
 ### GetSkyboxColor() ### GetSkyboxColor()
  
-> 获取游戏世界天空盒叠加色调。+> 获取世界天空盒叠加色调。
  
 ```javascript ```javascript
 function GetSkyboxColor(): Color function GetSkyboxColor(): Color
 +```
 +
 +
 +
 +### SetSkyboxNightColor()
 +
 +> 设置世界天空盒叠加色调(夜间\黑暗),默认为`Color(0, 0, 60)`。
 +
 +> 注意:阴天、雨天等天气变化时(变暗),也会受到此颜色的影响。
 +
 +```javascript
 +function SetSkyboxNightColor( color: Color )
 +```
 +
 +
 +
 +### GetSkyboxNightColor()
 +
 +> 获取世界天空盒叠加色调(夜间\黑暗)。
 +
 +```javascript
 +function GetSkyboxNightColor(): Color
 ``` ```
  
行 625: 行 647:
 ### GetSkyboxOffset() ### GetSkyboxOffset()
  
-> 获取游戏世界天空盒偏移(高度)。+> 获取世界天空盒偏移(高度)。
  
 ```javascript ```javascript
行 635: 行 657:
 ### SetSkyboxRotateSpeed() ### SetSkyboxRotateSpeed()
  
-> 设置游戏世界天空盒旋转速度,默认`1.0`。+> 设置世界天空盒旋转速度,默认`1.0`。
 > >
 > 如果设置为`0`则固定角度,如果设置为`-1`则使用地图默认速度。 > 如果设置为`0`则固定角度,如果设置为`-1`则使用地图默认速度。
行 647: 行 669:
 ### GetSkyboxRotateSpeed() ### GetSkyboxRotateSpeed()
  
-> 获取游戏世界天空盒旋转速度。+> 获取世界天空盒旋转速度。
  
 ```javascript ```javascript
行 1187: 行 1209:
 function ReplaceTerrainLayer( layer: int, newLayer: int ) function ReplaceTerrainLayer( layer: int, newLayer: int )
 ``` ```
 +