Space Engineers

Space Engineers

Space Anchor
moon fangirl  [developer] 30 Dec, 2016 @ 1:13pm
Config Details
The config allows pretty much complete control over the mod (other than the defined CubeBlock properties). The file is generated automatically after the first run and can be regenerated to default using a command. the file itself is located at '%appdata%\SpaceEngineers\Saves\<Steam 64 ID>\<World Name>\Storage\826024934.sbm_SpaceAnchor\settings.cfg', and is unique to each world. If you want the same on multiple worlds, then as long as the folder structure of the save is the same you can just copy and paste.

The file itself is stored as XML, and if it can't be loaded it should reset back to default settings. The structure is as follows:

<LargeChargeInput>300</LargeChargeInput>
This is the input in MW of the large grid anchor while it is charging. While you can override this with the thruster override, this doesn't lock out the thruster axis the game considers the block to be pointing, and doesn't have the limit of 1000MW as the slider does. Decimal values are allowed, but it can only be a number.

<LargeRunInput>50</LargeRunInput>
This is the input in MW of the large grid anchor while it is running normally. This is the only way to change this value, since it wouldn't make sense to use the thruster override for it.

<LargeChargeAmount>25</LargeChargeAmount>
This is the amount in MWh of the large grid anchor will need to store before it starts running. I believe a value of 0 should disable charging entirely, however I haven't tested this yet. This is the only way to change this value, since it wouldn't make sense to use the thruster override for it.

<SmallChargeInput>100</SmallChargeInput>
The same as the large grid config but for the small grid anchor. The thruster override slider only has a limit of 400MW, for the small grid, however.

<SmallRunInput>20</SmallRunInput>
The same as the large grid equivalent config but for the small grid anchor.

<SmallChargeAmount>16</SmallChargeAmount>
The same as the large grid equivalent config but for the small grid anchor.

<AdminBlockInstantCharge>true</AdminBlockInstantCharge>
Contrary to how it sounds, this option is for enabling and disabling the ability to put 'charge_now' (without quotes) in the custom data of the admin anchor to instantly charge it. This is for if you wanted to use it like a normal anchor but 1x1x1 (which I wouldn't recommend, since some features are disabled on it). The admin block itself uses the large grid anchor settings, but has a much higher thruster override setting (allowing up to 10GW of consumption)

<LocalisedStrings>...</LocalisedStrings>
This is a dictionary of strings that allows custom text to be displayed and outputted by the anchor blocks (this is mainly so that you can localise for your language if you want). The strings are as follows:

str_disabled_info
The full text for when the anchor is disabled.

str_charging_info
The formattable text for when the anchor is charging (this uses {0} for the current charge, {1} for the maximum charge and {3} for the localisation of MWh) (to learn more visit the Microsoft C# String Formatting[msdn.microsoft.com] page, although some of it might be a little complicated to someone who hasn't seen any of this before, just make sure that you only include the stated curly brackets, since it won't format correctly otherwise).

str_running_info
The full text for when the anchor is running.

str_megawatt_hours
The localisation of MWh (megawatt hours).

For the first 3 strings, they are all actually formatted exactly the same as str_charging_info, however you don't need to include all of the formatting items in the string, it just cannot contain any more. The disabled string will just use 0 for the megawatt hours, and the running string will just use the maximum charge amount for the megawatt hours (both in the {0} item), meaning you can use the same kind of formatting for them if you wanted.

Finally, to reset the settings, type '/spaceanchor settings reset' in the main chat (without quotes). This will reset the settings file and the current loaded settings (meaning all current space anchors will have the values updated). Only use this command if you know what you are doing.
Last edited by moon fangirl; 30 Dec, 2016 @ 7:46pm
< >
Showing 1-4 of 4 comments
Airomis 31 Dec, 2016 @ 3:36pm 
What are all the commands that can be placed in the admin custom data?
moon fangirl  [developer] 31 Dec, 2016 @ 3:38pm 
Originally posted by Airomis:
What are all the commands that can be placed in the admin custom data?
currently just the 'charge_now', but at some point (it will be written up somewhere on this item) i will add a proper command set to allow fine tuning of the admin block. it just not a necessity at the moment, but it will be done at some point.
Airomis 31 Dec, 2016 @ 7:29pm 
Dose the admin block need power to run?
moon fangirl  [developer] 31 Dec, 2016 @ 7:31pm 
at the moment, yes. i will allow for it to be changed in the future
< >
Showing 1-4 of 4 comments
Per page: 1530 50