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!