Lou Montana/Sandbox – User

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Add format example)
m (Add some examples)
Line 23: Line 23:


* An advanced text editor such as Visual Studio Code or Notepad++ (see [[Debugging Techniques#Code Edition|Debugging Techniques' Code Edition chapter]] for useful plugins)
* An advanced text editor such as Visual Studio Code or Notepad++ (see [[Debugging Techniques#Code Edition|Debugging Techniques' Code Edition chapter]] for useful plugins)
* Some English knowledge, helped if needed by  
* Some English knowledge, helped if needed by a translator tool such as [https://www.google.com/translate Google Translate] or [https://www.deepl.com/ DeepL]
* Access to this wiki is a plus (the Swiss flag is, too)
* Access to this wiki is a plus (the Swiss flag is, too)
* Tutorial/examples (YouTube tutorials, community tutorials, [[:Category:Example_Code|Example Code]])
* Tutorials/examples (YouTube tutorials, community tutorials, [[:Category:Example_Code|Example Code]])
* Google-Fu (a.k.a search engine skills)
* Google-Fu (a.k.a search engine skills)
* Help with a translator tool, like [https://www.google.com/translate Google Translate] or [https://www.deepl.com/ DeepL]
* {{arma3}} Discord channel: [https://discord.gg/arma/ ARMA], channel <tt>#scripting</tt>




Line 61: Line 61:
* '''DRY:''' '''D'''on't '''R'''epeat '''Y'''ourself. If you write the same code block or the same logic many times, export this code as a function and use parameters with it.
* '''DRY:''' '''D'''on't '''R'''epeat '''Y'''ourself. If you write the same code block or the same logic many times, export this code as a function and use parameters with it.
** If your code has too many levels, it is time to split and rethink it<!--
** If your code has too many levels, it is time to split and rethink it<!--
--> (e.g {{Inline code|[[if]] (something) [[then]] { [[if]] (somethingElse) [[then]] { [[if]] (anotherSomething) [[then]] { {{codecomment|/* etc */ }} }; }; };}}...)
--> (e.g {{Inline code|[[if]] (a) [[then]] { [[if]] (b) [[then]] { [[if]] (c) [[then]] { {{codecomment|/* etc */ }} }; }; };}}...)
** Do NOT use [[PreProcessor_Commands#Macros|macros]] as functions - these hinder readability. Use functions instead.
** Do NOT use [[PreProcessor Commands#Macros|macros]] as functions - these hinder readability. Use functions instead.
* Using {{codecomment|comments}} in your code must not explain ''what'' the code does, but ''why'' it is done this way (if needed).<!--
* Using {{codecomment|comments}} in your code must not explain ''what'' the code does, but ''why'' it is done this way (if needed).<!--
--> Your code organisation combined to your variable names must be enough to be read by a human.
--> Your code organisation combined to your variable names must be enough to be read by a human.
Line 95: Line 95:
| <code>private _uB = allUnits select { side _x == blufor };</code>
| <code>private _uB = allUnits select { side _x == blufor };</code>
| <code>private '''_bluforUnits''' = allUnits select { side _x == blufor };</code>
| <code>private '''_bluforUnits''' = allUnits select { side _x == blufor };</code>
|-
| <code>private _plead = leader player;</code>
| <code>private '''_playersLeader''' = leader player;</code>
|-
|-
| <code>finalAssault = true; publicVariable "finalAssault";</code>
| <code>finalAssault = true; publicVariable "finalAssault";</code>
| <code>'''PREFIX_'''finalAssault = true; publicVariable "'''PREFIX_'''finalAssault";</code>
| <code>'''PREFIX_'''finalAssault = true; publicVariable "'''PREFIX_'''finalAssault";</code>
|-
|-
| <code>player setVariable ["MoneyInPocket", true];</code>
| <code>player setVariable ["MoneyInPocket", 250, true];</code>
| <code>player setVariable ["'''PREFIX_'''MoneyInPocket", true];</code>
| <code>player setVariable ["'''PREFIX_'''MoneyInPocket", 250, true];</code>
|- style="vertical-align: top"
|
<code>{{cc|if player has less than 3/4 health}}
if (damage player > 0.25) then
{
{{cc|if the player has no first aid kit}}
if (not ("FirstAidKit" in items player))
{
{{cc|if player has room for first aid kit}}
if (player canAdd "FirstAidKit") then
{
{{cc|add first aid kit to the player}}
player addItem "FirstAidKit";
}
else
{
{{cc|set player's damage to 1/4}}
player setDamage 0.25;
};
};
};</code>
|
<code>{{cc|player will need health at this stage of the mission}}
if (
damage player > 0.25 &&
not ("FirstAidKit" in items player)) then
{
if (player canAdd "FirstAidKit") then
{
player addItem "FirstAidKit";
}
else {{cc|let's help him anyway}}
{
player setDamage 0.25;
};
};</code>
|-
|-
! colspan="2" |
! colspan="2" |
Line 144: Line 183:
switch (true) do {
switch (true) do {
case (_playerDamage >= 0.9): {hint "very damaged";};
case (_playerDamage >= 0.9): {hint "very damaged";};
case (_playerDamage >= 0.5): {  
case (_playerDamage >= 0.5): {
hint  "quite damaged";};<br>
hint  "quite damaged";};<br>
case (_playerDamage > 0): { hint "slightly damaged"; };
case (_playerDamage > 0): { hint "slightly damaged"; };
<nowiki>  </nowiki>default
<nowiki>  </nowiki>default
{<br>
{<br>
<nowiki>    </nowiki>hint "pristine";  
<nowiki>    </nowiki>hint "pristine";
<nowiki>  </nowiki>};
<nowiki>  </nowiki>};
};</code>
};</code>

Revision as of 23:47, 11 September 2019


Template:wip


Template:SideTOC Template:Stub

Category: Scripting Topics

Getting started

In the domain of development, any rule is a rule of thumb. If a rule states for example that it is better that a line of code doesn't go over 80 characters, it doesn't mean that any line must not go over 80 characters; sometimes, the situation needs it. If you have a good structure, do not change your code to enforce a single arbitrary rule. If you break many of them, you may have to change something; again, this is according to your judgement.

With that being said, let's go!

Prerequisites

  • An advanced text editor such as Visual Studio Code or Notepad++ (see Debugging Techniques' Code Edition chapter for useful plugins)
  • Some English knowledge, helped if needed by a translator tool such as Google Translate or DeepL
  • Access to this wiki is a plus (the Swiss flag is, too)
  • Tutorials/examples (YouTube tutorials, community tutorials, Example Code)
  • Google-Fu (a.k.a search engine skills)
  • Arma 3 Discord channel: ARMA, channel #scripting


Best practices

Code format

  • Whatever you do about your code's format, be consistent.
  • Choose an indentation format and stick to it. There is not especially one indent better than another (but there sure are terrible ones), again the important point here being consistency.
    • Common indentation styles are:
    • Use empty space. Line return, spaces before and after brackets, if this improves readability, use it: space is free.
    • indent with two/four spaces or one tab. Do not mix these.
    • One-lining (putting everything in one statement) memory improvement is most of the time not worth the headache it gives when trying to read it. Don't overuse it.
  • 0 = myCommand is "useful" only for editor fields that for no apparent reason refuse commands returning a value.
    You do not need it in script files.

Variable format

  • Name your variables and functions properly: While SQF is (non-noticeably) impacted by variable name length, this should not take precedence on the fact that code must be readable by a human being.
    • Your variable names must have a meaning: variables like _u instead of _uniform should not exist. _i is an accepted iteration variable name (e.g in for loops).
    • It is recommended to use camel-case your variables; camel-casing (namingLikeThis) your variables and functions make the code naturally more readable, especially for long names.
  • Prefix your public variables and setVariable with your tag in order to avoid any conflict about other mods, scripts or mission variables.
  • Make your variables private thanks to the private or params keyword in order to avoid accidental upper-scope overwriting of variables of the same name.
  • Defined constants must be UPPERCASE_WITH_UNDERSCORES (e.g #define SOME_CONST).


Code structuration

  • DRY: Don't Repeat Yourself. If you write the same code block or the same logic many times, export this code as a function and use parameters with it.
    • If your code has too many levels, it is time to split and rethink it (e.g if (a) then { if (b) then { if (c) then { /* etc */ }; }; };...)
    • Do NOT use macros as functions - these hinder readability. Use functions instead.
  • Using comments in your code must not explain what the code does, but why it is done this way (if needed). Your code organisation combined to your variable names must be enough to be read by a human.

Code/Files organisation

  • Use CfgFunctions to declare the functions that will be called frequently.
    • One Functions directory, with sub-directories if needed.
  • Use Event Scripts as needed.
  • Don't put any code in a unit's init box but eventually local commands for this specific unit - all unit's init boxes are run client-side on client connection.


Examples

Bad Example Good Example

Good Practice examples

_unit = player; private _unit = player;
private _uB = allUnits select { side _x == blufor }; private _bluforUnits = allUnits select { side _x == blufor };
private _plead = leader player; private _playersLeader = leader player;
finalAssault = true; publicVariable "finalAssault"; PREFIX_finalAssault = true; publicVariable "PREFIX_finalAssault";
player setVariable ["MoneyInPocket", 250, true]; player setVariable ["PREFIX_MoneyInPocket", 250, true];

// if player has less than 3/4 health if (damage player > 0.25) then { // if the player has no first aid kit if (not ("FirstAidKit" in items player)) { // if player has room for first aid kit if (player canAdd "FirstAidKit") then { // add first aid kit to the player player addItem "FirstAidKit"; } else { // set player's damage to 1/4 player setDamage 0.25; }; }; };

// player will need health at this stage of the mission if ( damage player > 0.25 && not ("FirstAidKit" in items player)) then { if (player canAdd "FirstAidKit") then { player addItem "FirstAidKit"; } else // let's help him anyway { player setDamage 0.25; }; };

Flow Logic examples

if (alive player && damage player >= 0.9) then { hint "very damaged"; }; if (alive player && damage player >= 0.5 && damage player < 0.9) then { hint "quite damaged"; }; if (alive player && damage player > 0 && damage player < 0.5) then { hint "slightly damaged"; }; if (alive player && damage player == 0) then { hint "pristine state"; }; if (not alive player) then { hint "dead"; };

if (not alive player) exitWith { hint "dead"; };
private _playerDamage = damage player; switch (true) do { case (_playerDamage >= 0.9): { hint "very damaged"; }; case (_playerDamage >= 0.5): { hint "quite damaged"; }; case (_playerDamage > 0)  : { hint "slightly damaged"; }; default { hint "pristine"; }; };

Format examples

if (not alive player) exitWith { hint "dead"; };
private _playerDamage = damage player; switch (true) do { case (_playerDamage >= 0.9): {hint "very damaged";}; case (_playerDamage >= 0.5): { hint "quite damaged";};
case (_playerDamage > 0): { hint "slightly damaged"; }; default {
hint "pristine"; }; };

if (not alive player) exitWith { hint "dead"; };
private _playerDamage = damage player; switch (true) do { case (_playerDamage >= 0.9): { hint "very damaged"; }; case (_playerDamage >= 0.5): { hint "quite damaged"; }; case (_playerDamage > 0)  : { hint "slightly damaged"; }; default { hint "pristine"; }; };


Final words

  • Learn from others' scripts but don't steal code and pretend it's yours — be a decent human being. Stealing code and its consequences:
    • It soils your reputation and devaluates your actions once it is found out — and it always get found out. DMCA's are filled on Steam every day.
    • It makes people in the community get less helpful and more reluctant in giving advices. It can also prevent them to release an interesting feature!
  • Don't try to obfuscate your code: it is considered rude, especially since you learnt from others.
    • Obfuscated code only makes it harder to get, but does not make it protected.
    • Obfuscated code is also slower on compilation (and, depending on the quality of code and obfuscation, on execution too).
  • Have fun!