Yeastmans-CustomSkybox icon

CustomSkybox

Replace the skybox on every map with your own 360 images. Includes 4 starter skyboxes, a labeled equirectangular template for editing your own, and a dropdown in ModMenu to switch between them. Vanilla compatible.

Last updated 2 weeks ago
Total downloads 225
Total rating 0 
Categories Vanilla compatible
Dependency string Yeastmans-CustomSkybox-1.0.2
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100
kestrel-Mod_Menu-1.1.3 icon
kestrel-Mod_Menu

Configure your mods ingame!

Preferred version: 1.1.3

README

CustomSkybox for STRAFTAT

Replaces the skybox on every map with your own 360° images. Pick a skybox from a dropdown in ModMenu's settings panel. Vanilla compatible — purely client-side, other players see vanilla.

Make your own skybox

Open BepInEx/plugins/CustomSkybox/templates/Template.png in any image editor (GIMP, Photoshop, Krita, Paint.NET, Aseprite — anything). It's a 4096×2048 labeled canvas with the horizon, zenith, nadir, cardinal directions, and a grid drawn on it so you can see where everything will land on the sphere.

Paint over it however you like, then save it as .png or .jpg directly into BepInEx/plugins/CustomSkybox/ (any name you want). Restart the game and it shows up in the dropdown.

Two things to know about equirectangular projection

  1. The left edge wraps around to the right edge on the sphere. If you draw across the seam, make sure pixels at x=0 match pixels at the rightmost column or you'll see a visible vertical line in the sky.
  2. Anything painted near the top or bottom edges gets squashed to a point. That's how the projection works — the top row of pixels all becomes the single point directly overhead, the bottom row becomes the single point directly below. Don't waste detail there.

Use existing 360° images

You don't have to draw from scratch — drop any equirectangular .png / .jpg / .jpeg file into BepInEx/plugins/CustomSkybox/ and it shows up in the dropdown. Filename (without extension) is what you'll see.

Good free sources:

The image must be equirectangular (2:1 width-to-height ratio, e.g. 2048×1024, 4096×2048, 8192×4096). The bundled skyboxes are 4096×2048 — that's twice the base game's resolution, sharp without bloating the install.

Caveats

  • New files require a game restart to appear in the dropdown — ModMenu caches the dropdown options the first time the settings panel opens.
  • Baked reflection probes still reflect the original map's skybox. Only the runtime ambient probe updates.

License

Bundled images are individually licensed: