Repository navigation
FAQ
Frequently asked questions.
The plugin does not start and the log shows a database error. On the first start the drivers must be downloaded. Check the server's internet connection. For MySQL or ClickHouse check the credentials and that the database exists. See Troubleshooting.
How do I switch from SQLite to DuckDB?
In the console run /up migrate-db duckdb. See Databases.
Why are picked up items not logged?
log.pickup is off by default because it creates many entries. Set it to true in config.yml.
A rollback did nothing.
Check t: and r:. The default radius is 10. Try it with #preview first.
Can I search by an old player name? Yes. The old name leads through the UUID to the entries of the current name.
Can I use it together with Watson?
Yes. Enable networking and give the player universalprotect.networking. See Networking.
Does it work with plugins that use the CoreProtect API?
Not unchanged. UniversalProtect provides an API with the same structure as CoreProtect API v13, but in its own package, de.muffin.universalprotect.api. Plugins must be adapted to it, usually by changing the imports and how the API object is obtained. See API.
How much space does the database use?
It depends on the player count. Use auto-purge-days and /up purge #optimize.
Can I log different things in different worlds?
Yes, with world files such as world_nether.yml. See Per-World Configuration.
Can I ignore specific blocks, commands or players?
Yes, in blacklist.txt. See Blacklist.
Can I undo a /fill or /clone?
Yes. Use #command, for example /up rollback t:10m #command #preview. See Rollback and Restore.
Can I import my CoreProtect data?
Yes, with /up import-coreprotect from the console. See Migrating from CoreProtect.
Why is the output split into pages?
No reply is longer than 20 chat lines. Use the Prev and Next buttons, /up page or /up view <n>. If wrapped lines still exceed your chat window, lower chat.width-px.
What happens if the server crashes during a rollback? It is resumed automatically after the next start. See Rollback and Restore.
Can alerts go to Discord?
Yes. Set detection.discord-webhook in config.yml. See Investigation and Alerts.
Can I see what my staff did?
Yes, with /up audit.
Can alerts and staff actions go to different Discord channels?
Yes. Set discord.alerts-webhook and discord.audit-webhook to webhooks of two channels. See Investigation and Alerts.
How do I get fewer Discord alerts?
Raise discord.min-level to 2 (MEDIUM and HIGH, the default) or 3 (HIGH only). See Configuration.
Does the plugin collect data?
The Paper edition sends anonymous usage statistics to bStats. This includes the server software and version, Java version, operating system, player count, online mode, the plugin version and which database type is used. No player names, IP addresses or log data are sent. To turn it off, set metrics.enabled: false in this plugin's config.yml, or enabled: false in plugins/bStats/config.yml to turn it off for all plugins on the server.
How much space does each log type use?
/up stats lists block, container, item, entity, chat, player and interaction logs with their size and rows. See Purge.
How do I free up space?
Delete old entries of one log type, for example /up clear blocks t:30d, then confirm with /up clear confirm. You can also use /up purge t:30d for everything or set auto-purge-days. See Purge.
Are items from the creative inventory logged?
Yes, as create with the amount that was added. Turn it off with log.creative: false, globally or per world. See Configuration.
Which edition should I use, Paper or Fabric? Use the edition that matches your server software. Both have the same features, see Platforms.
Can I use my data from the Paper edition on Fabric? No, the data formats differ. Start with a fresh database.
Do players need to install the Fabric mod? No. UniversalProtect is server-side only and works with a vanilla client. Only the server needs Fabric Loader and the Fabric API.
Does it work in singleplayer? No. The Fabric edition is marked as server-only. Use a local Fabric server for tests.
Related pages: Troubleshooting · Installation
UniversalProtect · Minecraft 26.3 · Paper · Fabric · Java 25 · API v13
Getting started
Using UniversalProtect
- Commands
- Inspector
- Parameters and Tags
- Actions
- Lookup Examples
- Rollback and Restore
- Investigation and Alerts
- Purge
Administration
Developers
Help