SkyWarsFFA

A feature-rich Minecraft Spigot 1.8.8 Plugin for a SkyWars Free-For-All (FFA) minigame. Written in Kotlin using modern libraries such as Ktor, Kotlin Coroutines, and JetBrains Exposed.

🚀 Features

• Multi-Map System: Seamlessly setup, manage, and load multiple maps.
• Kit System: Create customizable kits with custom inventory sorting options for players.
• Player Stats: Track kills, deaths, and other statistics utilizing an integrated SQL database.
• Scoreboard Integration: Optional auto-configuration and integration with the TAB plugin.
• PlaceholderAPI Support: Custom placeholders out of the box for displaying stats and information.
• Holograms: Built-in integration with HolographicDisplays.
• Visuals: Automated action bars, scoreboards, and custom joining effects.
• Optimized: Leverages Kotlin Coroutines for asynchronous tasks and JetBrains Exposed for efficient database interactions.

📋 Requirements

To run this plugin, your server needs the following environment:

• Server version: Spigot or PaperMC 1.8.8
• Java version: Java 8+
• PlaceholderAPI (Plugin can auto-download if missing)
• TAB (Plugin can auto-download if missing)
• HolographicDisplays (Soft-Depend / Recommended)

💻 Commands

• /skywarsffa (/swffa) - Main setup command
  • Usage: /skywarsffa <build|reload|kits|maps>
  • Description: Manage maps, kits, plugin reloads, and toggle build modes.
• /stats (/statistic, /stat) - View statistics
  • Usage: /stats [player]
  • Description: Shows your stats or the stats of another player.
• /resetstats (/resetstatistic, /resetstat) - Reset statistics
  • Usage: /resetstats [player]
  • Description: Reset your stats or the stats of a specified player.

🛠️ Building

This project is built utilizing Gradle. To compile the plugin and shadow dependencies into a singular ready-to-run JAR, simply execute:

./gradlew shadowJar

Or run:

./gradlew build

The compiled artifact will be generated as SkyWarsFFA.jar globally located within the build/libs/ directory.

⚙️ Configuration

During its initial loading phase, the plugin will seamlessly generate default configuration files within the plugins/SkyWarsFFA directory (config.yml, config.tab.yml, kit.yml.default, map.yml.default). Ensure that a valid SQL connection string is fully populated within config.yml before usage.