Docs

Installation

Requirements

  • Paper 1.20.4 through 1.21.11.
  • Java 17 or newer.
  • A license key for AtomCombat, issued through the Aeros Discord bot.

Optional software

None of these are required to run AtomCombat, but each unlocks extra behaviour when installed:

PluginWhat it unlocks
PacketEventsRequired for the packet-based knockback and attack timing engine in Combat Core.
VaultEconomy-backed bounties.
LuckPermsRank abilities are gated by Bukkit permissions, which LuckPerms manages naturally.
WorldGuardPer-region PvP, keep-inventory, keep-experience and knockback profile overrides.
PlaceholderAPI%atomcombat_*% placeholders for stats.
PulsePrisonCurrency rewards for bounties, skill experience on kill, and prestige/rebirth gates on rank abilities.

Steps

  1. Install PacketEvents on your server (required for Combat Core's packet-based timing and knockback).
  2. Drop AtomCombat-<version>.jar into your plugins folder.
  3. Start the server once to generate the default files under plugins/AtomCombat/.
  4. Stop the server (or use /atomcombat reload once configured) and open plugins/AtomCombat/config.yml.
  5. Set your license.key (see First Setup).
  6. Review modules/*.yml for each feature you plan to use, and languages/*.yml if you want to change any wording.
  7. Start the server.

AtomCombat downloads a few small libraries (bStats, HikariCP, the SQLite and MySQL drivers) automatically at startup through Paper's plugin library loader — no manual JAR shading is needed, and no extra download step is required from you.

Installation | AtomCombat Docs