OlaPermissions

LuckPerms Migration Guide

Moving away from LuckPerms? OlaPermissions comes with a built-in migrator that safely copies your entire database in seconds.

How it works

The migration tool connects directly to your LuckPerms database. It reads your users, groups, permissions, prefixes, suffixes, weights, and inheritances, and seamlessly translates them into the OlaPermissions native architecture.

Warning

The migrator will completely overwrite your existing OlaPermissions database! Do not run this command if you have already set up users and groups in OlaPermissions.

Steps to Migrate

1. Install OlaPermissions alongside LuckPerms on your server.
2. In the server console (or in-game if you have OP), type:
   • /ola import luckperms
3. A warning will appear in chat asking you to confirm the destruction of the current OlaPermissions database.
4. Type /ola import luckperms confirm to begin.
5. Watch the console as the migrator processes your users and groups!
6. Once completed, stop your server and delete the LuckPerms plugin jar.
7. Start your server. Your entire network is now running entirely on OlaPermissions!