[{"data":1,"prerenderedAt":632},["ShallowReactive",2],{"wiki-nav":3,"wiki-sidebar":238,"wiki-en-\u002Fwiki\u002Fguides\u002Fmigration":304,"wiki-surround-en-\u002Fwiki\u002Fguides\u002Fmigration":629},[4],{"title":5,"icon":6,"path":7,"stem":8,"children":9},"Wiki","i-lucide-book","\u002Fwiki","wiki",[10,13,40,84,88,110,114,155,159,197,212,234],{"title":11,"path":7,"stem":12},"Wiki home","wiki\u002Findex",{"title":14,"icon":15,"path":16,"stem":17,"children":18,"page":39},"About","i-lucide-info","\u002Fwiki\u002Fabout","wiki\u002Fabout",[19,23,27,31,35],{"title":20,"path":21,"stem":22},"Credits","\u002Fwiki\u002Fabout\u002Fcredits","wiki\u002Fabout\u002Fcredits",{"title":24,"path":25,"stem":26},"External connections","\u002Fwiki\u002Fabout\u002Fexternal-connections","wiki\u002Fabout\u002Fexternal-connections",{"title":28,"path":29,"stem":30},"Locale and translations","\u002Fwiki\u002Fabout\u002Flocale","wiki\u002Fabout\u002Flocale",{"title":32,"path":33,"stem":34},"Placeholders","\u002Fwiki\u002Fabout\u002Fplaceholders","wiki\u002Fabout\u002Fplaceholders",{"title":36,"path":37,"stem":38},"Why LuckPerms?","\u002Fwiki\u002Fabout\u002Fwhy-luckperms","wiki\u002Fabout\u002Fwhy-luckperms",false,{"title":41,"icon":42,"path":43,"stem":44,"children":45},"Commands","i-lucide-terminal","\u002Fwiki\u002Fcommands","wiki\u002Fcommands\u002Findex",[46,48,52,56,60,64,68,72,76,80],{"title":47,"path":43,"stem":44},"Command usage",{"title":49,"path":50,"stem":51},"General commands","\u002Fwiki\u002Fcommands\u002Fgeneral","wiki\u002Fcommands\u002Fgeneral",{"title":53,"path":54,"stem":55},"Group commands","\u002Fwiki\u002Fcommands\u002Fgroup","wiki\u002Fcommands\u002Fgroup",{"title":57,"path":58,"stem":59},"Log commands","\u002Fwiki\u002Fcommands\u002Flog","wiki\u002Fcommands\u002Flog",{"title":61,"path":62,"stem":63},"Meta commands","\u002Fwiki\u002Fcommands\u002Fmeta","wiki\u002Fcommands\u002Fmeta",{"title":65,"path":66,"stem":67},"Parent commands","\u002Fwiki\u002Fcommands\u002Fparent","wiki\u002Fcommands\u002Fparent",{"title":69,"path":70,"stem":71},"Permission commands","\u002Fwiki\u002Fcommands\u002Fpermission","wiki\u002Fcommands\u002Fpermission",{"title":73,"path":74,"stem":75},"Permissions reference","\u002Fwiki\u002Fcommands\u002Fpermissions","wiki\u002Fcommands\u002Fpermissions",{"title":77,"path":78,"stem":79},"Track commands","\u002Fwiki\u002Fcommands\u002Ftrack","wiki\u002Fcommands\u002Ftrack",{"title":81,"path":82,"stem":83},"User commands","\u002Fwiki\u002Fcommands\u002Fuser","wiki\u002Fcommands\u002Fuser",{"title":85,"path":86,"stem":87},"Configuration","\u002Fwiki\u002Fconfiguration","wiki\u002Fconfiguration",{"title":89,"icon":90,"path":91,"stem":92,"children":93,"page":39},"Developers","i-lucide-code","\u002Fwiki\u002Fdevelopers","wiki\u002Fdevelopers",[94,98,102,106],{"title":95,"path":96,"stem":97},"Developer API","\u002Fwiki\u002Fdevelopers\u002Fapi","wiki\u002Fdevelopers\u002Fapi",{"title":99,"path":100,"stem":101},"API usage","\u002Fwiki\u002Fdevelopers\u002Fapi-usage","wiki\u002Fdevelopers\u002Fapi-usage",{"title":103,"path":104,"stem":105},"Contributing","\u002Fwiki\u002Fdevelopers\u002Fcontributing","wiki\u002Fdevelopers\u002Fcontributing",{"title":107,"path":108,"stem":109},"Standalone app and REST API","\u002Fwiki\u002Fdevelopers\u002Fstandalone-rest","wiki\u002Fdevelopers\u002Fstandalone-rest",{"title":111,"path":112,"stem":113},"FAQ","\u002Fwiki\u002Ffaq","wiki\u002Ffaq",{"title":115,"icon":116,"path":117,"stem":118,"children":119,"page":39},"Features","i-lucide-sparkles","\u002Fwiki\u002Ffeatures","wiki\u002Ffeatures",[120,124,128,132,136,140,151],{"title":121,"path":122,"stem":123},"Context","\u002Fwiki\u002Ffeatures\u002Fcontext","wiki\u002Ffeatures\u002Fcontext",{"title":125,"path":126,"stem":127},"Default groups","\u002Fwiki\u002Ffeatures\u002Fdefault-groups","wiki\u002Ffeatures\u002Fdefault-groups",{"title":129,"path":130,"stem":131},"Prefixes, suffixes and meta","\u002Fwiki\u002Ffeatures\u002Fprefixes-suffixes-meta","wiki\u002Ffeatures\u002Fprefixes-suffixes-meta",{"title":133,"path":134,"stem":135},"Tracks","\u002Fwiki\u002Ffeatures\u002Ftracks","wiki\u002Ffeatures\u002Ftracks",{"title":137,"path":138,"stem":139},"Verbose","\u002Fwiki\u002Ffeatures\u002Fverbose","wiki\u002Ffeatures\u002Fverbose",{"title":141,"path":142,"stem":143,"children":144},"Web Editor","\u002Fwiki\u002Ffeatures\u002Fweb-editor","wiki\u002Ffeatures\u002Fweb-editor\u002Findex",[145,147],{"title":146,"path":142,"stem":143},"Web editor",{"title":148,"path":149,"stem":150},"Web editor technical details","\u002Fwiki\u002Ffeatures\u002Fweb-editor\u002Ftechnical","wiki\u002Ffeatures\u002Fweb-editor\u002Ftechnical",{"title":152,"path":153,"stem":154},"Weight","\u002Fwiki\u002Ffeatures\u002Fweight","wiki\u002Ffeatures\u002Fweight",{"title":156,"path":157,"stem":158},"Getting started","\u002Fwiki\u002Fgetting-started","wiki\u002Fgetting-started",{"title":160,"icon":161,"path":162,"stem":163,"children":164,"page":39},"Guides","i-lucide-map","\u002Fwiki\u002Fguides","wiki\u002Fguides",[165,169,173,177,181,185,189,193],{"title":166,"path":167,"stem":168},"Argument-based command permissions","\u002Fwiki\u002Fguides\u002Fargument-permissions","wiki\u002Fguides\u002Fargument-permissions",{"title":170,"path":171,"stem":172},"Bulk editing","\u002Fwiki\u002Fguides\u002Fbulk-editing","wiki\u002Fguides\u002Fbulk-editing",{"title":174,"path":175,"stem":176},"Extensions","\u002Fwiki\u002Fguides\u002Fextensions","wiki\u002Fguides\u002Fextensions",{"title":178,"path":179,"stem":180},"Migration","\u002Fwiki\u002Fguides\u002Fmigration","wiki\u002Fguides\u002Fmigration",{"title":182,"path":183,"stem":184},"Prefix and suffix stacking","\u002Fwiki\u002Fguides\u002Fprefix-stacking","wiki\u002Fguides\u002Fprefix-stacking",{"title":186,"path":187,"stem":188},"Storage system errors","\u002Fwiki\u002Fguides\u002Fstorage-errors","wiki\u002Fguides\u002Fstorage-errors",{"title":190,"path":191,"stem":192},"Switching storage types","\u002Fwiki\u002Fguides\u002Fswitching-storage","wiki\u002Fguides\u002Fswitching-storage",{"title":194,"path":195,"stem":196},"Syncing data between servers","\u002Fwiki\u002Fguides\u002Fsyncing","wiki\u002Fguides\u002Fsyncing",{"title":198,"icon":199,"path":200,"stem":201,"children":202},"Installation","i-lucide-download","\u002Fwiki\u002Finstall","wiki\u002Finstall\u002Findex",[203,204,208],{"title":198,"path":200,"stem":201},{"title":205,"path":206,"stem":207},"Hytale","\u002Fwiki\u002Finstall\u002Fhytale","wiki\u002Finstall\u002Fhytale",{"title":209,"path":210,"stem":211},"Network installation","\u002Fwiki\u002Finstall\u002Fnetwork","wiki\u002Finstall\u002Fnetwork",{"title":213,"icon":214,"path":215,"stem":216,"children":217,"page":39},"Reference","i-lucide-library","\u002Fwiki\u002Freference","wiki\u002Freference",[218,222,226,230],{"title":219,"path":220,"stem":221},"Migrating from GroupManager or PermissionsEx","\u002Fwiki\u002Freference\u002Fmigrating-gm-pex","wiki\u002Freference\u002Fmigrating-gm-pex",{"title":223,"path":224,"stem":225},"How permission calculation works","\u002Fwiki\u002Freference\u002Fpermission-calculation","wiki\u002Freference\u002Fpermission-calculation",{"title":227,"path":228,"stem":229},"Self-hosting the web interfaces","\u002Fwiki\u002Freference\u002Fself-hosting","wiki\u002Freference\u002Fself-hosting",{"title":231,"path":232,"stem":233},"Upgrading from v4 to v5","\u002Fwiki\u002Freference\u002Fupgrade-v4-v5","wiki\u002Freference\u002Fupgrade-v4-v5",{"title":235,"path":236,"stem":237},"Storage types","\u002Fwiki\u002Fstorage","wiki\u002Fstorage",[239],{"title":5,"icon":6,"path":7,"stem":8,"children":240},[241,242,249,261,262,268,269,281,282,292,297,303],{"title":11,"path":7,"stem":12},{"title":14,"icon":15,"path":16,"stem":17,"children":243,"page":39},[244,245,246,247,248],{"title":20,"path":21,"stem":22},{"title":24,"path":25,"stem":26},{"title":28,"path":29,"stem":30},{"title":32,"path":33,"stem":34},{"title":36,"path":37,"stem":38},{"title":41,"icon":42,"path":43,"stem":44,"children":250},[251,252,253,254,255,256,257,258,259,260],{"title":47,"path":43,"stem":44},{"title":49,"path":50,"stem":51},{"title":53,"path":54,"stem":55},{"title":57,"path":58,"stem":59},{"title":61,"path":62,"stem":63},{"title":65,"path":66,"stem":67},{"title":69,"path":70,"stem":71},{"title":73,"path":74,"stem":75},{"title":77,"path":78,"stem":79},{"title":81,"path":82,"stem":83},{"title":85,"path":86,"stem":87},{"title":89,"icon":90,"path":91,"stem":92,"children":263,"page":39},[264,265,266,267],{"title":95,"path":96,"stem":97},{"title":99,"path":100,"stem":101},{"title":103,"path":104,"stem":105},{"title":107,"path":108,"stem":109},{"title":111,"path":112,"stem":113},{"title":115,"icon":116,"path":117,"stem":118,"children":270,"page":39},[271,272,273,274,275,276,280],{"title":121,"path":122,"stem":123},{"title":125,"path":126,"stem":127},{"title":129,"path":130,"stem":131},{"title":133,"path":134,"stem":135},{"title":137,"path":138,"stem":139},{"title":141,"path":142,"stem":143,"children":277},[278,279],{"title":146,"path":142,"stem":143},{"title":148,"path":149,"stem":150},{"title":152,"path":153,"stem":154},{"title":156,"path":157,"stem":158},{"title":160,"icon":161,"path":162,"stem":163,"children":283,"page":39},[284,285,286,287,288,289,290,291],{"title":166,"path":167,"stem":168},{"title":170,"path":171,"stem":172},{"title":174,"path":175,"stem":176},{"title":178,"path":179,"stem":180},{"title":182,"path":183,"stem":184},{"title":186,"path":187,"stem":188},{"title":190,"path":191,"stem":192},{"title":194,"path":195,"stem":196},{"title":198,"icon":199,"path":200,"stem":201,"children":293},[294,295,296],{"title":198,"path":200,"stem":201},{"title":205,"path":206,"stem":207},{"title":209,"path":210,"stem":211},{"title":213,"icon":214,"path":215,"stem":216,"children":298,"page":39},[299,300,301,302],{"title":219,"path":220,"stem":221},{"title":223,"path":224,"stem":225},{"title":227,"path":228,"stem":229},{"title":231,"path":232,"stem":233},{"title":235,"path":236,"stem":237},{"id":305,"title":178,"body":306,"contributors":605,"description":621,"editUrl":622,"extension":623,"meta":624,"navigation":625,"path":179,"seo":626,"stem":180,"updatedAt":627,"__hash__":628},"wiki_en\u002Fwiki\u002Fguides\u002Fmigration.md",{"type":307,"value":308,"toc":592},"minimark",[309,313,318,326,329,337,340,345,348,376,380,383,387,394,397,407,411,414,569,573,576,579,582,585],[310,311,312],"p",{},"LuckPerms is able to automatically import permissions data from other plugins - we call this system \"migration\".",[314,315,317],"h2",{"id":316},"intro","Intro",[310,319,320,321,325],{},"It should be noted that these scripts are not perfect. They will do a pretty decent job at converting all of your existing data, and work perfectly in ",[322,323,324],"em",{},"most cases",". However, not all data is the same, and there are sometimes things I haven't accounted for.",[310,327,328],{},"LuckPerms has some similarities with other permission plugins, however, some parts are fundamentally different, and therefore sometimes automatic migration is tricky.",[310,330,331,332,336],{},"Additionally, letting the plugin migrate all of your data for you means you will not have a chance to learn any of the LuckPerms commands. This may become an issue later on. 😉 If you're migrating from PermissionsEx or GroupManager, you might ",[333,334,335],"a",{"href":220},"find this page useful",".",[310,338,339],{},"If you have an old permissions setup, or a setup you're not completely happy with, now might be a great time to have a restructure and cleanup, and a chance to learn LuckPerms commands in the process!",[341,342,344],"h3",{"id":343},"supported-plugins","Supported plugins",[310,346,347],{},"Migration is supported for:",[349,350,351,355,358,361,364,367,370,373],"ul",{},[352,353,354],"li",{},"GroupManager",[352,356,357],{},"PermissionsEx (Bukkit\u002FSpigot only)",[352,359,360],{},"zPermissions",[352,362,363],{},"bPermissions",[352,365,366],{},"PermissionsBukkit",[352,368,369],{},"PowerRanks",[352,371,372],{},"UltraPermissions",[352,374,375],{},"BungeePerms (migration can only be performed on the proxy)",[314,377,379],{"id":378},"the-process","The process",[310,381,382],{},"The migration process is fairly simple, however it varies slightly for each platform.",[341,384,386],{"id":385},"step-1-install-luckperms","Step 1: Install LuckPerms",[310,388,389,390,393],{},"Firstly, you need to ",[333,391,392],{"href":200},"install LuckPerms",". Don't remove your old permissions plugin yet.",[310,395,396],{},"Ensure that your old permissions plugin is still enabling properly. The migration process won't work if your old setup is broken.",[310,398,399,400,403,404,336],{},"If you intend to change your data ",[333,401,402],{"href":236},"storage type",", for instance, to mysql, it is easiest to do this now. If you decide to change storage types after the migration, follow the instructions in ",[333,405,406],{"href":191},"Switching Storage Types",[341,408,410],{"id":409},"step-2-install-the-correct-migration-plugin","Step 2: Install the correct migration plugin",[310,412,413],{},"Download the jar that corresponds to your existing permission plugin from the table below. Add it to your plugins folder too.",[415,416,417,433],"table",{},[418,419,420],"thead",{},[421,422,423,427,430],"tr",{},[424,425,426],"th",{},"Plugin",[424,428,429],{},"Migration Jar",[424,431,432],{},"Migration Command",[434,435,436,455,472,488,504,520,536,552],"tbody",{},[421,437,438,441,449],{},[439,440,354],"td",{},[439,442,443],{},[333,444,448],{"href":445,"rel":446},"https:\u002F\u002Fci.lucko.me\u002Fjob\u002Fluckperms-migration\u002FlastSuccessfulBuild\u002Fartifact\u002Fgroupmanager\u002Fbuild\u002Flibs\u002Fluckperms-migration-groupmanager.jar",[447],"nofollow","luckperms-migration-groupmanager.jar",[439,450,451],{},[452,453,454],"code",{},"\u002Fmigrate-groupmanager",[421,456,457,460,467],{},[439,458,459],{},"PermissionsEx",[439,461,462],{},[333,463,466],{"href":464,"rel":465},"https:\u002F\u002Fci.lucko.me\u002Fjob\u002Fluckperms-migration\u002FlastSuccessfulBuild\u002Fartifact\u002Fpermissionsex\u002Fbuild\u002Flibs\u002Fluckperms-migration-permissionsex.jar",[447],"luckperms-migration-permissionsex.jar",[439,468,469],{},[452,470,471],{},"\u002Fmigrate-permissionsex",[421,473,474,476,483],{},[439,475,360],{},[439,477,478],{},[333,479,482],{"href":480,"rel":481},"https:\u002F\u002Fci.lucko.me\u002Fjob\u002Fluckperms-migration\u002FlastSuccessfulBuild\u002Fartifact\u002Fzpermissions\u002Fbuild\u002Flibs\u002Fluckperms-migration-zpermissions.jar",[447],"luckperms-migration-zpermissions.jar",[439,484,485],{},[452,486,487],{},"\u002Fmigrate-zpermissions",[421,489,490,492,499],{},[439,491,363],{},[439,493,494],{},[333,495,498],{"href":496,"rel":497},"https:\u002F\u002Fci.lucko.me\u002Fjob\u002Fluckperms-migration\u002FlastSuccessfulBuild\u002Fartifact\u002Fbpermissions\u002Fbuild\u002Flibs\u002Fluckperms-migration-bpermissions.jar",[447],"luckperms-migration-bpermissions.jar",[439,500,501],{},[452,502,503],{},"\u002Fmigrate-bpermissions",[421,505,506,508,515],{},[439,507,366],{},[439,509,510],{},[333,511,514],{"href":512,"rel":513},"https:\u002F\u002Fci.lucko.me\u002Fjob\u002Fluckperms-migration\u002FlastSuccessfulBuild\u002Fartifact\u002Fpermissionsbukkit\u002Fbuild\u002Flibs\u002Fluckperms-migration-permissionsbukkit.jar",[447],"luckperms-migration-permissionsbukkit.jar",[439,516,517],{},[452,518,519],{},"\u002Fmigrate-permissionsbukkit",[421,521,522,524,531],{},[439,523,369],{},[439,525,526],{},[333,527,530],{"href":528,"rel":529},"https:\u002F\u002Fci.lucko.me\u002Fjob\u002Fluckperms-migration\u002FlastSuccessfulBuild\u002Fartifact\u002Fpowerranks\u002Fbuild\u002Flibs\u002Fluckperms-migration-powerranks.jar",[447],"luckperms-migration-powerranks.jar",[439,532,533],{},[452,534,535],{},"\u002Fmigrate-powerranks",[421,537,538,540,547],{},[439,539,372],{},[439,541,542],{},[333,543,546],{"href":544,"rel":545},"https:\u002F\u002Fci.lucko.me\u002Fjob\u002Fluckperms-migration\u002FlastSuccessfulBuild\u002Fartifact\u002Fultrapermissions\u002Fbuild\u002Flibs\u002Fluckperms-migration-ultrapermissions.jar",[447],"luckperms-migration-ultrapermissions.jar",[439,548,549],{},[452,550,551],{},"\u002Fmigrate-ultrapermissions",[421,553,554,557,564],{},[439,555,556],{},"BungeePerms",[439,558,559],{},[333,560,563],{"href":561,"rel":562},"https:\u002F\u002Fci.lucko.me\u002Fjob\u002Fluckperms-migration\u002FlastSuccessfulBuild\u002Fartifact\u002Fbungeeperms\u002Fbuild\u002Flibs\u002Fluckperms-migration-bungeeperms.jar",[447],"luckperms-migration-bungeeperms.jar",[439,565,566],{},[452,567,568],{},"\u002Fmigrate-bungeeperms",[341,570,572],{"id":571},"step-3-restart-your-server-then-run-the-migration-command","Step 3: Restart your server, then run the migration command.",[310,574,575],{},"Restart the server to allow your existing plugin, LuckPerms, and the migration plugin to load correctly.",[310,577,578],{},"Then, go to your server console and run the migration command listed in the table above.",[310,580,581],{},"Sit back, relax, and let LuckPerms handle the rest! You will be notified of the migration progress, and then notified again once it has finished.",[310,583,584],{},"When the process has finished, stop the server, remove the your old permissions plugin and the migration jar, then start your server again.",[310,586,587,588,591],{},"If you're migrating from GroupManager or PermissionsEx, there are some additional resources ",[333,589,590],{"href":220},"here"," which may be useful!",{"title":593,"searchDepth":594,"depth":594,"links":595},"",3,[596,600],{"id":316,"depth":597,"text":317,"children":598},2,[599],{"id":343,"depth":594,"text":344},{"id":378,"depth":597,"text":379,"children":601},[602,603,604],{"id":385,"depth":594,"text":386},{"id":409,"depth":594,"text":410},{"id":571,"depth":594,"text":572},[606,610,614,618],{"name":607,"username":608,"avatar":609},"Luck","lucko","https:\u002F\u002Fgithub.com\u002Flucko.png?size=80",{"name":611,"username":612,"avatar":613},"Sam Goodger","Turbotailz","https:\u002F\u002Fgithub.com\u002FTurbotailz.png?size=80",{"name":615,"username":616,"avatar":617},"powercas_gamer","powercasgamer","https:\u002F\u002Fgithub.com\u002Fpowercasgamer.png?size=80",{"name":619,"username":619,"avatar":620},"zeronerve","https:\u002F\u002Fgithub.com\u002Fzeronerve.png?size=80","Move to LuckPerms from another permissions plugin.","https:\u002F\u002Fgithub.com\u002FTurbotailz\u002Fwiki\u002Fedit\u002Fv3-structure\u002Fen\u002Fguides\u002Fmigration.md","md",{},true,{"title":178,"description":621},"2026-09-11T10:20:37+10:00","65CEXlbCBPzXVzvXD8rggwbrIAPnMCTg5PwlOzhdOtA",[630,631],{"title":174,"path":175,"stem":176,"children":-1},{"title":182,"path":183,"stem":184,"children":-1},1792996654195]