------------------------------------------------------------ --------------------

Hello and welcome to the Trigger Request Thread (TRT). This thread's purpose is only to place trigger requests and discuss them.


------------------------------------------------------------ --------------------

Before posting your request, it's always good to read the so-called FAQ.

How do I install a trigger?

When we have finished making your trigger, we'll post the required code here. To install this code you will first of all need to find your way to the AOE§ installation folder. C:\Program Files\Microsoft Games\Age of Empires3 by default).
Now open the trigger folder if you use vanilla -trigger1, if you use TWC -trigger2, and finally if you use TAD go to -trigger3.
Next, open the file called typetest.xml. The only thing left to do is copy the code at the right position and save. If you requested a condition, then place the line above ,
if you requested an effect paste it right above . Note the "s" at the end of both tags.

Notes:


• When copying the trigger from someone please click first and only then copy the required code.
  
  
• If you're still uncomfortable with installing triggers please backup the original typetest file, i.e. copy the original to another folder.
  
  How do I uninstall a trigger?
  If a trigger happens to be faulty or if it generates errors you better remove it. Just do as if you were installing a new trigger, but instead of copy-pasting new code, remove the code corresponding with the chosen trigger. Make sure to remove it completely, including the starting < effect > or < condition > tag and the corresponding < /effect > or < /condition > closing tag. Failure to do so properly will cause XML errors in the file making ALL triggers in that file inaccessbile for AoM.
  
  
  Help! My triggers have stopped working! If this doesnt help you can send an email including your scenario to mister.scp@gmail.com.
  
  
  ------------------------------------------------------------ --------------------
  
  Recommended Downloads:
  -Advanced Trigger Set
  -My Trigger Set
  -Gunner`s Trigger Set
  -Random22`s Trigger Set
  -Hedanito`s Trigger Set
  -Kolt`S Trigger Set
  -SH Trigger
  -M925's Trigger Set
  
  ------------------------------------------------------------ --------------------
  
  
  Posting a Request
  
  So you have read the FAQ and want to post a request? OK, go for it, just be sure to use the following format:
  
  Name - This should be as straightforward as possible. Try to comply with today's standards.Description - Always describe the actions that you want the trigger to perform. An example can be a great help when requesting complex triggers.
  
  [b]Name[/b]
  [b]Description[/b]
  [b]Params[/b]
  (A List of Params. If you are pretty nice you set them in the context with your request.)
  
  
  Unfinished Requests
  
  -a lot
  
  Finished Requests
  -even more (list isnt up to date)
  
  Not Possible:
  -Fixing Modify Protounit
  -Fixing Chat Contain
  -Change name of the protounit which affect also the name when you train it
  ------------------------------------------------------------ --------------------
  Additional: XS - Basics (mostly based on pftq's guide for XS - Effects + Conditions)
  
  XS - Triggers are a bit different from other triggers, since they use strings instead for e.g. PlayerID, Unit Select...
  The key highlight of these effects/conditions is to allow Unit Selections to be specified by number or QV. This makes great use of the effects which set QV to an OBJECT ID and opens up a whole new world of possibilites.
  
  This includes all original and new effects/conditions with ALL appliable fields set to use ANY form of data, including but not limited to:
  
• -- Quest Var Code: enter trQuestVarGet("QVNAME")
  
• -- Player Stats: enter trGetStatValue(PLAYER, STATID_NUMBER) e.g. trGetStatValue(1, 2)-> count "Enemy Units Killed" for Player 1
  
• -- Math Operations: (5*PlayerStat) ...allowed are + - * / as Math Operations
  
• -- Any XS Code: (just open the typetest.xml and start digging!)
  
  typical strings: (strings with * have additional informations on the bottom)
  
• Amount (of resources), Radius, Headings, Duration, Damage Percent, Count (e.g. in Army Deploy), Rate (e.g. of Construction), Value
  
• the table of PlayerID´s is a string
  
• Operators* (don't use any numbers for them!)
  
• Center Unit OBJECT ID/Source Unit OBJECT ID/Target Unit OBJECT ID **
  
• Unit Type ID /ProtounitID ***
  
  
  
  
• *Operators you can use are:
  == equal to
  >= equal to or higher
  <= equal to or lower
  > higher
  < lower
  != is not equal to
  
  
• **The Unit Selections require an OBJECT ID. This is NOT the same as a NAME ID (like in Reyk's triggers). To find an OBJECT ID, use the supplied "QV Set.. OBJECT ID" effects OR select a unit and open the "Object Info" window. Open the Object Debug Info Window if you are using Age of Empires III and the ID is not readily available in the "Object Info".
  
  
  The first amount show you the Unit ID, every unit have a unique one. The third amount show you the Unit Type ID/ Protounit ID. Every MercJaeger have the ProtounitID -387-. Note that you can select ALL Units with Unit ID's but not even all with Protounit ID like cinematic blocks.
  
  
  
  1. ***TO USE NAME IDS: If you have the Name ID of a unit, you can convert it to OBJECT ID by using the kbGetBlockID("") function.
     
  2. ***For string (text) IDs, example: kbGetBlockID("ThisIsMyUnit")
     
  3. ***For QV, example: kbGetBlockID(""+trQuestVarGet("ThisIsMyQV"))
     
  4. ***For # NAME ID, example: kbGetBlockID("NUMBER")
     *** Generally, you can use kbGetBlockID(""+ID) for all, except text. As said above, enclose the text entirely with the quotes.
     

[This message has been edited by Mister SCP (edited 08-21-2011 @ 03:07 AM).]