Build it in our OpenRCT2 Studio too: set up a park plugin, wire up events, read the park and export real plugin files in the browser, with no install. Open the OpenRCT2 Mod Studio →

🔥

Ember says: a guest is just an object with properties like x, y and happiness. Learn to find the ones you care about, and the rest is action.

👀

Find the Right Guest

Loop and filter

Active

🎯

Goal for this step

Loop over guests and pick out the unhappy ones.

1Get all guests with map.getAllEntities("guest").
2Each guest has a happiness value.
3Collect the ones below a threshold into a shortlist.

var guests = map.getAllEntities("guest");
var sad = guests.filter(function (g) { return g.happiness < 100; });

✏️

Fill in the Blanks

+15 XP

We use filter to keep only the guests who are .

🧠

Knowledge Check

+15 XP

What does the filter here do?

ARemoves all guests

BKeeps only the guests matching the test

CAdds new guests

📍

Where Is a Guest?

x, y and z

Locked

🎯

Goal for this step

Read a guest position.

1Every entity has x, y and z coordinates.
2z is the height above the ground.
3These let you spot guests in odd places, like the water.

✏️

Fill in the Blanks

+15 XP

A guest position has x, y and coordinates.

🧠

Knowledge Check

+15 XP

Which coordinate is the height above the ground?

🛟

Act on a Guest

Change what happens

Locked

🎯

Goal for this step

Teleport a guest to safety.

1You can set a guest position with the entity API.
2Move the guest to the nearest path tile.
3Post a message so the player knows you helped.

g.setCoordinates(safeX, safeY, safeZ);
park.postMessage("Rescued a soggy guest!");

✏️

Fill in the Blanks

+15 XP

We set a guest position with set.

🧠

Knowledge Check

+15 XP

What is a friendly way to use powers over guests?

AHelp guests in trouble

BScare everyone away

CDelete the park

❤️

Track the Mood

Are guests happy?

Locked

🎯

Goal for this step

Report how many guests are unhappy.

1Count the unhappy guests from your shortlist.
2If the number is high, tell the player what might help.
3Keep the advice kind and specific.

✏️

Fill in the Blanks

+15 XP

A good tip is , not just "make it better".

🧠

Knowledge Check

+15 XP

Your plugin sees 20 unhappy guests. Best message?

A"Everyone is unhappy!"

B"20 guests want a bench and a drink nearby."

CSilence

🧪

Test a Rescue

Make it happen safely

Locked

🎯

Goal for this step

Set up a guest near water and watch your rescue work.

1Load a park with a lake.
2Cheat a guest into the water using the developer tools.
3Watch your plugin find them and move them out.

🧠

Knowledge Check

+15 XP

Why cheat one guest into the water while testing?

ATo avoid ruining a real park

BTo make the game harder

CIt is required by law

Help the GuestsEpisode 5: Working with Guests

Help the Guests
Episode 5: Working with Guests