EasyFFA - Ultimate Free-For-All 0.1.2

What is FFA in Minecraft?
In a Free-For-All (FFA), every player fights for themselves - no teams, no alliances, just pure PvP. Players instantly respawn, jump back into action, and compete for kills, points, rank-ups, and bragging rights. A great FFA feels smooth, fair, and snappy. That's exactly what EasyFFA is built for.

Why EasyFFA? 🎯
EasyFFA focuses on admin productivity and player flow:

1. ✅ Zero-friction admin tools: one-command safe-zone editor, per-world spawn control, map rotation with countdowns, and map-specific kits.
2. 🔥 Deep progression loop: points, experience, configurable ranks, killstreak broadcasts, and an optional multi-level bounty system that fuels rivalries.
3. ⚡ Modern & lightweight: no NMS, up-to-date Spigot API support, optimized performance, simple config.

Feature Highlights

1. Safe Zones — Protect spawn/areas with a simple two-point selection flow.
2. Map Rotation — Automated rotation with messages, countdowns, and teleports.
3. Kits & Map Kits — Create kits from inventory and assign per-world; kits are reapplied after respawn and map changes.
4. Stats & Ranks — Track kills, deaths, points, exp; configurable rank ladder.
5. Killstreaks — Broadcast milestones (3, 5, 7, 10, 15, 20, 25 by default) and persist each player's maximum streak.
6. Bounties — Players spend points to place bounties; killers earn rewards.
7. Combat Logging — Tag timer + optional punishments/commands.
8. Scoreboard & Tablist — Show player stats/rank; configurable formatting.
9. Join Flow & Spawn — Spawn countdown, world-specific spawns, optional force-adventure-mode, and QoL rules (prevent drops/breaking/durability).
10. Build Mode — Admins can toggle build mode for editing during FFA.
11. Chat Control — Quick clear your own chat or global chat via admin commands.
12. Game Rule Loader — Automatically loads and reapplies gamerules from gamerules.yml on startup.
13. Runtime World Loading — Load or create worlds when using world teleport and active-map management.
14. Config-First — Main settings are configurable, with separate generated files for maps, gamerules, progression, kits, bounties, and combat-log data.
15. Public Event API — Integrate with kill, death, bounty, killstreak, and rank-up events.

Requirements & Compatibility

1. Spigot/Paper 1.21+ up to 26+
2. Java 21+ recommended (built for modern runtimes)
3. Optional: MySQL/MariaDB if you enable database storage (driver included)

Note: EasyFFA is designed for network setups. The scoreboard, join/leave handling, and related messages/mechanics are always active by design. ℹ️

Installation
[list=1]Place the EasyFFA jar into your server's plugins folder.Start the server once to generate config files.Open plugins/EasyFFA/config.yml and adjust settings (messages, points/exp, ranks, killstreaks, chat format, combat tag, etc.).(Optional) Enable MySQL in the config and set credentials (details below).Create kits, set map spawns, and (optional) define safe zones.
[/list]

Quick Start ⚡

1. Set spawn for your current world: /ffa setspawn
2. Create a kit from your inventory: /ffa kit create
3. Assign that kit to the current world: /ffa kit setmap
4. (Optional) Define a safe zone: /ffa zone set (twice to complete the two corners)
5. (Optional) Choose default active world (when map rotation is off): /ffa activemap
6. (Optional) Start map rotation: /ffa mapchange start

Maps & Safe Zones

1. Spawn Per World
   /ffa setspawn sets the FFA spawn point for the current world. Players can use /spawn; a configurable countdown prevents abuse.
2. Safe Zone Setup
   • Stand at corner 1 and run: /ffa zone set
   • Stand at the opposite corner and run: /ffa zone set again
   • Done — the region is protected, with clear titles on enter/leave
   If you make a mistake: /ffa zone del cancels the setup.
   Zones are saved per-world and automatically loaded on server start.
3. Active Map (Join Behavior, No Rotation)
   If automatic map rotation is not used, the world configured under ActiveWorldName in config.yml is treated as the active FFA world. All players are teleported to this world on join. For the best FFA experience, make sure this world has a properly defined safe zone and spawn.
   
   Use /ffa activemap to update the default active world. This command immediately updates the config value and teleports all online players to the newly set world.
   
   If you do not enable map rotation and also leave ActiveWorldName unset/unused, players will join in a random/default world as defined by the server. This behavior is not controlled by EasyFFA.
4. Map Rotation
   Use /ffa mapchange start to begin rotation across your configured worlds, with broadcasted countdowns and automatic teleports. Stop anytime with /ffa mapchange stop. If enabled in config and at least two maps are available, rotation can auto-start on server boot.
   When map rotation is enabled, ActiveWorldName is ignored and players will always join the current rotating map.

Kits

1. Create from Inventory: Equip items/armor, then run /ffa kit create .
2. List Kits: /ffa kit list
3. Delete Kit: /ffa kit delete
4. Assign Kit to World: /ffa kit setmap (applies to your current world)
5. Players receive assigned map kits automatically on join, after respawn, and when the map changes.

Stats, Points, EXP, Ranks & Killstreaks

1. Stats GUI: /stats to view personal stats (kills, deaths, points, K/D, rank, exp); authorized admins can inspect another online player's stats with /stats .
2. Points: Gain on kills, lose on death — fully configurable.
3. Experience: Award EXP per kill; define rank thresholds in config.
4. Ranks: Displayed in tablist/scoreboard; define names and thresholds in FFA.Ranks.
5. Killstreaks: Broadcast messages at configured thresholds and track the player's maximum streak separately from the current streak.

Bounties (Optional PvP Economy Twist)
Players can spend points to place bounties on others; rewards are paid out to the killer.

1. /bounty — Help and subcommands
2. /bounty add — Place a bounty (costs points, configurable per level)
3. /bounty level — View bounty tiers and their costs/rewards
4. /bounty list — List all active bounties on the server
5. Important: Adding a bounty to a player who already has one will overwrite the previous bounty level. The levels do not stack - the new bounty completely replaces the old one.

Combat Logging Control
Tag players in combat for a set duration. Optionally execute server commands, deduct points, or reset stats if they log out.
Configure under FFA.CombatLogging in config.yml.
Common options:
• TagDurationSeconds: how long a player stays in combat after the last hit.
• Punishments.CommandsEnabled + Punishments.Commands: run console commands (e.g., warn/kick).
• Punishments.ResetAllStatsEnabled: reset the offender's stats.
• Punishments.DeductPointsEnable + DeductPointsValue: remove points on combat logout.

Scoreboard and Tablist

1. Scoreboard: Toggle and customize the display name and lines in FFA.Scoreboard.
2. Tablist: Independently configure rank/name formatting plus a tablist header and footer (e.g., Format: '&f[%RANK%&r&f] %NAME%').

Storage Options

1. Flatfile (Default) — Simple YAML storage; no setup required. Generated files include kits.yml, stats.yml, points.yml, exp.yml, ranks.yml, killstreaks.yml, bounties.yml, maps.yml, gamerules.yml, and combatloggers.yml.
2. MySQL/MariaDB (Optional) — Enable in config.yml under FFA.MySQL. The MariaDB JDBC driver is bundled, and database storage covers stats, points, experience, ranks, maximum killstreaks, bounties, and combat-logger records.

FFA:
  MySQL:
    Enabled: true
    Host: 'localhost'
    Port: 3306
    Username: 'minecraft'
    Password: 'password'

Optional Chat Styling
You can optionally enable EasyFFA's chat formatting and styling in config.yml:

• Path: FFA.Chat
• Enabled: true/false
• Format: e.g. "%PREFIX% %RANK% >> %PLAYER%&7: %MESSAGE%"
• DefaultPrefix: e.g. "&7"

When enabled, EasyFFA will format player chat according to your Format. You can include rank/prefix placeholders.

Commands & Usage

1. /stats — View your FFA stats
2. /stats — View another online player's stats (permission required)
3. /spawn — Teleport to the map spawn with a configurable countdown and a fixed 10-second cooldown
4. /points
   • /points — Help
   • /points add
   • /points set
   • /points remove
5. /bounty
   • /bounty — Help
   • /bounty level — View bounty levels
   • /bounty add — Place a bounty
   • /bounty list — List all active bounties
   • /bounty remove — Remove a bounty (if enabled/authorized)
6. /ffa
   • /ffa — Info & help
   • /ffa tp — Teleport to a world
   • /ffa activemap — Set the default active world (updates ActiveWorldName) and teleport all players there
   • /ffa zone set — Start/complete a safe-zone selection
   • /ffa zone del — Cancel a safe-zone selection
   • /ffa setspawn — Set/update spawn for current world (admin)
   • /ffa build — Toggle build mode (admin)
   • /ffa mapchange — Control map rotation
   • /ffa kit list — List kits and map assignments
   • /ffa kit create — Create a kit from your inventory (admin)
   • /ffa kit delete — Delete a kit (admin)
   • /ffa kit setmap — Assign kit to current world (admin)
   • /ffa resetstats — Reset stats (admin)
   • /ffa cc — Clear your own chat (admin)
   • /ffa ccg — Clear global chat (admin)

Note: /ffa resetstats lets you target a specific category (e.g., points only) or all.

API Documentation
You can find detailed API documentation in the documentation, including event subscription examples and integration tips. Available Bukkit events include EasyFFAKillEvent, EasyFFADeathEvent, BountySetEvent, BountyResolvedEvent, KillstreakStartEvent, KillstreakChangeEvent, KillstreakEndEvent, and PlayerRankUpEvent.

Permissions Overview

1. easyffa.* — Full access
2. easyffa.ffa — Use /ffa (default: true)
3. easyffa.world.tp — World teleport (default: op)
4. easyffa.kit — Use kits (default: true)
5. easyffa.points — Manage points (default: op)
6. easyffa.bounty — Manage bounties (default: op)
7. easyffa.removebounty — Remove bounties (default: op)
8. easyffa.stats.others — View other players' stats (default: op)
9. easyffa.admin — Access admin commands (default: op)
10. easyffa.admin.kit — Manage kits (default: op)
11. easyffa.admin.setspawn — Set spawn (default: op)
12. easyffa.admin.cc — Clear chat (default: op)
13. easyffa.admin.zone — Manage safe zones (default: op)
14. easyffa.admin.resetstats — Reset player statistics (default: op)
15. easyffa.admin.build — Toggle build mode (default: op)
16. easyffa.admin.mapchange — Control map rotation (default: op)
17. easyffa.admin.activemap — Change the active map (default: op)
18. easyffa.admin.chatclear — Clear chat with /ffa cc and /ffa ccg (default: op)

Configuration Tips

1. Tweak points/exp gain under FFA.Points and FFA.Exp.
2. Define rank thresholds and names under FFA.Ranks.
3. Adjust killstreak broadcasts under FFA.Killstreaks.
4. Customize scoreboard and tablist in their respective sections.
5. Use the action bar kill messages to keep feedback snappy and non-intrusive.

Performance & Quality

1. Optimized for modern Spigot APIs; no NMS.
2. Asynchronous operations where appropriate.
3. Lightweight runtime footprint and clean config defaults.

Support & Updates

1. Regular updates to track new Spigot versions.
2. Clear, commented config with sensible defaults.
3. Priority support for bug reports and compatibility issues via Spigot messages. 📨