Reference
PermissionsEx migration
Import your groups, permissions, prefixes and users from the PermissionsEx permissions.yml into sofyCore, with a report to review everything before applying it.
Coming from PermissionsEx? sofyCore imports your permissions.yml file and turns your groups into ranks, with their permissions, inheritance, prefixes, suffixes, worlds and the temporary ranks of your players. Your original file is never modified, and before anything is applied you get a report to review it all.
The migration works the same on MongoDB, MySQL, MariaDB and SQLite, and accepts both older files (users by name) and newer ones (users by UUID).
Steps
Every migration command runs from the server console, with the ranks module enabled.
Pause changes in PEX
Avoid editing permissions in PermissionsEx while the migration runs.
Copy your permissions.yml
Copy
plugins/PermissionsEx/permissions.ymlintoplugins/sofyCore/migrations/pex/.Get the owner UUID
Ask the future owner to join the network once and run
access uuid <name>in the console. Copy the UUID it returns.Analyze the file
Run
access migration pex analyze permissions.yml <owner-uuid> import. Withimportyour groups are taken exactly as they are in PEX; withsofycorethe ranks you already created in sofyCore with the same name are kept.Review the report
access migration report <plan>shows groups, users, conflicts and any skipped entries. If something looks wrong, fix the file and analyze again.Apply the migration
access migration apply <plan> confirmimports exactly the reviewed plan. If it is interrupted,access migration resume <plan> confirmcontinues it.Remove PermissionsEx
Stop the servers, remove PermissionsEx and start them again. From then on sofyCore manages all your ranks.
What is imported
| PermissionsEx | sofyCore |
|---|---|
| Groups | Ranks, with their prefix, suffix and priority order |
| Group inheritance | Rank inheritance |
| Permissions and negated permissions | Rank permissions |
| Default group | default rank |
| Per-world permissions and prefixes | Rules limited to that world |
| Each user's groups | Player ranks, temporary ones included with their end date |
| A user's personal prefix and suffix | The player's personal prefix and suffix |