StructurePickUpBalance
Configuration
Modes, exemptions and notification wording.
Configuration lives in config.json in the plugin folder. Comments using // are supported, so the shipped file is annotated inline.
| Key | What it does |
|---|---|
Enabled | Master switch for the plugin. |
Mode | Demolish, Destroy, Block or Vanilla. An unrecognised value logs a warning and falls back to Demolish. |
ExemptBlueprintPaths | Substring matches against blueprint paths. An exempt structure keeps stock pickup behaviour. |
DependentsRemovedText | The message shown to the player after a collapse. Takes the number of collapsed structures. |
LogActions | Logs one line per removed structure. Useful while verifying, noisy in production. |
LogActions is very verbose
It writes a line for every structure removed. One pickup of a large build can produce hundreds of lines, so turn it off once you have confirmed the behaviour you wanted.
Exemptions
ExemptBlueprintPaths is matched as a substring, and where the match lands changes the effect:
- Exempt the structure being picked up, and the whole chain behaves as vanilla.
- Exempt a dependent, and that structure alone is still picked up rather than collapsing.
Choosing a mode
- Demolish — the usual choice. Collapses refund as a manual demolish would, which keeps pickup and demolish consistent.
- Block — the strictest option. Players simply cannot pick up a structure that is holding something else up.
- Destroy — collapses without a refund. This is the least exercised path; try it on a test server before running it on a live cluster.
- Vanilla — leaves stock behaviour in place, useful for temporarily disabling the plugin without removing it.
Changing mode mid-session
Edit the config and run
SPB.Reload. There is no need to restart the server to switch modes.