Complete Factions plugin for Paper 1.21.x servers (1.21 to 1.21.11), fully standalone (no external dependencies, no third-party economy plugin required). Local JSON data storage.

• Faction management: create, disband, invite, accept, kick and leave.
• Rank system: Leader, Mod (Officer), Member, Recruit, with promotion/demotion (/f promote, /f demote).
• Chat: in-game faction chat and public/faction chat toggle (/f c).
• Power: max 10 per player, lose 2 on death, gain 1 per kill, gain 1 when joining a faction, regenerates over time (even offline).
• Claims: claim/unclaim chunks based on the faction's total power, full territory protection (break, place, chests, interactions).
• Overclaim: steal an enemy chunk when the enemy faction's total power drops below its number of claims.
• HQ: /f sethome and /f home.
• Interactive guide: /f gui (in-game GUI explaining the whole plugin).
• Complete commands with tab-completion and permission handling.

• Server running Paper 1.21.x (1.21 to 1.21.11) or Spigot/another Paper-API-compatible implementation
• Java 21

Compatible with all Paper API versions from 1.21 to 1.21.11 (tested against each version).

1. Place SimpleFactions-1.0.0.jar in the server's plugins/ folder.
2. Restart the server.
3. Data is saved in plugins/SimpleFactions/data/:
   • factions.json: factions, members, claims, HQ.
   • players.json: player power.
4. Everything is configured in plugins/SimpleFactions/config.yml (then /f reload).

• Each player has a power between 0 and 10 (configurable).
• The faction's total power = the sum of its members' power.
• To claim a chunk: total power > number of claims.
• On each death: −2 power; on each kill: +1 power; when joining a faction: +1 power.
• Regeneration: +1 per minute, caught up even offline.
• Overclaim: an enemy chunk can be conquered when enemy faction power < its claims (enabled via settings.overclaim).
• Inside a claim, outside players cannot break/place blocks, open chests or interact with blocks (doors, buttons, furnaces, etc.).

Excerpt from config.yml:

settings:
  max-power: 10.0          # maximum power per player
  power-per-death: -2.0    # loss on death
  power-per-kill: 1.0      # killer's gain
  power-regen-per-min: 1.0 # regeneration per minute
  max-members: 50          # max members per faction
  invite-expire-seconds: 300
  overclaim: true          # enables overclaim
  autosave-minutes: 5

All messages (English by default) can be customized in the messages: section.

This plugin was built with vibe coding — the software-development practice, coined by AI researcher Andrej Karpathy in 2025, in which you describe a project or task in natural language to a large language model (LLM), which then generates the code for you. As Merriam-Webster puts it: "the practice of writing code... by just telling an AI program what you want, and letting it create the product for you."

In short: the code was generated by an AI from a specification, not written line-by-line by a human. Keep that in mind — review, test and adapt it to your own server before using it in production.

See: Vibe coding (Wikipedia)

mvn clean package

The JAR is generated at target/SimpleFactions-1.0.0.jar.

Report bugs or suggest improvements through the repository's Issues section.

License: MIT