# ⚔️ SmartRtp - Premium Smart Rtp Plugin

---

## ✨ Features

- ⚔️ **Premium 1v1 Matchmaking**: Players can join queues for Overworld, Nether, or End arenas.
- **Smart RTP**: Safe, random teleportation with configurable radius and spawn distance.
- ️ **Modern GUI**: Beautiful, animated inventory menus for world selection and confirmation (toggleable).
- **Leaderboard & Statistics**: Track wins, matches, and display top players.
- **Premium Sound Effects**: Custom sounds for queue join, leave, and match found.
- ️ **Combat Logging Protection**: Prevents unfair disconnects during matches.
- ️ **Highly Configurable**: All messages, sounds, GUI, and queue settings are customizable.
- **DeluxeMenu Integration**: Fallback GUI support when built-in GUI is disabled.
- **Permission System**: Fine-grained permissions for users and admins.
- **Queue Announcements**: Broadcast queue status and match found messages.
- **Match Staging**: Countdown and effects before teleporting to the arena.

---

## Screenshots

* *


---

## Commands

| Command | Description | Permission |
|------------------------|---------------------------------------------|--------------------|
| `/rtpqueue` | Open world selection GUI / Leave queue | rtpqueue.use |
| `/rtpqueue overworld` | Join Overworld queue | rtpqueue.use |
| `/rtpqueue nether` | Join Nether queue | rtpqueue.use |
| `/rtpqueue end` | Join End queue | rtpqueue.use |
| `/rtpqueue leave` | Leave current queue | rtpqueue.use |
| `/rtpqueue status` | Check your queue status | rtpqueue.use |
| `/rtpqueue reload` | Reload configuration | rtpqueue.admin |

---

## Permissions

| Permission | Description | Default |
|--------------------|---------------------------|---------|
| rtpqueue.use | Basic RTP usage | true |
| rtpqueue.admin | Admin commands | op |
| rtpqueue.bypass | Bypass restrictions | op |

---

## ⚙️ Configuration

- **Fully customizable** via `config.yml`
- Enable/disable GUI, set world names, sounds, effects, queue size, messages, and more.
- Supports gradients and color codes in messages.
---

## Placeholders

- Supports PlaceholderAPI for custom placeholders (add details if you have any).

---

## Dependencies

- [PlaceholderAPI] (optional)
- [DeluxeCombat] (optional)
- [CombatLogX] (optional)
- [DeluxeMenu] (optional, for fallback GUI)

---

## Installation

1. Download the plugin jar and place it in your `plugins` folder.
2. Restart your server.
3. Edit `config.yml` to your liking and reload with `/rtpqueue reload`.

---

## ❓ FAQ

**Q:** How do I disable the built-in GUI?
**A:** Set `gui.enabled: false` in `config.yml` to use DeluxeMenu instead.

**Q:** How do I add more worlds?
**A:** Add world names under the appropriate section in `worlds:` in `config.yml`.

---

## ️ Support

- For help, bug reports, or feature requests, contact me via SpigotMC PM or Discord: `engine_365`

---

## ❤️ Like this plugin?

Leave a review and share with your friends!