arma_3:createurs_de_missions:sqf_for_noobs [DokuWiki]

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Le SQF pour les nuls ======

<note important>Catégories en construction</note>

===== Démarrer =====

==== Outils ====

Éditeur de code conseillé : [[https://code.visualstudio.com|visual studio code]] Si vous ne souhaitez pas la version distribuée par Microsoft à cause de la télémétrie, il existe une distribution complètement libre : [[https://vscodium.com|vscodium]].

Une fois installé, voici quelques extensions utiles :
  * [[https://marketplace.visualstudio.com/items?itemName=blackfisch.sqf-language|SQF Language Updated]]
  * [[https://marketplace.visualstudio.com/items?itemName=Sparker95.sqf-vm-vscode|SQF-VM]]
  * [[https://marketplace.visualstudio.com/items?itemName=bux578.vscode-openlastrpt|Arma 3 - Open Last RPT]]

Et quelques options que vous pouvez activer dans vscode:
  * Bracket Pair Colorization
  * Trim Trailing Whitespace

==== Structure d'une mission ====

=== Le mission.sqm ===

À moins que vous ayez modifié votre installation, toutes les missions que vous enregistrez depuis l'Eden editor se trouve dans le chemin ''C:\Users\<username>\OneDrive\Documents\Arma 3 - Other Profiles\<userprofile>'' dans lequel vous trouverez 2 dossiers, ''missions'' et ''mpmission''.\\
Chacune de vos missions s'enregistre sous la forme d'un dossier nommé ''missionName.mapName'', dans lequel vous trouverez un fichier ''mission.sqm'' qui contient tout ce que vous faites dans l'éditeur. Par défaut ce fichier est binarisé pour gagner de la mémoire mais cela le rend illisible pour un utilisateur. Si vous faites une mission canard, il est demandé de désactiver cette option dans l'éditeur pour que GDC-toolbox puisse lire le fichier sans problème.

Ceci se fait pour le scénario et le futur scénario comme l'on voit sur l'image suivante
{{ :arma_3:createurs_de_missions:unbinarizescenario.png |}}
Pour revenir à notre scripting, il est déconseillé excepté pour les utilisateurs avancés de modifier ce fichier au prix de ne plus pouvoir ouvrir la mission à cause d'une erreur.

=== Les fichiers sqf du jeu ===

Dans votre dossier mission vous allez pouvoir placer tout ce qui est nécessaire à la mission comme des images, des sons dans des sous-dossiers, etc. Attention à veiller que la mission ne devienne pas trop lourde car elle est téléchargée par tous les clients (pas d'images/sons inutiles, compression si possible).\\
Toutefois il existe des noms de fichiers optionnels particuliers qui sont recherchés par le moteur du jeu au lancement de la mission tel que l%%'%%''init.sqf'', l%%'%%''initServer.sqf'', l%%'%%''initPlayerLocal.Sqf'', etc.\\
Plus d'infos sont disponibles sur le wiki de Bohémia sur leurs [[https://community.bistudio.com/wiki?title=Event_Scripts&oldid=336864|noms]] et sur leur [[https://community.bistudio.com/wiki?title=Initialization_Order&oldid=330506|ordre d'exécution]].

=== Le description.ext ===

Il existe également le fichier ''description.ext''. Ce dernier contient des informations supplémentaires à propos de votre mission comme le nom, l'auteur, l'image de chargement bien qu'il soit possible de renseigner tout cela depuis l'éditeur. Il est surtout important pour la compilation de fonction ou de son que vous rajoutez dans votre mission mais cela est pour une utilisation avancée. Encore une fois je ne peux que vous rediriger vers le [[https://community.bistudio.com/wiki?title=Description.ext&oldid=338273|wiki de Bohémia]].

==== Windows fait chier ====

Un problème récurrent pour ceux commençant le scripting est de [[https://community.bistudio.com/wiki/Introduction_to_Arma_Scripting#File_Creation|créer]] les différents fichiers ci-dessus parfaitement comme attendu mais rien ne se passe dans la mission, comme ci c'est fichier ne s'executait pas (et c'est le cas).\\
Comme l'indique le titre de cette section, la raison générale de ce problème est du à Windows. Ceci est du au fait que l'explorateur Windows, par défaut, cache les extensions de fichier et ne vous permet pas de les modifier. Ainsi quand vous nommez votre fichier ''init.sqf'', celui-ci est en réalité un fichier texte ''init.sqf.txt''. La solution la plus simple à long terme est donc d'afficher ces extensions de fichier afin de pouvoir les modifier. Voici en image l'option dans Windows 11, Microsoft propose également un [[https://support.microsoft.com/fr-fr/windows/extensions-de-nom-de-fichier-courantes-dans-windows-da4a4430-8e76-89c5-59f7-1cdbbc75cb01|tuto similaire]] pour Windows 10.
{{ :arma_3:createurs_de_missions:afficherextentionfichier.png |}}