Install PerPlayerKit

PerPlayerKit needs Paper or Spigot 1.19 or newer and Java 17 or newer. On anything older the plugin fails to load.

Install the plugin

Download the jar

Get PerPlayerKit-x.x.x.jar from Modrinth, SpigotMC, or Hangar.

Stop the server

Shut it down fully.

Put the jar in the plugins folder

Copy the into plugins/.

Start the server

The plugin creates plugins/PerPlayerKit/.

Stop the server again

A running server overwrites edits to config.yml when it saves.

Pick a database

Set storage.type in plugins/PerPlayerKit/config.yml. See below.

Start the server

The plugin connects and finishes setup.

What the plugin creates

plugins/

PerPlayerKit-x.x.x.jar

PerPlayerKit/

config.yml

lang/

backups/

database.db


`config.yml`	All settings.
`lang/`	One file per language.
`backups/`	Automatic backups. SQLite and YAML only.
`database.db`	SQLite only.

Choose a database

`storage.type`	Use it for
`sqlite`	A single server. No setup, no password.
`mysql`, `postgresql`, `redis`	A network that shares kits between servers.

SQLite (recommended)
MySQL
PostgreSQL
Redis

config.yml

storage:
  type: sqlite

Created at plugins/PerPlayerKit/database.db on the next start.

Works with MariaDB too.

config.yml

storage:
  type: mysql
  mysql:
    host: localhost
    port: '3306'
    dbname: kitdatabase
    username: username
    password: pa55w0rd
    use-ssl: false
    maximum-pool-size: 10

Create the database first; the plugin makes its own tables.

config.yml

storage:
  type: postgresql
  postgresql:
    host: localhost
    port: '5432'
    dbname: kitdatabase
    username: username
    password: pa55w0rd
    use-ssl: false
    maximum-pool-size: 10

Create the database first; the plugin makes its own tables.

config.yml

storage:
  type: redis
  redis:
    host: localhost
    port: 6379
    password: pa55w0rd

Do not use the yml storage type on a real server. It is slow and can lose data.

Optional plugins

Plugin	What it adds
PlaceholderAPI	Placeholders in plugin messages.
WorldGuard	Per-region kits for rekit on kill.

Both are detected automatically.

Next step

Players cannot build a kit until the kit room is stocked. For a working setup straight away:

/perplayerkit autosetup

Set up your kit room

The items players may use, by command or by hand.

Start here

Features

Commands

Settings

Managing data

Common issues

For developers

Install the plugin

What the plugin creates

Choose a database

Optional plugins

Next step

Set up your kit room

​Install the plugin

​What the plugin creates

​Choose a database

​Optional plugins

​Next step

Set up your kit room

Install the plugin

What the plugin creates

Choose a database

Optional plugins

Next step