Revela's Fair Teleports

Revela's Fair Teleports is a robust, server-side utility mod for Hytale that provides essential movement commands like TPA and Homes, built with a strict focus on survival/combat integrity.

This server mod is designed to prevent "escape-button" gameplay. It integrates directly into Hytale’s Entity Component System (ECS) to monitor damage live, ensuring that teleports are a tool for convenience, not a way to cheat death.

Anti-Combat Abuse (Core Feature)

The standout feature of this mod is its Active Combat Monitoring.

Real-Time Tracking: Using a native CombatMonitorSystem, the mod detects exactly when a player takes damage.
Teleport Gating: If a player has been in combat within the last 15 seconds (configurable), all teleport commands are strictly disabled.
Abuse Prevention: Players can no longer "TPA out" or "Home out" the moment a fight turns against them. The system respects the flow of battle.

✨ Features

🏠 Persistent Home System

Set multiple named homes (e.g., /sethome base, /sethome farm).
Configurable home limits per server (default is 5).
Positional arguments: Use /home base instead of clunky flags.
Safe cross-world support: Teleporting to a home in a different world is handled seamlessly.

🤝 Advanced TPA Suite

Standard /tpa to request to move to a friend.
Supports multiple concurrent requests.
Intelligent acceptance: /tpaccept automatically selects your newest request unless a name is specified.
Full control: Deny unwanted requests or cancel requests you sent by mistake.

📍 Global Spawn Access

Quickly return to the server’s default spawn point with /spawn.
Uses the engine’s native SpawnProvider to ensure you land exactly where the world intended.

⚙️ Server-Side Only

Zero client-side installation required.
Works automatically for all players using Hytale’s native UI and messaging.

💾 Rock-Solid Persistence

Hytale Native BSON: Data is stored using the engine's preferred binary format for maximum speed.
Thread Safety: All file I/O happens off the world thread to prevent server lag or TPS drops.
Layered Saving: Data saves instantly on change and is managed by a background maintenance service.

Commands

Teleport Request (TPA)

/tpa [player]: Send a request to teleport to a player.
/tpahere [player]: Request for a player to teleport to you.
/tpaccept [player]: Accept a pending request (newest by default).
/tpdeny [player]: Reject a pending request.
/tpcancel [player]: Cancel a request you sent to someone else.

Homes

/sethome [name]: Set a home at your current spot (defaults to "home").
/home [name]: Teleport to a saved home.
/delhome [name]: Delete a specific home.
/homes: List all your currently saved homes.

Spawn

/spawn: Return to the server's starting point.

Permission Nodes

This mod uses Hytale's system command nodes for easy integration with your existing permission groups.

hytale.system.command.tpa
hytale.system.command.tpahere
hytale.system.command.tpaccept
hytale.system.command.tpdeny
hytale.system.command.tpcancel
hytale.system.command.sethome
hytale.system.command.home
hytale.system.command.delhome
hytale.system.command.homes
hytale.system.command.spawn

Configuration

The mod generates a config.json file inside mods/fairteleports/ on first startup.

Server owners can customize:

homeLimit: The maximum number of homes a player can set.
combatTagSeconds: How long a player must wait after taking damage before teleporting.
tpaTimeoutSeconds: How long a request stays active before expiring.

Compatibility

Designed for survival and creative multiplayer servers.
Safe to add to existing worlds.
Fully independent of client-side mods.

Feel free to leave a comment if you have any questions!