Rankings & combat
The starting ranking is set by rank-start (1000 by default).
Point system
Section titled “Point system”rank-system picks one of three models for how points change after a fight:
| System | Description |
|---|---|
ELO (default) |
Chess-style ranking — the change depends on the rating gap between the two players |
PERCENT |
Both players’ ranking changes by a percentage (percent-rank-change) of the victim’s ranking |
STATIC |
Always a fixed amount: static-attacker-change for the winner, static-victim-change for the victim |
For ELO you can also tune elo-constants (the maximum point swing per
ranking bracket — the smaller the constant, the smaller the swings),
elo-divider (400 by default) and elo-exponent (10 by default).
Players can see the predicted point change before a fight if you enable
display-combat-prediction-attacker/display-combat-prediction-victim
(off by default); combat-prediction-interval throttles how often that
notification repeats for the same pair of players.
Kills, deaths and assists
Section titled “Kills, deaths and assists”Alongside ranking points, kills, deaths and assists are tracked (KDR/KDA).
The assist system (rank-assist-enable) splits kill points between the
attacker and any assisting players, proportional to damage dealt —
rank-assist-killer-share (0.5 by default) sets the portion that always
goes to the killer. assists-limit caps how many assists count per kill
(-1 = unlimited).
Who sees a death message, and how, is set by death-message-receivers
(PARTICIPANTS/GUILD/WORLD/ALL). disable-default-death-message turns
off the server’s own message, which would otherwise appear alongside the
FunnyGuilds one.
Anti-farming protections
Section titled “Anti-farming protections”Several independent switches guard against artificially inflating ranking points:
rank-farming-protect— blocks repeatedly scoring points for killing the same person in a short window (rank-farming-cooldown, 2h by default), optionally also by IP address (rank-farming-cooldown-ip).rank-ip-protect/rank-ip-protect-players-from-guild— block ranking changes between players sharing an IP address.rank-member-protect/rank-ally-protect— block ranking changes in fights within a guild or between allies.skip-privileged-players-in-rank-positions— skips players with thefunnyguilds.ranking.exemptpermission when computing ranking positions.
Top lists
Section titled “Top lists”The top section drives player and guild top lists, available as the
{PTOP-type-x}/{GTOP-type-x} placeholders (see
Placeholders). Every type enabled in
enabled-user-tops/enabled-guild-tops is calculated separately:
- Player types:
points,kills,deaths,assists,logouts,kdr,kda. - Guild types: the same, plus
avg_*average variants (e.g.avg_points,avg_kdr,avg_kda), as well aswars_wonandwar_streak.
use-relationship-colors colors top-list entries by guild relationship
(same guild/allies/enemies), just like chat tags. The appearance of the
values themselves can additionally be graded by threshold in
format.ptop-value-formatting/format.gtop-value-formatting (e.g. a
different color for players below and above 1500 points).
Value formatting
Section titled “Value formatting”value-formatting.user, value-formatting.guild and value-formatting.ping
configure placeholders ending in -FORMAT, independently of enabled top lists.
See Configuration for examples
and range semantics.
For top lists, local {VALUE-FORMAT} in top.format.ptop/gtop selects rules as follows:
- If the type key exists in
top.format.ptop-value-formattingortop.format.gtop-value-formatting, its list is used. - An absent key inherits from
value-formatting.userorvalue-formatting.guild. - Missing rules or no matching range returns the plain value.
An empty list [] explicitly disables formatting and does not inherit. A gap in
the selected list does not trigger inheritance either. Existing top-list settings
take precedence. {VALUE} and the top-list -VALUE suffix remain raw; there is
no new top-list -VALUE-FORMAT suffix. Name and guild relationship colors are
independent of numeric formatting.
kill-points-change-format and {CHANGE} still describe the signed change
in points after combat; current-statistic formatting does not replace them.