meta data for this page
📚 差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录前一修订版 | |||
| scripting:world:core [2025/08/28 02:49] – bibiboxs | scripting: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(" | > 此方法是`SetGameRule(" | ||
| 行 365: | 行 365: | ||
| ### GetWorldTimeRate() | ### GetWorldTimeRate() | ||
| - | > 获取游戏世界时间速率(游戏时间每分钟的时间间隔)。 | + | > 获取世界时间速率(游戏时间每分钟的时间间隔)。 |
| ```javascript | ```javascript | ||
| 行 375: | 行 375: | ||
| ### SetWorldWeather() | ### SetWorldWeather() | ||
| - | > 设置游戏世界天气,具体参考[天气ID](reference/ | + | > 设置世界天气,具体参考[天气ID](reference/ |
| > | > | ||
| > **注意:每次加载新世界场景后,天气都将重新替换为【地图文件配置——随机天气(天气池)】。** | > **注意:每次加载新世界场景后,天气都将重新替换为【地图文件配置——随机天气(天气池)】。** | ||
| 行 387: | 行 387: | ||
| ### GetWorldWeather() | ### GetWorldWeather() | ||
| - | > 获取游戏世界天气。 | + | > 获取世界天气。 |
| ```javascript | ```javascript | ||
| 行 397: | 行 397: | ||
| ### GetRandomWorldWeather() | ### GetRandomWorldWeather() | ||
| - | > 随机获取游戏世界天气,获取方式根据参数决定。 | + | > 随机获取世界天气,获取方式根据参数决定。 |
| ```javascript | ```javascript | ||
| 行 409: | 行 409: | ||
| ### SetWorldGravity() | ### SetWorldGravity() | ||
| - | > 设置游戏世界物理重力,分别为`横向X、纵向Y、前后Z`,默认为`Vector(0.0, | + | > 设置世界物理重力,分别为`横向X、纵向Y、前后Z`,默认为`Vector(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, | + | > 设置世界叠加色调,默认为白色`Color(255, |
| > | > | ||
| 行 463: | 行 463: | ||
| ### GetWorldColor() | ### GetWorldColor() | ||
| - | > 获取游戏世界叠加色调。 | + | > 获取世界叠加色调。 |
| ```javascript | ```javascript | ||
| 行 473: | 行 473: | ||
| ### SetWorldFogColor() | ### SetWorldFogColor() | ||
| - | > 设置游戏世界雾颜色,默认为白色`Color(180, | + | > 设置世界雾颜色,默认为白色`Color(180, |
| > | > | ||
| > 此方法是`SetGameRule(" | > 此方法是`SetGameRule(" | ||
| 行 485: | 行 485: | ||
| ### GetWorldFogColor() | ### GetWorldFogColor() | ||
| - | > 获取游戏世界雾颜色。 | + | > 获取世界雾颜色。 |
| ```javascript | ```javascript | ||
| 行 495: | 行 495: | ||
| ### SetWorldSolarColor() | ### SetWorldSolarColor() | ||
| - | > 设置游戏世界日月颜色(太阳& | + | > 设置世界日月颜色(太阳& |
| ```javascript | ```javascript | ||
| 行 505: | 行 505: | ||
| ### GetWorldSolarColor() | ### GetWorldSolarColor() | ||
| - | > 获取游戏世界日月颜色(太阳& | + | > 获取世界日月颜色(太阳& |
| ```javascript | ```javascript | ||
| 行 515: | 行 515: | ||
| ### SetWorldSolarScale() | ### SetWorldSolarScale() | ||
| - | > 设置游戏世界日月尺寸缩放(太阳& | + | > 设置世界日月尺寸缩放(太阳& |
| ```javascript | ```javascript | ||
| 行 525: | 行 525: | ||
| ### GetWorldSolarScale() | ### GetWorldSolarScale() | ||
| - | > 获取游戏世界日月尺寸缩放(太阳& | + | > 获取世界日月尺寸缩放(太阳& |
| ```javascript | ```javascript | ||
| 行 535: | 行 535: | ||
| ### SetWorldCloudColor() | ### SetWorldCloudColor() | ||
| - | > 设置游戏世界云层颜色,默认为浅灰色`Color(180, | + | > 设置世界云层颜色,默认为浅灰色`Color(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, | + | > 设置世界天空盒叠加色调,默认为`Color(128, |
| ```javascript | ```javascript | ||
| 行 605: | 行 605: | ||
| ### GetSkyboxColor() | ### GetSkyboxColor() | ||
| - | > 获取游戏世界天空盒叠加色调。 | + | > 获取世界天空盒叠加色调。 |
| ```javascript | ```javascript | ||
| function GetSkyboxColor(): | function GetSkyboxColor(): | ||
| + | ``` | ||
| + | |||
| + | |||
| + | |||
| + | ### SetSkyboxNightColor() | ||
| + | |||
| + | > 设置世界天空盒叠加色调(夜间\黑暗),默认为`Color(0, | ||
| + | > | ||
| + | > 注意:阴天、雨天等天气变化时(变暗),也会受到此颜色的影响。 | ||
| + | |||
| + | ```javascript | ||
| + | function SetSkyboxNightColor( color: Color ) | ||
| + | ``` | ||
| + | |||
| + | |||
| + | |||
| + | ### GetSkyboxNightColor() | ||
| + | |||
| + | > 获取世界天空盒叠加色调(夜间\黑暗)。 | ||
| + | |||
| + | ```javascript | ||
| + | function GetSkyboxNightColor(): | ||
| ``` | ``` | ||
| 行 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 ) | ||
| ``` | ``` | ||
| + | |||