Skip to content

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.

  1. Pause changes in PEX

    Avoid editing permissions in PermissionsEx while the migration runs.

  2. Copy your permissions.yml

    Copy plugins/PermissionsEx/permissions.yml into plugins/sofyCore/migrations/pex/.

  3. 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.

  4. Analyze the file

    Run access migration pex analyze permissions.yml <owner-uuid> import. With import your groups are taken exactly as they are in PEX; with sofycore the ranks you already created in sofyCore with the same name are kept.

  5. 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.

  6. Apply the migration

    access migration apply <plan> confirm imports exactly the reviewed plan. If it is interrupted, access migration resume <plan> confirm continues it.

  7. Remove PermissionsEx

    Stop the servers, remove PermissionsEx and start them again. From then on sofyCore manages all your ranks.

What is imported

PermissionsExsofyCore
GroupsRanks, with their prefix, suffix and priority order
Group inheritanceRank inheritance
Permissions and negated permissionsRank permissions
Default groupdefault rank
Per-world permissions and prefixesRules limited to that world
Each user's groupsPlayer ranks, temporary ones included with their end date
A user's personal prefix and suffixThe player's personal prefix and suffix