WarpDrive Celestials

WarpDrive Celestials 是 WarpDrive 的视觉附加模组，将其扁平的行星渲染转换为 3D 天体。该模组可仅安装在客户端，因此即使服务器未安装，单个玩家也能启用 3D 行星。若需全服支持，包括为所有玩家提供正确的共享视觉效果、自定义行星环、自定义昼夜纹理以及额外的渲染层行为，则服务器端也应安装该模组。

行星默认以 Minecraft 风格的立方体渲染，配置中可选启用球体渲染模式。球体渲染还包含 LOD 设置，可降低较小或较远物体的网格复杂度，并提供性能、均衡和质量三种预设。

WarpDrive Celestials 最初是为 The Empire Strikes Block 服务器制作的。

特性

• 为 WarpDrive 行星提供 3D 天体
• 默认使用立方体行星
• 可选球体渲染
• 球体 LOD 预设以提升性能
• 细微的随机行星倾斜与旋转
• 为单个玩家提供仅客户端视觉支持
• 服务端支持共享自定义渲染层
• 自动检测立方体贴图纹理
• 支持行星、云层和渲染层立方体贴图
• 自动夜面阴影
• 可选自定义夜间纹理
• 水平与垂直行星环
• 支持多层行星环
• 可配置的恒星渲染预设

行星渲染

默认情况下，行星以立方体渲染，以更好地匹配 Minecraft 的视觉风格，同时仍让天体比 WarpDrive 原本的扁平渲染更具立体感。

也可在配置中启用球体渲染，以获得更平滑的行星外观。使用球体时，LOD 预设控制球体网格的精细程度，有助于降低较小或较远物体的渲染开销。

客户端与服务端用法

如果只希望在本地获得视觉升级，WarpDrive Celestials 可仅安装在客户端。这样即使服务器未安装该附加模组，玩家也能看到 3D 行星。

对于希望所有玩家看到相同自定义视觉效果的服务端和整合包，服务器端也应安装该模组。要正确共享支持自定义行星环层、自定义昼夜纹理以及额外天体渲染层行为，必须安装服务端。

立方体贴图纹理支持

WarpDrive Celestials 支持用于行星、云层及类似渲染层的立方体贴图纹理。普通单面纹理使用 1:1 宽高比，即图像为正方形，例如 512×512 或 1024×1024。立方体贴图纹理使用 2:1 宽高比，即图像宽度是高度的两倍，例如 1024×512。

当检测到兼容的 2:1 纹理时，模组会自动将其映射到行星模型的各个面。这样行星就能使用正确的多面纹理，而不是在每一面重复同一张图像。

昼夜纹理

行星默认自动获得夜面阴影，随着光照变化呈现更自然的昼夜外观。

创作者还可以添加专用夜间纹理以实现更精细的效果，例如发光的城市灯光或照亮区域。要添加自定义夜间纹理，请在行星普通基础纹理之后直接放置一个额外渲染层，并使用相同的纹理文件名，在前面加上 night_。

示例：

<render texture="warpdriveaddon:textures/cosmos/celestial/coruscant.png" />
<render texture="warpdriveaddon:textures/cosmos/celestial/night_coruscant.png" />

WarpDrive Celestials 会自动检测匹配的纹理对，并在行星暗面使用夜间纹理。

行星环

WarpDrive Celestials 还支持通过额外的渲染层添加自定义行星环。要添加行星环，请将一个或多个渲染层放在行星的常规基础纹理之后，并在纹理文件名前加上 ring_。

示例：

<render texture="warpdriveaddon:textures/cosmos/celestial/saturn.png" />
<render texture="warpdriveaddon:textures/cosmos/celestial/ring_saturn_1.png" />
<render texture="warpdriveaddon:textures/cosmos/celestial/ring_saturn_2.png" />

可使用额外的行星环层来制作更宽或延伸得更远的行星环。该模组还支持垂直行星环，只需在纹理文件名前加上 ring_vertical_。

示例：

<render texture="warpdriveaddon:textures/cosmos/celestial/uranus.png" />
<render texture="warpdriveaddon:textures/cosmos/celestial/ring_vertical_uranus.png" />

WarpDrive Celestials 会自动检测这些行星环层，并将其渲染在对应的行星周围。

恒星渲染预设

该模组内置了多种可配置的恒星渲染预设：

• 自定义 WarpDrive Celestials 恒星颜色
• WarpDrive 默认恒星颜色
• 纯白色恒星
• 无恒星

这样更容易让视觉风格适配不同的整合包：无论你想要色彩更丰富的太空背景、更接近 Minecraft 原版风格的清爽天空，还是完全不显示背景恒星，都能轻松实现。