UABlockConverter V1.0

Convert uSkyblock files to aSkyblock!

  1. Tastybento

    Warning this only works for uSkyBlock versions up to 2.6.17. After that, versions (2.7.x) do not work.

    A converter for uSkyblock to aSkyblock.

    This plugin converts files between the uSkyblock files and aSkyblock plugin. It is easy to use and low-risk because no changes are made to your uSkyblock folder or world.

    • Enables uSkyblock plugin users to transition to aSkyblock
    • One command usage - uaconvert
    • Keeps current uSkyblock world
    1. Back up everything! Just in case - no changes are made to the world or uSkyblock folders.
    2. Keep players off the server or do the conversion on a copy of your server.
    3. Download askyblock.jar and place in your in plugins folder.
    4. Start server - this will create the askyblock folders and files and the askyblock world and nether. VERY IMPORTANT.
    5. Stop the server.
    6. Remove askyblock.jar and uskyblock.jar from the plugins folder. The converter will not run if these plugins are active.
    7. Remove the *world* folders (not plugin folders) askyblock and askyblock_nether because askyblock will use you uSkyblock world after conversion.
    8. Make a copy of askyblock's config.yml for reference later.
    9. Place this plugin uaconv.jar in the plugins folder and start the server.
    10. Did you remember to back up? Good.
    11. If you run a 100% offline server then type uaconvert offline in the console, otherwise type uaconvert.
    12. Did nothing happen? If so, look through your console and find out why the plugin was disabled - it will tell you why. Correct that and reload.
    13. Did you get UUID errors? That may be due to Mojang thinking you are DDOSing them - try a different machine or time. Alternatively, it could be that you cannot connect to Mojang.
    14. After it is complete (see below for what it does and does not do), stop the server.
    15. Look through the console log and see what happened. It tries to explain what went on. You may want to save the log for later.
    16. Remove uaconv.jar.
    17. Copy askyblock.jar back into the plugins folder.
    18. Check askyblock's config.yml to make sure it's correct and how you like. When it is converted, the comments are lost so use the copy from #5 for reference.
    19. If you want a different starter island to the default one, then replace island.schematic. Note there are rules about what it must have to be acceptable. (See here for a How To).
    20. (optional) Have a look in plugins/ASkyBlock/players and see that it is full of player files - it should be. (Note that all files in the ASkyBlock/islands folder are zero length - just file names)
    21. Restart the server
    22. (optional) Follow the set up instructions in the main plugin page, like checking the nether, establishing a spawn etc.
    23. Write a glowing review, or donate a few bucks so little Jenny can get shoes this year.:p
    24. You are done!

    What is and is not converted
    The following will be converted:
    • The uSkyBlock world - actually, nothing has to change here.
    • config.yml settings for: world name, chest items, reset cool down timer, distance between islands, protection range, island height, island level, max team size, remove creatures by teleport and whether PVP is allowed or not.
    • Island data for: island owner and team members, island location, home location of each player.
    • UUID's for each player - this is done by asking Mojang for UUID's or making them locally for offline players.
    What is not converted:
    • Challenges - the challenges are different and I've no idea what customization you may have done to them. As a result all challenges are reset for players. This may result in a mini boon for players as they yet again get to finish the cobble challenge (woohoo).
    • Bonus chest items - I don't have this option in askyblock - just the basic.
    • Level calculations - A Skyblock calculates levels differently to uSkyblock - it's similar, but will result in different level values. Although the levels are copied over, as soon as a player types /is level it will be recalculated the A Skyblock way.
    • A few other misc settings, like island lock, use/not use top ten, which don't exist in askyblock.
    • This plugin has successfully converted a number of large worlds, but I've learned that there are a lot of different setups out there. Please let me know how it goes. At no point will the uSkyblock world or config files be altered, so this is a low-risk test.


    1. utoA.png

Recent Reviews

  1. CrYT_GamingHD
    Version: V1.0
    A big thanks to you that you made this! uSkyBlock has some Bugs but my server in public and if I simply changed the plugin every island were lost. BUT you made this that I can easy convert it into the better skyblock plugin
  2. The_bird
    Version: V1.0
    Very good plug-in, it took a long time. Will the author allow me to reprint this plug-in to China's MCBBS? I will keep the original author's information and the original post
  3. UnioDex
    Version: V1.0
    Does exactly what it tells. It needs an update right now but author has no time for it. If you are using uSkyBlock 2.6 or lower it will work for you. This will not import challenges, warps but they are not that necessary :D

    -Set timeout-time: 86400 or more in spigot.yml before conversion. It will prevent crashes.
    - After conversion done, set your -Xmx as high as possible in your Whitelist and restart server your server. Join and create an island. It will add every exist islands to islands.yml. This process might be long.
  4. RepublicanSensei
    Version: V1.0
    Well done!
  5. Johandrex
    Version: V0.6
    An awesome replacement for the uSkyblock plugin!