UK Mapping Wiki

This is an old revision of the document!

# Object activator and what they do. <i><span style=“color:FireBrick; font-size:20px;”>Need help? Come to the Envy & Spite Discord server at <a href=“https://discord.gg/RY8J67neJ9”>https://discord.gg/RY8J67neJ9</a>!</span></i>

# Beginning

`ObjectActivator` is one of the most important tools under your belt of Ultrakill scripts. It allows you to simply activate a gameobject when the gameobject that has this script is activated (a chain), or more importantly, triggering things with a box collider that is set to a trigger within the same gameobject that has the script.

It has 2 overridable methods, in which you can go to the `OnActivate()` (<b>which gets called when the gameobject is fired (similarly, the `OnDisActivate` gets called after the gameobject is disabled or the player walks out of a trigger(?)) , such as walking into a trigger or it being active</b>) list, add a gameobject to it, and run a public method from one of the scripts of the gameobject. This function is useful in many scenarios, for exmaple, to make a breakable break during a wave, and ensure the player cannot break it before then.

<figure>
	<img src="https://coolboi21.github.io/Rude-Docs/Components/assets/obj-activator-component.png" alt="Object Activator" width="50%" height="50%">
	<figcaption>Example image of Object Activator script</figcaption>
</figure>

</div>

—

# Behaviour

This script has 2 behaviours.

* If it has no Box Collider, activate the objects and run the `OnActivate()` method. * If there is, activate the objects and run the `OnActivate()` ONCE the player enters the trigger.

—

# Fields

This means the gameobject can be activated only once. Further reactivation of the gameobject (such as rewalking into trigger or activating it and disactivating it) will not trigger anything else if this field is set to true.

<h3>Disable on Exit</h3>

This reverses the statements once the player walks out of trigger or the gameobject getting disabled.

Example: `To Activate Object` has its objects disactivated once the player walks out of the trigger or the gameobject gets disabled and objects under `To Dis Activate Objects` become active, and On `Dis Activate()` events run.

<h3>Dont Activate On Enable</h3>

If this is enabled, events will not be activated when the object becomes active.

### Reactivate On Enable This is required for non-trigger based Object Activators. If you want to run the events every time the Game Object becomes active, this has to be enabled, even if `One Time` is not ticked.

### Delay Events will ran after specified amount of time in seconds. Can use decimal numbers. This can be cancelled if the Object Activator gets deactivated

### OBAC Requires a Game Object that has an Object Activation Check component on it, functioning similarly to an “If” Statement. If a gameobject is active, it would run the activate method. If it's not, it doesn't run it until it becomes true.

### For Enemies If the Game Object that has an Object Activator also has a trigger on it, it will only be able to be triggered by enemies.

—

This gameobject runs a [ULTRAKILL Event](ULTRAKILL-Event)