Eventing 101
Hey there ppls of Earth, Mars, and wherever the hell else, if you're a new player and have pretty much just finished the tutorial, then this is for you. Remember that little button labeled "Events" in the bottom of the wrench screen that isn't mentioned in the Tutorial, well that is the answer to life. Not really, but it is the force that makes doors open, makes bricks disappear, and makes spam way spammier than before. This will show you every part of the event screen, and every event included with Blockland (not add-ons).
BTW: If you want info about a certain event, press ctrl f, then enter the event you want :D
BTW2:I do not know some events. If you know what any of these do, plz reply.
radiusImpulse-(The whole event)
Redirect-(The checkbox)
Enable
That little column way on the left of the events menu is a way to make events change, without having to change the events (that sounds very wierd, I know). It can stop events from happening if unchecked, or can let events happen if checked. More uses will be included later in the manual.
Delay
This column (the second from the left) is what delays the event after it is supposed to happen. The counting is in milliseconds, meaning every 1000 you put in = one second. The limit is 30,000, or 30 seconds of delay.
Input Event
This is where it starts getting meaty. These are what causes the event to happen.
onActivate-When a player clicks that brick, the events are triggered
onBlownUp-When the brick is "blown up" or blasted, the event is triggered. You can tell a brick is blasted when it is no longer in the place you built it, and it can be kicked around when you touch it.
onBotTouch-When a zombie from Rotondo's Left 4 Block mod, a Bot from Amade's Bot Mod touches the brick (not by clicking it, but by coming into contact with it), or a vehicle touches it, the event is triggered
onPlayerTouch-Same thing as onBotTouch, but when a player touches it.
onPrintCountOverflow-Print Bricks ONLY-When a print brick has numbers on it, that is called its print count. If that number goes above 9 using other events, the event will be triggered.
onPrintCountUnderflow-Print Bricks ONLY-If the brick's print count goes below 0, the event is triggered.
onProjectileHit-When a bullet, rocket, sword attack, etc. hits it, the event is triggered.
onRelay-When a relay occurs using the "fireRelay, fireRelayUp, Down, North, South, East, and West" events, the event is triggered.
onRespawn-When the brick comes back after being "Blown Up", the event is triggered.
Target
This is what will be affected by the event. Some events are not available under all inputs, so I will add side notes for these.
Self-The event will affect the brick its events are in.
Player-The event will affect the player that triggered the events (for example, using onActivate, the player clicks it will be affected).-Not available for onBotTouch, onPrintCountOverflow or Underflow, onRelay, or onRespawn.
Client-The body that the player is controlling will not be affected, but the person playing the game will (for example, CenterPrint does not show anyone else looking at you any effects, but you would see the message)-Not available for onPrintCountOverflow or Underflow, onRelay, or onRespawn.
Minigame-The brick owner's minigame will be affected by the events (meaning that the minigame's creator has to have placed the brick for the events to affect the minigame).
<NAMED BRICK>-You can have other bricks besides the host brick have events by naming the brick you want affected, and then selecting its name in the drop-down menu under the named brick choice.
Bot-The zombie/bot/vehicle that touched the brick will be affected.-Only available for onBotTouch
Driver-The driver of the vehicle that touched the brick will be affected.-Only available for onBotTouch
Projectile-The projectile/sword slice/etc. will be affected.-Only available for onProjectileHit
Output Event and Output Parameters
The part where you pick what you want to be done to the target. BTW some targets share events with others, so I will be grouping them together.
Self/<NAMED BRICK>
cancelEvents-Cancels any delays or relays. Anything that was supposed to happen after being canceled will not happen.
decrementPrintCount-Print Bricks ONLY-Makes a print count go down by a number.
--Box 1--The number you want the print count to go down by. Only 1-9.
disappear-Makes a brick disappear, turning off rendering, collision, and ray casting.
--Box 1--How many seconds you want the brick to stay invisible. You can also put -1 in the box to make it disappear forever, or put 0 in the box to make it reappear instantly.
fakeKillBrick-Simulates the brick being "Blown Up".
--Box 1-- How far north/south you want the brick to fly in Bricks Per Second. Enter a positive number to make it fly north, or enter a negative number to make it fly south (for the winter xD).
--Box 2--How far east/west you want the brick to fly in BPS. Enter a positive number to make it fly east, or enter a negative number to make it fly west.
--Box 3--How far up/down you want the brick to fly in BPS. Enter a positive number to make it fly up, or enter a negative number to make it fly down.
--Box 4--How long you want the brick to stay "Blown Up" in seconds. Unlike disappear, you cannot enter -1.
fireRelay-fires a relay to the chosen brick. For use with onRelay.
fireRelayUp, Down, East, West, North, and South-Fires a relay to a brick in that cardinal direction from the target brick.
incrementPrintCount-Print Bricks ONLY-Makes a print count go up by a number.
--Box 1--The number you want the print count to go up by. Only 1-9.
playSound-Plays the sound chosen in the drop-down from the target brick.
--Drop 1--The sound you want played from the target.
radiusImpulse-???
recoverVehicle-Vehicle Spawns ONLY-If no one is in the vehicle, then the vehicle will respawn. If there is someone in the vehicle, then the vehicle will NOT respawn.
respawn-The brick will go back to its original place after being fakeKillBricked or "Blown Up".
respawnVehicle-Vehicle Spawns ONLY-The vehicle will respawn, no matter if anyone is in it or not.
setColliding-Its an event version of the collision box in the wrench menu.
--Check 1--Uncheck to turn colliding off, or check it to turn colliding on.
setColor-Simply sets the color of the target brick.
--ColorBox 1--Use to pick the color you want set.
setColorFX-Simply sets the paint effects of the target brick.
--Drop 1--Select the paint effect you want to set.
setEmitter-Simply sets the target brick's emitter like in the wrench menu.
--Drop 1--Select the emitter you want the brick to have.
setEmitterDirection-Simply sets the target brick's emitter direction like in the wrench menu.
--Drop 1--Select the cardinal direction you want the brick's emitter to be in
setEventEnabled-Set the target brick's events enabled or not.
--Box 1--Enter the event numbers separating them with spaces (ex. 1 2 4 7).
--Check 1--Check to set the enable the event, uncheck to disable.
setItem-Simply set the target brick's spawned item.
--Drop 1--Select the item you want the brick to have.
setItemDirection-Simply set the item's direction like in the wrench menu.
--Drop 1--Set the direction you want the item to be in.
setItemPosition-Simply set the item's position on the brick like in the wrench menu.
--Drop 1-- Set the position you want the item to be at.
setLight-Simply sets the target brick's light.
--Drop 1--Select the light you want the brick to have.
setMusic-Music Bricks ONLY-Set the target brick's music.
--Drop 1--Select the music you want set.
setPrintCount-Print Bricks ONLY-Set the target brick's print count.
--Box 1--Enter the number you want the print count to be. Only 0-9.
setRayCasting-Simply set the brick's rayCasting like in the wrench menu.
--Check 1--Check to turn rayCasting on, uncheck to turn off.
setRendering-Simply set if you can see the brick or not like in the wrench menu.
--Check 1--Check to turn rendering on, uncheck to turn off.
setShapeFX-Set what movement effect you want.
--Drop 1--Select the effect you want. Either none, undulo, or water.
setVehicle-Vehicle Spawns ONLY-Sets the target brick's vehicle.
--Drop 1--Select the vehicle you want the brick to spawn.
spawnExplosion-Spawns the explosion of vehicles, projectiles, etc.
--Drop 1--Select the explosion.
--Slide 1--Set the scale of the explosion. 1 is normal size, 2 is double, .500 is half, etc.
spawnItem-Spawns an item as if a player just dropped it.
--Box 1--How far north/south you want the item to fly in Bricks Per Second. Enter a positive number to make it fly north, or enter a negative number to make it fly south.
--Box 2--How far east/west you want the item to fly in BPS. Enter a positive number to make it fly east, or enter a negative number to make it fly west.
--Box 3--How far up/down you want the item to fly in BPS. Enter a positive number to make it fly up, or enter a negative number to make it fly down.
--Drop 1--Select the item you want to be spawned.
spawnProjectile
--Box 1--How far north/south you want the projectile to be able to go off a straight line. Enter a positive number to make it deflect north, or enter a negative number to make it deflect south.
--Box 2--How far east/west you want the projectile to be able to go off a straight line. Enter a positive number to make it deflect east, or enter a negative number to make it deflect west.
--Box 3--How far up/down you want the projectile to be able to go off a straight line. Enter a positive number to make it deflect up, or enter a negative number to make it deflect down.
--Drop 1--Select the projectile you want to be spawned.
--Box 4--How far north/south you want the projectile to go in. Enter a positive number to make it go north, or enter a negative number to make it go south.
--Box 5--How far east/west you want the projectile to go in. Enter a positive number to make it go east, or enter a negative number to make it go west.
--Box 6--How far up/down you want the projectile to go in. Enter a positive number to make it go up, or enter a negative number to make it go down.
toggleEventEnabledMakes the "enable" part of the chosen events change to its opposite.
--Box 1--Enter the events you want to affect with spaces between the numbers (ex. 1 3 7 10).
Player/Driver/Bot
AddHealth-Add health to the target player/bot.
--Box 1--Enter the amount of health you want added (note, most players have 100 health). Also, you can enter a negative amount to make them lose health
AddVelocity-Make the player fly in a direction
--Box 1-- How far north/south you want the player to fly in Bricks Per Second. Enter a positive number to make it fly north, or enter a negative number to make it fly south.
--Box 2--How far east/west you want the player to fly in BPS. Enter a positive number to make it fly east, or enter a negative number to make it fly west.
--Box 3--How far up/down you want the player to fly in BPS. Enter a positive number to make it fly up, or enter a negative number to make it fly down.
BurnPlayer-Burn the player like they are on fire.
--Box 1--Enter the number of seconds you want them to stay burned. Only from 1-9.
ChangeDataBlock-Set the target's playertype.
--Drop 1--Select the playertype you want set.
ClearBurn-Removes the player's burn if burnt.
ClearTools-Clears the player's items.
Dismount-Driver ONLY-Makes the player leave the vehicle as if they right-clicked.
InstantRespawn-Makes the player respawn as if they died, but without any score losses or gains.
Kill-Kills the player, thats it :D
SetHealth-Sets the player's health at a point.
--Box 1--Enter a number to set the player's health at.
SetPlayerScale-Set the player's size.
--Slide 1--Sets the player's size. 1 is normal, .500 is half size, 2 is double size, etc.
SetVelocity-Sets how fast a player moves in a direction, no matter what the beginning speed was.
--Box 1-- How far north/south you want the player to fly in Bricks Per Second. Enter a positive number to make it fly north, or enter a negative number to make it fly south.
--Box 2--How far east/west you want the player to fly in BPS. Enter a positive number to make it fly east, or enter a negative number to make it fly west.
--Box 3--How far up/down you want the player to fly in BPS. Enter a positive number to make it fly up, or enter a negative number to make it fly down.
SpawnExplosion-Makes the player spawn an explosion.
--Drop 1--Select the explosion.
--Slide 1--Set the scale of the explosion. 1 is normal size, 2 is double, .500 is half, etc.
SpawnProjectile-Makes the player spawn a projectile at where they are looking if box 1, 2, and 3 are 0's.
--Box 1--Sets how fast the projectile is fired.
--Drop 1--Sets the projectile fired
--Box 2--How far north/south you want the projectile to go in. Enter a positive number to make it go north, or enter a negative number to make it go south.
--Box 3--How far east/west you want the projectile to go in. Enter a positive number to make it go east, or enter a negative number to make it go west.
--Box 4--How far up/down you want the projectile to go in. Enter a positive number to make it go up, or enter a negative number to make it go down.
Client
BottomPrint-Gives the player a message at the bottom of their screen.
--Box 1--Enter the message here.
--Box 2--How long the message will stay there before disappearing in seconds.
CenterPrint-Gives the player a message in the middle of their screen.
--Box 1--Enter the message here.
--Box 2--How long the message will stay there before disappearing in seconds.
ChatMessage-Gives the player a message in their chat area.
--Box 1--Enter the message here.
IncScore-Increases the player's score by a number.
--Box 1--The number their score changes by. Enter a positive to add points, and a negative to subtract points.
Minigame
BottomPrintAll-Gives all players in the minigame a message on the bottom of their screen.
--Box 1--Enter the message here.
--Box 2--How long the message will stay there before disappearing in seconds.
CenterPrintAll-Gives all players in the minigame a message in the middle of their screen.
--Box 1--Enter the message here.
--Box 2--How long the message will stay there before disappearing in seconds.
ChatMessageAll-Gives all players in the minigame a message in their chat area.
--Box 1--Enter the message here.
Reset-Resets the minigame.
RespawnAll-Respawns all players in the minigame.
Projectile
Bounce-Makes the projectile bounce off the brick and keep going. Rockets will still explode on contact though.
Delete-Deletes the projectile on contact. Rockets will still explode.
Explode-Makes the projectile explode on contact.
Redirect-Makes the projectile fly off in another direction.
--Box 1--How far north/south you want the projectile to go in. Enter a positive number to make it go north, or enter a negative number to make it go south.
--Box 2--How far east/west you want the projectile to go in. Enter a positive number to make it go east, or enter a negative number to make it go west.
--Box 3--How far up/down you want the projectile to go in. Enter a positive number to make it go up, or enter a negative number to make it go down.
--Check 1--???
And there you have it. A full explanation of every event that comes with Blockland. I have 2 parts that I am not sure about, so if you know, plz reply with it. Also rate x/10.
:{D
