MapCycle

<div align="center"> <img src="https://capsule-render.vercel.app/api?type=waving&color=2B2D31&height=200&section=header&text=MapCycle&fontSize=60&fontColor=ffffff&desc=Automated%20FFA%20Arena%20Rotation%20System&descFontSize=20&descAlignY=70" alt="MapCycle Banner"/> <br> <img src="https://img.shields.io/badge/Minecraft-1.20%2B-62B47A?style=flat-square&logo=minecraft&logoColor=white"> <img src="https://img.shields.io/badge/Platform-Paper%20%7C%20Spigot-ED8B00?style=flat-square"> <img src="https://img.shields.io/badge/Java-17%2B-5382A1?style=flat-square&logo=openjdk&logoColor=white"> <img src="https://img.shields.io/badge/PlaceholderAPI-Supported-4F8CFF?style=flat-square"> <br><br> </div> > **MapCycle** is a lightweight automated arena rotation plugin designed for Minecraft FFA servers. It allows unlimited arena locations, automatic map switching, player teleportation, countdown announcements, and PlaceholderAPI integration. MapCycle makes managing rotating FFA maps simple by handling everything automatically while keeping full control available for administrators. <br> --- # Features <table width="100%"> <tr> <td width="50%" valign="top"> <h3> Arena Rotation</h3> <ul> <li><b>Unlimited Maps:</b> Create as many arena locations as your server needs.</li> <li><b>Sequential Rotation:</b> Maps rotate based on creation order.</li> <li><b>Automatic Switching:</b> Cycles maps after the configured interval.</li> <li><b>Instant Rotation:</b> Force the next map manually.</li> </ul> </td> <td width="50%" valign="top"> <h3> Player Experience</h3> <ul> <li><b>Simple Join Command:</b> Players use <code>/map</code> to join the active arena.</li> <li><b>Countdown System:</b> Includes configurable warnings before rotation.</li> <li><b>Action Bar Support:</b> Visual countdown messages.</li> <li><b>Sound Notifications:</b> Audio feedback during rotation events.</li> </ul> </td> </tr> </table> <br> --- # Integrations ## PlaceholderAPI Support Display the current active map anywhere: ``` %mapcycle_current_map% ``` Perfect for: - Scoreboards - TAB lists - Holograms - Server menus <br> --- # Commands ## Player Commands | Command | Description | |---|---| | `/map` | Teleports the player to the currently active FFA map. | <br> ## Admin Commands | Command | Description | |---|---| | `/mapcycle create <name>` | Creates a new map location at your current position. | | `/mapcycle delete <name>` | Removes an existing map. | | `/mapcycle list` | Shows all registered maps in database order. | | `/mapcycle next` | Forces an immediate map rotation. | | `/mapcycle reload` | Reloads plugin configurations. | <br> --- # Permissions | Permission | Description | Default | |---|---|---| | `mapcycle.use` | Allows players to use `/map`. | True | | `mapcycle.admin` | Grants access to all admin commands. | OP | | `mapcycle.create` | Allows creating maps. | OP | | `mapcycle.delete` | Allows deleting maps. | OP | | `mapcycle.list` | Allows viewing map list. | OP | | `mapcycle.next` | Allows forcing rotation. | OP | | `mapcycle.reload` | Allows reloading configuration. | OP | <br> --- # Requirements - Minecraft **1.20+** - Paper / Spigot based server - Java **17+** - PlaceholderAPI *(optional)* <br> --- # Configuration MapCycle provides configurable files: ``` config.yml messages.yml ``` Configure: - Rotation intervals - Countdown timings - Sounds - Messages - Teleport delays - Placeholder settings <br> --- # Installation 1. Download the latest MapCycle release. 2. Place the `.jar` inside your server's `plugins` folder. 3. Restart your server. 4. Create your first map: ``` /mapcycle create <name> ``` 5. Configure rotation settings. <br> --- # License GNU-3.0