Creation

Blocks are codes in the form of toy blocks.

From making objects rotate, to summoning meteor with skill, block can do it all.

In addition to clicking the “Block Script” button under “More”, there are several other ways to enter the block editor.

Every object has an option to edit its script.

You may add global, team, or player script under “Setting - BASIC SETTINGS”.

All blocks are located in the panel on the left. Each square button corresponds to a group of blocks in that category.

Just like placing objects into the scene, drag the blocks from the left panel into a blank area.

Only when block is added to an object will it be displayed in the drop-down list in the upper right of the block editor.

As shown in the picture, the building with block script added appears in the list.

Know Blocks

Blocks have two distinctive features: shape and color.

Let’s introduce how blocks work through these two features.

The Meaning of Shape

Just like toy blocks, blocks with different shapes are used differently.

Only by assembling blocks with correspondent shapes will they work.

Event Block

The red event block is flat on the top and has a bulge on the bottom.

Which means that it is the beginning of all codes and no blocks can connect to its top.

There cannot be duplicate event blocks in a block script.

Execution Block

The execution block, which has a dent on the top and a bulge on the bottom, supports the rest of the code.

As its shape indicates, it can be connected to event blocks or other execution blocks. It can also be the end of a block section.

Data Block

The rectangular block with a yellow dot on the left can only be embedded in other blocks to provide the required data.

Order of Running

By assembling said blocks according to their shapes, a block section can be made.

The blocks always run in order from top to bottom.

The Meaning of Color

Colors are used to classify blocks and provide indication.

Classification

Tap the left sidebar to expand the block panel. Each square button usually corresponds to a group of blocks of its color.

For example, logic blocks are dark green; data blocks are magenta or dark gray.

Indication

If a block contains a data block of the same color, it means that this is its output (return value).

This output can be dragged into other blocks below.

Simple Example

Want the player to start gun fights right after joining the game? No problem.

Event + Action

Enter the global script and find the “On Player Join” event as the beginning.

Select the “Add Item” execution block as the “Behavior” that responds to the “Event”.

“Item” and “Count” are easy to understand. For example, select FAMAS with the count of 1.

The “Target” slot indicates to whom the weapon should be issued. How to fill it?

We want to issue the weapon to “players who join the game”, so drag the “Player” block returned by the event “On Player Join” to the “Target” slot.

In this way, players who enter the game will get a FAMAS:

Event + Condition + Action

In addition to using the “Event + Action” mode above, you can also add conditions to make it the “Event + Condition + Action” ECA mode.

Use Output Log

You may have found a problem: after entering the game, you cannot see how the blocks are running.

Using output log can help us observe and control blocks.

Type “log” in the search bar above the left panel and add the “Log Info” block.

Click the plus sign and the left panel will pop up with valid options. Click the string block to place it in and enter a message.

After entering test play mode, click the Log button in the picture.

When the block runs to “Log Info”, a line will be printed in the Output Log window.

Flexible usage of Output Log is very helpful for testing and troubleshooting.