How to Configure Multiverse-Core on a Minecraft Server
Create, import, configure, and permission multiple worlds without losing track of access, spawn points, generators, or per-world rules. This guide covers install order, first startup, LuckPerms permissions, config files, use-case presets, integrations, performance checks, common failures, and admin FAQ.
Audience
Admins running survival plus resource, creative, event, skyblock, or lobby worlds.
Install Jar
Multiverse-Core.jar.
Tested Stack
Paper or Purpur 1.20.6 to 1.21.x, Java 21, LuckPerms for permissions, and a staging server before production changes.
What Multiverse Does
Multiverse-Core should be treated as part of your server architecture, not as a random jar dropped into production. The safe workflow is to define the job the plugin owns, decide which groups can touch it, test the generated files on staging, then move only the reviewed configuration to the live server.
For Multiverse, the main job is: Create, import, configure, and permission multiple worlds without losing track of access, spawn points, generators, or per-world rules. That means every setting should support a concrete player workflow or staff workflow. If a setting does not have an owner, a test, and a rollback path, leave it at the generated default until you have a reason to change it.
The most common failure pattern is configuring the plugin as OP, seeing it work, and assuming players are ready. Operators bypass too much. For every section below, create a temporary non-OP account in the target LuckPerms group and test the exact command or interaction that normal players will use.
Keep a small audit note beside the config. Record the plugin version, the file paths changed, the exact permissions granted, the test account used, the commands verified, and the rollback file or database backup to restore. When another plugin depends on Multiverse, repeat the same test after updates because the failing part may be the bridge, provider, world context, or display plugin rather than Multiverse itself. Keep the note in your operations runbook.
Installation and First Startup
Back up the server before installing Multiverse-Core. At minimum, keep a copy of the existing plugins folder, the world data if the plugin touches worlds or claims, and any database used by related plugins. Upload Multiverse-Core.jar. into the plugins folder, then perform a full restart so Bukkit, Paper, or Purpur loads the plugin cleanly.
On first startup, do not edit every generated file immediately. Let the plugin create its folder, read the startup log, then run a small command or player action to prove the plugin is alive. The first goal is a known-good baseline. After that, make one config change at a time.
First startup checklist
- Run /mv version and /mv list.
- Import a copied test world before touching production worlds.
- Confirm each world appears in worlds.yml.
- Test teleport permissions with a non-OP account.
LuckPerms Permission Setup
Configure Multiverse-Core permissions through groups. A clean setup usually has default, trusted, helper, moderator, admin, and owner groups. Default players get only the commands required for normal gameplay. Staff groups get narrow operational permissions. Owner keeps destructive, economy-changing, rollback, purge, import, or wildcard permissions.
Use this pattern for every permission below. Replace the group and permission with the row you are granting. Run the command from console or as an owner, then test with a non-OP player in that group.
/lp group <group> permission set <permission> true
/lp group <group> permission check <permission>
/lp user <player> parent add <group>multiverse.core.tp.selfGrant to trusted: Allows teleporting self through Multiverse.
multiverse.access.resourceGrant to default: Allows access to a named world when access checks are used.
multiverse.core.createGrant to owner: World creation can consume disk and affect server state.
multiverse.core.importGrant to owner: World imports should be staged and backed up.
Command Workflows
Commands are not just a reference list. They are the operational workflows your staff will use under pressure. Write the exact command patterns into your runbook and include which group may run each one. For sensitive commands, test with a preview, a limited radius, a staging world, or a throwaway account before using them live.
/mv create resource normalCreate a normal overworld-style resource world.
/mv import oldworld normalImport an existing world folder.
/mv tp resourceTeleport to a managed world.
/mv modify set gamemode survival resourceSet a world option through Multiverse.
/mv setspawnSet the spawn point for the current Multiverse world.
/mv reloadReload Multiverse configuration after supported edits.
Config File Deep Dive
The config files below are the parts of Multiverse most likely to matter on a real server. Do not copy a random full config from another network. Generated files change between plugin versions, and old examples can silently disable modern safeguards. Keep the generated comments, change only the setting you understand, then reload or restart using the plugin-specific path.
For every setting, write down the old value, the new value, why it changed, and how to back out. This is slower than editing blindly, but it prevents mystery behavior three weeks later when another admin tries to debug the server.
worlds.yml
plugins/Multiverse-Core/worlds.yml
Stores per-world settings such as aliases, environment, game mode, difficulty, spawn, and generator metadata.
Recommendation: Use commands for most changes and back up before manual edits.
config.yml
plugins/Multiverse-Core/config.yml
Controls global Multiverse behavior.
Recommendation: Keep defaults until world access and teleport behavior are tested.
World access permissions
LuckPerms
Access nodes can restrict which groups enter worlds.
Recommendation: Use explicit access nodes for staff-only, event, or creative worlds.
Generator settings
worlds.yml
Tracks custom generator names and options.
Recommendation: Install generator plugins before world creation or import.
Spawn settings
worlds.yml
Stores per-world spawn location.
Recommendation: Set spawns after terrain is safe and protected.
Use-Case Configs
A good Multiverse setup depends on the type of server. Survival wants stability and player trust. Creative wants build speed and plot safety. Skyblock and economy modes care about item generation and abuse loops. Use these presets as decision checklists, then convert them into exact config changes for your own server.
Resource world
A resettable world for mining and exploration.
- Create or import resource.
- Deny permanent claims if needed.
- Set access permission.
- Create clear portal or command path.
- Document reset schedule.
Creative world
Separate creative gameplay from survival economy.
- Create creative world.
- Set creative gamemode.
- Use separate inventory plugin if needed.
- Restrict economy commands by world context.
Event world
Temporary event worlds need strict access and cleanup.
- Import event map.
- Grant access to event group.
- Set spawn.
- Protect with WorldGuard.
- Unload when finished.
Plugin Integrations
Most Minecraft plugin problems happen at the boundary between plugins. Multiverse may load correctly while the full workflow still fails because a dependency, bridge, economy provider, permission group, display plugin, or world manager is missing. Check integrations during startup and after every plugin update.
LuckPerms
World contexts and access nodes control who can enter or use commands in each world.
WorldGuard
Protect spawns and event builds per world.
CoreProtect
Log grief in build worlds and avoid logging short-lived test worlds if retention matters.
PlaceholderAPI
Display current world names in scoreboards and menus.
Performance and Maintenance
Performance tuning starts with scope. Do not enable every module, world, render, placeholder, command, or log type just because the plugin supports it. Enable the parts that support your server design, measure the impact, and keep a short maintenance checklist for future updates.
- Unload unused worlds instead of keeping every test map active.
- Pregenerate large worlds with Chunky before public exploration.
- Do not import worlds directly into production without a backup.
- Keep resource world resets procedural and documented.
Common Errors and Fixes
When Multiverse misbehaves, separate facts from guesses. Capture the command used, player group, world, plugin version, and console output. Then work through the smallest reproducible test instead of changing five settings at once.
World import fails
- World folder is in the server root.
- Environment type matches.
- Folder is not corrupt.
- No duplicate world name exists.
Fix: Test import on staging and verify the environment argument before trying production.
Players cannot teleport to a world
- They have teleport permission.
- They have access permission.
- World is loaded.
- Another plugin blocks teleport.
Fix: Grant the exact access node and test /mv tp as non-OP.
Wrong gamemode after world change
- worlds.yml gamemode value.
- Multiverse enforce setting.
- Other gamemode plugins.
- LuckPerms world context.
Fix: Set the world gamemode through /mv modify and remove conflicting plugin rules.
Multiverse-Core FAQ
Should I configure Multiverse-Core on a live production server?
Use a staging copy for the first setup, then move the finished configuration to production during a quiet period. Multiverse-Core may read files, register commands, or touch player data during startup, so testing on a copy prevents avoidable downtime.
Can I use /reload after changing Multiverse-Core?
Avoid the global /reload command. Use /mv reload when the plugin supports it, or schedule a normal restart when the change affects dependencies, database settings, worlds, generated regions, or plugin jars.
Where should I keep backups before changing Multiverse-Core?
Back up the plugin data folder, the jar you are replacing, and any database tables used by the plugin. Keep the backup outside the live plugins folder so a later cleanup or plugin scan cannot accidentally load it.
How should I grant permissions for Multiverse-Core?
Grant permissions to LuckPerms groups, not individual players. Use a small default group, a trusted staff group, and an owner group. Temporary exceptions should use LuckPerms temporary permissions with a clear expiration.
Why does Multiverse-Core work for operators but not normal players?
Operators bypass many checks, so OP testing is not enough. Test with a non-OP account in the default group and watch the console for missing permission messages or plugin-specific deny output.
How do I know whether Multiverse-Core loaded correctly?
Check the startup log for the plugin name, run the main info command, confirm the data folder was created, and test one normal player workflow. Do not assume the plugin is ready just because it appears in /plugins.
Should I edit generated config files by hand?
Yes, but keep comments, indentation, and encoding intact. YAML and HOCON are strict enough that one bad indent or missing quote can stop a plugin from loading its configuration.
How often should I review Multiverse-Core settings?
Review the config after major Minecraft updates, plugin major releases, and changes to your server mode. Survival, skyblock, creative, and proxy networks usually need different defaults.
What is the safest way to update Multiverse-Core?
Read the changelog, back up the existing jar and data folder, test the new version on staging, then replace the jar during a normal restart. Do not hot swap core plugins that hold data or hook deeply into server internals.
How do I document the final Multiverse-Core setup?
Write down the plugin version, config files changed, permissions granted, commands staff use, and rollback steps. Store that note beside your server runbook so another admin can recover the setup later.
Official References
Check the upstream documentation before changing version-specific settings. This tutorial avoids full copied configs because plugin defaults and generated comments can change between releases.