🏠 HomesPlus - Home Teleportation Plugin

UI IS HERE!!

HomesPlus is a feature-rich home teleportation plugin for Hytale servers. It allows players to set multiple personal home locations and teleport back to them with configurable delays. Perfect for survival servers, RPG servers, or any server where players need quick travel to their bases!

✨ Features

Easy-to-use GUI - Players can use '/homes' to open a GUI to manage or TP to their homes and admin have access to the '/homes admin' GUI to manage server rules and permission groups.
Multiple Homes Per Player - Configurable home limits based on player ranks/permissions
Teleport Delays - Customizable warmup timers before teleporting (configurable per rank)
Teleport Cancellation - Teleports are cancelled if the player moves or takes damage
Cross-World Support - Homes work across different worlds
Persistent Storage - All homes are saved to JSON and persist through restarts
Fully Configurable - All messages, limits, and delays can be customized in config.json

For Singleplayer:

/op self (this makes you an OP of the single player game)

/homes admin (gives you access to the admin GUI to make edits)

If you use /op self again it will remove you from OP so that you're a normal player.

/homes GUI

/homes admin GUI

📜 Commands

Command	Description	Example
`/sethome <name>`	Set a home at your current location	`/sethome base`
`/home <name>`	Teleport to one of your homes	`/home base`
`/homes`	Open homes GUI	`/homes`
`/delhome <name>`	Delete a home	`/delhome base`

⚙️ Configuration

On first run, the plugin creates a config.json file in the plugin's data folder with the following options:

Option	Type	Description
`homeLimits`	Map	Permission node → max homes allowed
`teleportDelays`	Map	Permission node → delay in seconds
`defaultHomeLimit`	Integer	Default homes for players without permissions (default: 1)
`defaultTeleportDelay`	Integer	Default delay in seconds (default: 5)
`cancelOnDamage`	Boolean	Cancel teleport if player takes damage
`cancelOnMove`	Boolean	Cancel teleport if player moves
`moveThreshold`	Double	Distance (blocks) player can move before cancel

🔑 Default Permission Nodes

Admin UI:

homesplus.admin

Home Limits:

home.limit.member - 2 homes
home.limit.vip - 3 homes
home.limit.vipplus - 5 homes
home.limit.mvp - 7 homes
home.limit.mvpplus - 10 homes
home.limit.admin - 50 homes

Teleport Delays:

home.delay.member - 4 seconds
home.delay.vip - 3 seconds
home.delay.vipplus - 2 seconds
home.delay.mvp - 1 second
home.delay.mvpplus - 0 seconds (instant)
home.delay.admin - 0 seconds (instant)

You can add your own custom permission nodes VIA '/homes admin' GUI or in the config file!

📦 Installation

Download the HomesPlus.jar file
Place it in your server's mods folder
Start/restart your server
Configure config.json in the plugin's data folder (optional)

🔧 Troubleshooting

Teleport keeps cancelling? - Reduce moveThreshold in config or set cancelOnMove to false
Players can't set more homes? - Check their permission nodes match entries in homeLimits
Instant teleport not working? - Ensure the player has a home.delay.* permission set to 0

Join our Discord server 'The Outpost' here: https://discord.gg/MRKGZqagbm
Our Hytale Server is opening soon!