Configuration

Configuration reference

Wiki home · Player commands · Get help

Understand the generated files, bundled settings, and which changes require a restart.

This wiki documents Civilizations 1.0.1. Numbers are bundled defaults; in-game menus and previews show your server’s current values.

On this page: Files and their responsibilities · Main setting groups and defaults · Reloads and catalog upgrades

The complete defaults are committed under src/main/resources/. Edit the generated files under plugins/Civilizations/ on the running server. Use spaces for YAML indentation and preserve material names, resource identities, and prerequisite keys.

Files and their responsibilities

File	What it controls
config.yml	Database, server identity, worlds, membership, claims, plots, travel, economy, enforcement, war, protection, integrations, scheduler intervals
resources.yml	Civic families/items, recipes, accepted logs, tier conversion ratio, creative deposits, claim-cost bands
technologies.yml	Technology keys, prerequisites, Knowledge/material costs, duration, capabilities, numerical modifiers, displayed-age milestones
workorders.yml	Persistent order categories, resource targets, weights, eligibility, Knowledge rewards, completion cooldown
religion.yml	Gods, icons, offerings, potion effects, amplifiers, blessing duration, per-god cooldown
messages.yml	Shared player-facing messages, supporting legacy & colors; not every string in the plugin is externalized
plugin.yml	Packaged plugin identity, registered commands, permissions, and optional dependencies; not a generated gameplay settings file

A resource amount uses a stable key such as "masonry:2": 4. It means four Tier 2 masonry civic items, not four vanilla stone bricks. A potion amplifier in religion.yml is zero-based: 0 means level I and 1 means level II.

Main setting groups and defaults

Group / key	Bundled default	Meaning
server-id	primary	Stable audit identity; one active server per schema
database.*	Local MySQL, port 3306, pool 10, timeout 5000 ms, retry 30 s	Credentials and connectivity; change the placeholder password
worlds.allowed	["world"]	Founding/new-claim world allowlist; empty means all worlds
worlds.blacklisted-biomes	[]	Additional biome restrictions
worlds.fail-closed-during-warmup	true	Required protection invariant while territory data is unknown
chat.local-radius-blocks	100	Same-world local chat range
founding.minimum-distance-chunks	12	Founding separation rule
founding.peace-shield-days	14	Initial protection from campaign declarations
founding.money-cost / material-cost	0; 4 masonry:1, 2 timber:1	Personal founding payment
membership.invite-expiry-minutes	10	Invitation lifetime
membership.change-cooldown-hours	24	Membership-change cooldown after departure
membership.established-after-hours	72	Membership age needed for establishment
membership.established-active-minutes / established-window-days	120 / 14	Activity requirement and rolling window
membership.advisor-base-limit	3	Advisor slots before technology bonuses
claims.base-capacity / established-member-bonus / absolute-cap	8 / 2 / 128	Claim-capacity calculation
claims.refund-percent	50	Eligible unclaim resource refund
claims.capital-move-cooldown-days / capital-move-cost	7; 2 masonry:2, 1 timber:2	Moving the capital
plots.base-limit / default-price	4 / 100.00	Private-plot capacity and initial default listing price
plots.sale-tax-percent	10	One-time private resale share paid to the treasury
plots.confirmation-seconds	30	Plot/confirmation lifetime where used
plots.home-enabled / home-warmup-seconds / home-cooldown-seconds	true / 5 / 60	Civilization home travel
economy.mode	DISABLED	Enable VAULT for currency-backed gameplay
technology.enforcement / cancellation-grace-minutes	STRICT / 5	Capability checks and research cancellation
travel.warmup-seconds / cooldown-seconds	5 / 60	Shared dimension-travel timing
travel.safe-search-radius	8	Search radius around the fixed Overworld return anchor
travel.claim-protection-radius-chunks	1	Public reservation around each configured anchor
travel.destinations.*	world, world_nether, world_the_end	Travel target world names; optional coordinates apply to the Overworld return
war.timezone / weekday / start-time / end-time	America/Los_Angeles / SATURDAY / 14:00 / 18:00	Weekly campaign window
war.notice-hours / truce-days	24 / 7	Declaration notice and post-campaign truce
war.declaration-grace-minutes	10	Declaration cancellation deadline
war.minimum-established-members	3	Established members required on each side
war.capital-monument-radius / capital-monument-height	3 / 8	Protected capital monument dimensions
war.allow-capital-combat / attacker-block-drops	true / true	Campaign combat and drop policy
war.declaration-cost	4 masonry:2, 4 timber:2, 2 metalwork:2	Shared-resource cost in addition to a Charter
war.siege-place-materials / tnt-breakable-materials / always-protected-materials	Explicit material lists	Allowed siege construction and destruction; see full configuration
protection.friendly-fire-own-claims / friendly-fire-wilderness	false / true	Civilization friendly-fire policy
protection.protect-animals / block-mob-griefing	true / true	Entity/environment protection
integrations.worldguard / placeholderapi / coreprotect	All true	Enable detection/use when installed
notifications.claim-entry-seconds	3	Claim-entry notification interval
notifications.research-check-seconds / war-tick-seconds	30 / 1	Research and war processing intervals
notifications.invariant-check-minutes	30	Periodic data-consistency scan

Leadership succession is player-initiated through /civ claimleadership after a fixed 7 days offline. The legacy membership.inactivity-succession-enabled, inactivity-days, and succession-notice-hours settings remain reserved for automatic succession and do not enable, disable, delay, or change this command. No automatic transfer or additional notice period applies.

The 12-hour /wild cooldown, random-search bounds, and weekly tax period are implementation constants, not existing YAML settings. The weekly tax amount is civilization-specific database state set by /civ taxes set; it is not plots.sale-tax-percent.

Reloads and catalog upgrades

/civ admin reload reloads messages.yml and validates config.yml. It does not replace the live database, gameplay, integration, scheduler, or catalog configuration. Fully restart after changing those settings. Do not use a plugin manager or /reload to replace a running Civilizations instance.

Catalogs have catalog-version markers. When a file’s version differs from the shipped version, startup backs up that file as a .pre-v*.bak file and restores the packaged catalog (the religion v1→v2 upgrade instead changes Demeter’s default wheat offering to bread while preserving other settings); a legacy work-order format also has an upgrade path. Review and reapply compatible custom balancing after that upgrade. Do not simply bump the version marker to bypass a required format conversion.

Resource keys, technology keys, recipe versions, and world UUIDs participate in persistent identity. Preserve deployed keys and the matching worlds. Renaming/removing a used key requires an intentional data migration, not just a cosmetic YAML edit. Display names and balancing also need a restart and a review of their effect on existing items/orders.

---

Continue reading: Server setup and installation · Permissions · Administration and maintenance