LyttleHotbar

<div align="center">

LyttleHotbar

Paper

Hangar

Discord

<img src="https://raw.githubusercontent.com/Lyttle-Development/LyttleUtils/main/navigation_showcase.gif" alt="Plugin Banner" width="700px">

> ✨ The ultimate lightweight navigation bar and actionbar overlay plugin for modern Minecraft servers. ✨

📚 Features • ⌨️ Commands • 🔑 Permissions • 📥 Installation • ⚙️ Configuration • 📱 Support

</div>

🌟 Features

<p align="center"> <img src="https://raw.githubusercontent.com/Lyttle-Development/LyttleUtils/main/navigation_showcase.gif" alt="Feature Showcase" width="500px"> </p>

🎯 Core Plugin Features

- Real-time overlay using MiniMessage formatting - Player direction (`<PLAYER_FACING>`), in-game 24h time (`<SERVER_TIME_24_H>`), and total server days (`<STATISTIC_TOTAL_SERVER_DAYS>`) - Supports PlaceholderAPI for coordinates and more: `%player_x%`, `%player_y%`, `%player_z%`, etc. - ActionBar display updates on inventory, join, teleport, or world change - Fully configurable, lightweight, and open source

---

🤌 Lyttle Certified

- Basic plugin without fluff - No unnecessary features - Full flexibility and configurability - Open source and free to use (MIT License)

---

⌨️ Commands

> 💡 `<required>` `[optional]`

| Command | Permission | Description | |:-----------------------|:----------------------|:-----------------------------| | `/lyttlehotbar reload` | `lyttlehotbar.reload` | Reloads plugin configuration |

---

🔑 Permissions

| Permission Node | Description | Default | |:----------------------|:---------------------------------|:--------| | `lyttlehotbar.*` | Grants all plugin permissions | ❌ | | `lyttlehotbar.reload` | Allows reloading config/messages | ❌ |

---

📥 Installation

Quick Start

1. Download the latest version from Hangar 2. Place the `.jar` file in your server's `plugins` folder 3. Download and add PlaceholderAPI for coordinate placeholders (`%player_x%`, etc.) 4. Restart your server 5. Edit the configuration file to customize navigation overlays

---

📋 Requirements

- Java 21 or newer - Paper 1.21.x+ - PlaceholderAPI for player coordinates - Minimum 10MB free disk space

---

💫 Dependencies

- PlaceholderAPI - Required for player coordinate placeholders

---

📝 Configuration Files

🔧 `config.yml`

The main configuration file controlling plugin behavior and features. Supports placeholders like `<PLAYER_FACING>`, `<SERVER_TIME_24_H>`, `<STATISTIC_TOTAL_SERVER_DAYS>`, and PlaceholderAPI values such as `%player_x%`, `%player_y%`, `%player_z%`.

💬 `messages.yml`

Customize all plugin messages. Supports MiniMessage formatting.

🔄 The #defaults Folder

The folder serves several important purposes: `#defaults`

1. Documentation: Contains original copies of all configuration files 2. Documentation: Use these to restore default settings 3. Documentation: Preserved during plugin updates 4. Documentation: Shows all available options with comments

> 💡 Never modify files in the #defaults folder! They are automatically overwritten during server restarts.

---

💬 Support

<div align="center">

🤝 Need Help?

Discord

🐛 Found a bug? Open an Issue 💡 Have a suggestion? Share your idea

</div>

---

📜 License

<div align="center">

This project is licensed under the MIT License - see the LICENSE file for details.

---

🌟 Made with the lyttlest details in mind by Lyttle Development

If you enjoy this plugin, please consider:

⭐ Giving it a star on GitHub <br> 💬 Sharing it with other server owners<br> 🎁 Supporting development through Donations

</div>