Installation

1. Drop the JAR

Place AstralCollections-<version>.jar in your server's plugins/ directory. AstralCore and AstralSync must already be installed; CraftEngine and AstralItems are optional.

2. Start the server

On first start the plugin creates:

plugins/AstralCollections/
├── blueprints/
│   └── example.yml        ← shipped sample blueprint
├── menus/
│   └── collections.yml    ← sample menu (provided by the JAR)
└── messages.yml

3. Configure messages and menus

Edit messages.yml to match your network's tone — see Messages.
Edit menus/collections.yml if you want a different UI — uses the standard AstralCore Menu System.

4. Add your collections

Drop more YAML files into blueprints/. The file name is irrelevant; the id field inside the file is the identifier. Sub-folders are scanned recursively.

plugins/AstralCollections/blueprints/
├── starter.yml
├── pvp/
│   ├── weapons.yml
│   └── armor.yml
└── seasonal/
    └── halloween.yml

Reload at runtime with /collections reload — no restart required.

Permissions

Node	Default	Description
`collections.reset`	op	Reset a player's progress with `/collections reset <player>`.
`collections.reload`	op	Reload blueprints, messages, and menus.

The base /collections command has no permission node and is open to all players.

Last modified: 25 July 2026