Celeste-OG is a 1.19 fork of Celeste maintained for TrueOG Network. It keeps the original Celeste concept and documentation while updating the project for this fork's Gradle build, Purpur 1.19.4 target, and additional gameplay/config features merged from upstream community work.

Inspired by the shooting stars from Animal Crossing and the falling stars from Breath of the Wild, this plugin brings some celestial ambience to your Minecraft world.

Fork Changes

NotAlexNoyle

Gradle build instead of Maven
Purpur API 1.19.4-R0.1-SNAPSHOT
Java 17 toolchain
Removed bStats metrics
Removed update checker
World whitelist for falling stars (falling-stars-world-whitelist)

SpaceXCheeseWheel

Configurable falling star max height

rm20killer

Adaptive shooting star and falling star spawn rates based on player count
Optional daytime falling stars with a configurable multiplier
/celeste info shows the effective highest falling star rate

Features

Add shooting stars to the night sky with configurable frequency
Find rare falling stars that deliver precious materials in a sparkling package
Watch meteor showers that occur every new moon, increasing the rate of shooting and falling stars
Scale star activity with server or world player counts
Allow falling stars during the day at a reduced rate if desired
Override settings per world
Use either simple weighted loot or Minecraft loot tables for falling star rewards

Shooting stars

Shooting stars occur frequently, but because they spawn around random players in large areas, players usually only notice them when they are actually stargazing. They are cosmetic only and exist to make the sky feel alive. Celeste varies their speed, length, and breakup behavior to better resemble real meteors.

Falling stars

Falling stars are much rarer and are meant to be discovered. They streak toward the ground, play an impact sound, and leave behind a short-lived sparkling landing site so players can hunt them down. When found, they can reward configurable loot and experience.

In-Depth Functionality

Stars are processed per world. When a star is selected to spawn, the plugin chooses a random player in that world and centers the spawn around that player to avoid wasting events on unloaded chunks.

By default, stars only spawn when these conditions are met:

A world has at least one player in it
The world time is between 13000 and 23000
The weather is clear
The world is a normal overworld unless explicitly overridden in config

This fork also supports:

Adaptive spawn bonuses using either global online player count or per-world player count
Falling stars during daytime when falling-stars-daylight is enabled
Per-world overrides via world-overrides
Restricting falling stars to specific worlds via falling-stars-world-whitelist

Build

This repo no longer uses Maven.

Requirements:

Java 17

Build with:

./gradlew build

Compile only:

./gradlew compileJava

Installation

Copy the built jar into your server's plugins/ folder and start the server once to generate the default config.

Configuration

If your config was created by an older version, it may be missing newly added settings. Add the missing keys from the defaults below as needed.

Default Config

shooting-stars-enabled: true
falling-stars-enabled: true
begin-spawning-stars-time: 13000
end-spawning-stars-time: 23000
shooting-stars-per-minute: 12
shooting-stars-min-height: 160
shooting-stars-max-height: 310
falling-stars-per-minute: 0.2
falling-stars-max-height: 300
falling-stars-radius: 75
falling-stars-sound-enabled: true
falling-stars-volume: 6
falling-stars-spark-time: 200
falling-stars-experience: 25
falling-stars-loot:
  diamond: 1
  emerald: 0
  fire_charge: 0
new-moon-meteor-shower: true
shooting-stars-per-minute-during-meteor-showers: 36
falling-stars-per-minute-during-meteor-showers: 0.4
shooting-stars-summon-text: "&eMake a wish!"
falling-stars-summon-text: "&eWish granted!"
debug: false
# Adaptive settings
# This settings will increase falling-stars-per-minute and shooting-stars-per-minute depending on player count.
# 0 is disabled, 1 will increase it by 0.1 for every player, 2 will increase it by 0.2 for every 2 players etc
adaptive-falling-stars: 0
adaptive-shooting-stars: 0
adaptive-use-global-player-count: true
# Allow falling stars to spawn during the day with a lower chance.
falling-stars-daylight: false
falling-stars-day-multiplicative: 0
# World whitelist for falling stars (case-sensitive world names).
# If empty, falling stars may spawn in any eligible world (default behavior).
# If non-empty, falling stars only spawn in the listed worlds.
falling-stars-world-whitelist: []

Adaptive Spawn Settings

adaptive-falling-stars: Adds to the falling star rate based on player count
adaptive-shooting-stars: Adds to the shooting star rate based on player count
adaptive-use-global-player-count: If true, uses total online players; if false, uses players in each world

Example:

adaptive-falling-stars: 1 adds 0.1 falling stars per minute per player
adaptive-falling-stars: 2 adds 0.1 per 2 players
0 disables the adaptive bonus entirely

Daytime Falling Stars

falling-stars-daylight: Enables falling stars outside the configured night window
falling-stars-day-multiplicative: Multiplies the falling star rate during daytime

Example:

falling-stars-daylight: true
falling-stars-day-multiplicative: 0.25

This keeps daytime falling stars possible while making them much rarer than nighttime events.

Falling Star World Whitelist

falling-stars-world-whitelist: Restricts natural falling stars to specific worlds (case-sensitive names)

Behavior:

Empty list (default): falling stars may spawn in any otherwise-eligible world
Non-empty list: falling stars only spawn in the listed worlds

Example:

falling-stars-world-whitelist:
  - world
  - world_nether

This only affects natural spawns. The /fallingstar command still works in any world. Shooting stars are not affected.

Falling Star Loot

Falling stars can reward experience, simple weighted loot, or a Minecraft loot table.

Simple Config-Based Loot

Use falling-stars-loot to define weighted single-item rewards:

falling-stars-loot:
  nether_star: 0.05
  apple: 33
  blaze_spawn_egg: 33
  blue_orchid: 33

Material names must match Bukkit Material names valid for your server version.

Loot Tables

Use falling-stars-loot-table to hand reward generation to Minecraft:

falling-stars-loot-table: "minecraft:chests/simple_dungeon"

Loot tables are better if you want multiple drops, more complex rewards, or NBT data.

World Overrides

You can override global settings for specific worlds:

falling-stars-spark-time: 200
falling-stars-experience: 25
falling-stars-loot:
  diamond: 1
  emerald: 0
  fire_charge: 0

world-overrides:
  some_world:
    falling-stars-enabled: false
  another_world:
    falling-stars-loot-table: "minecraft:chests/simple_dungeon"
    falling-stars-experience: 300
    adaptive-falling-stars: 1
    falling-stars-daylight: true
    falling-stars-day-multiplicative: 0.25

Any world not listed under world-overrides continues to use the global settings.

Commands

/shootingstar [player] summons a shooting star near the target player, or near the sender if no player is supplied.
Permission: celeste.shootingstar

/fallingstar [player] summons a falling star near the target player, or near the sender if no player is supplied.
Permission: celeste.fallingstar

/celeste reload reloads the plugin configuration and rebuilds the active config set.
Permission: celeste.reload

/celeste info shows whether shooting stars, falling stars, and meteor showers are enabled, plus the highest current falling star rate.
Permission: celeste.info

Credits

Original plugin by IdreesInc
Fork build, platform migration, and falling star world whitelist by NotAlexNoyle
Falling star max height config by SpaceXCheeseWheel
Adaptive spawn scaling, daytime falling stars, and /celeste info rate display by rm20killer