Custom Skyboxes

模组

· 作者 Cotii_Art

Custom Skyboxes 是一款模组,允许你通过纹理或 GIF 以及命令,实时更改天空、云朵、太阳、月亮、雨、雪和星星,以及在天空中添加自定义裂隙或 Geckolib 模型。

0 本站下载 0 关注 更新于 2 周前

最新 1.0.4.2-PLUGIN · 26.3 · Bukkit / Paper

一键开服(送7天)

自定义天穹、裂隙和 Rift 上的 GeoModel,带有动画效果

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

folders

支持 .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 版本中,部分显卡驱动下的卡顿现象减少

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源