# TitleInfo — The Ultimate Navigation Suite 🚀 !(https://cdn.modrinth.com/data/cached_images/44cbedc28e1bcdc10f8140d7ab2b274e9ad39552.png) <div style="background-color: #2d3436; padding: 25px; border-radius: 12px; text-align: center; border: 2px solid #0984e3;"> <h1 style="color: #74b9ff; margin: 0; font-size: 28px;">✨ Elevate Your Minecraft Experience ✨</h1> <p style="color: #dfe6e9; font-size: 16px; margin-top: 10px;"><b>Action Bars • Waypoints • Smart Sharing • Developer API</b></p> </div> **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(); <br> ### 📍 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(); <br> > Location loc = player.getLocation(); <br> > &nbsp; <br> > // Set a waypoint asynchronously <br> > api.upsertWaypointAsync(playerId, "Home Base", loc).thenAccept(success -> { <br> > &nbsp;&nbsp;&nbsp;&nbsp; if (success) { <br> > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; player.sendMessage("Waypoint synchronized!"); <br> > &nbsp;&nbsp;&nbsp;&nbsp; } <br> > }); <br> ### 📡 Example: Listening for Events Hook into user actions to add custom logic, such as blacklisting certain names: > @EventHandler <br> > public void onWaypointSet(TitleInfoWaypointSetEvent event) { <br> > &nbsp;&nbsp;&nbsp;&nbsp; // Prevent players from naming waypoints "Spawn" <br> > &nbsp;&nbsp;&nbsp;&nbsp; if (event.getWaypointName().equalsIgnoreCase("Spawn")) { <br> > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; event.setCancelled(true); <br> > &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; event.getPlayer().sendMessage("That waypoint name is reserved!"); <br> > &nbsp;&nbsp;&nbsp;&nbsp; } <br> > } <br> --- ## 🎨 Commands & Permissions | Command | Description | Permission | | :--- | :--- | :--- | | `/ti display <type>` | Toggle specific HUD elements | `titleinfo.display` | | `/ti share ` | 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. --- <p style="text-align: center; color: #636e72;"> <i>Developed with ❤️ by <b>RRS</b></i><br> </p>