Skip to content

Mayor Election

LordFinn - Yannick Suc edited this page Aug 28, 2026 · 1 revision

Mayor Election

An optional, in-app election feature: a candidate list with campaign posters, in-app voting with a cooldown, and commands to manage candidates and toggle the feature. Works on both NeoForge and Fabric - see Architecture § Platform support.

For players

Vote for a candidate from the phone's mayor screen - each vote runs the same /crazyphone mayor vote <number> command the button itself calls, so it's usable by any player without extra permissions. Votes are subject to a cooldown to prevent spamming the same choice repeatedly.

For admins

All admin-side management goes through /crazyphone mayor ... - see Commands § Mayor election for the full list:

  • Add/remove candidates by phone number.
  • Attach a campaign poster image to a candidate (NeoForge only for now - see the command's own note).
  • Open/close voting independently of whether the feature is visible at all.
  • Enable/disable the whole feature.
  • View current vote tallies, or clear a single player's vote (e.g. to let them re-vote).

Configuration

mayorElectionFeatureEnabled is the global on/off switch, also reachable at runtime via /crazyphone feature mayor_voting <true|false> on NeoForge. A permission node (crazyphone.feature.mayor_voting) can further restrict who's allowed to vote, if a permission plugin is installed - see Configuration.

Clone this wiki locally