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.

---

Features

Arena Rotation Unlimited Maps: Create as many arena locations as your server needs. Sequential Rotation: Maps rotate based on creation order. Automatic Switching: Cycles maps after the configured interval. Instant Rotation: Force the next map manually.

Player Experience Simple Join Command: Players use /map to join the active arena. Countdown System: Includes configurable warnings before rotation. Action Bar Support: Visual countdown messages. Sound Notifications: Audio feedback during rotation events.

---

Integrations

PlaceholderAPI Support

Display the current active map anywhere:

%mapcycle_current_map%

Perfect for:

• Scoreboards
• TAB lists
• Holograms
• Server menus

---

Commands

Player Commands

Command	Description
/map	Teleports the player to the currently active FFA map.

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.

---

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

---

Requirements

• Minecraft 1.20+
• Paper / Spigot based server
• Java 17+
• PlaceholderAPI (optional)

---

Configuration

MapCycle provides configurable files:

config.yml
messages.yml

Configure:

• Rotation intervals
• Countdown timings
• Sounds
• Messages
• Teleport delays
• Placeholder settings

---

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.

---

License

GNU-3.0