Script your first interaction

If you ran the game, you may have seen that, while the character moves towards the window, a message is printed on top of the scene: Can't INTERACT with it.
That's because we didn't define what should happen when we interact with the window. Remember, in the GUI we selected, clicking on an object will trigger an interaction while right-clicking on an object will trigger an examination.

We are now going to script our first interaction, using Godot GDScript language and the very convenient engine API that Popochiu provides to make our life easier.

In the room tab of the Popochiu dock, locate the "Open Script" icon for the Window hotspot (25):

This will open the GDScript connected to this hotspot in the Godot scripting editor (26):

We will now add some interaction to the script. So far it will be simple stuff: we'll make our main character say something meaningful when we examine the window, and - in the absence of other elements in the room - act a bit weird when we try to interact with the window.

Locate the _on_click() function in the script. It should read something like this:

# When the node is clicked
func _on_click() -> void:
    # Replace the call to E.command_fallback() with your code.
    E.command_fallback()
    # For example, you can make the player character walk to this hotspot, gaze at it, and then say
    # something:
#   await C.player.walk_to_clicked()
#   await C.player.face_clicked()
#   await C.player.say("What a nice view")

Popochiu automatically executes this function when you click over the Window hotspot. We just need to put something meaningful into it. Let's try something. Change the function so it looks like this:

# When the node is clicked
func _on_click() -> void:
    await C.player.walk_to_clicked()
    await C.player.face_clicked()
    await E.wait(0.5)
    for n in 3:
        await C.player.face_left()
        await E.wait(0.3)
        await C.player.face_right()
        await E.wait(0.3)
    await C.player.face_clicked()
    await C.player.say("I wanted to open the window but I can't find the handle")

Save the script (ctrl/cmd + s) and run your game.
Now when you click the window, the character will walk to it, turn around three times like it is looking around for something, then face the window and say a phrase.

Yay! You reached an important milestone! Now your game feels more alive, isn't it?

Let's see what happened, breaking the function down to pieces. Ignore for a moment the await keyword.

    await C.player.walk_to_clicked()
    await C.player.face_clicked()

These two lines use the C Popochiu object. It holds a reference to every character in the game. Our character is called Goddiu, so C.Goddiu allows us to give commands to that character. But since Goddiu is also the character that the player controls, we can use the shortcut C.player.

This comes in very handy for those games that have more player-controlled characters, like Maniac Mansion, or Day of the Tentacle. You can change the active character as the game progresses but your scripts will point to the current active character, sparing you the effort to duplicate the code for each and every playable character.

    await E.wait(0.5)
    for n in 3:
        await C.player.face_left()
        await E.wait(0.3)
        await C.player.face_right()
        await E.wait(0.3)

Here we are literally waiting for some time to pass. E is the object representing the game engine (Popochiu!) and we are asking it to wait for half a second. After that, we use the for GDScript keyword to repeat the same code three times.

The executed code just flips the character left and right after a small pause, as it is looking around.

    await C.player.face_clicked()
    await C.player.say("I wanted to open the window but I can't find the handle")

These last two lines make sure the character finally looks towards the window and says its line.

Now let's provide an examine interaction. Edit the _on_right_click() function you can find further down the script so it looks like this:

# When the node is right clicked
func _on_right_click() -> void:
    await C.player.face_clicked()
    await C.player.say("The weather is so nice today")
    await C.player.say("I may as well open that window!")

By this time, you should be able to figure out what will happen by yourself. Run the game and see your masterpiece in action.