Find a Minecraft plugin setup or troubleshooting guide
Find setup and troubleshooting instructions for Minecraft server plugins, grouped by what you want to do. These guides cover individual projects and their integrations; they are not a recommendation to install every plugin together. Start with the smallest set of features your community needs.
Before choosing a plugin
Check the plugin author's supported Minecraft release and server platform before downloading. Paper, a proxy such as Velocity, and a Fabric server require different builds. A guide does not guarantee compatibility with every future release. Some projects require a paid licence; obtain those files from the author through a legitimate account.
Read how to install plugins, keep a completed backup, and test substantial changes away from the only copy of your world. Plugins may keep player data in an external database, which needs its own matching backup. Use the commands and configuration for the exact installed release.
Maps, worlds and land protection
- Set up a BlueMap web map and control rendering load
- Install Dynmap and test a bounded world render
- Publish a squaremap world map with a separate web port
- Add and import Minecraft worlds with Multiverse-Core
- Create a controlled Multiverse-Portal between worlds
- Separate creative and survival inventories with Multiverse-Inventories
- Link Nether and End worlds with Multiverse-NetherPortals
- Load an existing world safely with MyWorlds
- Create a separate creative plot world with PlotSquared
- Set up player land claims with GriefPrevention
- Configure GriefDefender claims and LuckPerms safely
- Create a Lands claim and control member roles
NPCs, menus, quests and progression
- Create and manage a Citizens NPC without granting command access
- Create Shopkeepers player shops and test trades safely
- Build a safe starter menu with DeluxeMenus
- Create a DecentHolograms display and check player visibility
- Set up a FancyHolograms text display on Paper
- Configure an ExcellentCrates test crate and verify rewards
- Set up a CrazyCrates test and troubleshoot crate keys
- Create and test a beginner quest with PikaMug Quests
- Build and diagnose a small BetonQuest conversation
- Set up Jobs Reborn and check that job payments work
- Add mcMMO skills and preserve existing player levels
- Configure AuraSkills progression and test player rewards
Voice chat, voting and community tools
- Set up Simple Voice Chat with an allocated UDP port
- Install Plasmo Voice and diagnose voice connection errors
- Set up Plan analytics without exposing private player data
- Configure NuVotifier and protect vote-receiver credentials
- Create and test Minecraft vote rewards with VotingPlugin
- Customise the Minecraft server list with MiniMOTD
- Maintain an existing ServerListPlus configuration safely
- Control a Minecraft maintenance window with Maintenance
- Set up GSit poses and restrict player interactions
- Configure SkinsRestorer without changing account authentication
- Restore a recorded player inventory with InventoryRollbackPlus
- Use MiniPlaceholders with a compatible Minecraft text plugin
Administration, compatibility and moderation
- Install ProtocolLib and diagnose dependent plugin failures
- Set up PacketEvents for plugins that require it
- Let supported older Java clients join with ViaBackwards
- Evaluate legacy Java client support with ViaRewind
- Set up SuperVanish for a limited staff role
- Configure LiteBans moderation and preserve punishment history
- Set up AdvancedBan with controlled moderation tests
- Introduce GrimAC alerts before automated punishments
- Add and test WorldGuard ExtraFlags in one region
- Replace WorldEdit with FastAsyncWorldEdit safely
- Configure DriveBackupV2 and verify an off-server recovery copy
- Give safe lobby items with ItemJoin
Shops, travel, economy and shared player data
- Create player chest shops with QuickShop-Hikari
- Configure and test an EconomyShopGUI server shop
- Create and protect a ChestShop sign shop
- Set up zAuctionHouse and test item sale recovery
- Create player-owned public warps with Player Warps
- Configure bounded random teleports with BetterRTP
- Set up personal homes and teleport requests with HuskHomes
- Test cross-server inventory synchronisation with HuskSync
- Introduce CMI without conflicting with existing server plugins
- Configure an AdvancedEnchantments trial without risking player gear
- Fix EssentialsXChat prefixes and chat formatting
- Configure first-join spawn and respawn rules with EssentialsXSpawn
Permissions, protection and performance essentials
Already have the basics installed? These existing guides explain common dependencies and the controls used by several plugins above. Check permissions with an ordinary player account as well as an administrator; operator access can conceal a missing permission or bypass a protection rule.
- Create Minecraft ranks and inheritance with LuckPerms
- Connect Vault to an EssentialsX economy
- Install PlaceholderAPI expansions and fix raw placeholders
- Configure a Minecraft TAB list and scoreboard
- Allow compatible Minecraft Java clients with ViaVersion
- Inspect block changes and preview a CoreProtect rollback
- Set up EssentialsX commands and player permissions
- Use WorldEdit selections, limits and undo safely
- Protect a Minecraft spawn with WorldGuard regions
- Connect Minecraft chat to Discord with DiscordSRV
- Pre-generate Minecraft terrain with Chunky and monitor disk space
When a plugin does not work
Save the first useful startup error and record the server, Java and plugin versions. Check dependencies before changing permissions or replacing data. Restart normally after a supported file change; do not repeatedly reload the entire server to bypass a failed plugin. A missing command, an inactive dependency and a blocked network connection need different investigations.
If you need help, open a private support ticket with the relevant server ID, timestamp and redacted logs. Do not post database passwords, voting tokens, bot credentials or remote-storage keys. Keep the original files and last working backup while investigating.
Focused tasks by plugin
Choose a plugin below for individual configuration tasks, checks and recovery steps. These guides complement the setup articles above. Match the instructions to your installed release and keep a recovery copy before changing player data.
Permissions and moderation
- AdvancedBan tasks and troubleshooting
- CoreProtect tasks and troubleshooting
- EssentialsX tasks and troubleshooting
- GrimAC tasks and troubleshooting
- LiteBans tasks and troubleshooting
- LoginSecurity tasks and troubleshooting
- LuckPerms tasks and troubleshooting
- PremiumVanish tasks and troubleshooting
- SuperVanish tasks and troubleshooting
- WorldGuard tasks and troubleshooting
- WorldGuard ExtraFlags tasks and troubleshooting
Worlds, building and maps
- BlueMap tasks and troubleshooting
- Chunky tasks and troubleshooting
- ChunkyBorder tasks and troubleshooting
- Dynmap tasks and troubleshooting
- FastAsyncWorldEdit tasks and troubleshooting
- Multiverse-Core tasks and troubleshooting
- Multiverse-Inventories tasks and troubleshooting
- Multiverse-NetherPortals tasks and troubleshooting
- Multiverse-Portals tasks and troubleshooting
- MyWorlds tasks and troubleshooting
- PlotSquared tasks and troubleshooting
- WorldEdit tasks and troubleshooting
Economies, shops and claims
- ChestShop tasks and troubleshooting
- EconomyShopGUI tasks and troubleshooting
- GriefDefender tasks and troubleshooting
- GriefPrevention tasks and troubleshooting
- Jobs Reborn tasks and troubleshooting
- Lands tasks and troubleshooting
- QuickShop-Hikari tasks and troubleshooting
- Shopkeepers tasks and troubleshooting
- Towny tasks and troubleshooting
- Vault tasks and troubleshooting
Progression, items and quests
- AdvancedEnchantments tasks and troubleshooting
- AuraSkills tasks and troubleshooting
- BetonQuest tasks and troubleshooting
- ItemsAdder tasks and troubleshooting
- mcMMO tasks and troubleshooting
- MythicMobs tasks and troubleshooting
- Nexo tasks and troubleshooting
- Oraxen tasks and troubleshooting
- Quests tasks and troubleshooting
- RoseStacker tasks and troubleshooting
Menus, chat and voice
- DecentHolograms tasks and troubleshooting
- DeluxeMenus tasks and troubleshooting
- DiscordSRV tasks and troubleshooting
- FancyHolograms tasks and troubleshooting
- GSit tasks and troubleshooting
- InteractiveChat tasks and troubleshooting
- MiniMOTD tasks and troubleshooting
- MiniPlaceholders tasks and troubleshooting
- PlaceholderAPI tasks and troubleshooting
- Plasmo Voice tasks and troubleshooting
- ServerListPlus tasks and troubleshooting
- Simple Voice Chat tasks and troubleshooting
- TAB tasks and troubleshooting
Connections, analytics and backups
- DriveBackupV2 tasks and troubleshooting
- Floodgate tasks and troubleshooting
- Geyser tasks and troubleshooting
- HuskHomes tasks and troubleshooting
- HuskSync tasks and troubleshooting
- InventoryRollbackPlus tasks and troubleshooting
- NuVotifier tasks and troubleshooting
- PacketEvents tasks and troubleshooting
- Plan tasks and troubleshooting
- ProtocolLib tasks and troubleshooting
- spark tasks and troubleshooting
- ViaBackwards tasks and troubleshooting
- ViaRewind tasks and troubleshooting
- ViaVersion tasks and troubleshooting
- VotingPlugin tasks and troubleshooting
No comments to display
No comments to display