Tutorial GUI - Triggering for Dummies (the basics)

GFreak45

I didnt slap you, i high 5'd your face.
Reaction score
130
Prerequisits:
  • None

Alright so there are a few things we are going to look at:
  • Variables
  • Events
  • Conditions
  • and Actions

Variables

Alright, essentially a variable is something that stores information, there are many types of information that they can store but every variable has a defined type. IE: a point variable can not store a unit, but a unit variable can. For example, we are going to use an action to save a variable of the position of a unit every time it is damaged.
Trigger:
  • Example
    • Events
      • Any unit takes fatal or non-fatal damage
    • Local Variables
      • Point < no point >
    • Conditions
    • Actions
      • Set Point = position of triggering unit

this saves the variable: Point, as the position of the unit that was last damaged when it was damaged. Now we will go over a few different parts of variables:
  • Indexes/Arrays
  • Constants
  • Global Variables
  • Local Variables

Indexes/Arrays:
An array variable is essentially a variable with multiple instances to it (or it can save multiple pieces of information), array variables can have a max array set by you in the editor, now this array includes 0 so if you are using it to get a player number or something of that sort it will not work if your player number becomes equal to the max array (the actual arrays for the variable are 0 through max - 1) a variable would look like this in your editor if it has an array: variable[array]. Arrays are capable of being multi-dimensional (up to 4 dimensions) like this: variable[dimension 1][dimension 2][dimension 3]. Each of these dimensions is refered to as an index and can only be defined by an integer, for example: variable[1] works, but variable[a] doesn't.

Constants:
A constant is the only type of variable that can not be an array. It is a variable that can not be set by actions because it is, as the name says, constant. It remains the same value throughout the entire game, but what it stays can be set by changing the default value. These are mainly used for systems that have edit-able options, so that when a player copies the system into their map, they can change a constant like a setting.

Global Variables:
These are variables that can simply be used in any trigger or to keep information throughout the game, which is important, because the next type can not do this.

Local Variables:
These are variables that are used only in the trigger that they are defined in. Essentially these are for saving information throughout a trigger without it overlapping when the trigger fires again or another trigger tries to use the variable. Every time the trigger that uses them is finished the variable is destroyed and recycled for use in that trigger again.

Events

Events are the part of a trigger that causes it to run. There are a wide variety of events ranging from a specific game time or real time, all the way to a unit casting an ability or a unit dying. You can have multiple events in a trigger and it will run off of any of them. When you have an event firing off a unit, player, or some other type of object in game you can use Triggering X (triggering unit, triggering player) to get that specific unit or player that caused the event to happen. There are also other types of event responses, like Damaging Unit (used when the event is, a unit takes damage), I am going to create another tutorial later about event responses and more complex events, even adding events to a trigger.

Trigger:
  • Example
    • Events
      • A unit Dies <-- this fires when any unit dies
      • Map Initialization <-- this fires 1 time at the start of the map
      • A player types OMG! as an exact match <-- this fires when a player types OMG!
    • Local Variables
    • Conditions
    • Actions


Conditions

Conditions are essentially a requirement that must be fulfilled before the actions can begin (IE an event is fired where a unit takes damage, but you have a condition that they are in a specific region, if they are not, the actions will not fire). These conditions can require many many different things, ranging from a requirement that a variable is equal to something specific all the way to a unit-type requirement. Conditions can also include Or/And conditions, an OR condition is a list of conditions requiring that 1 of the conditions listed is fulfilled, AND conditions require that all listed conditions are full filled just like a normal condition section of a trigger, but they can be used inside OR conditions

Trigger:
  • Example
    • Events
      • Any unit takes damage
    • Local Variables
    • Conditions
      • Owner of triggering unit (!=) Player 15 <--- this requires that the owner of the unit IS NOT player 15, or neutral hostile i believe, (!=) = not equal to, (==) = equal to, (<=) = less than or equal to, (>=) = greater than or equal to
      • Or, any of the conditions are true <--- one of the conditions in this and all of the conditions not in this are required
        • Damage Taken (>) 1.00
        • BooleanVariable (==) true <--- this is a variable you set in another trigger
        • And, all of the conditions are true <--- this requires that a set of conditions are true for this condition to be fulfilled
          • Unit type of triggering unit (==) zergling
          • Unit type of Damaging unit (!=) zergling
    • Actions
      • Do something but who cares what it is right now.


basically, if the unit that takes damage is owned by a computer, and it fulfills any of the conditions in the or condition it can go on with it's actions, the or condition has a few conditions inside it that are viable answers, the damage is greater than or equal to 1, a boolean variable is set to true, or the damage source is not a zergling and the triggering unit is

Actions

Actions, to be put as basically as possible, do something. Each of them does. An action is a reaction to the event, doing whatever it is that you want them to do. When in a trigger, they complete each action in an order, from top to bottom, but sometimes that order will not matter. If you have an action that moves a unit when it enters a region then right after you set a variable to that units position it would be different than if you set the units position before it was moved, but if you set a unit variable to that unit when it enters, then move it, it would be the same as though you had set it after you moved it because that unit has not been changed in the move.

Trigger:
  • Example
    • Events
      • Any unit enters Region 1
    • Local Variables
      • Point < no point >
      • Unit < no unit >
    • Conditions
    • Actions
      • Here is where the action's orders matter.
        • Set Point = position of triggering unit
        • Unit - Move triggering unit to the center of Region 2
      • OR...
        • Unit - Move triggering unit to the center of Region 2
        • Set Point = position of triggering unit
      • Each of those do different things, but below does not matter what order they are in.
        • Set Unit = Triggering unit
        • Unit - Move triggering unit to the center of Region 2




Any questions on this just pm me or make a post in the SC2 Galaxy Editor thread. I plan to add some pictures to this later, but until then, go out and create!

This goes on to:
 

Siretu

Starcraft 2 Editor Moderator
Reaction score
293
I just wanted to post here acknowledge this. I have seen it and read it but I will wait with the comments on it until I'm done judging after the deadline runs out.
 
General chit-chat
Help Users
  • No one is chatting at the moment.
  • Monovertex Monovertex:
    Hmm, how do I change my signature?
  • tom_mai78101 tom_mai78101:
    Signatures can be edit in your account profile. As for the old stuffs, I'm thinking it's because Blizzard is now under Microsoft, and because of Microsoft Xbox going the way it is, it's dreadful.
  • The Helper The Helper:
    I am not big on the recipes I am just promoting them - I use the site as a practice place promoting stuff
    +2
  • Monovertex Monovertex:
    @tom_mai78101 I must be blind. If I go on my profile I don't see any area to edit the signature; If I go to account details (settings) I don't see any signature area either.
  • The Helper The Helper:
    You can get there if you click the bell icon (alerts) and choose preferences from the bottom, signature will be in the menu on the left there https://www.thehelper.net/account/preferences
  • The Helper The Helper:
    I think I need to split the Sci/Tech news forum into 2 one for Science and one for Tech but I am hating all the moving of posts I would have to do
  • The Helper The Helper:
    What is up Old Mountain Shadow?
  • The Helper The Helper:
    Happy Thursday!
    +1
  • Varine Varine:
    Crazy how much 3d printing has come in the last few years. Sad that it's not as easily modifiable though
  • Varine Varine:
    I bought an Ender 3 during the pandemic and tinkered with it all the time. Just bought a Sovol, not as easy. I'm trying to make it use a different nozzle because I have a fuck ton of Volcanos, and they use what is basically a modified volcano that is just a smidge longer, and almost every part on this thing needs to be redone to make it work
  • Varine Varine:
    Luckily I have a 3d printer for that, I guess. But it's ridiculous. The regular volcanos are 21mm, these Sovol versions are about 23.5mm
  • Varine Varine:
    So, 2.5mm longer. But the thing that measures the bed is about 1.5mm above the nozzle, so if I swap it with a volcano then I'm 1mm behind it. So cool, new bracket to swap that, but THEN the fan shroud to direct air at the part is ALSO going to be .5mm to low, and so I need to redo that, but by doing that it is a little bit off where it should be blowing and it's throwing it at the heating block instead of the part, and fuck man
  • Varine Varine:
    I didn't realize they designed this entire thing to NOT be modded. I would have just got a fucking Bambu if I knew that, the whole point was I could fuck with this. And no one else makes shit for Sovol so I have to go through them, and they have... interesting pricing models. So I have a new extruder altogether that I'm taking apart and going to just design a whole new one to use my nozzles. Dumb design.
  • Varine Varine:
    Can't just buy a new heatblock, you need to get a whole hotend - so block, heater cartridge, thermistor, heatbreak, and nozzle. And they put this fucking paste in there so I can't take the thermistor or cartridge out with any ease, that's 30 dollars. Or you can get the whole extrudor with the direct driver AND that heatblock for like 50, but you still can't get any of it to come apart
  • Varine Varine:
    Partsbuilt has individual parts I found but they're expensive. I think I can get bits swapped around and make this work with generic shit though
  • Ghan Ghan:
    Heard Houston got hit pretty bad by storms last night. Hope all is well with TH.
  • The Helper The Helper:
    Power back on finally - all is good here no damage
    +2
  • V-SNES V-SNES:
    Happy Friday!
    +1
  • The Helper The Helper:
    New recipe is another summer dessert Berry and Peach Cheesecake - https://www.thehelper.net/threads/recipe-berry-and-peach-cheesecake.194169/
  • The Helper The Helper:
    I think we need to add something to the bottom of the front page that shows the Headline News forum that has a link to go to the News Forum Index so people can see there is more news. Do you guys see what I am saying, lets say you read all the articles on the front page and you get to the end and it just ends, no kind of link for MOAR!
  • The Helper The Helper:
    Happy Wednesday!
    +1

      The Helper Discord

      Members online

      No members online now.

      Affiliates

      Hive Workshop NUON Dome World Editor Tutorials

      Network Sponsors

      Apex Steel Pipe - Buys and sells Steel Pipe.
      Top