Configuration

The config file controls how the plugin behaves: the command that opens the menu, permissions, the HUD, logging, and more. Edit it by hand in any text editor, or open it in the web editor. The editor has a config section next to your contracts, categories, and presets, and it validates every setting as you change it.

Where it lives

Oxide

oxide/config/Contracts.json

Carbon

carbon/config/Contracts.json

After editing it, reload the plugin for changes to take effect:

Oxide

o.reload Contracts

Carbon

c.reload Contracts

Tip

If a value is invalid, the plugin does not crash: it logs a warning, falls back to the default, and keeps running. Watch the server console after a reload to catch typos.

The shape

The file has one block per section. The full shape looks like this, with each block detailed on its own page below:

{
  "Command": [ ... ],
  "Permissions": { ... },
  "Rewards": { ... },
  "Score": { ... },
  "Progress": { ... },
  "Conditions": { ... },
  "HUD": { ... },
  "Reminders": { ... },
  "Logging": { ... },
  "Misc": { ... },
  "UI": { ... },
  "Version": { ... }
}

Sections

CommandThe chat and console command(s) that open the Contracts menu.

PermissionsThe permissions that gate access to Contracts, and the per-permission contract limits.

RewardsHow rewards show up in the menu, and the multipliers that decide what they pay each player.

ScoreControls players' Contract Score (CS) behavior.

ProgressControls players' contract progress behavior.

ConditionsHow the plugin orders condition checks when evaluating objective progress.

HUDPosition and collapse behavior of the on-screen contract tracker.

RemindersChat or toast nudges for contracts a player can accept and rewards they have not claimed.

UIRe-theme the Contracts UI with your own palette colors and per-type icons.

LoggingTurn on event logging, choose a format, and customize each event's log line.

MiscMiscellaneous settings, including the chat icon shown next to the plugin's messages.

Version

The Version block is written by the plugin to track which config format it last wrote. Leave it alone: it is managed automatically and is not a setting you tune. If you upgrade Contracts and the format changes, the plugin migrates the file and updates this stamp for you.