Three kinds of key, and they carry very different risk:
Connection — where the sidecar is, and how much the plugin may buffer.
Sweep intervals — how often the plugin walks part of the world. These are the
performance dial. Every sweep runs on the game’s core thread, so shortening one costs
the game, not the sidecar.
Caps and switches — feature toggles, and the bounds on anything a player can
influence.
Bounded queue depth. Full means drop-oldest — never block the game
PublicConnectAddress
Address players connect to, published to the site
LinkUrl
Where in-game account linking sends a player
Sweeps
Key
What it is for
StatSweepSeconds
Character stat sweep interval
DecaySweepSeconds
House decay sweep
EconomySweepSeconds
Economy totals sweep
ChampSweepSeconds
Champion spawn sweep
PageSweepSeconds
Staff page sweep
GuildSweepSeconds
Guild roster sweep
CitySweepSeconds
City / governor sweep
PresenceSweepSeconds
Who is online
HousingSweepSeconds
Housing sweep
Guilds
Key
What it is for
GuildRosterMembersPerLine
Frame cap — a roster is split rather than sent oversized
GuildRosterGuildsPerTick
How many guilds are swept per tick
Points
Key
What it is for
PointsSweepSeconds
Points sweep interval
PointsLeaderboardEnabled
Publish a leaderboard at all
PointsTopN
Leaderboard length
PointsSystems
Which point systems to include
PointsProfileEnabled
Show points on a character profile
PointsProfileRank
Show rank as well as total
Market
Key
What it is for
MarketEnabled
Publish player vendor listings
MarketSweepSeconds
Market sweep interval
MarketSweepBatch
Vendors per sweep
MarketMaxListings
Cap on listings published
Ruleset
Key
What it is for
RulesetEnabled
Publish the shard ruleset
RulesetIncludeSchedule
Include the event schedule with it
Town crier
Key
What it is for
TownCrierMaxLines
Lines per notice
TownCrierMaxLineLength
Characters per line
TownCrierMaxActive
Concurrent notices
TownCrierMaxDurationSec
Longest a notice may run
News
Key
What it is for
NewsMaxTitleLength
Title cap
NewsMaxBodyLength
Body cap
NewsMaxExternal
How many site posts are carried in-game
NewsAnnounceDurationSec
How long an announcement shows
Admin commands
Key
What it is for
AdminWriteEnabled
Whether the site may write to the game at all. Off by default
AdminAccessFloor
Minimum in-game access level for admin actions
AdminBroadcastMaxLength
Broadcast cap
AdminReasonMaxLength
Reason field cap
AdminBanMaxDurationSec
Longest ban the site may set
Scheduled events
Key
What it is for
EventsEnabled
Whether the website may run scheduled events against this world at all. Off by default, and deliberately a separate switch from AdminWriteEnabled
EventsSweepSeconds
How often expired gates are collected and lost objects pruned
EventsMinSaveIntervalSec
Shortest gap between world saves, counted from the last save by anyone. A save asked for too soon is refused rather than queued
Event caps
Key
What it is for
EventsMaxCreatures
Creatures one call may spawn
EventsMaxBosses
Enhanced "boss" variants one call may spawn
EventsMaxNpcs
Oracle NPCs one call may place
EventsMaxDecor
Decoration items one call may place
EventsMaxGateMinutes
Longest a temporary gate may stand
EventsMaxOwnedPerRun
Objects one run may own across every verb — the runaway bound
EventsMaxSpread
How far from the chosen spot things may be scattered
EventsMaxBossMultiplier
How much harder than normal a boss may be made
EventsMaxGrantPerRun
How many characters one item grant may reach
EventsMaxGrantStack
How large one granted stack may be
The oracle NPC
Key
What it is for
EventsOracleMaxLines
Keyword lines it will answer to
EventsOracleGreetRange
How close a player must be to be greeted
EventsOracleSpeechRange
How close a player must be to be heard
EventsOracleGreetCooldownSec
How often it greets the same player
EventsOracleAnswerCooldownSec
How often it answers the same player
Leases
Key
What it is for
LeaseMaxDurationSec
Longest lease this shard will hold, whatever the site asks for. A longer request is refused rather than shortened
LeaseGraceSec
How long a restored lease stays listed, so a late teardown still gets a verdict
Participation
Key
What it is for
ParticipationSweepSeconds
How often everyone standing in a run's area is credited
ParticipationKillWeight
What one kill inside the area is worth against one minute in it
ParticipationMaxRuns
Runs counted at once
ParticipationMaxMembers
Members counted per run
ParticipationMaxRadius
Widest area an event may declare
ParticipationGraceSec
How long a closed run's tally stays readable
ParticipationSnapshotChunk
Members resolved per yield of the game's core thread
Accounts
Key
What it is for
SignupMode
How game accounts may be created
AccountCreateEnabled
Allow creation at all
RequireIpForCreate
Require a real client IP
AccountNameMaxLength
Account name cap
AccountPasswordMaxLength
Account password cap
This list is checked against the shipped Bridge.cfg on every build, so a key added by a
protocol change turns this page red rather than going undocumented.
QueueCap bounds the drop-oldest queue between the game and the writer thread. When it
fills, the oldest events are discarded — which is the correct behaviour, because the
alternative is a game server that stutters when a sidecar is slow. Raising it buys tolerance
for longer sidecar outages at the cost of memory; it never buys correctness.
GuildRosterMembersPerLine exists because a roster is the only fat frame this bridge
emits — a real 155-member guild measured about 10.8 KB. Rosters are split across lines
rather than sent oversized. See The bridge.
The shipped
Bridge.cfg
is the authority;
link/PLAN.md
§10 documents the config keys and
SHARD_PREREQS.md
covers what a shard needs before any of this works.
