CIRCUITS: HOW TO BRING YOUR ISLAND TO LIFE
Circuits are the island automation system.
They allow a room to react to things like:
- When someone enters
- When someone steps on a furniture item
- When someone clicks
- When someone says a word
- When an object's state changes
- When you want something to repeat automatically
- When a user gets close to another
- When a furniture item reaches a certain position
It's the event that starts the chain.
- Entering a room
- Stepping on a tile
- Clicking on a lever
- Saying a word
- When a timer ends
- When a user gets close to another
- When a die or furniture changes state
It's the rule that decides whether the action should continue or not.
- Only if they are the owner
- Only if they are on the whitelist
- Only if there are between 2 and 5 users
- Only if they have a certain badge
- Only if they have a certain visual effect
- Only if a furniture item is at a certain position
- Only if the user is inside a zone
- Only if the die rolled a certain number
It's the final action the system executes.
- Send a message
- Teleport
- Change a furniture's state
- Freeze the user
- Change a furniture's color
- Transfer an effect to another user
- Roll a die or spin a wheel
- Detects the event.
- Looks for associated Conditions.
- If all pass, looks for the Effects.
- Executes those Effects.
Important: normal Conditions use AND logic. That means if there are several, all of them must be met.
Targets are the IDs that connect pieces to each other or to specific furniture items.
- In a Trigger, they can be the furniture items it watches and also the Effects it fires.
- In a Condition, they are usually the furniture items it checks.
- In an Effect, they are usually the furniture items it acts upon.
Trigger: Step on furniture Targets: ID_carpet_origin;ID_effect_teleport
A stack is, in practice, the set of Conditions and Effects that are linked to respond to an activation.
- A Trigger fires a chain.
- That chain finds related conditions and effects.
- That group is the stack that gets executed.
It's not a Trigger or a Condition. It's a special Effect that calls other Effects you put in its Targets.
Trigger: Click furniture Effect A: Execute stacks Targets of A: ID_message;ID_toggle;ID_tp
Very useful for grouping multiple actions, reusing blocks and better organizing complex mechanics.
Delay is the wait time before executing a Circuit. It's measured in ticks and each tick lasts approximately 600 ms.
- 0 = immediate
- 1 = ~0.6 seconds
- 2 = ~1.2 seconds
- 5 = ~3 seconds
- 10 = ~6 seconds
Message and whisper Effects allow the use of dynamic variables.
- {username} = name of the user who triggered the Circuit
- {roomname} = current room name
- {roomusers} = number of users in the room
- {online} = total number of users online
- {result} = last die or wheel result
- {score} = user's accumulated score
- {points} = points awarded in the last action
Welcome {username}, right now there are {roomusers} people in {roomname}
{username} rolled the die and got: {result} | Total score: {score}
{username} earned {points} points! Accumulated total: {score}
Several Conditions allow defining a rectangular zone on the map. They are configured with 4 coordinates: two opposite corners of the rectangle.
Parameter: X1,Y1,X2,Y2 Example: 5,10,8,15
In the visual editor you can drag to select the zone directly on the map. The selected tiles are shown in green.
The order of the corners doesn't matter. The system automatically normalizes which is the minimum and which is the maximum.
The system allows rolling dice, wheels and other interactive furniture automatically. Each roll generates a result and accumulates points per user.
- The "Activate furniture" Effect rolls the die automatically.
- The result is saved in {result} and can be used in messages.
- The score accumulates in {score} by adding each roll.
- Reset timer clears all scores and results.
Dice show 1 to 6 visually. The wheel goes from 0 to 36.
The "Message" Effect has a private mode and a public mode.
- Bool disabled (default): the message is sent as a whisper only to the user who triggered the Circuit.
- Bool enabled: the message is sent as a broadcast to the entire room. Everyone sees it.
Broadcast example:
[Circuit] {username} rolled the die and got: {result}
> All users in the room see this message.
Activates when a user steps on a specific furniture item.
Typical uses: portals, traps, checkpoints, puzzle starts.
Activates when the user stops stepping on a furniture item.
Close doors on exit, deactivate zones, reset a mechanic.
Activates when the user clicks on a furniture item.
Buttons, levers, switches and manual mechanisms.
Activates when a user enters the island.
Welcome, access control, quick tutorial and initial ambiance.
Activates when the user says a specific word or phrase.
Secret doors, event commands, riddles and passwords.
Activates when a furniture item changes state or animates. Includes dice, wheels and any furniture with toggle.
When a die or wheel activates, this Trigger automatically saves the result and accumulates the user's score.
It's the base for any dice mechanic: the result is saved in {result} and the sum in {score}.
Activates automatically on a periodic basis.
Moving obstacles, living decoration and automatic events.
Same as the repeater, but slower.
Long cycles, ambiance and less aggressive mechanisms.
Activates when a user leaves the room.
Farewells, state cleanup and exit logic.
Activates when a furniture item moves to the same tile as another target furniture item.
Detect that an object reached where another is. Very useful for push-piece puzzles.
Activates when two specific furniture items end up on the same tile. Both must be in the Targets.
Mechanics where two specific objects must meet.
Activates when a target furniture item reaches a specific X,Y coordinate.
Parameter: X,Y Example: 5,3
Visible countdown. Users see a HUD with the remaining seconds. It fires once when it reaches zero.
Delay = duration in ticks Parameter = HUD label
Perfect for timed rounds, minigames and timed events.
Activates when a user walks to a tile adjacent to another user (8 directions).
Ideal for contact mechanics like hot potato, tag, contagion and proximity.
Activates when a moving furniture item hits the edge of the map or a wall.
Useful for detecting when an object reached the limit and needs to bounce, stop or change direction.
Passes if all target furniture items have at least one user on top.
Passes if none of the target furniture items have users on top.
Passes if the user who activated the Trigger is on top of one of the target furniture items.
Passes if the user who activated the Trigger is not on top of those furniture items.
This condition checks the total number of users in the room and verifies if it's within a range.
min,max 1,5 2,2 10,50
Does the opposite. Passes when the number of users is below the minimum or above the maximum.
Passes if whoever activated the Trigger is the island owner.
Passes if whoever activated the Trigger is not the owner.
Passes if the user is on the island's whitelist.
Passes if the user is not on the whitelist.
Passes if the user has a specific badge. You can use the badge's numeric ID or its exact title.
Parameter: 299 or: Summer champion
Passes if the user doesn't have that badge. Same format as the previous one.
Passes if all target furniture items are at the indicated X,Y coordinate.
Parameter: X,Y Example: 5,3
Passes if all target furniture items are on the same tile. Needs at least 2 furniture items in Targets.
Useful for verifying that multiple puzzle pieces are together.
Passes if the user has an active specific visual effect (potion).
Parameter: Potion ID Example: 5
Key for mechanics like hot potato, where you need to know who has the effect.
Counts how many different users have stepped on the furniture. Only passes when the indicated number is reached.
Parameter: required amount Example: 3
When the number is reached, the counter resets. If you don't set a parameter, it defaults to needing 2 users.
Passes if the user is inside a rectangular zone defined by two corners.
Parameter: X1,Y1,X2,Y2 Example: 5,10,8,15
In the editor you can drag directly on the map to select the zone.
Bool disabled = active user only Bool enabled = any user
Passes if the user is outside the defined zone. It's the inverse of "User in zone".
Parameter: X1,Y1,X2,Y2 Bool disabled = active user only Bool enabled = any user
Passes if the target furniture items are inside the rectangular zone.
Parameter: X1,Y1,X2,Y2 Bool disabled = all must be inside Bool enabled = at least one
Passes if the target furniture items are outside the zone. Inverse of "Furniture in zone".
Parameter: X1,Y1,X2,Y2 Bool disabled = all outside Bool enabled = at least one outside
Passes if the last die or wheel result matches any of the indicated values.
Parameter: comma-separated values Example: 3,5,6
Bool enabled = invert (passes if it's NOT any of those values). Very useful for filtering lucky numbers or penalizing certain results.
Passes if the user's accumulated score is within the specified range.
Parameter: min,max Example: 10,50 Min only: 10 (no upper limit)
Bool enabled = invert (passes if OUTSIDE the range). Ideal for rewarding when reaching X points or blocking actions until enough are earned.
Random picks an Effect at random and can repeat the same one several times in a row.
Unseen picks one that hasn't come up in the current round and resets when all have been shown.
Unseen stores that information in the room's temporary memory, not in the database.
Sends a message to the user with [Circuit] prefix.
Bool disabled = private whisper Bool enabled = broadcast to entire room
Supports variables: {username}, {roomname}, {roomusers}, {online}, {result}, {score}.
Teleports the user to one of the target furniture items.
On arrival it can trigger other step-on-furniture Triggers.
Toggles the state of the target furniture items.
Moves and/or rotates target furniture items. Configurable with direction and rotation type.
Directions: Random, Left-Right, Up-Down, Up, Right, Down, Left, TP Random, diagonals... Rotation: Clockwise, Counter-Clockwise, Random
Expels the user from the room.
CEOs and the island owner cannot be kicked by this effect.
Teleports the user to another room.
For normal users, validation depends on permissions and whitelist.
Resets all repeaters and timers in the room. Also clears {result} and {score} for all users.
Includes Repeater, Long repeater, Timer, scores and die results.
Executes other Effects or Triggers you put in its Targets.
If the target is a Trigger, it executes its full stack with conditions. If it's an Effect, it executes it directly.
Delivers an item from the catalog to the user.
Reserved for staff.
Changes the rotation of target furniture items. Can set an exact rotation or toggle between two values.
Makes a furniture item follow the nearest user continuously.
Ideal for enemies, smart obstacles and escape mechanics.
Makes a furniture item flee from the nearest user continuously.
Opposite of Chase. Useful for scared pets or hunting puzzles.
Sends a message to the user without the [Circuit] prefix.
More immersive for ambiance and narrative. Supports: {username}, {roomname}, {roomusers}, {result}, {score}.
Applies or removes a visual effect (potion) on the user. The entire room sees it.
Parameter: Potion ID Bool: enabled = remove effect
Some effects are banned for security reasons (IDs 11 and 12).
Prevents the user from walking for a period of time.
Duration is measured in ticks (~0.6s per tick). Perfect for traps.
Changes the user's Keko appearance inside the room. It's only visual, it's not saved to the account.
Parameter: Figure ID (1-11) Bool: enabled = restore original
Perfect for event costumes, themed zones and temporary transformations.
Moves the target furniture items to an exact X,Y coordinate.
Parameter: X,Y Example: 5,10
Unlike Move/rotate, here you specify the exact destination position.
Makes target furniture items disappear or reappear visually.
Bool disabled = hide Bool enabled = show
It's only visual. The furniture items are not deleted from the database. They reappear when the room reloads.
Teleports the user to a specific X,Y coordinate.
Parameter: X,Y Example: 5,3
Doesn't allow TP to blocked tiles or outside the map. On arrival it can trigger step-on-furniture Triggers.
Removes a visual effect from the current user and passes it to the nearest adjacent user.
Parameter: Potion ID Example: 5
Only works if the user has the effect and someone is next to them. Key for hot potato.
Changes the colors of the target furniture items.
Parameter: Color1|Color2 Example: 259D1DE42A3C|45,18,62 Bool enabled = save to DB Bool disabled = visual only
The separator is | because Color2 uses commas internally. Visual mode resets when the room reloads.
Activates an interactive furniture item automatically. If the furniture is a die, it rolls it. If it's a wheel, it spins it.
Dice (1-6) | Wheel (0-36) Parameter: cooldown in seconds Example: 3 (wait 3s between uses)
When activated, the result is saved in {result} and added to the user's {score}. This allows creating board games, scoring competitions and chance mechanics.
If you don't set a cooldown or set it to 0, it can be activated without limit.
Displays a floating ranking board over a furniture item with current scores. The top 3 are highlighted in gold, silver and bronze.
Parameter: title|period|max Example: Ranking|session|10 Periods: session = this game only weekly = weekly (DB) monthly = monthly (DB) global = all-time (DB) Bool enabled = persist to DB
Shows up to 50 entries with scroll. Can be dragged and minimized.
Session data is cleared with Reset timer. Weekly, monthly and global are saved to the database.
Adds (or subtracts) a fixed amount of points to the user who activated the circuit.
Parameter: points to give
Simple example: 5
Example with message: 5|+{points} pts!
Variables: {username} {score} {points}
Bool = notify the userWorks with any trigger: step on furniture, say word, click, enter room, etc. Points accumulate in {score} and are displayed with Ranking (23).
Use negative values to subtract points (e.g.: -3). Resets with "Reset timer" (effect 7).
Makes collectible drops appear on the floor. Users pick them up by walking over them and earn points automatically.
Parameter:
visual|points|mode|interval|max|msg
Example: 1|5|walk|5|3|+{points}!
visual = drop appearance
points = points per drop
interval = seconds between spawns
max = simultaneous drops
msg = message on pickup
ExtraString1 = spawn zone (X1,Y1,X2,Y2). If not defined, they fall on any walkable tile. Supports {username}, {score}, {points}.
Executes an action on the player with the highest score, lowest score or all who have points.
Parameter: who|action|value Who: top / bottom / all Action: tp / kick / msg Examples: top|tp|10,5 (TP the best) bottom|kick|Eliminated! all|msg|Round over!
Perfect for rewarding winners at the end of a round or eliminating the worst. Kick protects CEOs and island owners.
There are Effects that are blocked when they come from a Repeater to prevent spam or abuse. This especially affects message, teleport, kick, give item, visual effect and add points.
The Timer doesn't have this restriction because it only fires once. Drop rain isn't blocked either (it needs continuous spawns).
The dice system allows creating games of chance, scoring competitions and mechanics based on random results. It works with three key pieces:
Rolls the die (or spins the wheel) automatically. Generates a random number and saves it.
Fires when the die changes. Saves the result in {result} and adds it to {score}.
Filters by specific values. Only lets through if a specific number came up.
Every time a die is rolled or a wheel is activated, the result is saved in {result}. It only stores the last value.
Die: 1, 2, 3, 4, 5 or 6 Wheel: 0 to 36
{result} is cleared with Reset timer. If nobody has rolled, it appears empty.
Each roll adds its result to the user's {score}. It's individual: each player has their own {score}.
Roll 1: result 3 → score = 3 Roll 2: result 5 → score = 8 Roll 3: result 2 → score = 10
{score} is cleared with Reset timer for all users.
- The owner clicks the start button → Reset timer clears scores and results.
- A player says "roll" → Activate furniture rolls the die automatically.
- The die changes state → State change fires, {result} is saved and added to {score}.
- A broadcast Message announces: "{username} got {result} | Total: {score}".
- If you want to reward a specific number, Die result filters (e.g.: only 6).
- When the Timer ends, the end of the round is announced.
The scoreboard system allows creating real-time rankings. Players see a floating table with names, scores and positions. It works with four main pieces:
Awards points to the user. They can be given for stepping on furniture, saying words, collecting drops or any other Trigger.
Makes collectible objects appear. Picking them up by walking over them earns the user points automatically.
Shows the floating ranking table. Can be updated in real time every time someone scores.
Executes actions on the best, worst or all players based on their ranking position.
- session — This game only. Lives in memory and is cleared with Reset timer.
- weekly — Weekly ranking. Saved to the database.
- monthly — Monthly ranking. Saved to the database.
- global — All-time ranking. Saved to the database.
For weekly/monthly/global you need to enable the scoreboard's Bool to persist scores.
- Appears as a floating panel above the furniture item.
- Shows up to 50 entries with scroll if there are more than 10.
- 1st place: gold background.
- 2nd place: silver background.
- 3rd place: bronze background.
- Can be dragged and minimized.
The title and maximum number of entries are configured in the Effect's parameter.
Automatic with dice: Every time a die or wheel is rolled with Activate furniture, the result is automatically added to {score}.
Manual with Add points: Effect 24 allows giving a fixed amount of points for any action (step, click, say word...).
Collecting drops: Effect 25 (Drop rain) gives points every time a user picks up a drop by walking over it.
Zones allow defining rectangular areas on the map for use in Conditions. You can check if a user or furniture item is inside or outside a zone.
X1,Y1,X2,Y2 Top-left corner and bottom-right corner. Example: 3,3,12,12 (10x10 tile zone)
In the editor, when configuring a zone Condition a button appears to select. When pressed, you can drag directly on the map.
Tiles are painted green while you drag. When released, the coordinates are saved.
- 17. User in zone — is the user inside the area?
- 18. User not in zone — is the user outside the area?
- 19. Furniture in zone — is the furniture inside the area?
- 20. Furniture not in zone — is the furniture outside the area?
User conditions have a Bool to choose between checking only the one who activated the Trigger or anyone in the room.
Trigger: Enter room
Effect: Message
Text: Welcome {username}
Trigger: Step on furniture Condition: On whitelist Effect: TP to furniture
Trigger: Step on tile Effect 1: Message Effect 2: Block walking Effect 3: TP with delay
Trigger: Click button Special condition: Random Effect 1: Message small prize Effect 2: Message medium prize Effect 3: Message large prize
Trigger: Click button Special condition: Unseen Effect 1: TP destination A Effect 2: TP destination B Effect 3: TP destination C
Trigger: Click lever Effect: Execute stacks Targets: message, toggle, teleport
Trigger: Furniture reaches position Parameter: 5,3 Condition: Furniture at position (5,3) Effect: Message "Correct piece!" Effect: Change state (open door)
Trigger: Step on furniture (zone entrance) Effect: Change Keko (figure 3) Trigger: Leave furniture (zone exit) Effect: Change Keko (restore)
Trigger: Step on furniture Condition: Has badge (299) Effect: TP to furniture (secret zone) If they don't have the badge: Effect: Message "You need the badge"
Trigger: Click furniture (die)
Effect: Activate furniture (die)
Effect: Message
"{username} got {result}"
Trigger: Step on furniture Condition: User in zone (3,3,10,10) Effect: Message "You are inside the game zone"
Trigger: Say word "roll"
Effect 1: Activate furniture (die)
Effect 2: Message (broadcast)
Text: {username} got {result}
Has: {score} points
Stack A: Trigger: Say word "luck" Effect: Activate furniture (die) Stack B: Trigger: State change (die) Condition: Die result (6) Effect: Message "PRIZE! You got 6!" Effect: Give item (prize)
Trigger: Step on furniture (entrance) Condition: User in zone (5,10,8,15) Condition: On whitelist Effect: TP to furniture (VIP zone) If not met: Effect: Message "No access"
Trigger: Repeater Effect: Move or rotate (Right) Trigger: Furniture hits wall Effect: Move or rotate (Left) > The obstacle goes back and forth between walls
Trigger: Step on furniture (platform) Condition: Step counter (3) Effect: Change state (open door) Effect: Message "3 people stepped, door opened!"
Stack A: Start round
Trigger: Click furniture (button)
Effect: Reset timer
Effect: Message "New round!"
Stack B: Each player rolls
Trigger: Say word "roll"
Effect: Activate furniture (die)
Effect: Message (broadcast)
"{username}: {result} | Total: {score}"
Trigger: Click furniture (board) Effect: Show scoreboard Parameter: Ranking|session|10 > Displays a floating ranking > with game scores
Trigger: Step on furniture (star)
Effect: Add points
Parameter: 10|+{points} points!
> The user earns 10 points
> and sees a confirmation message
Trigger: Click furniture (button) Effect: Drop rain visual: 1 | points: 5 interval: 4 | max: 3 > Drops appear every 4 seconds > Pick them up by walking over them
Trigger: Click furniture (end button) Condition: Is owner Effect: Action by score Parameter: top|msg|You're the champion! Effect: Action by score Parameter: top|tp|15,3
Trigger: Step on furniture (door) Condition: Score in range (50,999) Effect: TP to furniture (VIP zone) Effect: Message "Access by score!" If they don't reach 50: Effect: Message "You need 50 pts"
Trigger: Enter room Effect: Show scoreboard Parameter: Tournament|monthly|20 Bool: enabled (save to DB) > The ranking persists between sessions > Resets automatically each month
A classic minigame where a visual effect passes from player to player when they get close. When time runs out, whoever has the effect is eliminated.
Trigger: Click furniture (start button) Effect 1: Visual effect (potion 5) > Gives the effect to whoever clicks Effect 2: Reset timer > Resets the timer
Trigger: User near user Condition: Has effect (5) Effect: Transfer effect (5) > Removes the effect and gives it > to the adjacent user
Trigger: Timer (30 ticks) > Visible countdown > Fires when it reaches zero Effect: Execute stacks > Targets: ID of the call stacks > that has the kick logic
Effect: Execute stacks
> Runs for each user
Condition: Has effect (5)
> Only passes if they have the potato
Effect: Kick user
> Eliminates whoever has the effect
Effect: Message
> "{username} had the potato!"
The key is that Execute stacks checks each user in the room individually. This way the "Has effect" Condition finds exactly who has the potato and only that person gets kicked.
A minigame where players roll dice by turns. Each roll adds points and at the end of the round you see who has the most. Uses {result} for the last roll and {score} for the accumulated total.
Trigger: Click furniture (start button) Effect 1: Reset timer > Clears previous scores > and resets the timer Effect 2: Message (broadcast) > "New dice round! > Say 'roll' to play"
Trigger: Say word "roll"
Effect 1: Activate furniture
> Targets: die ID
> The die animates and generates result
Effect 2: Message (broadcast, Bool ON)
> "{username} got {result}
> Has {score} points"
Trigger: State change (die)
Condition: Die result (6)
> Only if a 6 came up
Effect: Message (broadcast)
> "{username} got 6! BONUS!"
Effect: Visual effect (potion 5)
> Gives them a celebration effect
Trigger: Timer (50 ticks)
> ~30 seconds of play
Effect: Message (broadcast)
> "Time! Whoever has the most
> points in {score} wins!"
Optional: use result Condition
to reward the best
The key is that Reset timer clears {score} and {result} for everyone. Each "Activate furniture" generates a new {result} and adds it to the {score} of the user who activated it. {score} keeps accumulating roll after roll until the next Reset.
A survival minigame where safe platforms keep disappearing. Players must jump between them to avoid falling into the "lava". If they step off the platforms or stay on one that disappears, they're eliminated.
Trigger: Click furniture (start button) Condition: Is owner Effect 1: Reset timer > Clears everything for new round Effect 2: Message (broadcast) > "The Floor is Lava! > Stay on the platforms!" Effect 3: Execute stacks > Targets: show all platforms > (restore map)
Trigger: Repeater (every 5 ticks) Special condition: Random Effect 1: Hide furniture (platform A) Effect 2: Hide furniture (platform B) Effect 3: Hide furniture (platform C) > Each cycle a random platform > disappears
Trigger: Repeater
Condition: User not in zone
Parameter: 3,3,15,15
> Zone where the platforms are
Effect: Kick user
Effect: Message (broadcast)
> "{username} fell into the lava!"
Trigger: Timer (60 ticks) > ~36 seconds of play Effect: Message (broadcast) > "Time! The survivors win!" Effect: Execute stacks > Restores all platforms > (Hide/Show with Bool ON)
The key is using Hide/Show furniture with Random so platforms disappear unpredictably. Use multiple zones if the platforms don't form a perfect rectangle.
Several chests scattered around the room. Clicking one opens it and it may contain a prize, a trap or be empty. Only one has the real treasure. Each round the chests are shuffled.
Trigger: Click furniture (chest 1) Effect: Change state (open chest) Effect: Execute stacks > Targets: prize logic (Repeat for each chest)
Special condition: Random Effect 1: Message "+50 points!" + Add points (50) Effect 2: Message "Trap!" + Block walking (5 ticks) Effect 3: Message "Empty..." Effect 4: Message "TREASURE!" + Add points (200) + Visual effect (celebration)
Trigger: Click furniture (any chest) Effect: Show scoreboard Parameter: Treasures|session|10 > Updates every time > someone opens a chest > Shows live ranking
Trigger: Click furniture (reset button) Condition: Is owner Effect: Reset timer > Clears scores Effect: Execute stacks > Closes all chests > (Change state to closed) Effect: Message (broadcast) > "Chests reset!"
Use Random so each chest is unpredictable. The scoreboard shows in real time who is winning. You can use Unseen instead of Random so the same prize doesn't repeat.
Collectible drops appear on the floor automatically. Players compete to collect the most by walking over them. The scoreboard shows who is winning in real time.
Trigger: Click furniture (start button)
Condition: Is owner
Effect 1: Reset timer
Effect 2: Drop rain
visual: 1 (chest)
points: 5 per drop
interval: 3 seconds
max: 5 drops at once
zone: 3,3,15,15
msg: +{points} points!
Effect 3: Message (broadcast)
> "Collect the drops!"
Trigger: Long repeater Effect: Show scoreboard Parameter: Collection|session|10 > Updates periodically Trigger: Timer (50 ticks) Effect: Message (broadcast) > "Time! Let's see who won" Effect: Action by score Parameter: top|msg|Winner! Effect: Show scoreboard Parameter: Final|session|10
Drops appear on their own on walkable tiles within the defined zone. They're collected automatically when stepped on. Each drop adds points to the user's {score}.
A tournament system where scores are saved between sessions. The weekly or monthly ranking persists in the database, so players can return and keep accumulating points.
Trigger: Step on furniture (checkpoint)
Effect: Add points
Parameter: 10|+{points} pts!
Trigger: Say word "completed"
Condition: User in zone (5,5,10,10)
Effect: Add points
Parameter: 50|Challenge completed!
+{points} points!
Trigger: Click furniture (ranking board) Effect: Show scoreboard Parameter: March Tournament|monthly|20 Bool: enabled (save to DB) > Persists between sessions > Resets each month Trigger: Enter room Effect: Show scoreboard Parameter: March Tournament|monthly|10 > Shows on entry
Trigger: Click furniture (reward button) Condition: Is owner Effect: Action by score Parameter: top|msg|You're the champion! Effect: Action by score Parameter: top|tp|15,3 > TP to winner's podium
Trigger: Click furniture (eliminate button) Condition: Is owner Effect: Action by score Parameter: bottom|kick|Eliminated! > Kicks the one with lowest score Effect: Message (broadcast) > "The last one has been eliminated!"
Use monthly or weekly for recurring tournaments. The ranking resets automatically with each new period. Use global for a permanent ranking that never resets.
A race with checkpoints that give points, traps that take them away and a scoreboard showing who's in the lead. Combines movement, zones and scoring.
Trigger: Step on furniture (checkpoint 1)
Effect: Add points
Parameter: 10|Checkpoint! +{points}
Effect: TP to furniture (next zone)
Trigger: Step on furniture (checkpoint 2)
Effect: Add points
Parameter: 20|Checkpoint! +{points}
Trigger: Step on furniture (finish)
Effect: Add points
Parameter: 100|FINISH! +{points}!
Effect: Message (broadcast)
> "{username} reached the finish
> with {score} points!"
Trigger: Step on furniture (trap)
Effect: Add points
Parameter: -5|Trap! -{points} pts
Effect: Block walking (3 ticks)
Effect: TP to position (start)
Trigger: Long repeater
Effect: Show scoreboard
Parameter: Race|session|10
Trigger: Timer (100 ticks)
Effect: Action by score
Parameter: top|msg|WINNER!
Effect: Message (broadcast)
> "Race finished!"
Each checkpoint gives more points than the previous one to reward progress. Traps subtract points and send back to the start. The scoreboard updates automatically.
A minigame where players must dodge obstacles inside a zone. If an obstacle touches them or they leave the zone, they're eliminated.
Trigger: Repeater Condition: User not in zone Parameter: 3,3,12,12 > Defines the play area Effect: Kick user > If someone leaves, eliminated Effect: Message > "You left the zone!"
Trigger: Repeater Effect: Move or rotate (Random) > Targets: the obstacle furniture Trigger: Furniture hits wall Effect: Move or rotate (opposite dir.) > The obstacle bounces
Combine zones with moving obstacles to create survival arenas. Use "Furniture in zone" to verify that obstacles don't leave the play area.
Each player says "roll" to throw a die. The ranking updates automatically every 5 seconds showing who is winning.
Trigger: Say word "roll"
Effect: Activate furniture
Targets: the die
> Rolls and adds to {score}
Trigger: Repeater (5 ticks) Effect: Show ranking Parameter: Dice|session|10 > Updates each cycle > showing who is winning
Trigger: Timer (300s) Effect 1: Show ranking Parameter: Winners|monthly|10 Bool: enabled (save to DB) Effect 2: Reset timer > Clears session scores Effect 3: Broadcast message > "New round!"
Session ranking is cleared with Reset timer. For permanent competitions use "monthly" or "global" with Bool enabled to save to the database. Global results accumulate points forever.
- First test a Trigger with a single simple Effect.
- Then add a Condition if needed.
- Then add delays or chains.
- Finally test Random, Unseen or Execute stacks.
Trigger: Click furniture Effect A: Execute stacks Targets of A: ID_message;ID_toggle;ID_tp Effect B: Message Effect C: Change state Effect D: TP to furniture
Set up 3 different messages with Unseen. If you activate the Trigger 3 times, all 3 should appear without repeating. On the fourth, the round can start over.
- Check that the correct Trigger is configured.
- Check that Targets point to the right things.
- Check that the room is an island.
- Check that the Condition isn't blocking.
Check the Targets of the Effect itself.
If there's only one possible Effect, you won't notice any difference.
The room, server or that specific Circuit may have been reset.
It may be blocked by the system's anti-spam protection.
- The user must actually have the active effect.
- There must be another user on an adjacent tile.
- The potion ID must not be 11 or 12.
Hide/Show is only visual. When the room reloads, everything is restored.
If Bool is disabled, the change is visual and is lost on reload. Enable it to save to the database.
- Give the user feedback with messages or visual changes.
- Don't fill the entire island with repeaters.
- Use small delays to create rhythm.
- Reserve kicks for very clear cases.
- Test in parts before connecting everything.
- Use Random for surprise and Unseen for variety without repetition.
- Use Execute stacks to better organize complex mechanics.
- For timed minigames, test the Timer alone first before linking it with everything else.
The entire room sees it.
No. It counts users in the entire room.
No. It can repeat.
Yes, but in the room's temporary memory, not in the database.
It can launch both direct Effects and full Triggers (with their Conditions).
No. There are protections for certain ranks and for the island owner.
Yes. This allows very powerful chains.
Depends on the period. Session only lives in memory. Weekly, monthly and global are saved to the database if you enable the Bool.
Yes. Use Add points with a negative value. Example: -5 subtracts 5 points from the user's {score}.
By default yes, on any walkable tile. You can limit the spawn zone with ExtraString1 (X1,Y1,X2,Y2).
Depends. With "top" only the best, with "bottom" only the worst, with "all" everyone who has points. You can combine several to reward and punish in the same round.
Condition 22 allows checking if the user's {score} is between two values. Ideal for unlocking zones or rewarding when reaching a certain goal.
{points} shows the points awarded in the last action (Add points or collect drop). It's different from {score}, which shows the accumulated total.
No. It fires only once when it reaches zero. To restart it use Reset timer.
No. It's only visual inside the room. On exit they recover their real appearance.
No. It only hides it visually. It still exists and reappears when reloading.
No. It only works with adjacent users (1 tile distance, 8 directions).
Minimum 2. Works better with 3 or more so the potato can move between several players.
Move/rotate moves in a direction (up, down, random...). Position furniture sends directly to an exact X,Y coordinate.
{score} accumulates by adding each die result. If a user rolls 3, then 5, then 2, their {score} will be 10. Reset timer sets everything to zero.
{result} only shows the last result, not the sum.
When configuring a zone Condition, the editor shows a button to select an area. When pressed, you can drag on the map to mark the tiles.
Selected tiles are shown in green. When released, the coordinates are saved automatically.
Check that the Effect's Targets point to the correct die or furniture. If it has a cooldown, wait for the time to pass. The user must be in the room.
If nobody has rolled a die yet, {result} is empty and {score} is 0. Make sure the "Activate furniture" Effect runs before the message that uses those variables.
Yes. Reset timer clears {result}, {score} for all users, and also resets repeaters and timers. Use it to start clean rounds.
By default yes. If you enable the Bool, it checks if any user in the room is in the zone, not just the one who triggered it.
"Activate furniture" is an Effect that GENERATES the action (rolls the die). "State change" is a Trigger that REACTS when a furniture changes (when the die has been rolled). They complement each other.
In the "Message" Effect, enable the Bool. With Bool enabled, the message is sent to all users in the room as a broadcast, not just to whoever activated the Circuit.
Check that the Target points to a visible furniture item in the room. The ranking is positioned above the target furniture. If there's no score data, it shows "No scores".
Session: memory only, cleared with Reset timer. Monthly: saved to DB per month, accumulates only within the current month. Global: saved to DB forever, accumulates points indefinitely.
Yes, when the required number is reached it resets automatically. If you set 3, it needs 3 different users. When all 3 arrive, it activates and counts from 0 again.
The "Furniture hits wall" Trigger fires. You can use that to change the furniture's direction and create a bounce effect.
Circuits are not just a technical system. Used well, they turn a normal island into an interactive experience.
The best way to build something great is to first think about what you want to happen and then translate it into Triggers, Conditions and Effects.
If you design with clarity, rhythm and good connections, users won't see just automations: they'll see a living room.






CIRCUITS: HOW TO BRING YOUR ISLAND TO LIFE