TitleInfo

TitleInfo — The Ultimate Navigation Suite 🚀

TitleInfo is a high-performance, lightweight utility designed to bridge the gap between immersion and information. By leveraging the Action Bar and a robust Waypoint system, it provides essential data without cluttering your chat or screen.

Now featuring a Full Developer API, TitleInfo is the perfect foundation for survival servers, RPGs, and competitive factions that want to integrate coordinate and navigation data into their own systems.

---

🌟 Core Features

📡 Dynamic Action Bar

Stop typing `/coords`. Keep your eyes on the world with real-time HUD elements: * ⚙️ Toggleable: Coordinates (X, Y, Z) and Facing Direction. * ⚙️ Toggleable: Current Biome and In-game/Real-world Time. * ⚙️ Toggleable: Distance and direction to your selected Waypoint. * ⚙️ Toggleable: Use `/ti display` to customize exactly what *you* see.

📍 Advanced Waypoint System

* Cross-World Support: Create waypoints at your feet or specific coordinates. * Cross-World Support: Select a waypoint to see a live distance tracker in your action bar. * Cross-World Support: Track locations across dimensions with ease.

✉️ Seamless Coordinate Sharing

* One-Click Waypoints: Share your location with the whole server or a specific friend. * One-Click Waypoints: Recipients can instantly save shared coordinates as their own waypoints.

🛠️ Administrative Control

* UI Management: Set or remove waypoints for players remotely. * UI Management: Force-toggle display options for specific players or ranks.

---

💻 Developer API

TitleInfo now exposes a powerful API for other plugin developers to hook into the navigation flow.

🔌 Quick Start

Add the TitleInfo.jar to your project dependencies and access the API via the provider:

> TitleInfoApi api = TitleInfoApiProvider.get();

📍 Example: Setting a Waypoint

You can update or create waypoints for any player. It is recommended to use the Async methods to keep your main thread healthy:

> UUID playerId = player.getUniqueId();
> Location loc = player.getLocation();
>  
> // Set a waypoint asynchronously
> api.upsertWaypointAsync(playerId, "Home Base", loc).thenAccept(success -> {
>      if (success) {
>          player.sendMessage("Waypoint synchronized!");
>      }
> });

📡 Example: Listening for Events

Hook into user actions to add custom logic, such as blacklisting certain names:

> @EventHandler
> public void onWaypointSet(TitleInfoWaypointSetEvent event) {
>      // Prevent players from naming waypoints "Spawn"
>      if (event.getWaypointName().equalsIgnoreCase("Spawn")) {
>          event.setCancelled(true);
>          event.getPlayer().sendMessage("That waypoint name is reserved!");
>      }
> }

---

🎨 Commands & Permissions

| Command | Description | Permission | | :--- | :--- | :--- | | `/ti display <type>` | Toggle specific HUD elements | `titleinfo.display` | | `/ti share [player]` | Share your current location | `titleinfo.share` | | `/ti waypoint <set/list>` | Manage your personal waypoints | `titleinfo.waypoint` | | `/ti admin <args>` | Administrative overrides | `titleinfo.admin` |

---

🚀 Installation & Tech Specs

1. Restart the latest release. 2. Restart into your `/plugins` folder. 3. Restart and enjoy!

* Adventure API Minecraft 1.13 - 1.21.x+ * Adventure API None (Standalone), but supports Adventure API for rich text.

---

<i>Developed with ❤️ by <b>RRS</b></i>