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.