Install and First Boot

Kits Crates Plus targets Spigot, Paper, and Arclight-style 1.21.1+ servers on Java 21.

What to install first

You need:

• the Kits Crates Plus jar
• a 1.21.1+ server
• Java 21

Optional:

• PlaceholderAPI if you want PlaceholderAPI placeholders in reward commands

First startup behavior

On first boot, the plugin creates the core file set and seeds example content.

Expected generated files include:

plugins/KitsCratesPlus/
- config.yml
- messages.yml
- theme-packs.yml
- data/kit-menu.yml
- kits/mega_example.yml
- kits/command_example.yml
- kits/effects_example.yml
- kits/container_example.yml
- crates/tier1_example.yml
- crates/tier3_example.yml
- crates/tier6_example.yml

That example bootstrap is controlled by config.yml:

• examples.bootstrapOnFirstRun
• examples.regenerateMissingOnStartup

If you want deleted examples to stay deleted, leave regenerateMissingOnStartup: false.

First things to prove before deeper editing

1. The plugin loaded cleanly

Start the server once and confirm there are no startup errors.

2. The files generated in the right places

Confirm the plugin created:

• kits/
• crates/
• data/kit-menu.yml
• messages.yml
• config.yml

3. The player-side kit surface opens

Run:

/kits

If it opens but shows no kits, that is usually a permission issue, not a broken install.

4. One admin editing flow works

Create or edit one kit:

/kit edit mega_example

And one crate:

/crate edit tier1_example

5. One real claim or open works end to end

Use one clean reward path before you branch out:

• claim one kit
• open one crate
• confirm the message, permissions, and reward output are all correct

Recommended first production changes

After the plugin is proven healthy:

• remove or replace the bundled example rewards
• set the real permission nodes you want on live kits and crates
• decide whether first-join kits are enabled
• decide whether crate previews are enabled
• set your real messages and prefix behavior

Good next pages

• files, Config, Messages, and Generated Data
• commands, Permissions, and Access
• kits, Crates, and the Shared Reward Engine