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:

home
tpto
stack
rtp
campfire
compassAndMapMarkers
death
return
logging

Persistence

HomePlus persists data for durability across restarts:

homes.json
returns.json
deaths.json
home-slot-grants.json
home-request-preferences.json
tpto-preferences.json
home-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.