HelicoprionBalance

Configuration

Cap, failure behaviour and player-facing messages.

On this page3 sections

Behaviour
Messages
A worked example

Configuration lives in config.json in the plugin folder. Changes apply with HelicoprionBalance.Reload.

Behaviour

Setting	Default	What it does
`DisableConversion`	`false`	Blocks conversion outright. The item stays a normal item and is never lost.
`MaxSuccessChancePercent`	`90.0`	Ceiling on the effective conversion chance. The default is the game's own cap, so it changes nothing until you lower it.
`BlockLevelUpsAtCap`	`true`	Refuses crafting-skill level-ups on matching creatures at or over the cap. The point stays unspent.
`KeepItemOnFailedRoll`	`false`	`false` destroys the item on a capped failure, like a vanilla failure. `true` returns it.
`DinoTags`	`["Helicoprion"]`	Which creatures the rules apply to.
`StatBaseOffset`	`1.0`	Advanced. Works together with the setting below to turn the creature's stat into the percentage shown in game. Leave at the default.
`StatToPercentMultiplier`	`100.0`	Advanced. Converts the creature's stat value to a percentage. Leave at the default unless a game change makes the logged percentage disagree with what you see in game.
`DebugLogging`	`false`	Verbose logging. Leave off in production.

Messages

Everything players see is under Messages and is yours to reword.

Setting	Default	What it does
`NotifyTribe`	`true`	Sends the message to the creature's owning tribe on a block or failure.
`SenderName`	`Helicoprion`	The name the chat message appears to come from.
`Blocked`	—	Shown when `DisableConversion` stopped a conversion.
`FailedItemKept`	—	Shown on a failure when `KeepItemOnFailedRoll` is on.
`FailedItemLost`	—	Shown on a failure when the item was destroyed.
`LevelCapReached`	—	Shown when a level-up is refused. `{}` is replaced with the cap percentage.

Keep the placeholder

LevelCapReached is the only message with a {} placeholder. Removing it drops the cap value from the message; it is not an error, but players lose the useful part.

A worked example

To let blueprints exist but stay rare — a 30% ceiling, wasted points refused, and failures costing the item as they do in vanilla:

json

"DisableConversion": false,
"MaxSuccessChancePercent": 30.0,
"BlockLevelUpsAtCap": true,
"KeepItemOnFailedRoll": false