Hola Pingheros! 👋

Romain here, I want to talk to you about an architectural concept that use in Los Pingheros: AssetActions. If the term looks pretty generic to you, it is because it is supposed to be, AssetActions are meant to represent a wide variety of things that can be done in our game. Let’s get into it.

In case you don’t know it already, LosPingheros[lospingheros.com] is a top down snowball fighting game where a lot of crazy stuff can happen: explosions, sharks chasing you, ananas meteor sent from the penguins gods, etc.

Thus, we developed a very systemic game and as we added features, the combinatorics of associating the different incomes with the different outcomes would have quickly exploded, se we searched for a generic solution to the problem.


We have different kind of triggers in our game, and the goal is to unify the way we produce outcome from those triggers. We need to be able to:

• Describe the outcome of the interaction
  
• Prototype things easily
  
• Give the designers the tools to leverage the systemic aspect of the game

Here is an example of what it looks like in the editor. Our coins are Interactable objects that trigger an action when the player touch them. The outcome of this interaction is given by the AssetAction associated to the Interactable component.

AssetActions are scriptable objects (more precisely AssetObject as we are using Photon Quantum, but this is not the topic) that implements the IAssetAction interface.


Simple and effective, the scriptable object must describe what happens when it executes, adding score to the player that triggered the action.


We previously, created an explosive bomb (is there any other kind of bomb really ?) as you might have seen here: VFX Creation, and the use of symbols. So what happens if we just swap the AssetAction from the score one to the explosive one ?

We just gave a way for the designers to add a fake explosive coin without any extra development cost ! And this is just the beginning…


You might have noticed in the IAssetAction description that a AssetActionRuntimeData is passed as a parameter of the function. This truly has 3 purposes:

Pass other possibly meaningful parameters to the Action:

This is pretty straightforward in the example, it gives information on the context of the interaction that triggered the AssetAction, such as the position, the frame, the player, etc.

Give the possibility to execute the action at another point in the frame:

You don’t always want to execute the action instantly, might it be for logical reasons or performances. For example, you might not want to apply scores before you gathered everything that triggered score in the frame. This allows you to handle things in batch.

This is what the IAssetInteraction interface is for in the ScoreActionConfig. This interface is completely empty, and serves as a tag to tell when the action is supposed to happen.

The system handling AssetActions just check for the implementations of the AssetAction and execute different logic based on it. IAssetInteraction are added to an interaction queue to be handled later on, while basic IAssetActions are executed instantly.

Give the possibility to delay the action more in the future:

Sometime, you don’t event want the action to happen in the frame where it was triggered, in that case, you just store AssetActionRuntimeData somewhere and wait for it to be ready to be executed.


Here is a sample of the kind of AssetActions you can find in our game:


And the list goes on. This is really powerful and might even unlock a new level of creativity for your designers. Would they have thought of a bomb which increase the range of other bombs in the area when it explodes ?

We also have a way to describe aggregated actions in a single one, would you trigger several things at the same time, or randomly pick one in a table.



This is a simple overview of what you can achieve with externalizing some logic in scriptable objects. Making systems like this help you go further faster, decoupling coding the interaction from using them, and even helping the creativity of the design of systemic games. How powerful !

But… with great power… comes great responsibilities… Don’t let your designers go crazy.

Don’t freeze your brains up ‘til next time, see you on ice !

Romain GROSSE

Hey Pingheros! Let's go for the DevNews #7 !!


The rewards announcement system has been updated! 🪙

The Falcon power-up is also getting an update! 💥

A new challenge map is "work in progress". Watch out, or you might just singe your feathers! 🔥

Introducing a new skin that will soon join the wardrobe of our beloved Pingheros: Aztec Crown 👘