Repository navigation
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;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.
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.
| 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].
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.
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.
- Setup: depending on AbyssCore
- Sides, threads and lifecycle: read this first
- Permissions
- Networking
- Synced player data
- Corruption
- Damage
- Continuous effects
- Screen overlays
- VFX: 3D effects
- Cinematics
- Sky
- Commands
- GUI toolkit
- GeckoLib
- Outside the API package: vanish and config queries
- Complete example: a mana mod
- Limitations, troubleshooting and changelog
- Quick reference