Skip to content

Athena Documentation

Athena is a Paper soup KitPvP core built as a Lunar Soup style replica. This documentation is written for server owners and administrators: it covers installation, configuration, event arena setup, permissions, and operational commands. Athena includes kits, soup combat, combat and spawn timers, safe zones, clans, credits, bounties, perks, trails, coinflips, Last Man Standing, One In The Quiver, Sumo, Wool Shuffle, Red Light Green Light, TNT Run, TNT Tag, warps, leaderboards, PlaceholderAPI output, staff mode, vanish, freeze, xray alerts, rank-provider integration, and staff/admin tooling for live server management.

The plugin name is Athena. The Paper entry point is cc.insidious.athena.paper.AthenaPlugin.

Requirements

  • Paper server compatible with the plugin's API declaration 1.20 (the current build is compiled against Paper API 1.21.8)
  • PlaceholderAPI
  • ActionBarAPI-Plus
  • Java runtime compatible with the server and build

Athena registers commands at runtime through its command framework, so commands are not listed in paper-plugin.yml.

Documentation Map

  • Setup & Configuration: install notes, dependencies, config files, data storage, reload/reset behavior, and current implementation notes.
  • Configuration Reference: every example YAML file in toReference/configs, value rules, staff-mode settings, rank-provider settings, and enum naming guidance for XSeries-backed values.
  • Event Setup Guide: administrator setup and operation for Last Man Standing, One In The Quiver, and Sumo events.
  • Feature Reference: every gameplay system, staff tooling flow, rank integration, and how the Lunar soup KitPvP loop is implemented.
  • Ability Reference: every registered runtime ability, trigger, cooldown, item/config hook, and gameplay effect.
  • Command Reference: player, admin, economy, kit, region, event, and utility commands.
  • Placeholders: all PlaceholderAPI values exposed by the athena expansion.
  • Permissions: all command permissions, runtime checks, bypasses, and purchasable trail nodes.

Core Loop

Players join at spawn, receive the lobby hotbar, choose kits, and leave safe zone to fight. Soup heals instantly, kills grant credits and streak progress, kits and perks create progression, and leaderboards/clans track long-term competition.

Admin systems are managed in-game through commands for kits, regions, killstreak milestones, warps, juggernauts, events, staff mode, vanish, freeze, xray alerts, and player profile corrections.

Important Runtime Notes

  • SQLite is the only storage mode currently registered at runtime. MySQL and MongoDB config/repository classes exist, but their module registration methods are empty.
  • Player, clan, kit, timer, region, killstreak, and warp data is autosaved every 60 seconds.
  • The plugin enables immediate respawn for every loaded world on startup.
  • off_hand_usage_enabled in config.yml controls whether soup can be used from the off hand.
  • /reloadathena reloads config-backed behavior. Event setup locations are saved when setup commands are used; restart after changing the plugin jar or dependencies. Only one hosted event can be active at a time.