SettlementCharts

Settlement Charts

Raids on player settlements become opt-in. A settlement is only a valid raid target while its cartography table is charted. Wilderness events are left exactly as vanilla.

Built for Mistwalkers RP, a whitelisted no-map Valheim server.

How it works

Branches on each event's own nearBaseOnly flag rather than a hardcoded list, so new events are handled without changes here.

| | nearBaseOnly: false | nearBaseOnly: true | |---|---|---| | Eligibility | vanilla | charted table within chartRadius | | Anchor | player position | table position | | Radius | vanilla 96m | eventRadius | | Currently | wolves | everything else |

Raid frequency is untouched. Interval and chance stay under the server's raid modifier. Expect the effective rate to fall below nominal, since rolls landing on no occupied charted settlement produce nothing.

Charting

Shift + E on a cartography table opens a naming dialog, pre-filled with whatever the settlement was last called. Confirm and it is charted; cancel and nothing happens.

Shift + E on a charted table erases it immediately, with no dialog.

Erasing never stops a raid already running. Events own their timer once started, and the charted state is read at selection time only.

Map markers

Charted settlements appear as named pins on every player's map. The server reads all cartography table ZDOs, loaded or not, and broadcasts the set. Pins are not written to player map files, so erasing leaves no ghosts.

With the nomap modifier, these are visible only while reading a map at a table.

Console commands

| Command | Purpose | |---|---| | chart | Toggle the nearest table | | chartcheck | Whether a raid could fire where you stand | | chartlist | Every loaded table and its state | | chartevents | Run the real selector, print survivors | | chartforce | Roll for a raid now, through the filter | | charttimer | Read or set roll interval and chance | | chartdiag | Probe prefab name and minimap availability |

charttimer writes live world values. Do not leave it cranked on a live server.

Installation

Required on both client and server.