MMORPG Bootstrapper v1.0

MMORPG Bootstrapper

MMORPG Bootstrapper is a Paper plugin that automatically runs your WorldEdit-based world bootstrap exactly once. It pastes all generated structures from your manifest, adapts terrain, avoids protected WorldGuard regions, protects settlements from hostile mobs, corrects NPC/shopkeeper positions, and places players directly at a safe tutorial spawn without relying on spawnRadius.

Instead of running dozens of WorldEdit pastes and cleanup steps by hand, the plugin reads your generated placement manifest, pastes every city, dungeon, road marker, and other structure in the correct order, and records completion so the bootstrap does not accidentally run again on the next restart.

It is built specifically for large pre-generated MMORPG-style maps where simple paste-at-Y workflows are not enough, and where the first player login needs to feel polished instead of random.

It can also respect protected WorldGuard/WorldEdit areas by moving structures vertically to the nearest editable placement, while keeping NPCs and shopkeepers aligned with that final shifted structure position.

WorldEdit Schematic Support

The plugin is designed for real WorldEdit or FAWE .schem build packs, not just static server configs. It reads the generated placement manifest, loads the referenced schematics, and pastes the complete build set in the correct order.

This makes the bootstrapper especially useful for marketplace packs and large server setups where the buyer should not have to manually run dozens of //schem load and //paste -a commands. The plugin keeps the schematic workflow reproducible, terrain-aware, and tied to the same manifest used by NPCs, shopkeepers, spawn correction, and protection zones.

What It Does

• Automatically runs a one-time bootstrap on server startup
• Supports manual reruns and reset commands for admins
• Reads placements from plugins/MMORPGPack/build/placements.yml
• Pastes all structures in manifest order
• Loads and pastes WorldEdit/FAWE .schem files from the generated build pack
• Stores bootstrap completion in a persistent state file
• Applies server setup commands such as setworldspawn
• Adjusts world spawn to the actual surface height automatically
• Teleports players to a safe spawn location on login without needing spawnRadius
• Can lock the player spawn to exact configured X/Z coordinates, ideal for spawning exactly two blocks from the first tutorial quest giver
• Can use a Citizens reference NPC such as Herald Teren to keep spawn height aligned with the tutorial scene
• Repositions Citizens NPCs to their final intended locations
• Snaps NPCs to valid surface positions so they do not end up inside the ground
• Corrects Shopkeepers save positions before Shopkeepers loads
• Keeps shopkeepers on their planned X/Z anchors while finding a safe nearby ground height
• Searches for safe nearby locations so players and NPCs do not spawn inside walls
• Aligns structures to real terrain height
• Prevents structures from spawning below sea level
• Avoids protected WorldGuard/WorldEdit regions during structure placement
• Searches vertically for the nearest editable placement while keeping X/Z fixed
• Stores final shifted structure anchors so NPCs and shopkeepers follow the real pasted position
• Builds continuous foundations under floating cities, dungeons, and markers
• Adds terraced terrain transitions so foundations look more natural
• Uses a safer terrain-preparation workflow that avoids tearing giant open holes into the world
• Prevents hostile mobs from spawning inside protected cities and hubs
• Removes hostile mobs that are already inside protected settlement areas
• Cancels hostile targeting when mobs or their targets are inside protected settlement areas
• Prevents block placing and block breaking inside protected cities, dungeons, hubs, and wayfinder areas

Why It Is Useful

• No more manual WorldEdit bootstrap sessions after deployment
• No more floating hubs, buried NPCs, or broken first-login spawns
• No more dependence on fragile spawnRadius handling across server versions
• New players can reliably start directly in front of the first tutorial quest giver
• Shopkeepers stay on intended marketplace positions instead of appearing on roofs
• Better visual results for large structures on uneven terrain
• Safer default behavior for worlds with oceans, rivers, and coastal builds
• Safer deployment into servers that already have protected regions
• Fewer accidental overwrites of admin, spawn, or protected build areas
• Cleaner settlement gameplay without hostile mobs wandering into protected town spaces
• Protected structures stay intact after deployment because players cannot modify them by accident

Best Use Case

This plugin is ideal for packaged MMORPG server setups, custom adventure servers, and large schematic-based world deployments where structures, NPCs, and spawn logic all need to line up automatically on first boot.


Admin Commands

• /mmorpgbootstrap status
• /mmorpgbootstrap run
• /mmorpgbootstrap run --force
• /mmorpgbootstrap reset