Progression / MxF Factions
Season Points are a persistent, non-negative competitive score stored per normal faction ID.
Docs version
v1.0.0
Product version
1.0.0-dev
Last updated
Jul 21, 2026
# MxF Season Points
Season Points are a persistent, non-negative competitive score stored per normal faction ID.
| Command | Permission | Description |
| --- | --- | --- |
| /f points | factions.points | Shows your faction's Season Points. |
| /f points <faction> | factions.points.others | Shows another faction's Season Points. |
| /f pointstop [page] | factions.pointstop | Shows the cached Season Points leaderboard. |
| /f points add <faction> <amount> [reason] | factions.points.admin, factions.points.admin.add | Adds points. |
| /f points remove <faction> <amount> [reason] | factions.points.admin, factions.points.admin.remove | Removes points without allowing negative totals. |
| /f points set <faction> <amount> [reason] | factions.points.admin, factions.points.admin.set | Sets a faction's point total. |
| /f points refresh | factions.points.admin, factions.points.admin.refresh | Rebuilds the cached leaderboard. |
Aliases include /f seasonpoints, /f spoints, /f seasonpointstop, /f spointstop, and /f stop.
Generated file:
plugins/Factions/mxf/season-points.yml
Important sections:
enabled
number-format
default-reason
leaderboard.page-size
leaderboard.refresh-interval-seconds
leaderboard.show-zero-point-factions
audit.log-changes
audit.log-rejected-changes
messages
Data file:
plugins/Factions/data/season_points.json
Storage is keyed by FactionsUUID faction ID, so faction renames keep points intact. Disbanded factions are cleaned up through the Season Points cleanup listener.
The first safe earning hook is the existing MxF outpost interval reward. If an outpost definition has a positive season-points reward, that value is added through SeasonPointsService when the interval reward is issued.
The bundled mxf expansion supports:
%mxf_faction_season_points%
%mxf_faction_season_points_formatted%
%mxf_faction_season_rank%
%mxf_season_points_top_1_name%
%mxf_season_points_top_1_points%
%mxf_season_points_top_1_points_formatted%
Top placeholders support ranks 1 through 10.