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.