Neptune FFA Addon

Neptune FFA Addon is a dedicated Free-For-All arena expansion built for Neptune Practice Core. It provides kit-based FFA arenas, combat-tag mechanics, drop handling, live killstreak tracking, session/lifetime leaderboards, and re-kit selection menus.

Supported Platforms

• Minecraft Version: 1.20 through 1.21+
• Server Engines: Paper, Purpur, Folia
• Required Dependency: Neptune (Neptune Practice Core)

Core Features

• Multi-Kit FFA Arenas: Create separate FFA arenas per kit (Nodebuff, BuildUHC, Gapple, Combo, SMP) with custom spawn points.
• Combat Tagging Engine: Prevents players from leaving the arena or logging out during active combat.
• Live Session & Lifetime Stats: Tracks killstreaks, best streaks, kill-death ratios (KDR), and ranks directly on the scoreboard.
• Re-Kit & Drops: Configure whether dead players drop golden apples, head consumables, or restore inventory loadouts upon respawn.
• Lobby Hotbar Selector: Right-click diamond sword lobby item with GUI kit browser.

Commands and Permissions

Command	Purpose	Permission
/ffa join <kit>	Join an active Free-For-All arena	Default
/ffa leave	Leave the FFA arena and return to spawn	Default
/ffa stats	View personal FFA killstreaks and KDR	Default
/ffa list	List active players in each kit arena	Default
/ffaadmin setarena <kit>	Define arena boundaries for a kit	neptuneffa.admin
/ffaadmin addspawn <kit>	Add a random player spawn point	neptuneffa.admin
/ffaadmin clearspawns <kit>	Clear all configured spawn points	neptuneffa.admin
/ffaadmin reload	Reload configuration and arenas	neptuneffa.admin

Key Permissions

• neptuneffa.admin: Full access to arena setup, player kicking, and configuration reloads.

Configuration Reference

The configuration file is located at plugins/NeptuneFFA/config.yml:

# =====================================================
#             Neptune FFA Configuration
# =====================================================

ffa:
  lobby-item:
    enabled: true
    slot: 8
    material: DIAMOND_SWORD
    name: "&c&lFree For All &7(Right Click)"
    lore:
      - "&7Click to choose an FFA kit arena"

  respawn-delay-seconds: 5
  combat-tag:
    duration-seconds: 15
    actionbar-message: "&c&lCombat Tag: &e{seconds}s"

  menu:
    title: "&c&lFree For All Arenas"
    size: 27

  scoreboard:
    update-interval-ticks: 20
    title: "&c&lFFA ARENA"
    lines:
      - "&7&m--------------------"
      - "&fKit: &c<ffa_kit> &7| &fPlayers: &a<ffa_players>"
      - ""
      - "&a&lSession"
      - " &fKills: &a<ffa_session_kills> &7| &fDeaths: &c<ffa_session_deaths>"
      - " &fStreak: &e<ffa_session_streak>"
      - ""
      - "&d&lLifetime"
      - " &fKills: &a<ffa_lifetime_kills> &7| &fKDR: &b<ffa_kdr>"
      - " &fRank: &e#<ffa_rank>"
      - "&7&m--------------------"