Skip to content
Gugas749 edited this page Nov 16, 2026 · 1 revision

Sky

Sky, fog (horizon) and cloud colours, star brightness and an extra dense star field - per player for a time (a ceremony, a curse) or saved per dimension. This is AbyssOrigins' "ascended sky", made generic, plus a staff panel and commands. Drawn only in dimensions with a normal sky (the Overworld and dimensions like it).

import com.gugas749.abysscore.api.sky.AbyssSky;
import com.gugas749.abysscore.api.sky.AbyssSkySpec;

What it looks like - AbyssSkySpec

AbyssSkySpec.tint(0xC0182E, 0.8f)                     // red tint that keeps day bright and night dark
AbyssSkySpec.solid(0x030309, 0x06060F, 0x29263D)      // flat colours at any hour (sky, fog, clouds)
new AbyssSkySpec(sky, fog, clouds, strength, keepBrightness, stars, starField, fadeTicks)
spec.withStars(1f).withStarField(1f).withFadeTicks(100)   // copies with one value changed
Field Description
sky 0xRRGGBB
fog, clouds 0xRRGGBB, or AbyssSkySpec.AUTO (-1) to follow the sky colour
strength 0..1, how much the colours replace the vanilla ones
keepBrightness true: the colour follows the vanilla brightness (day bright, night dark). false: used as it is at any hour
stars 0..1, minimum brightness of the vanilla stars (1 = stars at noon)
starField 0..1, an extra dense, coloured, twinkling star field
fadeTicks How long it fades in / out / into another sky (max 1200)

AbyssSkySpec.parseColor("#C0182E" | "C0182E" | "0xC0182E" | "auto") and hex(rgb) convert colours.

Layers (server)

Each player sees, top first: their personal sky, else their dimension's sky, else vanilla. Changes crossfade.

// Personal: one player, optionally for a time (0 = until cleared). Comes back after a quick relog.
AbyssSky.set(player, AbyssSkySpec.tint(0x9B6BFF, 0.85f), 20 * 120);     // two minutes
AbyssSky.set(players, AbyssSky.preset("starry_night"), 0);
AbyssSky.clear(player);
AbyssSky.get(player);           // their personal sky or null
AbyssSky.effective(player);     // what they see (personal, else dimension, else null)

// Dimension: saved in config/abysscore/abysscore_sky.json, everyone in that dimension sees it
AbyssSky.setDimension(server, Level.OVERWORLD, AbyssSky.preset("blood_moon"));
AbyssSky.clearDimension(server, Level.OVERWORLD.location());
AbyssSky.getDimension(Level.OVERWORLD);
AbyssSky.dimensions();          // every dimension with its own sky

// Presets: named specs in the same file (the defaults are written the first time)
AbyssSky.preset("void");
AbyssSky.presets();             // name -> spec, in order
AbyssSky.savePreset("my_sky", spec);   // a-z, 0-9, '_' and '-', up to 32
AbyssSky.deletePreset("my_sky");

Default presets: blood_moon, void, starry_night (night sky full of stars at any hour), inferno, radiant, abyss, aurora. The file is plain JSON ("sky": "C0182E", "fog": "auto", ...); /abysscore reload reads it again.

Staff tools

Command (ADMIN)
/abysscore sky panel The sky panel: RGB sliders / hex for sky, fog and clouds (fog and clouds can follow the sky), strength, stars, star field, fade, day/night light, live preview (only you see it while the panel is open), apply to me / everyone / this dimension, save presets. Presets tab: load, apply, delete. Active tab: your dimension, the dimension skies, clear buttons.
/abysscore sky presets Lists the presets
/abysscore sky player <targets> preset <name> [seconds] Personal sky (no seconds = until cleared)
/abysscore sky player <targets> color <RRGGBB> [strength] [seconds] Personal tint
/abysscore sky player <targets> clear
/abysscore sky dimension <dimension> preset <name> Saved dimension sky
/abysscore sky dimension <dimension> color <RRGGBB> [strength]
/abysscore sky dimension <dimension> clear

The VFX and cinematic engines have test commands too: /abysscore vfx <type> [scale] [color] [color2] [ticks] (where you stand / look), /abysscore cinematic demo [targets] (the showcase: orbit, text, burst, VFX, violet sky), /abysscore cinematic stop [targets], /abysscore cinematic quake [radius] [seconds] [strength].

Client side

AbyssSkyClient.setPreview(spec) shows a sky on this client only, at once (the panel's live preview; null ends it). current(), worldSky(), personalSky() say what the server sent.

Weather - AbyssWeather

Server-wide weather rules, saved in config/abysscore/abysscore_weather.json, plus the weather right now.

import com.gugas749.abysscore.api.weather.AbyssWeather;
import com.gugas749.abysscore.api.weather.AbyssWeatherSettings;

AbyssWeather.set(server, AbyssWeather.settings().withRain(false));      // never rain (also against /weather)
AbyssWeather.set(server, AbyssWeather.settings().withClouds(false));    // no clouds for anyone
AbyssWeather.setWeather(server, AbyssWeather.Type.THUNDER, 20 * 60);    // a storm for a minute (<= 0 = random length)
AbyssWeather.setWeatherCycle(server, false);                            // freeze the weather (doWeatherCycle)
AbyssWeather.current(server);  AbyssWeather.remainingTicks(server);  AbyssWeather.weatherCycle(server);
AbyssWeatherSettings Off means
rain The weather is kept clear
thunder Storms become plain rain
lightning Storms never strike natural lightning
clouds No clouds are drawn (every player)
precipitation No rain / snow drawn, no splashes or rain sound (every player)

The rules are checked every second on the server and on every change. Staff: the Weather tab of the AbyssCore menu (weather now with a duration, weather cycle, rules, visuals, a "Sky colours..." button to the sky panel, reset), /abysscore weather panel, and /abysscore weather status | set <clear|rain|thunder> [seconds] | cycle | rain | thunder | lightning | clouds | precipitation <true|false> | reset (ADMIN). /abysscore reload reads the file again.

Clone this wiki locally