Configuration

IgniteSky splits its config across folders so each concern is easy to find. This page is a map of what lives where. Reload most changes with /is admin reload; the few structural ones that need a restart are called out as you change them.

The layout

plugins/IgniteSky/
  config.yml          Worlds, storage, value and levels, flags, economy, spawn, network, integrations
  database.yml        MySQL and MongoDB connection details
  islands/
    roles.yml         Island roles and their permissions
    maps.yml          Island maps and spawn templates
  modes/
    oneblock.yml      OneBlock phases
  progression/
    upgrades.yml      Upgrade ladders (per-tier value, cost, commands; per-upgrade permission)
    missions.yml      Island missions and rewards
    milestones.yml    One-time level milestones
    generator.yml     Cobble/ore generator tiers
  features/           One file per feature domain, each a self-contained module:
    skilltree.yml  prestige.yml  cosmetics.yml  stacking.yml  templates.yml
    social.yml  snapshot.yml  island.yml  qol.yml
  gui/                Chest menu layouts
  lang/<code>.yml     Every message, per language

The features/ folder is the old single features.yml broken up by domain: each file holds one group of feature modules (each with its own enabled toggle), and IgniteSky reads them as one combined view, so you can edit one domain without scrolling past the rest.

A tour of config.yml

Islands and worlds

island:
  default-mode: skyblock        # skyblock | oneblock | chunkblock
  max-per-player: 1             # >1 enables multiple islands
  locked-by-default: false      # new islands start closed to visitors
  public-warps-default: false   # new warps publish to the browser immediately
  grid-spacing: 1024            # block spacing on a grid (GRID hosting)
  world-seed: 0                 # seed for generated base worlds
  environments:
    nether: true
    end: true
    platform-y: 101

The modes block underneath chooses each mode's hosting strategy.

Storage

storage:
  type: sqlite                  # sqlite | mysql | mongodb
  auto-save-interval-seconds: 300

sqlite is zero-config and stored in a local file, ideal to start. For mysql or mongodb, fill the connection in database.yml (only read for those backends):

database.yml

# used when storage.type is mysql
database:
  host: localhost
  port: 3306
  database: ignitesky
  username: root
  password: ""
  pool-size: 10
 
# used when storage.type is mongodb
mongodb:
  uri: "mongodb://localhost:27017"
  database: ignitesky

A shared MySQL or MongoDB is required for proxy sharding; SQLite is single-server only. Changing the storage backend needs a full restart, not just a reload.

Value and levels

level:
  points-per-level: 100.0
  allow-negative-worth: false
  worth-sync: NONE              # NONE | BUY | SELL
 
block-values:
  DIAMOND_BLOCK: 100.0
  # ...

Covered in full on Island Levels & Worth.

Limits

limits:
  max-scan-radius: 128
  block-limits: { BEACON: 16, SPAWNER: 64, HOPPER: 512 }
  entity-limits: { VILLAGER: 32, IRON_GOLEM: 16 }

See Upgrades & Limits.

Flags

The starting defaults for new islands, all toggleable per island. See Settings & Flags.

Economy, seasons, missions, boss bar

economy:
  chunk-unlock-cost: 1000.0
  bank-interest: { enabled: true, rate: 0.02, interval-minutes: 30 }
 
seasons:
  rewards: [100000, 50000, 25000]
 
missions:
  daily-reset-hours: 24
  weekly-reset-hours: 168

Presentation

dialogs:
  enabled: true                 # native client dialogs (Paper 1.21.7+, Bedrock via Geyser)
hologram:
  enabled: true
  height: 7.0
preview:                        # the /is preview cinematic orbit camera
  radius: 25.0                  # orbit radius around the island
  height: 18.0                  # camera height above the island
  speed-degrees: 2.0            # rotation per move step
  ticks-per-move: 1             # how often the camera advances (lower = smoother)
  duration-seconds: 20          # auto-end after this long

These three - dialogs, hologram and the preview camera - are also covered in depth on Notifications & Display.

Messages and formatting

messages:
  default-language: en
  languages: [en]
  auto-detect-language: true
  number-format: "#,##0.##"     # Java DecimalFormat
  date-format: "yyyy-MM-dd HH:mm" # Java DateTimeFormatter

Network and spawn

network:
  enabled: false
  server-name: ""
 
spawn:
  enabled: false
  protection-radius: 16

Network is covered on Proxy Sharding; spawn protection is bypassed by ignitesky.bypass.spawn.

Edit live where you can

For the common settings, /is admin config is faster than editing the file: a native dialog of sliders and tick boxes that writes back to config.yml and reloads for you. It covers hologram height and toggle, preview duration and orbit radius, recalc scan radius, boss bar duration and toggle, worth points per level, ChunkBlock unlock cost, auto-save interval, and bank interest rate, interval and toggle. Reach for the file for anything it does not cover, then /is admin reload. On Bedrock the same editor arrives as a Geyser form.

Edit this page on GitHub