迷你世界UGC3.0脚本Wiki

Appearance

环境（天空盒）模块 Wiki —— 迷你世界 ​

关于本文档：本 Wiki 介绍《迷你世界》中「环境」模块（即游戏里决定整个世界天空与氛围的系统，底层也叫"天空盒"）。本文用"功能 + 效果描述"说明每一项，不需要懂代码即可理解使用。

一、什么是「环境」 ​

「环境」是迷你世界里决定整个世界视觉氛围的总开关。它不只是头顶那张天空图，而是一整套配置，涵盖：

  • 天空的颜色与渐变
  • 太阳、月亮、星空
  • 云、雾、风
  • 水面的颜色与质感
  • 整个世界的光照明暗

1.1 环境 vs 滤镜（容易混淆，重要区分） ​

这是两套独立、但经常一起调的系统：

系统改的是什么类比
环境世界里的真实景物：天空、光、云雾水重新布置一个真实场景
滤镜镜头/画面的成像效果：对比、饱和、色调给相机镜头加一层滤镜

简单判断：玩家说的是"世界里有什么"→ 改环境；说的是"画面看起来怎样"→ 改滤镜。两者可以叠加使用。

二、环境模板（一键套用的预设） ​

2.1 模板是什么 ​

环境以模板为单位。每个模板都是一整套调好的预设氛围，选中即整体套用，玩家不用逐项手调。

  • 游戏内置 27 个模板槽位（含 1 个"空模板 = 不启用环境"，其余 26 个为可用预设）。
  • 切换模板 = 把整个世界的天空、光照、云雾水一次性换成那套预设。
  • 这是最快达到目标氛围的方式——想要某种感觉，先看有没有现成模板。

2.2 模板清单 ​

编号名称风格氛围缩略图
0空模板不启用环境空模板
1经典通用写实白天经典
2卡通风格卡通可爱明快卡通风格
3自然过渡自然写实柔和自然过渡
4梦幻粉梦幻粉色唯美梦幻粉
5冰雪蓝冰雪寒冷冷调冰雪蓝
6烈焰红炽热红色危险烈焰红
7废土黄废土荒凉末世废土黄
8科幻灰科幻赛博冷调科幻灰
9毒雾绿毒雾诡异绿色毒雾绿
10水墨水墨国风黑白水墨
11青山绿水水墨国风青绿青山绿水
12森林森林绿意自然森林
13沙漠沙漠干旱暖黄沙漠
14冰原冰原寒冷冷白冰原
15沼泽沼泽阴湿暗绿沼泽
16火山火山炽热红黑火山
17雨林雨林湿润浓绿雨林
18丛林丛林茂密绿丛林
19针叶林针叶林冷绿高纬针叶林
20高山高山高远冷蓝高山
21海洋海洋蔚蓝开阔海洋
22空岛空岛天空悬浮空岛
23盆地盆地低地柔和盆地
24草原草原开阔绿黄草原
25热带草原热带温暖黄绿热带草原
26发光空岛发光奇幻绚丽发光空岛

三、环境的可调属性（精细调整时用） ​

模板是"一键套用"，但每个模板内部还有很多可单独微调的属性。下面按类别说明每一项是什么、改了有什么效果。

3.1 ⭐ 核心机制：一天有 8 个时间段 ​

环境不是一套固定画面，而是按一天里的不同时刻分别存了多套配置，时间推进时自动平滑过渡。所以同一个模板，正午和午夜可以完全不一样。

时间段大致时刻感受
午夜0 点深夜、最暗
黎明前4 点将亮未亮
日出6 点天边泛光
清晨8 点明亮清新
正午12 点最亮
下午16 点偏暖
黄昏18 点日落、橙红
夜晚20 点入夜、繁星

关键：调颜色或参数时要想清楚作用于哪个时间段（或选"全天")。比如玩家说"傍晚再暖一点"，就只调黄昏段；说"整体调暗"，就改全部时间段。下面 3.2~3.10 的属性，每个时间段都可以独立设置。

3.2 天空颜色 ​

天空的渐变主要由顶部、腰部、底部三段颜色决定，这是营造氛围最直接的三个颜色。

设置项效果
天空顶部颜色头顶正上方的天色
天空腰部颜色天空中段的过渡色
天空底部颜色接近地平线的天色
天空光照颜色天空整体散发的光的颜色（偏冷/偏暖）
环境光颜色笼罩全场景的环境光颜色

3.3 光照（明暗） ​

控制世界整体的亮度和光的颜色，直接决定"白天黑夜""刺眼还是柔和"。

设置项效果
太阳光强度主光（平行光）的强弱，决定刺眼或柔和
太阳光颜色主光的颜色
环境光强度阴影处、背光面的整体亮度
环境光颜色补光的颜色

3.4 太阳与月亮 ​

设置项效果
太阳颜色太阳本体的颜色
太阳大小天上太阳的视觉大小
月亮颜色月亮本体的颜色
月亮大小天上月亮的视觉大小

3.5 星空 ​

设置项效果
星星密度夜空中星星的多少

白天一般没有星星（密度接近 0），夜晚调高才会出现繁星。

3.6 雾 ​

雾是营造"朦胧 / 神秘 / 压抑"氛围的关键。

设置项效果
雾开关是否启用雾
雾颜色雾的颜色（如白雾、紫色毒雾）
雾起始距离离玩家多远开始有雾
雾结束距离多远之外完全被雾遮住

起始距离越近、结束距离越近，雾越浓。玩家说"雾浓一点"就把这两个距离都拉近。

3.7 云 ​

设置项效果
云移动速度云飘动的快慢
云密度云的多少/厚度
云高度云层的高低
云颜色云的颜色（如晚霞红云、乌云）

3.8 水面 ​

设置项效果
水面开关水面的总开关，可整体开启或关闭水面（开/关两态）
水颜色水的颜色与浑浊感
水透明度能不能看清水底
水镜面度水面反射的强弱（越高越像镜子）

说明：水面可通过开关整体开启/关闭；而「反射强度（水镜面度）」只能调节数值大小，没有独立的开关。

3.9 风 ​

设置项效果
风速影响植被、粒子等的摆动幅度

3.10 整体材质（不分时间段） ​

这两项作用于整个世界的物体表面质感，全天统一，不随时间变化。

设置项效果
整体金属度物体表面的金属感强弱
整体粗糙度物体表面的反光是否锐利（越低越亮面，越高越哑光）

四、自定义天空贴图 ​

除了用预设模板，环境还支持替换天空贴图，做出完全自定义的天空。游戏内置了 43 张预设贴图资源供玩家直接选用，也可以上传自己的图片。

可替换的贴图分三类：

贴图层作用游戏内置预设数量
天空贴图整片天空的图案19 张
太阳贴图太阳的样式5 张
月亮贴图月亮的样式5 张

4.1 天空贴图预设（19 张） ​

ID名称描述
0_30000默认默认天空盒
0_30001天空1粉绿渐变（左上绿色到右下粉红色的四色渐变，色块感强）
0_30002天空2粉紫渐变（粉色到淡紫色的柔和渐变，右上角有白色光晕）
0_30003天空3彩虹渐变（紫粉黄蓝多色流动渐变，梦幻感强）
0_30004天空4粉蓝渐变（上粉下蓝的双色渐变，清新柔和）
0_30005天空5深空紫（深紫色背景，中央有明亮的紫色光点，神秘感）
0_30006天空6银河系（黑色背景，白色星系盘面，写实风格的侧视银河）
0_30007天空7紫色星云（紫色调的星云云团，带有星点，梦幻太空感）
0_30008天空8绿黄星云（绿色和黄色交织的星云，色彩浓烈，科幻感强）
0_30009天空9紫红云海（深紫红色云层，底部有剪影山峰，暗黑奇幻风）
0_30010天空10深蓝星空（深蓝黑色夜空，右侧有淡蓝色星云带，宁静深邃）
0_30011天空11粉紫星空（粉紫渐变背景，散布白色星点，浪漫梦幻）
0_30012天空12紫蓝星云（深紫到蓝色的星云渐变，中央有明亮光带，科幻感强）
0_30013全景天空1蓝天白云（写实风格，蓝天+层叠白云，明亮清新）
0_30014全景天空2绿色极光（深色天空，绿色极光带，科幻神秘感）
0_30015全景天空3水墨山水（黑白水墨风格，层叠山峦剪影，中国风意境）
0_30016全景天空4青绿山水（青绿色调的山峦，古典山水画风格）
0_30017全景天空5蓝天白云2（深蓝天空，底部白云层，清爽明快）
0_30018全景天空6云海日出（云层上方视角，阳光穿透云层，壮丽感）

4.2 太阳贴图预设（5 张） ​

ID名称描述
0_30101太阳1黄色太阳（金黄色球体，表面有纹理细节，明亮温暖）
0_30102太阳2橙红太阳（橙红色球体，表面颗粒感强，炽热感）
0_30103太阳3日环（黑色背景，橙色光环，中心暗黑，日食效果）
0_30104太阳4黑洞（黑色球体，周围白色吸积盘，科幻感强）
0_30105太阳5白色恒星（白色发光球体，光晕柔和，高亮度）

4.3 月亮贴图预设（5 张） ​

ID名称描述
0_30201月亮1写实月球（灰白色月球表面，环形山清晰可见，写实风格）
0_30202月亮2血月（深红色月球，神秘诡异氛围）
0_30203月亮3蓝色月环（深蓝色球体，外围蓝色光环，科幻感）
0_30204月亮4新月（黑色背景，白色弯月+蓝色光晕，宁静梦幻）
0_30205月亮5星芒月（白色十字星芒光效，中心明亮，魔幻感强）

4.4 LUT 色彩风格预设（14 张） ​

这 14 张是滤镜用的 LUT（色彩查找表），不是天空贴图，但也在同一资源表里。玩家在 §五滤镜模板或单独调 LUT 时会用到。

ID名称描述
0_30301冷色调画面偏蓝绿冷色，营造冷峻、科技或冬季氛围
0_30302暖色调画面偏橙黄暖色，营造温暖、怀旧或日落氛围
0_30303卡通色彩饱和度高，对比强烈，卡通动画风格
0_30304夜视绿色单色调，模拟夜视仪效果
0_30305反转颜色反转（负片效果），诡异超现实感
0_30306电影感低饱和度+高对比度，电影胶片质感
0_30307海岛蓝绿色调为主，清爽海洋度假氛围
0_30308回忆泛黄褪色效果，怀旧复古感
0_30309明艳高饱和度+高亮度，鲜艳明快
0_30310青橙青色阴影+橙色高光，电影调色常用对比色
0_30311清新淡雅柔和色调，小清新风格
0_30312日系柔和淡雅+轻微过曝，日系摄影风格
0_30313日系过曝日系风格+明显过曝，梦幻柔光感
0_30314郁金香粉紫色调为主，浪漫柔美氛围（推测以郁金香花色命名）

说明：这 14 个 LUT 对应 §5.1 滤镜模板清单里编号 10~18 那些"套用 XX LUT"的模板，以及单独调节滤镜时的"LUT 色彩风格"选项。

五、滤镜（画面效果） ​

滤镜作用在镜头/画面上，是和环境配合使用的"成像调色"。玩家可单独调节以下效果：

滤镜效果作用
对比度明暗反差（越高越通透分明）
饱和度颜色的鲜艳程度
泛光强度亮部的柔光扩散（越高越柔和梦幻）
曝光强度画面整体亮暗
体积光强度光束（丁达尔效应）的明显度
伽马强度中间调的亮暗倾向

以上是常用的 6 项。还有若干"电影色调"高级微调项和「Bloom 阈值」属于进阶项，一般玩家不需要直接调。

此外滤镜还支持几种"一键"能力：

  • 滤镜颜色：给整个画面统一染一层色。
  • LUT 色彩风格：一键切换预置的色彩调性（游戏内置 14 套）。
  • 滤镜模板：一键套用整套画面风格（游戏内置 19 套，清单见 §5.1）。

玩家说"画面整体偏冷一点""换个电影感"这类，通常用 LUT 或滤镜模板最快达成。

5.1 滤镜模板清单 ​

和环境模板一样，滤镜也有一键套用的预设。共 19 个槽位（编号 0~18，其中 0 为"空模板 = 不套滤镜"）。下表「画面效果」一列描述套用后画面大致长什么样，依据各模板的实际调色参数（染色、对比、饱和、曝光等）整理。

编号名称画面效果（套用后大致长什么样）缩略图
0空模板不套任何滤镜，画面保持原样空模板
1经典标准默认调色，自然不偏色，作为基准经典
2卡通高饱和、对比略增，颜色鲜艳明快，偏曝光较亮卡通
3夜视套用专门的夜视 LUT，画面整体压暗、泛光关闭，暗环境观感夜视
4蓝绿整体偏黄绿调（暖中带绿），适合山野/自然场景蓝绿
5雾蓝强偏冷蓝调、对比拉高、曝光偏强，冷峻通透的雾感雾蓝
6浅红整体染红、对比很高、饱和降到 0（近单色红），危险/紧张氛围浅红
7日出黄暖黄偏青的晨光调，曝光偏亮，清晨柔和感日出黄
8回忆灰偏灰蓝、对比很高、饱和偏低、曝光偏亮，老照片般的怀旧感回忆灰
9黑白饱和度归零（纯黑白）、对比偏高、曝光很亮，强烈的黑白纪实感黑白
10电影感套用电影感 LUT，对比与色调偏电影质感电影感
11海岛套用海岛 LUT，明亮通透、偏清爽的海岛色调海岛
12回忆套用回忆 LUT，偏柔和怀旧的色调回忆
13明艳套用明艳 LUT，色彩浓郁鲜亮明艳
14青橙套用青橙 LUT，暗部偏青、亮部偏橙的电影流行配色青橙
15清新套用清新 LUT，淡雅明快、偏小清新清新
16日系套用日系 LUT，低对比、淡雅通透的日系观感日系
17日系过曝套用日系过曝 LUT，在日系基础上整体更亮、发白的过曝感日系过曝
18郁金香套用郁金香 LUT，偏暖粉/紫的柔美色调郁金香

六、脚本接口（写 Lua 时用） ​

如果你要在地图里用脚本动态控制环境（比如玩家进入某区域自动切换成夜晚、Boss 出现时天空变红），就需要调用下面的接口。以下接口均来自游戏可视化编程 / Lua 脚本实际暴露的能力。

说明：

  • time 参数填游戏时间（小时），可用时间点见 §3.1 的 8 个时间段（如 0 / 6 / 12 / 18 / 20）。
  • itype 参数填对应的设置项类型（如颜色项、属性项），即 §三 各表里列的那些设置项。
  • 颜色统一用 16 进制字符串，如 0xffffff（白）、0xff0000（红）。
  • 多数数值参数取值范围为 0~100。
  • 带 Anim 的接口支持过渡动画，让变化平滑而非瞬变。

6.1 环境（世界场景）接口 ​

接口作用主要参数
World:SetSkyBoxTemplate(value)一键切换环境模板value：模板编号 0~26
World:SetSkyBoxColor(time, itype, color)设置某时间段的某项颜色time 时间；itype 颜色项；color 如 0xffffff
World:SetSkyBoxAttr(time, itype, value)设置某时间段的某项参数time 时间；itype 参数项；value 0~100
World:SetSkyBoxAttrWithNoTime(itype, value)设置不分时间的参数（如金属度/粗糙度）itype 参数项；value 0~100
World:SetSkyBoxSwitch(time, itype, value)设置开关类（如雾的开/关）time 时间；itype 开关项；value 0/1
World:SetSkyBoxMaps(itype, url)替换天空/太阳/月亮贴图itype 贴图层；url 图片链接

6.2 滤镜（画面效果）接口 ​

滤镜是针对玩家生效的，所以接口带 playerid（可传单个玩家或玩家组）。

接口作用主要参数
World:SetSkyBoxFilter(playerid, itype, value)设置某项滤镜参数playerid 玩家；itype 滤镜项；value 0~100 或颜色值
Trigger.World:SetSkyBoxFilterColor(...)设置滤镜整体染色玩家/玩家组；颜色值
Trigger.World:SetSkyBoxFilterLUT(...)切换滤镜色彩风格（LUT，14 套）玩家/玩家组；LUT 编号
Trigger.World:SetSkyBoxFilterTemplate(...)一键套用滤镜模板（19 套）玩家/玩家组；模板编号

6.3 带过渡动画的接口 ​

切换时希望"渐变而非突变"，用下面这些。animTime 是过渡时长（毫秒，建议 1000 左右），animId 是缓动方式。

接口作用
World:SetSkyBoxMapsAnim(playerid, itype, url, animId, animTime)带动画的贴图替换
World:SetSkyBoxColorAnim(playerid, itype, color, animId, animTime)带动画的颜色变化
World:SetSkyBoxFilterAnim(playerid, itype, value, animId, animTime)带动画的滤镜变化

七、基础环境控制 ​

除了天空盒外观，迷你世界还提供一组操控世界底层规则的接口，包括时间、天气、重力、生长倍率等。这些与天空盒配合使用，能更完整地控制世界的感受。当然，你也可以单独使用它们——不碰天空盒，只改天气和重力。

说明：以下接口均来自 World 模块，详见 世界模块管理接口。

7.1 游戏时间 ​

游戏内有一套独立的昼夜循环系统。时间以「小时」为单位，一天 24 小时循环。

接口作用说明
World:SetHours(time)设置世界时间time 0~24 小时
World:GetHours()获取当前世界时间返回当前小时数（0~24）
World:GetDay()获取已过的天数从世界创建到现在的总天数
World:SetTimeVanishingSpeed(speed)设置时间流逝速度speed 数值，越大时间过得越快
World:IsDaytime()判断当前是否为白天返回 true/false
lua
-- 把世界时间设到正午12点
World:SetHours(12)

-- 把时间流逝速度调快（40 = 快速昼夜交替）
World:SetTimeVanishingSpeed(40)

-- 判断当前是白天还是黑夜
if World:IsDaytime() then
    print("现在是白天")
else
    print("现在是黑夜")
end

7.2 天气 ​

迷你世界支持按地形组设置天气。不同地形组可以有不同的天气（晴天、下雨、下雪等）。

天气类型枚举（GroupWeatherType）：

枚举效果
GroupWeatherType.Shine晴天
GroupWeatherType.Rain雨天
GroupWeatherType.Thunder雷暴
GroupWeatherType.Snow雪天
GroupWeatherType.Sandduststorm沙尘暴
GroupWeatherType.Tempest暴风雨
GroupWeatherType.Blizzard暴风雪
GroupWeatherType.Bad恶劣天气
GroupWeatherType.ShineAndRain晴雨交替

地形组枚举（WeatherGroup）：

枚举说明
WeatherGroup.Global全局对象
WeatherGroup.Common常见组
WeatherGroup.Ocean海洋组
WeatherGroup.Desert沙漠组
WeatherGroup.Frigidzone普通寒带
WeatherGroup.Coldzone高峰寒带
WeatherGroup.Volcano火山组
WeatherGroup.Nunja湿地组
WeatherGroup.Plain平坦组
WeatherGroup.AirIsland空岛组
接口作用说明
World:SetGroupWeather(groupid, weatherid)设置某地形组的天气groupid 地形组；weatherid 天气
World:GetGroupWeather(groupid)获取某地形组的天气返回天气 ID
World:RandomWeatherID()随机一个天气 ID从可用天气列表中随机
lua
-- 把常见地形组的天气设为晴天
World:SetGroupWeather(WeatherGroup.Common, GroupWeatherType.Shine)

-- 把海洋组设为暴风雨
World:SetGroupWeather(WeatherGroup.Ocean, GroupWeatherType.Tempest)

-- 获取当前常见组的天气
local weather = World:GetGroupWeather(WeatherGroup.Common)

7.3 重力 ​

重力倍数控制玩家和生物的跳跃、下落速度。默认重力为 9.8（近似地球重力）。

接口作用说明
World:SetGravity(value)设置重力倍数value 数值，基数 9.8 ≈ 正常重力
World:AddGravity(value)增加重力在当前重力基础上增加一个值
World:GetGravity(worldId)获取当前重力可选参数 worldId 指定星球
lua
-- 设置低重力（月球漫步感）
World:SetGravity(3)

-- 在现有重力上再翻倍
World:AddGravity(10)

-- 获取当前重力
local g = World:GetGravity()
print("当前重力：" .. g)

7.4 世界规则调整 ​

一些更细粒度的世界规则也可以通过接口控制：

接口作用说明
World:SetPlantGrowRate(rate)设置农作物生长倍率rate 时间倍率（>0），不保存，退出后失效
World:SetMobSpawnDensity(mobType, density)设置生物生成密度mobType 生物类型枚举；density 0~2000
World:SetMidJoin(enable)设置是否允许中途加入true 允许 / false 禁止
lua
-- 设置作物快速生长（5倍速）
World:SetPlantGrowRate(5)

-- 设置动物生成密度为 500
World:SetMobSpawnDensity(MobType.Passive, 500)

-- 禁止中途加入
World:SetMidJoin(false)

本 Wiki 内容均依据《迷你世界》实际功能整理。风格描述类内容为建议值，请结合游戏内实际效果校正。最后更新时间：2026-06-10