Update | 1.20.4 to 1.21

This guide will explain how to update all of our setups from 1.20.4 to 1.21. If your setup is running on 1.20.4, this is the guide to follow.

Update released: 8th August 2024

Start by downloading the latest version of the setup you are using on BuiltByBit. All of our setups has been updated to 1.21 now.

Before completing all the step below, please STOP your server to avoid any file corruption!

1. Updating the plugins

First step is to update all of the plugins in the setup. The easiest way to do this is to download the latest version of our setup. Then go through all the plugins on your server 1 by 1 in alphabetical order. Delete the plugin on your server and replace it with the same plugin from the latest version of the setup. Below you can see a list of the plugins which requires updating:

List of plugins which require updating

Below is a list of all the plugins which require updating in our setups. Each of our setups only contain some of the plugins on this list. You should just ignore the plugins on this list which your server doesn't include. As an example, the AxGens plugin is only in our Gens Setup, and LifestealCore is only in our Lifesteal Setup.

ajLeaderboards ajParkour AuraSkills AxGens BetterTeams BlockParticles ChatEmojis Citizens CMILib Codex commandtimer CrazyVouchers DeathMessages DecentHolograms DeluxeHub DiceFurniture EasyCommandBlocker EssentialsX EssentialsXSpawn ExcellentCrates ExcellentEnchants FastAsyncWorldEdit ForcePack FurnitureLib IllegalStack InteractiveChat Jobs LevelledMobs LifestealCore Lottery Minepacks MythicMobs NexEngine nightcore PlaceholderAPI PlayerAuctions PlayerWarps ProtocolLib Quests SaberFactions sellwand Skript SuperiorSkyblock TAB Themis UltraCosmetics ViaVersion worldguard WorldGuardExtraFlags

2. Deleting and adding new plugins

In our 1.21 update, some of the plugins used has been replaced with new better ones. The old plugins which needs to be deleted are marked with red below, and the plugins which you should replace them with are marked with green. If your setup doesn't have 1 or more of the plugins marked with red, then you can just ignore the plugin change.

AutoTool > BestTools SmoothSleep > sleep-most skript-fishing > MorkatzSk (No plugins folder)

NOTE: You also have to delete/add BOTH the plugin itself and the plugins folder for these plugins.

3. Update ForcePack config

All of our setups uses the ForcePack plugin to handle the resourcepack. To update the ForcePack config, replace the file at this filepath on your server with the one at the same filepath from the latest version of the setup: plugins > ForcePack > config.yml

You can ignore this step if you are using ItemsAdder or Oraxen instead of ForcePack.

4. Update TAB config

All of our setups uses the TAB plugin. You have to update the config. Replace the file at this filepath on your server with the one at the same filepath from the latest version of the setup: plugins > TAB > config.yml

5. Update BetterRTP config

If your setup includes the BetterRTP plugin, you have to update the config. Replace the file at this filepath on your server with the one at the same filepath from the latest version of the setup: plugins > BetterRTP > config.yml

6. Update Quests config

If your setup includes the Quests plugin, you have to update the config. Replace the file at this filepath on your server with the one at the same filepath from the latest version of the setup: plugins > Quests > config.yml

7. Update autotool setting

Because of the change from AutoTool > BestTools, the settings menu has to be updated. Replace the file at this filepath on your server with the one at the same filepath from the latest version of the setup: plugins > DeluxeMenus > gui_menus > settings > settings_2.yml

NOTE: This step only applies to setups which has this file.

8. Update custom fishing script

Because of the change from skript-fishing > MorkatzSk, the customfishing script has to be updated. Replace the file at this filepath on your server with the one at the same filepath from the latest version of the setup: plugins > Skript > scripts > customfishing.sk

NOTE: This step only applies to setups which has this file.

9. Update Commandtimer plugin folder

If you are using a setup which includes the Commandtimer plugin, delete the Commandtimer plugins folder on your server and replace it with the same plugins folder from the latest version of the setup. This plugin is only used in our Dungeons Setup and Dungeons Addon, so if you are using the Dungeons Addon, that is where you would find the updated plugins folder.

NOTE: This step only applies to setups which has this Commandtimer plugin.

10. Clear problematic libraries

To avoid any issues, you should delete all of these files on your server to clear the libraries and let the plugins regenerate them for 1.21. Delete the files/folders at these filepaths:

plugins > Citizens > lib

plugins > PlayerAuctions > expansions, expansions.yml

plugins > LevelledMobs (Just the plugins folder, not .JAR)

plugins > DeathMessages (Just the plugins folder, not .JAR)

11. Adding ExcellentEnchants plugin

In the 1.21 update, we have added the ExcellentEnchants plugin to all of our setups in which the Dungeons Addon is available. Upload the ExcellentEnchants plugin and plugin folder from the latest version of the setup to your server.

NOTE: This step should by applied to these setups: Survival, Earth Survival, Towny, Skyblock, Gens Factions and Lifesteal already has ExcellentEnchants

12. Adding permissions

The update is almost completed now. This last step has to be applied while your server is running. So go ahead and start your server on Paper or Purpur 1.21.

When your server is running, enter these 2 commands in your console:

/lp group default permission set besttools.use
/lp group default permission set essentials.warp.list

Update Completed

If you have followed all of these steps, the update would be complete. If you have any issues with the setup after updating, please contact us on discord. Issues will most likely occur as the Minecraft 1.21 update is huge. But don't worry, we will help solve all issues with our setups on our discord server!

Last updated 2 months ago