Skip to content

3.0 Configuration File

Joseph Korinek edited this page Jul 8, 2016 · 25 revisions

Home || Prev || Next

Section 1 Accessing Ship Manifest
Section 2 Basic Operations
Section 4 SMInterface.dll


Configuration File

The configuration file for all settings persisted in Ship Manifest is located in the GameData\ShipManifest\Plugins\PluginData folder. The default file that is automatically created on first time run is shown below.

SM_Windows
{
	ManifestPosition
	{
		x = 524
		y = 792
		width = 316
		height = 288
	}
	TransferPosition
	{
		x = 841
		y = 791
		width = 622
		height = 289
	}
	DebuggerPosition
	{
		x = 221
		y = 68
		width = 516
		height = 360
	}
	SettingsPosition
	{
		x = 609
		y = 396
		width = 391
		height = 374
	}
	ControlPosition
	{
		x = 303
		y = 98
		width = 386
		height = 284
	}
	RosterPosition
	{
		x = 217
		y = 142
		width = 423
		height = 270
	}
}
SM_Settings
{
	ShowDebugger = False
	RealismMode = True
	LockSettings = False
	VerboseLogging = False
	AutoSave = False
	SaveIntervalSec = 60
	FlowRate = 100
	FlowCost = 0.00150000001303852
	MinFlowRate = 0
	MaxFlowRate = 1000
	MaxFlowTimeSec = 100
	EnableXferCost = True
	PumpSoundStart = ShipManifest/Sounds/59328-1
	PumpSoundRun = ShipManifest/Sounds/59328-2
	PumpSoundStop = ShipManifest/Sounds/59328-3
	CrewSoundStart = ShipManifest/Sounds/14214-1
	CrewSoundRun = ShipManifest/Sounds/14214-2
	CrewSoundStop = ShipManifest/Sounds/14214-3
	EnableHighlighting = True
	OnlySourceTarget = False
	EnableCLSHighlighting = True
	EnableCrew = True
	EnableScience = True
	EnableResources = True
	EnablePFResources = True
	EnableCLS = True
	EnableStockCrewXfer = True
	OverrideStockCrewXfer = True
	EnableBlizzyToolbar = False
	AutoDebug = False
	DebugLogPath = Plugins\PluginData\
	ErrorLogLength = 1000
	SaveLogOnExit = False
	EnableKerbalRename = True
	RenameWithProfession = True
	ShowToolTips = True
	ManifestToolTips = True
	TransferToolTips = True
	SettingsToolTips = True
	RosterToolTips = True
	HatchToolTips = True
	PanelToolTips = True
	AntennaToolTips = True
	LightToolTips = True
	DebuggerToolTips = True
}
SM_Hidden
{
	SourcePartColor = red
	TargetPartColor = green
	TargetPartCrewColor = blue
	MouseOverColor = green
	PumpSoundVol = 3
	CrewSoundVol = 3
	CrewXferDelaySec = 7
	IvaUpdateFrameDelay = 20
	ShowIVAUpdateBtn = False
}

This file can be edited externally. In the case of Locking Realism settings, you must edit this file outside the game to unlock the realism settings. Note that while you can edit and save the file with the game running, it will not retain your changes, due to the nature of the way Ship Manifest manages this file.

SM_Window settings

These settings are managed by Ship Manifest when you move windows around the screen. They remember the positions of your windows between scenes and between game sessions.

You can directly edit these values if you wish. However, if you place a window "outside" the screen dimensions, SM will automatically move the window to the appropriate screen edge, so your windows do not end up hidden.

When updating Ship Manifest, if you save your SMSettings.dat before the upgrade, you can copy these settings over the new settings file that will be generated automatically when the game is executed. This can help you "preserve" your existing window positions.

SM_Settings

These settings are exposed by the Settings window and are managed within the game. You need not edit them outside the game, unless you wish to do so. One setting must be edited in this file if it is set in the interface, and that is

  • LockSettings = False This setting is partially managed in the Settings window. To prevent "cheating" by those that want a realistic experience, but do not have the willpower to avoid turning off realism, SM offers a Lock. Once this setting is set to true, it disable all the realism buttons (including itself). The only way to turn it off and unlock the realism settings is to edit it directly in the SMSettings.dat file.

SM_Hidden

These settings are not managed via the Settings window. While they are not exposed to the interface (they are hidden), they are still available for alteration, if you are brave enough to edit this file directly. These settings are shown below with a description of their use, limits and effect.

  • SourcePartColor = red
  • TargetPartColor = green
  • TargetPartCrewColor = blue
  • MouseOverColor = green
  • PumpSoundVol = 3
  • CrewSoundVol = 3
  • CrewXferDelaySec = 7 This setting controls how long to wait before a kerbal actually moves during a Crew transfer with Realism ON. Changing this setting will alter the wait time for a crew Transfer with Realism ON to occur.
  • IvaUpdateFrameDelay = 20 After a crew transfer, in order to properly update the portraits, we need to wait a few frames to allow callback functions to complete. Changing this setting will alter the number of frames to wait for crew Transfer callbacks to occur.
  • ShowIVAUpdateBtn = False This Setting exposes a button to manually update the portraits of the kerbals (in the lower right of the screen). It is a holdover from the early days of Crew manifest, when the portraits had to be manually updated. Since that time the event model has been further explored, and portraits now update automatically.
  • *DebugLogPath = Plugins\PluginData* This setting controls where the debug log files are placed when you save them in the Debug Window. If you don't like clutter around your SMSettings.dat file, then put your debug logs somewhere else!
  • EnableOnCrewTransferEvent = True This setting is used to Enable/Disable the OnCrewTransferrred Event Trigger within SM. If true, then when a crew transfer completes, a GameEvents.Event is fired to notify other mods that a transfer has occurred. KIS uses this to move inventory when a kerbal is transferred. If you experience issues with KIS causing errors, you can set this option to False to remove the error.