Skip to content

Athena Documentation

Athena is a Paper 1.20 soup KitPvP core built as a Lunar Soup style replica. It includes kits, soup combat, combat and spawn timers, safe zones, clans, credits, bounties, perks, trails, coinflips, sumo events, warps, leaderboards, PlaceholderAPI output, 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 API version 1.20
  • 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.
  • Feature Reference: every gameplay system and how the Lunar soup KitPvP loop is implemented.
  • 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, 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. It does not replace a full server restart after code, dependency, or storage changes.