egosoft.com

Code: Select all

===========================================
Name:		SCX: Squadron Command Extension
Version:	V1.3
Author:	Voxol
Updated:	20/04/2007
===========================================

A long-overdue feature of X3 is now available - the Squadron Command Extension (SCX).  With this script you can easily assign a ship to a squadron, and from then on any command you give to any member of the squadron will be sent to the other squadron members.  However, there are limitations (discussed below).


USE:
- Ships belonging to the same squadron must have the same carrier set as homebase.

- Ships in the same squadron must have a unique identifier enclosed in '/' and '\'.  It should not matter where this identifier is in the name, but I would recommend put it at the beginning.  For example '/1\Argon Buster'.

- In a carriers 'General' menu you will now have two new commands: 

'SCX: Toggle Squadrons On/Off':
This will enable command passing between squadron members that have this carrier set as their homebase.  A message in your logbook will indicate whether it is on/off.  Once active, whenever you give a command to one of the ships in the same squadron, the whole squadron will be set to the same command.

'SCX: Prefix Docked Ship Names':
This is a utility command that will prefix the names of docked ships with an identifier.  It will also set the ships homebase to be the carrier:
- You will be asked for the identifier, enter whatever alphanumeric identifier you want, e.g. 'Bob', '1', etc.
- You will then be asked for a number.  This number is the amount of ships you want to prefix (or 0 for all docked ships).
- The choice of prefixed ships is arbitrary, so make sure you only have the ships docked that you want to prefix.  
- Once prefixed, order the squadron to undock before prefixing more with this command, as you could end up prefixing the same ships twice (only the first identifier in the name is used).


NOTES:
- Limitations: Stock commands such as Move To Position; Buy Ware; Jump To Sector - do not work.  Custom commands that are well written should work, but many will not - try them and see (and let me know).  The script should catch a failure and send you a message if you use an incompatible command.


EXAMPLE:
I have a Zeus filled with Novas each with equal loadout.  Zeus quite neatly has 42 docking ports, so I figure 7x squadrons of 6 fighters each.

1) Enable by 'SCX: Toggle Squadrons On/Off'.

2) Use 'SCX: Prefix Docked Ship Names' and enter 'L', then '7'.  This will prefix 7 Novas with '/L\'.

3) Order any of the '/L\Nova' ships to undock and they will all undock - leaving 35 Novas docked.

4) Use 'SCX: Prefix Docked Ship Names' and enter '1', then '5'.  This will prefix 5 Novas with '/1\'.

5) Order any one of the prefixed '/1\Nova' ships to Protect a single '/L\Nova'.  All the prefixed ships will undock and move into formation with selected '/L\Nova' as lead.

6) Repeat from (4) another 6 times, incrementing the prefix to create /2\, /3\, ..., /7\  squadrons.

7) You now have 7 squadrons, each with a '/L\' prefixed lead ship.  Order any one of the '/L\' ships to attack something and all 7 wings will move to engage the same target, but in 7 seperate formations.

Pretty cool, huh?


============================================

Change log:

1.3
- Fixed docking bug.
- Changed 'SCX: Prefix Docked Ship Names' to ask for number of ships to prefix instead of prefixing all of them.

1.2
- Changed error message and made it and less invasive (just writes to logbook rather than sending a message)

1.1
- Altered things a litte to help overcome problem of valid commands being rejected.

1.0
- Initial release.

============================================

Technical:

Language file: 8750
Text page:  8750

Commands:
<t id="845">COMMAND_TYPE_GENERAL_45</t>
<t id="846">COMMAND_TYPE_GENERAL_46</t>