Difference between revisions of "UnitNameTables"

From DCS World Wiki - Hoggitworld.com
(Created page with "Many Mist functions require tables of unit names, which are known in Mist as UnitNameTables. These follow a special set of shortcuts borrowed from Slmod. These shortcuts all...")
 
m
Line 3: Line 3:
 
These are the unit table “short-cut” commands (there will be examples of how to use them in a moment):  
 
These are the unit table “short-cut” commands (there will be examples of how to use them in a moment):  
 
   
 
   
Character sequence + name commands: "[-u]<unit name>" - subtract this unit from the table "[g]<group name>" - add this group’s units to the table "[-g]<group name>" - subtract this group’s units from the table "[c]<country name>"  - add this country's units to the table "[-c]<country name>" - subtract this country's units from the table  
+
Character sequence + name commands:  
+
<ul>
Stand-alone identifiers "[all]" – add all units to the table "[-all]" – remove all units from the table "[blue]" - add all blue coalition units to the table "[-blue]" - subtract all blue coalition units from the table "[red]" - add all red coalition units to the table "[-red]" - subtract all red coalition units from the table  
+
<li>"[-u]<unit name>" - subtract this unit from the table</li>
 +
<li>"[g]<group name>" - add this group’s units to the table</li>
 +
<li>"[-g]<group name>" - subtract this group’s units from the table</li>
 +
<li>"[c]<country name>"  - add this country's units to the table</li>
 +
<li>"[-c]<country name>" - subtract this country's units from the table</li>
 +
</ul>
 +
 
 +
Stand-alone identifiers:
 +
<ul>
 +
<li>"[all]" – add all units to the table</li>
 +
<li>"[-all]" – remove all units from the table </li>
 +
<li>"[blue]" - add all blue coalition units to the table </li>
 +
<li>"[-blue]" - subtract all blue coalition units from the table </li>
 +
<li>"[red]" - add all red coalition units to the table </li>
 +
<li>"[-red]" - subtract all red coalition units from the table </li>
 +
</ul>
 
   
 
   
 
Compound identifiers:  
 
Compound identifiers:  
 
10  
 
10  
+
<ul>
"[c][helicopter]<country name>"  - add all of this country's helicopters to the table "[-c][helicopter]<country name>" - subtract all of this country's helicopters from the table "[c][plane]<country name>"  - add all of this country's planes to the table "[-c][plane]<country name>" - subtract all of this country's planes from the table "[c][ship]<country name>"  - add all of this country's ships to the table "[-c][ship]<country name>" - subtract all of this country's ships from the table "[c][vehicle]<country name>"  - add all of this country's vehicles to the table "[-c][vehicle]<country name>" - subtract all of this country's vehicles from the table  
+
<li>"[c][helicopter]<country name>"  - add all of this country's helicopters to the table </li>
+
<li>"[-c][helicopter]<country name>" - subtract all of this country's helicopters from the table </li>
"[all][helicopter]" -  add all helicopters to the table "[-all][helicopter]" - subtract all helicopters from the table "[all][plane]" - add all  planes to the table "[-all][plane]" - subtract all planes from the table "[all][ship]" - add all ships to the table "[-all][ship]" - subtract all ships from the table "[all][vehicle]" - add all vehicles to the table "[-all][vehicle]" - subtract all vehicles from the table  
+
<li>"[c][plane]<country name>"  - add all of this country's planes to the table </li>
+
<li>"[-c][plane]<country name>" - subtract all of this country's planes from the table </li>
"[blue][helicopter]" -  add all blue coalition helicopters to the table "[-blue][helicopter]" - subtract all blue coalition helicopters from the table "[blue][plane]" - add all blue coalition planes to the table "[-blue][plane]" - subtract all blue coalition planes from the table "[blue][ship]" - add all blue coalition ships to the table "[-blue][ship]" - subtract all blue coalition ships from the table "[blue][vehicle]" - add all blue coalition vehicles to the table "[-blue][vehicle]" - subtract all blue coalition vehicles from the table  
+
<li>"[c][ship]<country name>"  - add all of this country's ships to the table </li>
+
<li>"[-c][ship]<country name>" - subtract all of this country's ships from the table </li>
"[red][helicopter]" -  add all red coalition helicopters to the table "[-red][helicopter]" - subtract all red coalition helicopters from the table "[red][plane]" - add all red coalition planes to the table "[-red][plane]" - subtract all red coalition planes from the table "[red][ship]" - add all red coalition ships to the table "[-red][ship]" - subtract all red coalition ships from the table "[red][vehicle]" - add all red coalition vehicles to the table "[-red][vehicle]" - subtract all red coalition vehicles from the table  
+
<li>"[c][vehicle]<country name>"  - add all of this country's vehicles to the table </li>
+
<li>"[-c][vehicle]<country name>" - subtract all of this country's vehicles from the table </li>
 +
<li>"[all][helicopter]" -  add all helicopters to the table </li>
 +
<li>"[-all][helicopter]" - subtract all helicopters from the table </li>
 +
<li>"[all][plane]" - add all  planes to the table </li>
 +
<li>"[-all][plane]" - subtract all planes from the table </li>
 +
<li>"[all][ship]" - add all ships to the table </li>
 +
<li>"[-all][ship]" - subtract all ships from the table </li>
 +
<li>"[all][vehicle]" - add all vehicles to the table </li>
 +
<li>"[-all][vehicle]" - subtract all vehicles from the table </li>
 +
<li>"[blue][helicopter]" -  add all blue coalition helicopters to the table </li>
 +
<li>"[-blue][helicopter]" - subtract all blue coalition helicopters from the table </li>
 +
<li>"[blue][plane]" - add all blue coalition planes to the table </li>
 +
<li>"[-blue][plane]" - subtract all blue coalition planes from the table </li>
 +
<li>"[blue][ship]" - add all blue coalition ships to the table </li>
 +
<li>"[-blue][ship]" - subtract all blue coalition ships from the table </li>
 +
<li>"[blue][vehicle]" - add all blue coalition vehicles to the table </li>
 +
<li>"[-blue][vehicle]" - subtract all blue coalition vehicles from the table </li>
 +
<li>"[red][helicopter]" -  add all red coalition helicopters to the table </li>
 +
<li>"[-red][helicopter]" - subtract all red coalition helicopters from the table </li>
 +
<li>"[red][plane]" - add all red coalition planes to the table </li>
 +
<li>"[-red][plane]" - subtract all red coalition planes from the table </li>
 +
<li>"[red][ship]" - add all red coalition ships to the table </li>
 +
<li>"[-red][ship]" - subtract all red coalition ships from the table </li>
 +
<li>"[red][vehicle]" - add all red coalition vehicles to the table </li>
 +
<li>"[-red][vehicle]" - subtract all red coalition vehicles from the table </li>
 +
</ul>
 
   
 
   
 
Country names for the "[c]<country name>"  and "[-c]<country name>" short-cuts:  
 
Country names for the "[c]<country name>"  and "[-c]<country name>" short-cuts:  

Revision as of 03:31, 5 April 2020

Many Mist functions require tables of unit names, which are known in Mist as UnitNameTables. These follow a special set of shortcuts borrowed from Slmod. These shortcuts alleviate the problem of entering huge lists of unit names by hand, and in many cases, they remove the need to even know the names of the units in the first place!

These are the unit table “short-cut” commands (there will be examples of how to use them in a moment):

Character sequence + name commands:

  • "[-u]<unit name>" - subtract this unit from the table
  • "[g]<group name>" - add this group’s units to the table
  • "[-g]<group name>" - subtract this group’s units from the table
  • "[c]<country name>" - add this country's units to the table
  • "[-c]<country name>" - subtract this country's units from the table

Stand-alone identifiers:

  • "[all]" – add all units to the table
  • "[-all]" – remove all units from the table
  • "[blue]" - add all blue coalition units to the table
  • "[-blue]" - subtract all blue coalition units from the table
  • "[red]" - add all red coalition units to the table
  • "[-red]" - subtract all red coalition units from the table

Compound identifiers: 10

  • "[c][helicopter]<country name>" - add all of this country's helicopters to the table
  • "[-c][helicopter]<country name>" - subtract all of this country's helicopters from the table
  • "[c][plane]<country name>" - add all of this country's planes to the table
  • "[-c][plane]<country name>" - subtract all of this country's planes from the table
  • "[c][ship]<country name>" - add all of this country's ships to the table
  • "[-c][ship]<country name>" - subtract all of this country's ships from the table
  • "[c][vehicle]<country name>" - add all of this country's vehicles to the table
  • "[-c][vehicle]<country name>" - subtract all of this country's vehicles from the table
  • "[all][helicopter]" - add all helicopters to the table
  • "[-all][helicopter]" - subtract all helicopters from the table
  • "[all][plane]" - add all planes to the table
  • "[-all][plane]" - subtract all planes from the table
  • "[all][ship]" - add all ships to the table
  • "[-all][ship]" - subtract all ships from the table
  • "[all][vehicle]" - add all vehicles to the table
  • "[-all][vehicle]" - subtract all vehicles from the table
  • "[blue][helicopter]" - add all blue coalition helicopters to the table
  • "[-blue][helicopter]" - subtract all blue coalition helicopters from the table
  • "[blue][plane]" - add all blue coalition planes to the table
  • "[-blue][plane]" - subtract all blue coalition planes from the table
  • "[blue][ship]" - add all blue coalition ships to the table
  • "[-blue][ship]" - subtract all blue coalition ships from the table
  • "[blue][vehicle]" - add all blue coalition vehicles to the table
  • "[-blue][vehicle]" - subtract all blue coalition vehicles from the table
  • "[red][helicopter]" - add all red coalition helicopters to the table
  • "[-red][helicopter]" - subtract all red coalition helicopters from the table
  • "[red][plane]" - add all red coalition planes to the table
  • "[-red][plane]" - subtract all red coalition planes from the table
  • "[red][ship]" - add all red coalition ships to the table
  • "[-red][ship]" - subtract all red coalition ships from the table
  • "[red][vehicle]" - add all red coalition vehicles to the table
  • "[-red][vehicle]" - subtract all red coalition vehicles from the table

Country names for the "[c]<country name>" and "[-c]<country name>" short-cuts:

Turkey Norway The Netherlands Spain 11

UK Denmark USA Georgia Germany Belgium Canada France Israel Ukraine Russia South Ossetia Abkhazia Italy Australia Austria Belarus Bulgaria Czech Republic China Croatia Finland Greece Hungary India Iran Iraq Japan Kazakhstan North Korea Pakistan Poland Romania Saudi Arabia Serbia, Slovakia South Korea Sweden Switzerland Syria USAF Aggressors

Do NOT use a '[u]' notation for single units. Single units are referenced the same way as before: simply input their names as strings. 12


These unit tables are evaluated in order, and you cannot subtract a unit from a table before it is added. For example,

{'[blue]', '[-c]Georgia'}

will evaluate to all of blue coalition except those units owned by the country named “Georgia”; however:

{'[-c]Georgia', '[blue]'} 

will evaluate to all of the units in blue coalition, because the addition of all units owned by blue coalition occurred AFTER the subtraction of all units owned by Georgia (which actually subtracted nothing at all, since there were no units in the table when the subtraction occurred).

More examples:

{'[blue][plane]', '[-c]Georgia', '[-g]Hawg 1'} -Evaluates to all blue planes, except those blue units owned by the country named “Georgia” and the units in the group named “Hawg1”.


{'[g]arty1', '[g]arty2', '[-u]arty1_AD', '[-u]arty2_AD', 'Shark 11' } -Evaluates to the unit named “Shark 11”, plus all the units in groups named “arty1” and “arty2” except those that are named “arty1_AD” and “arty2_AD”.

If you want to write your own scripts that make use of the Mist function that creates UnitNameTables, then this is the function you use: