🤝Relations & Leaderboards

Alliances, rivalries and the guild leaderboards.

Standings

A standing is one record for a pair of guilds, not one per side, so two guilds can never disagree about whether they are allies.

Command	Effect
/guild ally <guild>	Offers an alliance. It stands as a request until the other guild offers it back, which accepts it.
/guild rival <guild>	Declares a rival. Takes effect at once — waiting for an enemy's permission is not how rivalries work.
/guild neutral <guild>	Drops whatever standing the two guilds have.
/guild relations	Lists who your guild stands with and against, and which offers are still pending.

All four need the MANAGE_RELATIONS rank permission, so you decide which rank speaks for the guild abroad. See ranks.md.

relations:
  maximum-allies: 3
  track-kills: false
  ally-friendly-fire: true

Key	Effect
maximum-allies	How many guilds one guild may be allied to. 0 for no limit.
track-kills	Count kills between rival guilds, for the kills leaderboard.
ally-friendly-fire	Set to false to stop members of allied guilds from damaging each other, projectiles included.

Both combat options are off by default, because not every server is a PvP server. Neither listener is registered at all unless one of them is turned on.

Leaderboards

leaderboards:
  size: 10
  refresh-seconds: 300

Guilds are ranked by experience, level, members or kills. Each board is one query per refresh, held in memory: /guild top and the placeholders read the last snapshot and never touch the database, so a scoreboard asking every tick costs nothing. A refresh that fails leaves the previous snapshot standing rather than emptying the board.

/guild top [experience|level|members|kills]

kills ranks by kills against rival guilds, which is only counted when track-kills is on.