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:

• 📍 Precision Tracking: Coordinates (X, Y, Z) and Facing Direction.
• 🌍 World Data: Current Biome and In-game/Real-world Time.
• 🚩 Active Navigation: Distance and direction to your selected Waypoint.
• ⚙️ Toggleable: Use /ti display to customize exactly what you see.

📍 Advanced Waypoint System

• Set & Forget: Create waypoints at your feet or specific coordinates.
• Smart HUD: 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

• Global/Private: 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

• Player Support: 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. Download the latest release.
2. Drop into your /plugins folder.
3. Restart and enjoy!

• ✅ Compatibility: Minecraft 1.13 - 1.21.x+
• 📦 Dependencies: None (Standalone), but supports Adventure API for rich text.

---

Developed with ❤️ by RRS