Installation

Installation

Requirements, setup steps and updating.

Requirements

Requirement	Details
Minecraft	26.3 (first release)
Server	Paper for Minecraft 26.3
Java	Java 25
Internet (first start)	Paper downloads the DuckDB, ClickHouse and MySQL drivers automatically. SQLite ships with Paper.

Steps

1. Download or build UniversalProtect.jar.

2. Put the jar into your server's plugins/ folder.

3. Start the server. The plugin creates its files in plugins/UniversalProtect/:

   File	Purpose
   config.yml	Main configuration, see Configuration
   blacklist.txt	Things that are never logged, see Blacklist
   database.duckdb	The default database

4. Optionally edit config.yml and run /up reload.

5. Grant permissions, see Permissions. By default only operators can use the plugin.

Note: The first start can take a few seconds longer while Paper downloads the database drivers.

Updating from an older version

If the plugin finds an existing database.db (SQLite) and no database.type in your config, it keeps using SQLite so nothing is lost. You can switch to DuckDB later without downtime, see Databases.

Uninstalling

Stop the server, remove the jar and delete plugins/UniversalProtect/ if you no longer need the data.

---

Related pages: Configuration · Permissions · Building from Source