HyPortal

🌐 HyPortal Advanced Teleportation System for Hytale

HyPortal adds a powerful, flexible, and server-friendly Teleporters system to Hytale, allowing players and servers to create configurable teleport portals with full control, privacy options, limits, auto-destruction, and multilingual support.

With each update, it is recommended to break and replace the portals to ensure they are properly updated to the new version. Additionally, administrators should delete the Local_HyPortal folder inside the Mod directory if any errors occur, as these are usually caused by leftover files from early updates. (Player portals are stored in the teleporters.json file)

Update 1.0.2

Fixes the Loading error, significantly improving overall stability.
Additionally, a new customization system has been added, allowing you to place your server’s logo on the portals, giving them a unique identity and a more professional look for your server.

Simple for players. Powerful for admins. Fully configurable for servers.

---

✨ Features

• 🔮 Teleporters (TP Portals) as blocks/items
• ⚙️ Individual configuration per teleporter
• 🧭 Warp system (name + destination)
• 🔒 Privacy & restrictions per portal
• 👑 Ownership system (owner-only actions)
• ⏱ Optional auto-destruction system
• 📦 Safe item return system (even when offline)
• 🌍 Global + per-player language system (ES / EN)
• 🧱 Placement limits per player
• 🛠 Full admin panel UI

Version Update 1.0.3

Version Update 1.0.2

GUI OP . Admin

Performance improvements, configurable TP cooldown with the GUI op

---

🧩 Teleporter Configuration Menu

Each teleporter has its own settings panel:

• Warp Name – Display name of the portal
• Warp Destination – Destination warp
• Private – Hidden from other players
• Restricted – Only owner can use
• Lock Settings – Only owner can edit
• Lock Breaking – Only owner can break
• Display World – Show world/dimension
• Display Coordinates – Show coordinates
• Auto-Destroy (Self Destruct) – Portal auto-destroys after time

All settings are saved persistently in teleporters.json.

---

⏱ Auto-Destruction System

• Auto-destruction can be enabled per teleporter
• Global delay is configurable by admins
• When destroyed:
• The item is returned to the owner
• If owner is offline → stored in pending_returns.json

✅ No item loss ✅ Offline-safe system

---

🌍 Language System

• 🌐 Global server language (default)
• 👤 Personal language per player

Supported languages:

• es (Spanish)
• en (English)

---

👑 Admin System

/hyportal admin

Opens the HyPortal Admin Panel (OP only)

From the panel you can configure:

• Auto-Destroy Delay
• Global delay in seconds
• Range: 3–5 seconds
• Global Language
• es or en
• Max Portals Per Player
• Range: 1–1000

All changes are saved to config.json.

---

🧑‍💻 Commands

👤 Player Commands

/hyportal lang <es|en>

Sets personal language for the player.

---

👑 Admin Commands (OP only)

/hyportal admin - Opens admin panel UI.

/hyportal autodestroy <seconds> - Sets global auto-destroy delay (clamped 3–5).

/hyportal langglobal <es|en> - Sets global server language.

---

📁 Generated Files

HyPortal automatically creates and manages:

• teleporters.json
  Persistent teleporter data and settings
• config.json
  Global configuration
• pending_returns.json
  Pending item returns for offline players

---

🧪 Stability & Server Safety

HyPortal is designed to be:

• ✅ Server-safe
• ✅ Persistent-data based
• ✅ Offline-safe
• ✅ UI-driven
• ✅ Admin-controlled
• ✅ Multiplayer-friendly

---

🎯 Use Cases

• Survival servers
• RPG servers
• MMO-style hubs
• Warp networks
• City systems
• Fast travel systems
• Portal-based progression

---

📌 Philosophy

HyPortal is built to be:

Modular, controlled, immersive, and server-balanced.

No chaos. No spam. No abuse. Just clean teleportation gameplay.

---

❤️ Made for the Hytale Community

HyPortal is designed as a core infrastructure mod for servers that want:

• Professional systems
• Clean UI
• Scalable mechanics
• Full admin control
• Player-friendly UX

---

🚀 HyPortal — Teleportation, done right.