HomePlus
HomePlus is an all-in-one teleport and quality-of-life suite for Hytale servers.
It combines homes, public homes, teleport requests, random teleports, recovery tools, and admin controls in one consistent system.
What's New in v1.4.1
- Maintenance/stability update focused on release hardening.
- Improved plugin shutdown cleanup:
- Runtime systems now unregister more cleanly on shutdown/reload.
- HomePlus map markers are purged more reliably during shutdown.
- Hardened request-target resolution:
- UI request actions now use stable identifiers instead of fragile raw names.
- Home/home-request and TPTO request resolution better handles UUID-backed targeting.
- Reduced internal state leak risk:
HomeManager now protects stored home state with defensive copies.
- Reduced brittle marker cleanup behavior:
- Marker purge logic now relies less on reflective internals.
- Added regression coverage:
- Tests now cover config migration/sanitization, home persistence/order rules, request expiry/lookup behavior, and command input parsing.
Previous Feature Release: v1.4.0
- Added Homes Only access-control flow:
- Non-OP users can be command-locked while Homes Only is enabled.
- In-game OPs can force-open HomePlus for a player with
/homeplus <player>.
- In-game OPs can close/revoke access with
/homeplus close <player>.
- OP players are automatically exempt.
- Added admin default-home teleport command:
/home tpdefault <player|uuid> teleports that online player to their default home.- Forced admin teleport ignores normal home delay/cooldown.
- Expanded HomePlus Player Admin panel:
- Added
TP Player button to teleport selected online player to default home.
- Added Homes Only respawn routing:
- On respawn, players are sent to their HomePlus default home when available.
- If no valid default home/world exists, respawn silently falls back to normal behavior.
- Added optional bed-to-home behavior:
home.bedSetsHomeEnabled lets bed interaction create a HomePlus home and block vanilla bed behavior.
- Added/expanded command behavior:
/home <home name> teleports directly to a named home (in addition to /homes <name> support).
- Removed vein miner from HomePlus (no vein miner config/module/UI in this mod).
Why Server Owners Use HomePlus
- One mod covers most common teleport workflows, reducing plugin/mod sprawl.
- Player UX is clean:
/hp opens a full menu instead of forcing command memorization.
- Admin UX is practical:
/hpadmin provides live config editing and player/home management.
- Safety-first operations include preview/confirm where destructive actions exist.
- Backward-compatible config/data handling for stable server upgrades.
Core Features
Home System
/sethome [name] to create or update homes/home to teleport to default home/home <name> to teleport to a named home/homes to manage named homes (teleport, set default, rename, delete, move up, publish)/delhomes <name> for fast deletion- Global home cap with optional
* unlimited support
- Optional per-player slot grants layered on top of global cap
- Optional bed interaction override for setting homes
Homes Only Mode
- Optional dedicated homes-focused player UI layout
- Hides/locks non-home features for players (RTP, TPTO, Return, Death, Stack, Public Homes, request panes)
- OP-controlled menu access flow (force-open/close for specific players)
- Optional respawn-to-default-home behavior while mode is active
Public Homes
- Publish/unpublish selected homes
- Browse public homes with paging and search
- Teleport to a published home by owner + home name
- Per-player public home limit
Player-to-Player Teleports
/tpto request system with accept/deny flows- Bulk decisions (
acceptall, denyall) when enabled
- Auto-accept/auto-deny preferences
- Home visit requests via
/home <player> with accept/deny support (outside Homes Only restrictions)
Random Teleport (RTP)
/rtp for safe random teleport away from spawn/rtp poi variant for random locations near POI targets- Improved chunk/column probing strategy and water-heavy chunk rejection
- POI search supports adaptive distance and optional chunk-level cache
- Configurable attempts, distance range, and independent cooldowns
Recovery Teleports
/return to go back to your previous location after teleports/death to return to your latest death location- Optional safe-landing handling for death teleports
Utility Systems
/stack quick-stacks inventory into nearby containers- Campfire healing system with damage cooldown protection
- Optional native buff-icon support for campfire regen
- Compass/map marker integration for homes and return points
In-Game UI
/hp (alias: /homeplus)
- Multi-panel player menu for homes and teleport/recovery workflows
- Home row actions directly in UI
- Incoming request management (single, bulk, and auto preferences)
- Homes Only mode can switch to a dedicated homes-focused layout
/hpadmin (alias: /hpa, OP only)
- HomePlus Config Admin panel:
- Live-edit config categories (home, tpto, stack, rtp, campfire, markers, death/return, logging)
- Save/reload controls
- Filter/search across settings
- HomePlus Player Admin panel:
- Player/home search
- Slot grant controls (
+1, -1, set, clear)
- Single-button trim with preview-first behavior
- Per-home actions: publish/unpublish, set default, delete (confirm), TP
TP Player action to teleport selected online player to default home- All Players mode for cross-player home browsing
Admin Command Reference
/homeslots info <player|uuid>/homeslots grant <player|uuid> [amount]/homeslots revoke <player|uuid> [amount]/homeslots set <player|uuid> <amount>/homeslots clear <player|uuid>/homeslots trim <player|uuid>/homeslots trimapply <player|uuid>/homeplus <player> (OP: force-open HomePlus for that player)/homeplus close <player> (OP: close/revoke that player session)/home tpdefault <player|uuid> (OP: teleport player to default home)
Aliases:
/homeslot/hslots/hp/hpa
Configuration Modules
HomePlus uses a structured config.json with these sections:
hometptostackrtpcampfirecompassAndMapMarkersdeathreturnlogging
Persistence
HomePlus persists data for durability across restarts:
homes.jsonreturns.jsondeaths.jsonhome-slot-grants.jsonhome-request-preferences.jsontpto-preferences.jsonhome-quickstack.json
Summary
If you want fast travel, request-based teleports, recovery tools, and practical in-game admin controls without juggling multiple mods, HomePlus provides a complete and cohesive package.
