> For the complete documentation index, see [llms.txt](https://docs.mantic.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mantic.dev/manticsets.md).

# ManticSets

ManticSets creates configurable armor sets and set bonuses.

ManticSets lets you create armor sets with configurable item appearance and bonuses for combat, experience, currencies, and supported companion plugins.

## Guides

* Getting Started — install ManticSets and prepare a first set.
* Permissions — manage staff access.
* Placeholders — use the PlaceholderAPI expansion.
* Config Files — review generated files and example sets.
* Custom model data and leather armour — configure item appearance.

## Install

1. Add `ManticLib.jar` and `ManticSets.jar` to your server's `plugins` folder. ManticLib is required.
2. Start the server once. ManticSets creates `plugins/ManticSets/` and its configuration files.
3. Set `license` in `plugins/ManticSets/config.yml` to your issued ManticSets key. Keep the key private.
4. If `plugins/ManticSets/sets/` contains no `.yml` files, ManticSets creates 12 example sets on startup.
5. Run `/manticset list` to see the available set IDs, or open `/manticset editor` to edit or create sets.

The `manticset` command is also available as `/manticsets`, `/sets`, and `/set` by default. The last two aliases can be changed in `config.yml`; restart the server after changing them.

## Commands and permissions

See the command guide for command syntax and permission nodes. Operators have access by default.

## Configuration and in-game editor

See the configuration guide for generated files, set examples, and the editor. The editor opens with `/manticset editor` and can edit `config.yml`, `messages.yml`, and individual set files.

## Placeholders

PlaceholderAPI is optional. When installed, ManticSets provides `%manticsets_current%` for the active set ID and `%manticsets_current_display%` for its configured display name. For online players, both return the configured “not equipped” text when there is no active set.

## Developer API

See Developer API for the compile-time API JAR, dependency setup, methods, and equipment event.