Admin‐Guide

Admin Guide

Admin tools: /cadmin commands and the settings that can be changed while the server runs.

Access

/cadmin needs the controlserver privilege and a role listed in ROLE_CODES_WITH_ADMIN_RIGHTS (default: admin). Admins also see the Administration tab of the main window (Ctrl+Shift+U): world flags, cities, settings, prices and players.

Daily and hourly processing

Command	What it does
/cadmin nday	Run the daily charge now: upkeep, fees, taxes, debt
/cadmin nhour	Run the hourly tick now: prison hours, village supplies, announced raises
/cadmin backup	Make a manual backup — see Backups
/cadmin diag <player>	A player's city, mayor state and permissions, for debugging

Cities (/cadmin city)

Command	What it does
/cadmin city new <city>	Found a city with no mayor on the plot you stand on
/cadmin city delete <city>	Delete a city
/cadmin city claim <city>	Claim the plot you stand on for the city
/cadmin city radiusclaim <city> <radius>	Claim every plot around you within the radius
/cadmin city unclaim <city>	Unclaim the plot you stand on
/cadmin city add <city> <player>	Put a player into the city
/cadmin city kick <city> <player>	Remove a player from the city

City settings (/cadmin city set)

Command	What it does
/cadmin city set name <city> <newName>	Rename
/cadmin city set mayor <city> <player>	Change the mayor
/cadmin city set pvp|fire|blast|nomobspawn <city> on|off	City defaults
/cadmin city set open <city> on|off	Open or closed
/cadmin city set fee <city> <amount>	Citizen fee
/cadmin city set technical <city> on|off	A technical city pays no upkeep — for spawn towns and NPC cities
/cadmin city set bonusclaims <city> <amount>	Extra plots on top of the level
/cadmin city set tier <city> city|village	Turn a city into a village or back

Turning a city into a village gives it a village pole and a granary. Turning a village into a city takes both down and drops what was stored.

Plots (/cadmin plot)

These work on the plot you stand on and ignore the usual rules (disabled types included).

Command	What it does
/cadmin plot set permissions <group> <type> on|off	Access rights (alias p)
/cadmin plot set pvp|fire|blast|nomobspawn on|off	Flags
/cadmin plot type <type>	Any type, including mainplot
/cadmin plot fee <amount>	Plot tax
/cadmin plot fs <price>	Put it up for sale

World flags (/cadmin world)

Command	What it does
/cadmin world info	World statistics and flags
/cadmin world set <flag> on|off	Change a flag

Flag	Meaning
pvpew, fireew, blastew, mobspawnew	Everywhere: allowed in the whole world, whatever the plots say
pvpfb, firefb, blastfb, mobspawnfb	Forbidden: not allowed anywhere, whatever the plots say

Everywhere wins over forbidden when both are on.

Wars

Command	What it does
/cadmin startwar <party1> <party2>	Start a war between two cities or alliances
/cadmin setbattledate <party1> <party2> [minutesUntilStart] [durationMinutes]	Schedule a battle now
/cadmin endwar <party1> <party2>	End a war
/cadmin testwar create [name1] [name2]	Two throwaway cities next to you, at war — for trying wars out
/cadmin testwar ranges <party1> <party2> <days> <HH:mm> [minutes]	Set their battle schedule
/cadmin testwar remove	Delete everything testwar made

Live settings (/cadmin setcfg)

/cadmin setcfg <key> <value>

The value is range-checked, saved to claims.json and sent to every online player — no restart. The same values are on the settings pages of the Administration tab. An unknown key or a value out of range is refused with the allowed range.

Area	Keys
Capture flags	flag_capture_seconds, flag_reinforcement, flag_max_active, flag_defender_interrupt, flag_defender_radius, flag_regress_mult
Battles	min_days_between_battles, war_battle_warn_minutes, war_allowed_battle_days, war_schedule_timezone
War score	score_enabled, score_to_win, score_per_capture, score_per_kill, score_per_hold, score_hold_seconds
Spoils	pillage_enabled, pillage_percent, war_plunder_on_kill_enabled, war_plunder_on_kill_percent, war_bounty_enabled, war_bounty_min
Camps	camp_enabled, camp_max_per_conflict, camp_cost, camp_min_distance, camp_anchor_breaks
Respawn safe zone	safezone_enabled, safezone_radius, safezone_seconds
Siege	siege_enabled, siege_tick_seconds, siege_range, siege_cost
Declaring war	war_declaration_cost, war_redeclare_cooldown_days, war_require_casus_belli, war_casus_belli_grace_days
Peace and pacts	war_peace_terms_enabled, war_vassal_tribute, war_vassal_duration_days, war_nap_enabled, war_nap_default_days, war_nap_max_days, war_nap_break_penalty, war_ultimatum_enabled, war_ultimatum_expire_hours
War display	war_report_enabled, war_hud_enabled
Boats	boat_share_with_city, boat_share_with_alliance
Villages	village_enabled, village_create_cost, village_max_plots, village_max_citizens, village_min_distance, village_upgrade_cost, village_upgrade_min_citizens, village_supply_hours_per_item, village_decay_hours, village_raidable, village_raid_duration_seconds, village_anchor_breaks, village_raid_grace_days, village_refound_cooldown_hours, village_site_cooldown_hours, village_abandon_cooldown_hours, village_ruin_radius_plots
Land market	city_plot_trade_enabled, city_plot_trade_gui, city_plot_trade_remote_buy, city_plot_trade_require_adjacency, city_plot_trade_history_shown
Auctions	city_plot_auction_enabled, auction_min_hours, auction_max_hours, auction_default_hours, auction_min_increment, auction_extend_window_seconds
Bankruptcy	city_bankruptcy_mode (off, plots, whole_city), city_bankruptcy_grace_days, city_bankruptcy_start_price_factor
Respawn	temple_respawn, temple_respawn_choice, temple_respawn_choice_gui
Flag costs	plot_no_mobspawn_flag_cost, plot_no_pvp_flag_cost
Plot types	plot_cost_<type> (daily upkeep), plot_set_cost_<type> (one-time price)
Plot groups	max_plotsgroup_fee, plotsgroup_fee_raise_delay_hours
Sub-plots	max_subplot_tax, subplot_tax_raise_delay_hours, subplot_max_boxes, subplot_max_per_city, subplot_max_owned_per_player, subplot_max_volume, subplot_min_volume
Daily cycle	day_duration_seconds, day_start_offset_seconds, day_max_missed_cycles

On/off keys take on/off, true/false or yes/no. war_schedule_timezone takes a zone id with spaces, e.g. W. Europe Standard Time.

What each setting does is on the page of its feature: War and Conflicts, Villages, Land Market, Sub-Plots, Economy, Shared Boats.

Settings only in claims.json

Change these with the server stopped:

Key	Default	Meaning
PLOT_SIZE	16	Plot width in blocks (16 or 32). Never change it on a running world
NEUTRALITY_ENABLED	true	Allow neutrality at all
DELETE_CITIZEN_FROM_CITY_IF_DOESN_PAY_FEE	false	Remove citizens who cannot pay
DELETE_CITY_IF_DOESN_PAY_FEE	false	Delete cities whose debt passes the maximum
DISABLED_PLOT_TYPES	[]	Plot types players may not set
CROPS_ONLY_ON_FARM_PLOTS	false	Crops grow only on farm plots
FRUIT_ONLY_ON_ORCHARD_PLOTS	false	Fruit trees bear fruit only on orchard plots
MIN_DISTANCE_FROM_OTHER_CITY_NEW_CITY	3	Plots between a new city and the nearest one
MAX_PLOTS_GROUP_PER_CITY	5	Plot groups per city
VERBOSE_LOGGING	true	More detail in the server log

Tips

• /cadmin nday tests the daily charge without waiting a day.
• /cadmin city radiusclaim lays out a spawn town quickly; mark it technical so it pays nothing.
• bonusclaims grants extra land without touching the level table.
• Before updating the mod, make a backup — see Installation.

See also

• Installation
• Backups
• Commands