Licensing & install

Every Oreades plugin ships as a small loader. The loader carries no gameplay code. On enable it validates your licence, pulls the real plugin from the licence server, decrypts it in memory and hands off. No valid licence means no code to run.

Install

1. Drop the loader jar into your server’s plugins/ folder — for example AtlasSpawner-x.y.z-loader.jar.

2. Start the server once. The loader creates a shared folder, plugins/AtlasLoader/, and writes a licence file named after the plugin (atlasspawner.yml, atlasrealms.yml, …). It logs that the key is missing and stops the plugin.

3. Paste your licence key into that file:

   plugins/AtlasLoader/atlasspawner.yml

   license: "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX"
   version: latest
   channel: stable

4. Restart. The loader fetches the plugin and enables it.

One licence key can cover several products, so the same key can sit in more than one of these files.

Fields

Field	What it does
license	Your licence key. Required.
version	The build to pull. latest follows the newest release on the channel; a pinned version (e.g. 2.4.2) stays there.
channel	stable (default) or nightly.

Running more than one Oreades plugin

You can run any number of Oreades plugins on one server — AtlasSpawner and AtlasRealms together, for instance. They share the plugins/AtlasLoader/ folder and each reads its own licence file. Nothing to configure.

Requirements

• Server: Paper, Folia or Leaf, Minecraft 1.21.4 through 26.2.
• Java: 21 through 26.
• Network: the server reaches license.oreades.studio on enable.

Troubleshooting

• “No licence key yet.” — the licence file is empty. Paste your key and restart.
• “Licence rejected or licence server unreachable.” — the key is wrong, revoked, or bound to a different machine, or the server cannot reach the licence server.
• Nothing after an update — the loader fetches the build the channel points at; set version to a specific build to pin it.