Utilities – Arma 3

From Bohemia Interactive Community
No edit summary
 
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[File:Utilities.jpg|500px|right]]
{{TOC|side}}
{{TOC|side}}
{{GVI|arma3|1.68}}
{{GVI|arma3|1.68}}
In order to access the utilities list, type {{hl|utils}} in [[Arma 3: Debug Console|debug console]] and click on LOCAL EXEC or execute <sqf inline>execVM "A3\Functions_F\Debug\Utilities\lib\index.sqf"</sqf>.
In order to access the Utilities list, type {{hl|utils}} in [[Arma 3: Debug Console|debug console]] and click on {{hl|LOCAL EXEC}} or execute <sqf inline>execVM "A3\Functions_F\Debug\Utilities\lib\index.sqf"</sqf>.
{{Feature|informative|To find out how to access a tool directly, see description of the tools below.}}
{{Feature|informative|To find out how to access a tool directly, see description of the tools below.}}


[[File:Utilities.jpg|500px]]
{{Clear}}




Line 11: Line 12:


Auto-generates template to be used with [[CfgDisabledCommands]].
Auto-generates template to be used with [[CfgDisabledCommands]].
{| style="text-align: left"
{|
! Shortcut:
! Shortcut:
| {{hl|utils 1}}
| {{hl|utils 1}}
|-
|-
! Open by Script:
! Script:
| <sqf>execVM "A3\Functions_F\Debug\Utilities\utility_cfgDisabledCommands.sqf"</sqf>
| <sqf>execVM "A3\Functions_F\Debug\Utilities\utility_cfgDisabledCommands.sqf"</sqf>
|}
|}
Line 24: Line 25:
== Print Config ==
== Print Config ==


Prepares formatted config.
Prepares formatted config. There is a limit on how much of the config information can be retrieved and is limited by the [[Array]] maximum capacity.
{| style="text-align: left"
{|
! Shortcut:
! Shortcut:
| {{hl|utils 2}}
| {{hl|utils 2}}
|-
|-
! Open by Script:
! Script:
| <sqf>execVM "A3\Functions_F\Debug\Utilities\utility_printConfig.sqf"</sqf>
| <sqf>execVM "A3\Functions_F\Debug\Utilities\utility_printConfig.sqf"</sqf>
|}
|}
Line 36: Line 37:


[[File:MoonPhases.jpg|thumb|500px|Moon Phases Tool]]
[[File:MoonPhases.jpg|thumb|500px|Moon Phases Tool]]
== Moon Phases ==
== Moon Phases ==


Finds moon phases throughout given year.
Finds moon phases throughout given year. The longer the bar the brighter the night.
{| style="text-align: left"
{|
! Shortcut:
! Shortcut:
| {{hl|utils 3}}
| {{hl|utils 3}}
|-
|-
! Open by Script:
! Script:
| <sqf>execVM "A3\Functions_F\Debug\Utilities\utility_moonPhases.sqf"</sqf>
| <sqf>execVM "A3\Functions_F\Debug\Utilities\utility_moonPhases.sqf"</sqf>
|}
|}
Line 50: Line 52:


[[File:Jukebox.jpg|thumb|500px|Jukebox]]
[[File:Jukebox.jpg|thumb|500px|Jukebox]]
== Jukebox ==
== Jukebox ==


Plays music from CfgMusic. Drag progress bar to navigate, doubleclick to pause/play.
Plays music from CfgMusic. One can navigate through the track by dragging the progress bar left or right and pause/resume by clicking again on the song in the list. The track information for played track in window shows the actual track duration, while the track duration in the list comes from config and could be inaccurate.
{| style="text-align: left"
{|
! Shortcut:
! Shortcut:
| {{hl|utils 4}}
| {{hl|utils 4}}
|-
|-
! Open by Script:
! Script:
| <sqf>execVM "A3\Functions_F\Debug\Utilities\utility_jukebox.sqf"</sqf>
| <sqf>execVM "A3\Functions_F\Debug\Utilities\utility_jukebox.sqf"</sqf>
|}
|}
{{Clear}}
{{Clear}}




[[File:ScriptCommands.jpg|thumb|500px|Script Commands]]
[[File:ScriptCommands.jpg|thumb|500px|Script Commands]]
[[File:template.jpg|thumb|500px|Notepad++ language highlight template export (Since Arma 3 2.22)]]
 
== Script Commands ==
== Script Commands ==


Lists all available script commands and their arguments. Since Arma 3 2.22 all script commands can be exported in Notepad++ syntax highlight template format (light and dark). Follow the instructions on the export page.
Lists all available script commands and their arguments.
{| style="text-align: left"
{|
! Shortcut:
! Shortcut:
| {{hl|utils 5}}
| {{hl|utils 5}}
|-
|-
! Open by Script:
! Script:
| <sqf>execVM "A3\Functions_F\Debug\Utilities\utility_scriptCommands.sqf"</sqf>
| <sqf>execVM "A3\Functions_F\Debug\Utilities\utility_scriptCommands.sqf"</sqf>
|}
Limited modifiers can be used with search:
{|
! <pre>"<word>"</pre>
| Searches for exact word, for example:
| <pre>"addmagazine"</pre>
|-
! <pre>*</pre> 
| Replaces asterisk with anything, for example:
| <pre>add*global</pre>
|-
! <pre>-</pre> 
| Ignores given word, for example:
| <pre>addMagazine-cargo</pre>
|}
|}
{{Clear}}
{{Clear}}
[[File:template.jpg|thumb|500px|Notepad++ language highlight template export]]
{{ArgTitle|3|Notepad++ Export|{{GVI|arma3|2.22}}}}
All script commands can be exported in Notepad++ syntax highlight template format (light and dark).


Follow the instructions on the export page, here is a short transcript:
# Copy this content to clipboard with {{Controls|Ctrl|A}}/{{Controls|Ctrl|C}}
# Open Notepad++ and open a new file
# Paste the copied content into the new file with {{Controls|Ctrl|V}}
# Save the file as {{hl|arma3sqf.xml}}
# Open Notepad++ template directory via Notepad++ menu: Language &rarr; User Defined Language &rarr; Open User Defined Language folder...
# Move arma3sqf.xml in this directory and restart Notepad++
# From the Language menu, select:
#* ARMA 3 SQF (Default) - for Default style
#* ARMA 3 SQF (DarkModeDefault) - for DarkModeDefault style
The style can be chosen in: Settings  &rarr; Style Configurator...
{{Clear}}
<gallery mode="packed">
File:NPP_light.jpg|thumb|500px|Light mode syntax highlight example
File:NPP_dark.jpg|thumb|500px|Dark mode syntax highlight example
</gallery>


{{GameCategory|arma3|Editing}}
{{GameCategory|arma3|Editing}}
[[Category:Introduced with Arma 3 version 1.68]]
[[Category:Introduced with Arma 3 version 1.68]]

Latest revision as of 14:54, 15 September 2025

Utilities.jpg

Arma 3 logo black.png 1.68 In order to access the Utilities list, type utils in debug console and click on LOCAL EXEC or execute execVM "A3\Functions_F\Debug\Utilities\lib\index.sqf".

To find out how to access a tool directly, see description of the tools below.


CfgDisabledCommands Template Generator

CfgDisabledCommands Template Generator

Auto-generates template to be used with CfgDisabledCommands.

Shortcut: utils 1
Script:
execVM "A3\Functions_F\Debug\Utilities\utility_cfgDisabledCommands.sqf"


Print Config

Print Config

Prepares formatted config. There is a limit on how much of the config information can be retrieved and is limited by the Array maximum capacity.

Shortcut: utils 2
Script:
execVM "A3\Functions_F\Debug\Utilities\utility_printConfig.sqf"


Moon Phases Tool

Moon Phases

Finds moon phases throughout given year. The longer the bar the brighter the night.

Shortcut: utils 3
Script:
execVM "A3\Functions_F\Debug\Utilities\utility_moonPhases.sqf"


Jukebox

Jukebox

Plays music from CfgMusic. One can navigate through the track by dragging the progress bar left or right and pause/resume by clicking again on the song in the list. The track information for played track in window shows the actual track duration, while the track duration in the list comes from config and could be inaccurate.

Shortcut: utils 4
Script:
execVM "A3\Functions_F\Debug\Utilities\utility_jukebox.sqf"


Script Commands

Script Commands

Lists all available script commands and their arguments.

Shortcut: utils 5
Script:
execVM "A3\Functions_F\Debug\Utilities\utility_scriptCommands.sqf"

Limited modifiers can be used with search:

"<word>"
Searches for exact word, for example:
"addmagazine"
*
Replaces asterisk with anything, for example:
add*global
-
Ignores given word, for example:
addMagazine-cargo
Notepad++ language highlight template export

Notepad++ Export

All script commands can be exported in Notepad++ syntax highlight template format (light and dark).

Follow the instructions on the export page, here is a short transcript:

  1. Copy this content to clipboard with Ctrl + A/Ctrl + C
  2. Open Notepad++ and open a new file
  3. Paste the copied content into the new file with Ctrl + V
  4. Save the file as arma3sqf.xml
  5. Open Notepad++ template directory via Notepad++ menu: Language → User Defined Language → Open User Defined Language folder...
  6. Move arma3sqf.xml in this directory and restart Notepad++
  7. From the Language menu, select:
    • ARMA 3 SQF (Default) - for Default style
    • ARMA 3 SQF (DarkModeDefault) - for DarkModeDefault style

The style can be chosen in: Settings → Style Configurator...