Case Study - Rebuilding SetHomes from scratch, with a menu, dimension-aware blacklisting, and safe migration from v1

Overview

After running SetHomes on our own servers for a few years, we had a pretty clear list of what we'd do differently. SetHomesTwo is that list, built.

Homes now come with a /homes GUI menu alongside the classic chat commands, so players don't have to memorize home names to get around. Admins get per-dimension blacklisting instead of just per-world, so a home can be blocked in the Nether without touching the overworld or the End. Every home can carry a custom icon via defaultHomeItem, and all of it — home limits, teleport cooldown, teleport delay, every message a player sees — is still controlled from a single config file.

The part we're most proud of is the migration path. Server owners already running SetHomes v1 or EssentialsX can install SetHomesTwo and run /import-homes sethomes or /import-homes essentialsx as a dry run first — it reports exactly how many homes it would bring over and flags anything it would skip, without touching a single file. Running it again with confirm is the only thing that actually writes data, and it never overwrites a home that already exists. We didn't want anyone to lose home data trusting our plugin.

What's in it

Commands