Scripting Introduction: Difference between revisions
No edit summary |
(document how to apply a script to a match) |
||
Line 9: | Line 9: | ||
[[Category:Scripting]] | [[Category:Scripting]] | ||
== Using Scripts == | |||
A script can be applied to a match via [[Modifiers]] or via a [[Game Mode]] ("Rules"). | |||
=== In a modifier === | |||
Example of a modifier <code>Modifiers/Custom/FlagIsPoison.json</code> applying the <code>Scripts/Custom/FlagIsPoison.cs</code> script: | |||
<pre> | |||
{ | |||
"Objects": { | |||
"Rules": { | |||
"FlagIsPoison": { | |||
"FlagDamagePerSecond": 3.0 | |||
} | |||
} | |||
}, | |||
"Meta": { | |||
"Description": "(applies the FlagIsPoison script)", | |||
"Author": "noerw", | |||
"Version": 1.0 | |||
} | |||
} | |||
</pre> | |||
A script can be parametrized, where the parameters are defined in the modifier or rule definition. In the above example the <code>FlagDamagePerSecond</code> parameter is applied when the script class contains a <code>JsonProperty</code> with a default value: | |||
<pre> | |||
[JsonProperty("FlagDamagePerSecond")] public int flagDPSParameter = 5.0; | |||
</pre> | |||
=== In a rule / game mode === | |||
Add the script name to the <code>GameRules</code> section of the rule definition in <code>Rules/Custom/YourGameMode.json</code>: | |||
<pre> | |||
{ | |||
"Objects": { | |||
"YourGameMode": { | |||
"GameScript": { | |||
"Scripts": [ | |||
... potentially other scripts ..., | |||
"YourScriptName" | |||
] | |||
} | |||
} | |||
} | |||
} | |||
</pre> | |||
* TODO: check if parameters can be passed in this syntax too (eg <code>"Scripts": [{ "YourScriptName": { MyParam: false } }]</code> |
Revision as of 11:37, 19 January 2023
Scripting in Soldat 2 is done in a Unity/C# environment. For a script to be usable in-game, the script file must be placed under Soldat2/Scripts/
and there needs to be a ruleset that specifies that script in the GameScript object in its json - for example, see Soldat2/Rules/Standard/Climb.json
. The script can be tested by starting a game that uses that ruleset.
Scripting Resources
The Soldat 2 engine uses Unity, so it may be useful to familiarise yourself with the Unity Manual.
There is some preliminary documentation for the Soldat 2 engine, however it is currently rather limited.
Some examples of scripts can be found in your Soldat 2 game directory under the path Soldat2/Scripts/Standard/
.
Using Scripts
A script can be applied to a match via Modifiers or via a Game Mode ("Rules").
In a modifier
Example of a modifier Modifiers/Custom/FlagIsPoison.json
applying the Scripts/Custom/FlagIsPoison.cs
script:
{ "Objects": { "Rules": { "FlagIsPoison": { "FlagDamagePerSecond": 3.0 } } }, "Meta": { "Description": "(applies the FlagIsPoison script)", "Author": "noerw", "Version": 1.0 } }
A script can be parametrized, where the parameters are defined in the modifier or rule definition. In the above example the FlagDamagePerSecond
parameter is applied when the script class contains a JsonProperty
with a default value:
[JsonProperty("FlagDamagePerSecond")] public int flagDPSParameter = 5.0;
In a rule / game mode
Add the script name to the GameRules
section of the rule definition in Rules/Custom/YourGameMode.json
:
{ "Objects": { "YourGameMode": { "GameScript": { "Scripts": [ ... potentially other scripts ..., "YourScriptName" ] } } } }
- TODO: check if parameters can be passed in this syntax too (eg
"Scripts": [{ "YourScriptName": { MyParam: false } }]