MyTown Mod — Configuration

Ranks and Permissions

MyTown controls who can run which commands through permission nodes (for example mytown.cmd.assistant.claim), and it groups those permissions into ranks. Common rank tiers referenced throughout the commands are the mayor, assistants, and regular residents, plus outsiders who are not in the town.

With the modifiableRanks config option enabled, towns can manage their own ranks. /town ranks list lists a town's ranks. /town ranks add <name> [templateRank] creates a rank, optionally copying the permissions of an existing template rank. /town ranks remove <rank> deletes a rank, except ranks of type mayor or default. /town ranks set <rank> <type> sets a rank's type, where the type may be default (automatically given to any player who joins; unique), mayor (the mayor rank; unique), or regular (any other rank).

Individual permissions are managed with /town ranks perm add|remove <rank> <perm> and listed with /town ranks perm list [rank]. /town promote <resident> <rank> promotes a resident to a non-mayor rank. If a town's ranks have drifted out of date, /town ranks reset restores them to their default state.

Admin Commands

Administrators manage the server through the /townadmin command (aliases /ta and /mytownadmin; regular /town may also be written /t or /mytown). Admins can create special AdminTowns with /townadmin new <name>, which by default have no residents and no ranks, and delete any town with /townadmin delete <town>. They can place or remove residents directly using /townadmin add <resident> <town> [rank] and /townadmin kick <resident> <town>.

Admins can claim and unclaim land for any town with /townadmin claim <town> [range] and /townadmin unclaim, adjust a town's extra block allowance and far-claim allowance with the /townadmin blocks extra and /townadmin blocks far commands (both default to 0 per town), and grant a resident extra blocks via /townadmin res blocks extra. Town, plot, and Wilderness flags can all be edited through the /townadmin perm commands, and ranks and plots have full admin equivalents of the player-facing commands.

Server maintenance commands include /townadmin config reload, which reloads the main config plus all protection files and the rank, Wilderness, and flag config files, and /townadmin safemode <on|off> to restrict the server to operators (noted as not fully working). For the database, the console-only /townadmin db purge completely wipes the mod's tables — a destructive operation.