Contract Reward Modifier

People, and Info

Authors and Contributors

DMagic: Author and maintainer

TriggerAu: Contract Reward Modifier uses a version of TriggerAu's KSP Plugin Framework

License

The code is released under the MIT license; all art assets are released under the CC-BY-SA license

FAQ

What does Contract Reward Modifier do?
- It allows you to customize the reward and penalty values for each contract and parameter type.
- You can limit the number of contracts of each type offered; or prevent any from appearing.
- All values can be set and modified through an in-game user interface.
Does CRM support contracts from other addons?
- All contract and parameter types are accessed upon startup; any types from other addons will be detected.
- Contract Configurator contracts require some special handling and cannot be completely blocked, but are otherwise supported.
Can values be set for each save file?
- Yes. Default values are set using the included config file (which can be changed and saved in-game), but any save file can set its own reward and penalty values; these will supercede values from the config file.
I don't want another icon cluttering up the toolbar or an in-game interface, can this still be used?
- Yes. The toolbar icons can be completely removed (a field in the config file can be used to reset them); the values can be set in-game to your liking, then you can remove the toolbar icons.
- There is another option, only available in the config file, that will disable all save-specific settings. All values will be set entirely using the config file.

Usage instructions

The Contract Reward Modifier window presents a set of sliders that allow for changes to all contract and parameter reward amounts, as well as several other options.

Contract and Parameter Type Selection

At the top of the window are two drop down buttons that allow for the selection of different contract and parameter types.
- A special Global Settings selection is available for both Contract and Parameter Types.
- Values can be set with the sliders under the global settings; these will be applied to all Contract/Parameter Types after pushing the Apply To All button.
All addon contract and parameter types should be available here.
Contract Configurator types are pushed to the bottom of the list to avoid any potential spoilers revealed by contract names.

Sliders

Rewards and Penalties sliders

The sliders below control the amount given for each different reward and penalty type.
Strategy values are not directly affected by these sliders, i.e. setting science to 0.1% won't affect the science rewards given while using the science strategy.
The sliders are half-way log-scale; the left half of the slider allows for 0.1 - 100% of the original value, while the right half allows for 100-1000% of the original.

Duration slider

Contract duration can be adjusted from 10-1000%, but will only affect newly offered contracts.

Contract limit sliders

The maximum number of offered and active contracts of a type can be specified; any contracts beyond this amount will be rejected when the system tries to offer new contracts.
All Contract Configurator contracts are can only be set to allow 1 or more contracts to be offered.

Additional Settings

Allow for 0% values

By default the values only go down to 0.1%; there is an option to allow for nearly 0% (0.00000001%) using the Allow 0% Values toggle.
- Using this may cause odd rounding errors and prevent further adjustments from being made to any active contracts/parameters of that type.

Alter active contracts

A toggle option is available to Alter Active Contracts as well as newly offered contracts.
- Turning this on and off while adjusting values may cause problems with reward values.
- Be default it is off; but you should stick with either turning it on, or leaving it off; don't go back and forth.

Disable toolbars

There is also toggle to completely Disable All Toolbars.
- This can be used if you have set the values you want and don't need the toolbar icon taking up space.
Toolbars can be re-enabled by changing the disableToolbar field to True at the top of the config file.
If Blizzy78's Toolbar is installed you can switch between it and the stock app launcher using the Use Stock Toolbar toggle.

Reset Contract and Parameter values to default

Contract/Parameter amounts can be reverted to the default values set in your config file using the Reset Values button.

Save values to a global config file

The current values can be saved to the global config file in your GameData folder using the Save To Config button.
- Values saved to the config file will serve as the default for current save games.
- New save files (or save files that haven't been loaded while Contract Reward Modifier has been installed) will set all contract and parameter values using the config file settings.
The config file-only disableSaveSpecificValues field allows you to bypass any values set in your save files; all values stored in the save files will be deleted.

</footer>