Personal homes with a configurable GUI, optional team homes via PerfTeams, staff tools, and imports from other home plugins.
Paper and Folia 1.21 - 26.x
Support
Report bugs and get support here: https://discord.gg/VvM6k2eBDa
Features
• Folia support – Safe for Folia; listed in plugin.yml as folia-supported.
• Paper 1.21.x – Built for the Paper API (api-version 1.21).
• SQLite & MySQL – HikariCP pool; default SQLite file, optional MySQL in config.
• Home GUI – /home and /sethome open a menu; layouts compact (5), medium (13), or extended (20 slots) via gui.yml files.
• Commands & chat – List, delete, rename by slot or name; /home (name) or /home (number) teleports without opening the GUI.
• Teleport rules – Configurable delay, cancel on move/damage, actionbar countdown, teleport sound; perfhomes.bypassdelay skips delay.
• Home limits – Default count from config plus higher caps via perfhomes.limit.1 / .3 / .5 / .10 (highest permission wins).
• Naming rules – Min/max length and regex pattern in config (spaces allowed in default naming style).
• World & region locks – Block /sethome in listed worlds and optional WorldGuard region names when WorldGuard is present.
• PerfTeams – Team home slot, permissions, set/delete/teleport when PerfTeams is installed (loadafter/softdepend).
• Migration – /perfhomes migrate from EssentialsX userdata, HuskHomes (SQLite or MySQL), SimpleHomes YAML, ModernHome SQLite/MySQL; paths and DB settings in config.
• Staff & mod roles – /perfhomes uses perfhomes.staff; each subcommand checks perfhomes.admin, perfhomes.(sub), or admin.mod-permissions rows (YAML keys map to perfhomes.mod-style permissions).
• Messages – MiniMessage-based messages.yml; config-version migrations on load.
Commands
/home – Open homes GUI (perfhomes.use)
/home list – List your homes in chat (perfhomes.use)
/home delete (name|number) – Delete a home by name or slot (perfhomes.use)
/home rename (number) (newname) – Rename the home in that slot (perfhomes.use)
/home (name) – Teleport to a home by name; use multiple words for spaced names (perfhomes.use)
/home (number) – Teleport to the home in that slot; single numeric argument 1–99 only (perfhomes.use)
/sethome – Open GUI to set or manage homes (perfhomes.use)
/delhome – Open GUI to delete or manage homes (perfhomes.use)
/delhome (name|number) – Delete by home name or slot (perfhomes.use)
/renamehome (old) (new) – Rename a home (perfhomes.use)
/perfhomes – Show admin help lines you are allowed to see (perfhomes.staff; help gate via ModPermissions)
/perfhomes help – Same as above (perfhomes.staff; help gate)
/perfhomes reload – Reload plugin configuration (perfhomes.staff; reload gate)
/perfhomes list (player) – List a player’s homes (perfhomes.staff; list gate)
/perfhomes delete (player) (home name…) – Delete one home for a player (perfhomes.staff; delete gate)
/perfhomes deleteall (player) – Delete all homes for a player (perfhomes.staff; deleteall gate)
/perfhomes tp (player) (home name…) – Teleport to a player’s home; must be a player (perfhomes.staff; tp gate)
/perfhomes sethome (player) (home name…) – Set a player’s home at your location; must be a player (perfhomes.staff; sethome gate)
/perfhomes migrate (source) – Import homes; source: essentialsx, huskhomes, simplehomes, modernhomes (perfhomes.staff; migrate gate)
Database
• SQLite (default, file path in config)
• MySQL (optional, database.type mysql)
