
CustomSkyboxes
使用资源包中的纹理、动态 GIF 以及 GeckoLib 模型,实时自定义 Minecraft 的天空。
可以单独或全局替换天空、太阳、月亮、星星、云朵、雨和雪,也可以按生物群系(Biome)在主世界、下界和末地中分别设置——通过动态裂隙撕裂天空,在其中悬挂 3D 模型,并为所有这些元素播放入场、出场及实时特效。
客户端模组。无需安装服务器端——但如果模组(或 Paper 插件)也安装在服务器上,你可以使用 @a 来驱动所有人的天空。
支持版本
| 加载器 |
Minecraft |
| Fabric |
1.20.1 · 1.20.4 · 1.21.1 · 1.21.4 · 1.21.5 · 1.21.8 · 1.21.11 · 26.2 · 26.3 |
| NeoForge |
1.20.1 · 1.20.4 · 1.21.1 · 1.21.4 · 1.21.5 · 1.21.8 · 1.21.11 · 26.2 · 26.3 |
| Forge |
1.20.1 · 1.20.4 |
Fabric 版本需要 Fabric API。
兼容 Sodium、Iris / Oculus 光影包,并在 26.x 版本中同时支持 OpenGL 和 Vulkan。
命令
/customskyboxes set <type> <texture|color> [name=value ...]
/customskyboxes clear <type|all> [layer=N]
/customskyboxes reload
/customskyboxes animate <sky|day_sky|night_sky|sun|moon|custom|rift> <preset> [time] [name=value ...]
/customskyboxes animate stop [preset]
/customskyboxes animate <type> stop
/customskyboxes model set <sun|moon|custom> <model> [name=value ...]
/customskyboxes model animate <sun|moon|custom|rift> <animation|stop> [layer=N]
/customskyboxes biome set <biome> <type> <texture|color> [name=value ...]
/customskyboxes biome animate <biome> <type> <preset> [time] [name=value ...]
/customskyboxes biome list
/customskyboxes biome clear <biome> <type|all>
<type>: sky · day_sky · night_sky · stars · sun · moon · custom · clouds · rain · snow · rift
每个参数均以 name=value 的形式书写,所有参数均为可选,且顺序无关紧要。
Tab 补全会提供每种类型接受的名称及其值,当你已使用某个值后,它将不再被推荐。
/customskyboxes set sun vanilla scale=2.5 posX=EAST layer=2 anim_in=zoom_in anim_in_time=60
| 参数 |
类型 |
作用 |
opacity |
全部 |
透明度,范围 0 到 1 |
fadein / fadeout |
全部 |
淡入/淡出时间(以刻为单位,0 = 瞬间) |
gif_speed |
纹理 |
GIF 播放速度 |
speed |
rain, snow, clouds |
雨和雪的速率(0 到 1),其中 0 表示停止下落 |
scale |
sun, moon, custom, stars |
尺寸倍率 |
rotation |
穹顶, sun, moon, custom, rift |
旋转穹顶图像,或滚动太阳、月亮、自定义层或裂隙 |
layer |
sun, moon, custom, rift |
1 到 8:可同时设置多个图层,各自拥有独立的参数 |
posX / posY |
sun, moon, custom, rift |
位置:罗盘方向名(如 EAST, SOUTH_WEST…)或角度 |
direction / tilt |
rain, snow |
天气倾斜的方向及程度 |
amount / daycycle |
stars |
星星的数量,以及是否仅在夜间显示 |
skycolor |
clouds |
根据一天中的时间给云朵着色 |
anim_in / anim_out |
穹顶, sun, moon, custom, stars, rift |
入场和出场动画 |
anim_in_time / anim_out_time |
同上 |
动画持续的时间(以刻为单位) |
animation_preset / animation_time |
sun, moon, custom |
循环动画及其循环时长 |
model / model_texture |
sun, moon, custom, rift |
GeckoLib 模型,以及如果无法通过名称找到时的纹理 |
rift_length / rift_rays |
rift |
燃烧边缘和裂缝的粗细(0.1 到 6),以及从裂隙中射出的光线数量及长度(0 到 4,0 表示移除) |
force_overcome |
穹顶 |
强制在该图层之上绘制:sun moon custom stars clouds(或 all),用逗号分隔 |
sky_modifiers |
穹顶 |
在穹顶之上添加流星、彗星、流星雨等,用逗号分隔(见下文) |
modifier_color / modifier_amount / modifier_speed |
穹顶 |
它们的颜色、数量(0.1 到 5)和速度(0 到 10) |
将纹理设置为 vanilla 可保留原版纹理并仅应用其他参数,这在无需替换任何内容即可为雨赋予方向或为太阳添加第二层时非常有用。
你的天穹配置会自动保存,并在重启游戏时恢复。
裂隙
撕裂天空。裂隙具有发光且伴有爆裂声的边缘,透过它可以看见另一片天空(background=)。
- 37 种形状:裂口类
crack slash tear eye gate,以及闭合形状 circle oval square diamond triangle pentagon hexagon octagon star star6 star8 star4 star12 sparkle burst sun flower clover heart cross gear drop egg blob crescent infinity squircle keyhole hourglass arch claw shatter。
- 26 种颜色:可通过名称(
CRIMSON, GOLD, TEAL, VIOLET…)或任意 #rrggbb 指定。
- 最多可同时存在 8 个裂隙,使用
layer= 设置,可在天空中的任意位置放置(默认正上方),半径最大为 100,通过 posX / posY 定位。
- 14 种入场动画:
rift_open rift_unzip rift_burst rift_slash rift_flicker rift_shatter rift_vortex rift_lightning rift_awaken rift_bloom rift_supernova rift_glitch rift_ignite rift_portal
- 14 种出场动画:
rift_close rift_zip rift_collapse rift_seal rift_snuff rift_unshatter rift_implode rift_strike rift_slumber rift_wither rift_blackhole rift_glitch_out rift_burnout rift_portal_close
rift_length 控制燃烧边缘和裂缝的粗细(0.1 到 6),rift_rays 设置从中射出的光线数量及延伸距离(0 到 4,0 表示移除)。
/customskyboxes set rift vanilla type=star color=CYAN radius=30 posX=SOUTH posY=MIDDLE background=void.png anim_in=rift_supernova
/customskyboxes set rift vanilla type=circle color=GOLD rift_length=2.5 rift_rays=3
实时裂隙特效会在已开启的裂隙上播放,而不会将其关闭:
explosion shatter shockwave lightning pulse vortex tremor flare collapse supernova heartbeat riptide strobe siphon rupture warp eclipse cascade
| 参数 |
作用 |
color |
在特效播放期间为裂隙着色 |
size |
其环、闪电和碎片的延伸范围 |
strength / loop / layer |
冲击强度、持续播放、作用于哪个裂隙 |
delay |
开始前的刻数 |
spin |
特效期间裂隙旋转的角度 |
shake / glow / flash |
震动幅度、发光强度和闪烁程度 |
/customskyboxes animate rift explosion color=RED size=2 spin=180 glow=3
/customskyboxes animate rift lightning 80 color=GOLD flash=2 delay=20
GeckoLib 模型
使用 Blockbench 中的 GeckoLib 插件制作的任何模型(.geo.json + .animation.json)都可以替代太阳、月亮、custom 层或放置在裂隙内部——并带有动画效果。不需要安装 GeckoLib 本身:该模组会读取这些文件并在每个版本和加载器上自行渲染它们。
/customskyboxes model set sun planet scale=1.5 posX=EAST posY=HIGH
/customskyboxes model set custom station posX=NORTH posY=60 layer=2
/customskyboxes model animate sun attack
/customskyboxes model animate rift roar layer=2
- 名为
idle 的动画会自动循环播放;一次性播放的动画结束后会返回到 idle,hold_on_last_frame 则保持在最后一帧。
- 关键帧、
catmullrom、GeckoLib 缓动函数(如 easeInOutSine、easeOutBack、easeOutBounce…)以及 Molang 值(如 math.sin(query.anim_time * 90) * 10)。
- 纹理通过名称在
textures/geo/ 中查找(名称开头需与模型一致),也可通过 model_texture= 指定。
自定义层
custom 是一个类似太阳的层,它停留在你放置的位置,而不是横跨天空——例如悬挂在你出生点上方的行星、空间站或标志牌。它可以接受纹理或模型,最多支持 8 个层。
/customskyboxes set custom ringed_planet.png posX=SOUTH posY=30 scale=2
进入和退出动画
每种效果都提供 _in 和 _out 两种形式。
- 移动类:
fade zoom spin drop ripple curtain smoke
- 擦除类:
top_merge bottom_merge left_wipe right_wipe diagonal diagonal_reverse blinds iris iris_close spiral vortex
- 噪声类(天空被吞噬而非淡入淡出):
dissolve consume_top consume_bottom shatter
- 仅星星:
random_scale star_fall twinkle
- 太阳、月亮和自定义层:基础款 —
fade zoom spin
- 裂隙:上述列出的专属效果
/customskyboxes set sky galaxy.png anim_in=consume_top_in anim_in_time=80
/customskyboxes set sky galaxy.png anim_out=vortex_out anim_out_time=60
实时特效
/customskyboxes animate 可在不更改当前设置的情况下触发特效。时间(以刻为单位)是可选的。
| 目标 |
预设 |
sky, day_sky, night_sky |
pulse shockwave black_hole glitch aurora flash ripple vortex rotation nova static heartbeat |
sun, moon, custom |
circle shake glitch scale float spin pulse swing orbit bounce wobble flicker |
rift |
explosion shatter shockwave lightning pulse vortex tremor flare collapse supernova heartbeat riptide strobe siphon rupture warp eclipse cascade |
color、strength 和 size 塑造特效形态;scale(0 到 100)决定使用 scale 预设时太阳或月亮放大到的尺寸。
loop=true 使特效持续播放,直到你手动停止。
- 多个特效可同时运行并混合在一起。
animate stop 停止所有特效,animate stop <preset> 仅停止该预设,animate <type> stop 停止该类型的所有特效。
- 带有
loop=true 的动画从此成为天空的一部分:服务器会保留它,并在玩家加入时重新启动。
biome animate 将特效限制在特定生物群系内。
/customskyboxes animate sky pulse color=CYAN size=3 strength=2
/customskyboxes animate sun scale 60 scale=8 loop=true
/customskyboxes biome animate minecraft:desert sky heartbeat 40 color=RED loop=true
天穹
sky 始终可见,day_sky 在白天淡入,night_sky 在夜晚淡入。
- 适用于下界和末地,包括在末影龙战斗期间。
- 纹理映射为 360° 全景图(2:1 比例的图像效果最佳):图像顶部是天顶,中间是地平线。
- 左右边缘在连接处平滑融合。可使用
rotation 移动该位置。
- 太阳和月亮绘制在天穹和星星之上,因此不会被遮挡。
force_overcome 可反转这一行为,针对你指定的对象:force_overcome=moon,custom 会将天穹绘制在太阳和自定义层之上,从而使进入动画覆盖它们。仅列出项会被覆盖——云层除非添加 clouds 否则仍保持在顶层——且你在天穹之后设置的任何内容(新的月亮、自定义层等)都会绘制在其上方。
### 天穹修饰符
通过 `sky_modifiers=` 为天穹增添生机,可任意组合并用逗号分隔(或使用 `all`)。它们跟随所在的天穹,因此在 `night_sky` 上仅在夜间显示。
| 修饰符 | 说明 |
| --- | --- |
| `meteors` | 流星雨,每一道轨迹都从同一位置飞出 |
| `shooting_stars` | 偶尔出现一道明亮的单一流星轨迹 |
| `comet` | 拖着长尾的巨大彗星缓慢划过天空 |
| `twinkle` | 小星星闪烁不定 |
| | 绿色和紫色的帷幕在地平线上方飘动 |
| `fireflies` | 微小的发光光点在天际低空游荡 |
| `flashes` | 无声的闪电照亮远处的云层 |
| `satellites` | 小亮点沿直线滑过 |
| `rainbow` | 彩虹弧线 |
| `embers` | 火花从地平线向上飘浮 |
`modifier_color` 为所有效果着色,`modifier_amount` 调整数量(0.1 到 5),`modifier_speed` 加速或减速(0 到 10)。
```txt
/customskyboxes set night_sky galaxy.png sky_modifiers=meteors,twinkle,comet
/customskyboxes set sky vanilla_sky.png sky_modifiers=comet,shooting_stars modifier_amount=2 modifier_color=CYAN
资源包文件夹结构
assets/customskyboxes/
├── sun
├── moon
├── custom
├── night_sky
├── day_sky
├── sky
├── clouds
├── rain
├── snow
├── rift <- 裂隙纹理与背景
├── geo <- GeckoLib 模型: planet.geo.json
├── animations <- 动画: planet.animation.json
└── textures/geo <- 纹理: planet.png

支持 .png 和动态 .gif 文件,可放置在文件夹中、.zip 打包文件中以及服务器发送的资源包内。子目录同样有效(sky/space/galaxy.png 对应 space/galaxy.png)。
ItemsAdder、Oraxen 及其他资源包工具:纹理也可置于你自己的命名空间下——assets/<namespace>/customskyboxes/<type>/ 或 assets/<namespace>/textures/customskyboxes/<type>/ ——并在标签补全中显示为 <namespace>:file.png。模型以相同方式工作,使用 <namespace>:model。
添加文件后,运行 /customskyboxes reload 或按 F3+T。
多人游戏
服务器端的模组(Fabric、NeoForge 或 Forge):相同的 /customskyboxes 命令支持 @a 和玩家名称,但仅在模组安装于服务器时生效,并具备完整的标签补全功能:
/customskyboxes set @a night_sky galaxy.png
/customskyboxes model @a set custom planet posX=SOUTH
/customskyboxes biome @a set minecraft:desert sun big_red_sun.png scale=2
在 Paper/Spigot(1.20.1+)上,使用 CustomSkyboxesPlugin:它通过 /customskyboxesplugin 实现相同功能。
/customskyboxesplugin set <@a|player> <type> <texture|color> [name=value ...]
/customskyboxesplugin clear <@a|player> <type|all> [layer=N]
/customskyboxesplugin animate <@a|player> <type> <preset> [time] [name=value ...]
/customskyboxesplugin model set <@a|player> <sun|moon|custom> <model> [name=value ...]
/customskyboxesplugin model animate <@a|player> <sun|moon|custom|rift> <animation|stop>
/customskyboxesplugin biome set <@a|player> <biome> <type> <texture|color> [name=value ...]
/customskyboxesplugin reload <@a|player>
无论哪种方式,服务器设置的内容都会被保存:后续加入或返回的玩家在连接时即可立即获得该效果(@a 适用于所有人,指定名称则仅针对单个玩家)。玩家需要安装模组并将纹理和模型放入其资源包中;未安装模组的玩家将被跳过。
开发者文档
org.cotii.customskyboxes.api.CustomSkyboxesAPI 允许通过代码驱动模组,使用与命令相同的 name=value 参数:
CustomSkyboxesAPI.set(SkyboxType.SKY, Identifier.of("mymod", "sky/aurora.png"), "fadein=40 rotation=90");
CustomSkyboxesAPI.setVanilla(SkyboxType.SUN, "layer=2 posX=EAST posY=HIGH scale=0.6");
CustomSkyboxesAPI.setRift("type=star color=CYAN radius=30 background=void.png model=dragon");
CustomSkyboxesAPI.animateRift("explosion", 60, 1f, false, 0,
new RiftEffects.Options(0xFF3030, 2f, 0, 180f, 1f, 3f, 1f));
CustomSkyboxesAPI.setModel(SkyboxType.CUSTOM, "planet", "posX=SOUTH posY=30");
CustomSkyboxesAPI.playModelAnimation(SkyboxType.CUSTOM, 1, "spin");
CustomSkyboxesAPI.clear(SkyboxType.SUN);
此外还提供:setForBiome、clearLayer、clearAll、active、layers、availableTextures、animateDome、animateCelestial、stopAnimations,以及每种效果、预设、动画、裂隙形状和模型的列表。
为什么使用 CustomSkyboxes?
CustomSkyboxes 非常适合 Minecraft 地图制作者、服务器开发者和内容创作者,旨在打造沉浸式环境和电影级特效。
借助实时天空自定义功能,你可以:
- 创建动态天气与氛围
- 使用 GIF 和 3D 模型添加动态天空
- 撕裂天空用于 Boss 战和活动场景
- 构建独特的生物群系与维度
- 提升叙事表现力与沉浸感
- 在游戏过程中即时更改视觉效果,针对单个玩家或整个服务器
无论你是制作冒险地图、恐怖体验、RPG 服务器还是影视项目,CustomSkyboxes 都能让你对 Minecraft 的天空拥有完全的控制权。
1.0.4.2 新增内容
- 新增:
sky_modifiers 适用于 sky、day_sky 和 night_sky —— 包括 meteors、shooting_stars、comet、twinkle、fireflies、flashes、satellites、rainbow、embers,并支持 modifier_color、modifier_amount 和 modifier_speed
- 新增:
rift_length(控制裂隙边缘和裂缝的粗细程度)以及 rift_rays(控制从中射出的光线数量,或无光线)
- 修复:来自服务器的天空消息此前会在每位玩家的聊天中打印——现在只有执行命令的玩家会收到回复
- 修复:自定义月亮纹理始终显示满月且显得不自然——现在遵循月相变化,并且太阳和月亮会根据雨天的情况正确旋转、缩放和隐藏,行为与原版一致
- 改进:天空每帧复用内存而非重新分配,从而减轻内存负担,尤其在 1.21.5 及更高版本中效果更明显
1.0.4
- 新增:裂隙(Rifts) —— 撕裂天空:37 种形状,28 组入口与出口动画,18 种实时效果(含颜色、大小、旋转、震动、发光和闪烁),最多同时显示 8 个,且内部包含模型
- 新增:GeckoLib 模型 —— 用于太阳、月亮、
custom 层以及裂隙,自带动画 —— 无需 GeckoLib
- 新增:
custom —— 一种类太阳图层,可固定在你放置的位置
- 新增:在模组部署于服务器时,
/customskyboxes 命令支持 @a 和玩家目标 —— 配置会被保存,并在玩家加入时发送给他们
- 新增:Minecraft 26.3 —— 支持 Fabric 和 NeoForge,兼容 OpenGL 和 Vulkan
- 新增:光影包(shader packs) —— 天空和裂隙可与 Iris / Oculus 配合显示,且与 Sodium 良好兼容
- 新增:ItemsAdder、Oraxen 和资源包支持 —— 支持使用自定义命名空间下的纹理(
<namespace>:file.png)、子文件夹以及 .zip 资源包
- 更改:
force_overcome 现在接受任意逗号分隔的组合(sun moon custom stars clouds),仅覆盖你指定的内容,且在穹顶之后设置的内容会保留在最上层
- 更改:
speed 现已更名为 gif_speed 以用于纹理(speed 仍用于雨、雪和云;旧存档会自动转换)
- 更改:
animate 现在支持可选的时间参数,并立即显示其参数说明
- 修复:在某些渲染器和光影下,原版月亮周围出现黑色方块的问题
- 修复:在 1.21.11 和 26.2 版本中原版太阳和月亮不显示的问题
- 修复:太阳和月亮纹理被颠倒绘制的问题
- 优化:性能大幅减轻 —— 天空穹顶的开销降至原来的约四分之一,其效果(如
vortex、rotation…)和入场动画降至原来的约三分之一,裂隙也变得更流畅且更轻量
- 优化:云层、雨和雪每帧都会移动,从而在高速度下保持平滑
- 优化:在 1.20 – 1.21.4 版本中,部分显卡驱动下的卡顿现象减少

CustomSkyboxes
Fully customize the Minecraft sky in real time using textures, animated GIFs and GeckoLib models from a resource pack.
Replace the sky, sun, moon, stars, clouds, rain and snow individually, globally or per biome, in the Overworld, the Nether and the End — tear the sky open with animated rifts, hang 3D models in it, and play entrance, exit and live effects on all of it.
Client-side mod. No server installation needed — but if the mod (or the Paper plugin) is on the server too, you can drive everyone's sky with @a.
Supported Versions
| Loader |
Minecraft |
| Fabric |
1.20.1 · 1.20.4 · 1.21.1 · 1.21.4 · 1.21.5 · 1.21.8 · 1.21.11 · 26.2 · 26.3 |
| NeoForge |
1.20.1 · 1.20.4 · 1.21.1 · 1.21.4 · 1.21.5 · 1.21.8 · 1.21.11 · 26.2 · 26.3 |
| Forge |
1.20.1 · 1.20.4 |
Fabric versions require Fabric API.
Works with Sodium, Iris / Oculus shader packs, and on 26.x with both OpenGL and Vulkan.
Commands
/customskyboxes set <type> <texture|color> [name=value ...]
/customskyboxes clear <type|all> [layer=N]
/customskyboxes reload
/customskyboxes animate <sky|day_sky|night_sky|sun|moon|custom|rift> <preset> [time] [name=value ...]
/customskyboxes animate stop [preset]
/customskyboxes animate <type> stop
/customskyboxes model set <sun|moon|custom> <model> [name=value ...]
/customskyboxes model animate <sun|moon|custom|rift> <animation|stop> [layer=N]
/customskyboxes biome set <biome> <type> <texture|color> [name=value ...]
/customskyboxes biome animate <biome> <type> <preset> [time] [name=value ...]
/customskyboxes biome list
/customskyboxes biome clear <biome> <type|all>
<type>: sky · day_sky · night_sky · stars · sun · moon · custom · clouds · rain · snow · rift
Every argument is written as name=value, all of them are optional and the order does not matter.
Tab completion offers the names each type accepts and their values, and stops offering one once you have used it.
/customskyboxes set sun vanilla scale=2.5 posX=EAST layer=2 anim_in=zoom_in anim_in_time=60
| Argument |
Types |
What it does |
opacity |
all |
0 to 1 |
fadein / fadeout |
all |
fade time in ticks (0 = instant) |
gif_speed |
textures |
GIF playback speed |
speed |
rain, snow, clouds |
0 to 1 on rain and snow, where 0 stops the fall |
scale |
sun, moon, custom, stars |
size multiplier |
rotation |
domes, sun, moon, custom, rift |
turns the dome image, or rolls the sun, moon, custom layer or rift |
layer |
sun, moon, custom, rift |
1 to 8: several at once, each with its own arguments |
posX / posY |
sun, moon, custom, rift |
where it sits: a compass name (EAST, SOUTH_WEST…) or degrees |
direction / tilt |
rain, snow |
which way the weather leans, and how much |
amount / daycycle |
stars |
how many stars, and whether they only show at night |
skycolor |
clouds |
tints the clouds with the time of day |
anim_in / anim_out |
domes, sun, moon, custom, stars, rift |
entrance and exit animation |
anim_in_time / anim_out_time |
same |
how long that animation lasts, in ticks |
animation_preset / animation_time |
sun, moon, custom |
looping animation and its loop length |
model / model_texture |
sun, moon, custom, rift |
a GeckoLib model, and its texture if it is not found by name |
rift_length / rift_rays |
rift |
how thick its burning edges and cracks are, and how many rays run out of it (0 for none) |
force_overcome |
domes |
draws the dome over what you list, comma separated: sun moon custom stars clouds (or all) |
sky_modifiers |
domes |
meteors, comets, shooting stars and more on top of the dome, comma separated (see below) |
modifier_color / modifier_amount / modifier_speed |
domes |
their colour, how many (0.1 to 5) and how fast (0 to 10) |
vanilla as the texture keeps the vanilla one and only applies the arguments, which is handy for giving rain a direction or the sun a second layer without replacing anything.
Your skyboxes are saved automatically and restored when you restart the game.
Rifts
Tear the sky open. A rift has a glowing, crackling edge, and through it you see another sky (background=).
- 37 shapes: the tears
crack slash tear eye gate, and closed shapes circle oval square diamond triangle pentagon hexagon octagon star star6 star8 star4 star12 sparkle burst sun flower clover heart cross gear drop egg blob crescent infinity squircle keyhole hourglass arch claw shatter.
- 26 colours by name (
CRIMSON, GOLD, TEAL, VIOLET…) or any #rrggbb.
- Up to 8 rifts at once with
layer=, anywhere in the sky with posX / posY (straight up by default), radius up to 100.
- 14 entrance animations:
rift_open rift_unzip rift_burst rift_slash rift_flicker rift_shatter rift_vortex rift_lightning rift_awaken rift_bloom rift_supernova rift_glitch rift_ignite rift_portal
- 14 exit animations:
rift_close rift_zip rift_collapse rift_seal rift_snuff rift_unshatter rift_implode rift_strike rift_slumber rift_wither rift_blackhole rift_glitch_out rift_burnout rift_portal_close
rift_length makes the burning edge and the cracks thicker or thinner (0.1 to 6), and rift_rays sets how many rays run out of it and how far (0 to 4, 0 takes them off).
/customskyboxes set rift vanilla type=star color=CYAN radius=30 posX=SOUTH posY=MIDDLE background=void.png anim_in=rift_supernova
/customskyboxes set rift vanilla type=circle color=GOLD rift_length=2.5 rift_rays=3
Live rift effects play on a rift that is already open, without closing it:
explosion shatter shockwave lightning pulse vortex tremor flare collapse supernova heartbeat riptide strobe siphon rupture warp eclipse cascade
| Argument |
What it does |
color |
tints the rift while the effect plays |
size |
how far its rings, bolts and shards reach |
strength / loop / layer |
how hard it hits, keep it going, which rift |
delay |
ticks before it starts |
spin |
degrees the rift turns over the effect |
shake / glow / flash |
how much it shakes, flares and flashes |
/customskyboxes animate rift explosion color=RED size=2 spin=180 glow=3
/customskyboxes animate rift lightning 80 color=GOLD flash=2 delay=20
GeckoLib Models
Any model made in Blockbench with the GeckoLib plugin (.geo.json + .animation.json) can take the place of the sun, the moon, a custom layer or sit inside a rift — with its animations. GeckoLib itself is not needed: the mod reads the files and draws them on its own, on every version and loader.
/customskyboxes model set sun planet scale=1.5 posX=EAST posY=HIGH
/customskyboxes model set custom station posX=NORTH posY=60 layer=2
/customskyboxes model animate sun attack
/customskyboxes model animate rift roar layer=2
- An animation called
idle plays on its own; a play-once animation goes back to idle when it ends, hold_on_last_frame holds.
- Keyframes,
catmullrom, GeckoLib easings (easeInOutSine, easeOutBack, easeOutBounce…) and Molang values (math.sin(query.anim_time * 90) * 10).
- The texture is found by name in
textures/geo/ (a name that starts like the model's counts too), or chosen with model_texture=.
Custom Layer
custom is a sun-like layer that stays where you put it instead of crossing the sky — a planet hanging over your spawn, a station, a sign. It takes a texture or a model, up to 8 layers.
/customskyboxes set custom ringed_planet.png posX=SOUTH posY=30 scale=2
Entrance and Exit Animations
Every one exists as _in and _out.
- Movement:
fade zoom spin drop ripple curtain smoke
- Wipes:
top_merge bottom_merge left_wipe right_wipe diagonal diagonal_reverse blinds iris iris_close spiral vortex
- Noise, the sky is eaten instead of faded:
dissolve consume_top consume_bottom shatter
- Stars only:
random_scale star_fall twinkle
- Sun, moon and custom: the plain ones —
fade zoom spin
- Rifts: their own, listed above
/customskyboxes set sky galaxy.png anim_in=consume_top_in anim_in_time=80
/customskyboxes set sky galaxy.png anim_out=vortex_out anim_out_time=60
Live Effects
/customskyboxes animate fires an effect without changing what is set. The time in ticks is optional.
| Target |
Presets |
sky, day_sky, night_sky |
pulse shockwave black_hole glitch aurora flash ripple vortex rotation nova static heartbeat |
sun, moon, custom |
circle shake glitch scale float spin pulse swing orbit bounce wobble flicker |
rift |
explosion shatter shockwave lightning pulse vortex tremor flare collapse supernova heartbeat riptide strobe siphon rupture warp eclipse cascade |
color, strength and size shape the effect; scale (0 to 100) is what the sun or moon grows to with the scale preset.
loop=true keeps it playing until you stop it.
- Several effects run at once and are mixed together.
animate stop ends all of them, animate stop <preset> only that one, and animate <type> stop everything on that one type.
- An animation with
loop=true is part of the sky from then on: a server keeps it and starts it again when the player joins.
biome animate scopes an effect to one biome.
/customskyboxes animate sky pulse color=CYAN size=3 strength=2
/customskyboxes animate sun scale 60 scale=8 loop=true
/customskyboxes biome animate minecraft:desert sky heartbeat 40 color=RED loop=true
Sky Domes
sky is always visible, day_sky fades in during the day and night_sky at night.
- Works in the Nether and the End, including during the Ender Dragon fight.
- Textures are mapped as a 360° panorama (2:1 images look best): the top of the image is the zenith and the middle is the horizon.
- The left and right edges blend smoothly where they meet. Use
rotation to move that spot.
- The sun and the moon are drawn above the dome and the stars, so nothing covers them.
force_overcome turns that around for what you name: force_overcome=moon,custom draws the dome over the moon and the custom layers, so an entrance animation swallows them. Only what you list is covered — the clouds stay on top unless you add clouds — and anything you set after the dome (a new moon, a custom layer…) is drawn on top of it.
### Sky Modifiers
Add life to a dome with `sky_modifiers=`, any mix separated by commas (or `all`). They follow the dome they are on, so on a `night_sky` they only show at night.
| Modifier | What it is |
| --- | --- |
| `meteors` | a meteor shower, every streak flying out of the same spot |
| `shooting_stars` | now and then a single bright streak |
| `comet` | a big comet with a long tail slowly crossing the sky |
| `twinkle` | little stars sparkling on and off |
| | green and purple curtains waving over the horizon |
| `fireflies` | tiny glowing dots wandering low in the sky |
| `flashes` | silent lightning lighting up the clouds far away |
| `satellites` | small dots gliding across in straight lines |
| `rainbow` | a rainbow arc |
| `embers` | sparks floating up from the horizon |
`modifier_color` tints all of them, `modifier_amount` makes them more or fewer (0.1 to 5) and `modifier_speed` speeds them up or slows them down (0 to 10).
```txt
/customskyboxes set night_sky galaxy.png sky_modifiers=meteors,twinkle,comet
/customskyboxes set sky vanilla_sky.png sky_modifiers=comet,shooting_stars modifier_amount=2 modifier_color=CYAN
Resource Pack Folder Structure
assets/customskyboxes/
├── sun
├── moon
├── custom
├── night_sky
├── day_sky
├── sky
├── clouds
├── rain
├── snow
├── rift <- rift textures and backgrounds
├── geo <- GeckoLib models: planet.geo.json
├── animations <- their animations: planet.animation.json
└── textures/geo <- their textures: planet.png

Supports .png and animated .gif files, in folders, in .zip packs and in the resource pack a server sends. Subfolders work too (sky/space/galaxy.png is space/galaxy.png).
ItemsAdder, Oraxen and other pack tools: textures can also go under your own namespace — assets/<namespace>/customskyboxes/<type>/ or assets/<namespace>/textures/customskyboxes/<type>/ — and show up in tab completion as <namespace>:file.png. Models work the same way with <namespace>:model.
After adding files, run /customskyboxes reload or press F3+T.
Multiplayer
The mod on the server (Fabric, NeoForge or Forge): the same /customskyboxes command gets @a and player names, only when the mod is on the server, with full tab completion:
/customskyboxes set @a night_sky galaxy.png
/customskyboxes model @a set custom planet posX=SOUTH
/customskyboxes biome @a set minecraft:desert sun big_red_sun.png scale=2
On Paper/Spigot (1.20.1+), use the CustomSkyboxesPlugin: it does the same with /customskyboxesplugin.
/customskyboxesplugin set <@a|player> <type> <texture|color> [name=value ...]
/customskyboxesplugin clear <@a|player> <type|all> [layer=N]
/customskyboxesplugin animate <@a|player> <type> <preset> [time] [name=value ...]
/customskyboxesplugin model set <@a|player> <sun|moon|custom> <model> [name=value ...]
/customskyboxesplugin model animate <@a|player> <sun|moon|custom|rift> <animation|stop>
/customskyboxesplugin biome set <@a|player> <biome> <type> <texture|color> [name=value ...]
/customskyboxesplugin reload <@a|player>
Either way, what the server sets is saved: players who join later, or come back, get it as soon as they connect (@a for everyone, a name for one player). Players need the mod installed and the textures and models in their resource pack; players without it are skipped.
For Developers
org.cotii.customskyboxes.api.CustomSkyboxesAPI drives the mod from code, with the same name=value arguments the command takes:
CustomSkyboxesAPI.set(SkyboxType.SKY, Identifier.of("mymod", "sky/aurora.png"), "fadein=40 rotation=90");
CustomSkyboxesAPI.setVanilla(SkyboxType.SUN, "layer=2 posX=EAST posY=HIGH scale=0.6");
CustomSkyboxesAPI.setRift("type=star color=CYAN radius=30 background=void.png model=dragon");
CustomSkyboxesAPI.animateRift("explosion", 60, 1f, false, 0,
new RiftEffects.Options(0xFF3030, 2f, 0, 180f, 1f, 3f, 1f));
CustomSkyboxesAPI.setModel(SkyboxType.CUSTOM, "planet", "posX=SOUTH posY=30");
CustomSkyboxesAPI.playModelAnimation(SkyboxType.CUSTOM, 1, "spin");
CustomSkyboxesAPI.clear(SkyboxType.SUN);
Also: setForBiome, clearLayer, clearAll, active, layers, availableTextures, animateDome, animateCelestial, stopAnimations, and lists of every effect, preset, animation, rift shape and model.
Why Use CustomSkyboxes?
CustomSkyboxes is perfect for Minecraft map makers, server developers, and content creators who want to create immersive environments and cinematic effects.
With real-time sky customization, you can:
- Create dynamic weather and atmosphere
- Add animated skies using GIFs and 3D models
- Tear the sky open for boss fights and events
- Build unique biomes and dimensions
- Improve storytelling and immersion
- Instantly change visuals during gameplay, for one player or the whole server
Whether you're making an adventure map, horror experience, RPG server, or cinematic project, CustomSkyboxes gives you full creative control over the Minecraft sky.
What's New in 1.0.4.2
- New:
sky_modifiers for sky, day_sky and night_sky — meteors shooting_stars comet twinkle fireflies flashes satellites rainbow embers, with modifier_color, modifier_amount and modifier_speed
- New:
rift_length (how thick a rift's edges and cracks are) and rift_rays (how many rays come out of it, or none)
- Fixed: skies sent from the server printed their messages in every player's chat — now only whoever ran the command gets an answer
- Fixed: a moon texture of your own always showed full and looked fake — it now follows the moon phases, and the sun and the moon are turned, sized and hidden by rain exactly like vanilla
- Improved: the sky reuses its memory every frame instead of reserving it again, which is lighter on 1.21.5 and newer especially
What's New in 1.0.4
- New: Rifts — tear the sky open: 37 shapes, 28 entrance and exit animations, 18 live effects with colour, size, spin, shake, glow and flash, up to 8 at once, and a model inside them
- New: GeckoLib models for the sun, the moon, a
custom layer and rifts, with their animations — no GeckoLib needed
- New:
custom — a sun-like layer that stays where you put it
- New:
@a and player targets on /customskyboxes when the mod is on the server, saved and sent to players when they join
- New: Minecraft 26.3 on Fabric and NeoForge, with OpenGL and Vulkan
- New: shader packs — skies and rifts show with Iris / Oculus, and the mod plays nicely with Sodium
- New: ItemsAdder, Oraxen and server packs — textures under your own namespace (
<namespace>:file.png), in subfolders and in .zip packs
- Changed:
force_overcome takes any comma separated mix (sun moon custom stars clouds), only covers what you name, and anything set after the dome stays on top
- Changed:
speed is now gif_speed for textures (speed stays for rain, snow and clouds; old saves are converted)
- Changed:
animate takes the time as optional and shows its arguments right away
- Fixed: a black square around the vanilla moon with some renderers and shaders
- Fixed: the vanilla sun and moon not showing on 1.21.11 and 26.2
- Fixed: sun and moon textures drawn upside down
- Improved: much lighter — the sky dome costs about a quarter of what it did, its effects (
vortex, rotation…) and entrance animations about a third, and rifts are smoother and cheaper
- Improved: clouds, rain and snow move every frame, so they stay smooth at high speed
- Improved: less stutter on 1.20 – 1.21.4 with some graphics drivers
评论 0
登录后参与评分
还没有评论,来抢沙发吧