Configuration

config.yml

The core behavioural configuration — server capacity, world lifecycle, generators, and the settings applied to newly created islands.

Backed by SkyblockConfiguration:

loader.yml

Connection details for the MySQL-backed SlimeWorld loader (MysqlLoader) that AstralSkyblock uses to store and clone island worlds. Deserialized once into ASPLoaderConfiguration and handed to WorldService.load() when it constructs worldLoader during plugin enable.

block-values.yml

Assigns a numeric "worth" to block types, used to identify valuable blocks. Keys are Material names; the special form 'MOB_SPAWNER:<ENTITY>' matches a placed spawner whose CreatureSpawner.getSpawnedType() equals <ENTITY> (case-insensitive) — not the generic SPAWNER material — so 'MOB_SPAWNER:IRON_GOLEM' only matches a spawner currently set to spawn Iron Golems.

BlockValueConfiguration.blocks() lazily resolves the raw Map<String, Integer> into a Map<Predicate<Block>, Integer> — each entry becomes either an exact (case-insensitive) material-name predicate, or the spawner/entity-type predicate for MOB_SPAWNER: keys.

Current runtime use is narrower than the worth values suggest: IslandPermissionsListener.isValuable(Block) reads only the predicate keys (blocks().keySet().stream().anyMatch(...)) to decide whether a broken block should be gated behind IslandPermission.VALUABLE_BREAK. The islands table has a cached level column (schema.sql: "cached rank metric (recalc job); /is top orders by this") that these worth values are clearly meant to roll up into, but no recalculation job reading the Integer values exists in the current codebase — they are presently unused for scoring.

generators/<id>.yml

One file per cobblestone/basalt generator blueprint, loaded by GeneratorService.load() from the generators/ folder (created if missing). The active generator is generators.default in config.yml; GeneratorService.defaultGenerator() looks it up and logs a warning at load time if it doesn't exist.

GeneratorListener replaces a newly-formed COBBLESTONE/BASALT block (from a BlockFormEvent — lava meeting water) inside an island world with randomBlock() drawn from this weighted pool, cancelling the vanilla result. The listener currently always resolves generators().defaultGenerator() regardless of which island is firing the event (// TODO: Replace that in source) — every island effectively shares the single plugin-wide default generator today, even though multiple generators/<id>.yml files can be defined.

blueprints/<id>.yml

Island world templates, loaded by BlueprintService.load() from blueprints/. Exactly one blueprint across all files must set default: true — BlueprintService.load() throws IllegalStateException if none does. /is create <name> <blueprint> falls back to blueprints().defaultBlueprint() when no blueprint argument is given.

upgrades/<type>.yml

One file per upgradeable island stat, loaded by UpgradeService.load() from upgrades/. type must be one of the UpgradeType enum: WORLDBORDER_SIZE, MEMBERS_LIMIT, COOP_LIMIT, GENERATOR, HOPPERS_LIMIT, CROP_GROWTH_SPEED, SPAWNERS_RATE, MOB_DROPS, MINECART_LIMITS. A duplicate type across files is logged and skipped.

Each levels.<n> entry:

roles.yml, settings.yml & permissions.yml

• roles.yml seeds the roles every island starts with (RolesConfiguration — Map<String, Entry>, one entry per role): name, type (IslandRole.Type), weight, default (@Setting("default") → isDefault; the role auto-assigned to new members), icon, and permissions (raw IslandPermission names, or the ALL wildcard).

• settings.yml and permissions.yml are icon-only lookup tables (Map<IslandSettings, ItemStackWrapper>/Map<IslandPermission, ItemStackWrapper>, loaded via loadEnum) that back the settings/permissions toggle menus.

Full role, permission and setting catalogues, defaults, and menu behavior are covered in Roles, Permissions & Settings.

messages.yml

Every player-facing string, loaded into the ASMessages enum via loadEnum("messages.yml", ASMessages.class). Values are MiniMessage strings that accept %placeholder% tokens resolved per message; a key missing from the file is logged as a warning and skipped rather than failing the whole load.

Reload

/is reload (aliases /skyblock reload, /island reload; permission skyblock.reload) re-runs AstralSkyblock.loadConfiguration():

1. Copies database.properties if it doesn't already exist.

2. Reloads config.yml, loader.yml, roles.yml and block-values.yml into their configuration records.

3. Reloads messages.yml into ASMessages, and settings.yml/permissions.yml into IslandSettings/IslandPermission.

4. Fully reloads blueprints/, menus, dialogs, generators/, and upgrades/ from disk — each service clears its in-memory map and re-scans its folder, so files added or removed since the last load take effect.

Not re-applied by reload: WorldService.load() guards with if (this.worldLoader != null) return;, so it is a no-op on every call after plugin enable. Changes to loader.yml's connection settings only take effect on a full plugin/server restart — the same is true of the database, cache, and messaging connections, which are all opened once in onEnable and not reopened by loadConfiguration().

Configurate mapping note

All of the records above are Configurate @ConfigSerializable types. An unannotated camelCase Java field maps to a kebab-case YAML key (maximumIslands → maximum-islands, worldIdleUnloadSeconds → world-idle-unload-seconds). Where the natural key would collide with the Java keyword default, the field is renamed and annotated with @Setting("default"):