Installation

Getting IgniteSky running takes a few minutes. The defaults are sensible, so a first install needs almost no editing.

Steps

    1. Drop in the jar

      Put IgniteSky.jar into your server's plugins folder. Make sure you are on Paper or Folia 1.21.7 or newer running Java 21.

    2. Start the server once

      On first boot IgniteSky writes its config files and generates each enabled mode's base world. Let it finish, then stop the server.

    3. Pick your storage

      The default is sqlite, which needs zero setup and is perfect to start. For a network, switch to mysql or mongodb and fill in database.yml. See Configuration.

    4. Restart and play

      Start the server again and run /is. You are live.

Folia note

Folia cannot create worlds at runtime, so IgniteSky declares the worlds it needs in bukkit.yml and they are created at boot. After enabling a new mode or hosting strategy on Folia, one restart is needed for the world to appear. On Paper there is no such restart.

The config files

IgniteSky splits its configuration into folders so each concern is easy to find:

PathWhat lives there
config.ymlWorlds, storage, value and levels, flags, economy, spawn, network, integrations
database.ymlMySQL and MongoDB connection details
islands/roles.yml and maps.yml
modes/Per-mode settings (oneblock.yml)
progression/upgrades.yml, missions.yml, milestones.yml, generator.yml
features/One file per feature domain (skilltree, cosmetics, social, qol, ...)
gui/Chest menu layouts
lang/<code>.ymlEvery message, fully translatable

The full layout is mapped on the Configuration page.

Reload most changes in game with /is admin reload. Structural changes (storage backend, registries, world pools) still need a full restart, and IgniteSky tells you when that is the case.

Choosing a storage backend

BackendBest for
sqliteSingle servers. Zero config, stored in a local file. Recommended to start.
mysqlNetworks. A shared database every backend can read.
mongodbVery large servers that prefer a document store.
Networks need a shared database

Proxy sharding and cross server visiting require mysql or mongodb so every backend sees every island. sqlite is local only.

Next: the Quick Start.

Edit this page on GitHub