Aura Pearl

Aura Pearl is a standalone Hytale plugin that introduces a fully featured teleportation pearl with configurable cooldowns, safe destination validation and advanced projectile tracking.

Designed for PvP, Factions, Survival and competitive servers, Aura Pearl recreates the classic teleportation pearl experience while taking full advantage of Hytale's modern server architecture.

---

Features

• 🟣 Custom teleportation pearl with its own assets

• 🚀 Smooth projectile tracking

• 📍 Accurate teleportation to the projectile's landing position

• 🛡️ Safe teleport validation to prevent suffocation inside blocks

• ⏳ Fully configurable cooldown system

• 🔄 Automatic cooldown notifications

• 🎒 Inventory protection to prevent item loss

• 🌍 Automatic localization support

• ⚙️ Runtime configuration loading

• 📦 Lightweight standalone plugin

• 🔧 Built specifically for Hytale servers

---

How It Works

Using an Aura Pearl launches a physical projectile.

When the projectile lands, the plugin safely teleports the player to the destination after validating the surrounding terrain. If the destination is unsafe, Aura Pearl automatically searches for a nearby safe location, preventing players from becoming trapped inside solid blocks.

The plugin also protects against item loss by restoring pearls that were consumed during blocked launches.

---

Cooldown System

Aura Pearl includes a fully configurable cooldown system.

Features include:

• Configurable cooldown duration

• Countdown notifications

• Ready notifications

• Launch prevention while on cooldown

• Per-player cooldown tracking

Everything can be adjusted through the configuration file.

---

Configuration

Aura Pearl allows server owners to customize:

• Cooldown duration

• Countdown notifications

• Ready messages

• Blocked launch messages

• Scheduler behavior

• Plugin enable/disable state

Changes can be applied without modifying the source code.

---

Commands

/voidpearl

Gives the player a stack of 16 Aura Pearls.

Aliases:

• /vp

• /aurapearl

Designed primarily for administrators and testing.

---

Designed For

Aura Pearl is ideal for:

• PvP Servers

• Factions Servers

• Survival Servers

• RPG Servers

• Competitive Game Modes

• Custom Hytale Experiences

---

Built-in Protections

Aura Pearl includes several safeguards to improve gameplay and prevent common issues:

• Safe teleport destination validation

• Anti-suffocation checks

• Projectile tracking recovery

• Inventory restoration

• Cooldown enforcement

• Launch validation

• Automatic cleanup of temporary data

These systems help provide reliable and consistent teleportation even during high server load.

---

Current Status

Aura Pearl is under active development and continuously updated alongside Hytale.

Currently implemented features include:

• Teleportation pearl mechanics

• Projectile lifecycle tracking

• Safe teleport resolution

• Configurable cooldown system

• Inventory protection

• Localization synchronization

• Runtime configuration

• Administrative commands

Additional features and improvements will continue to be added as the Hytale SDK evolves.

---

Requirements

• Hytale Server

• Aura Pearl

No additional plugins or dependencies are required.

---

Philosophy

Aura Pearl aims to recreate one of the most iconic movement mechanics while making it feel native to Hytale.

Rather than simply copying existing implementations, the plugin focuses on reliability, smooth gameplay, server performance and complete configurability, making it suitable for both competitive and casual servers.

---

Future Plans

Planned improvements include:

• Region and claim integration

• Combat restrictions

• Additional configuration options

• Expanded customization

• Performance optimizations

• Continued compatibility with future Hytale SDK updates

---

Support

Bug reports, suggestions and feature requests are always welcome.

Aura Pearl is actively maintained and will continue to receive updates, improvements and compatibility fixes throughout Hytale's development.