ROOM CONSUMABLES

Room Consumables gives creators the ability to sell things that can be purchased multiple times. They are “consumed” when a player uses it—whether that’s jumping higher for 10 seconds in that fun parkour map or being able to see in the dark during that one scary level. Anything that can be done in CV2 can be triggered by using a consumable.


HOW TO USE THEM

Creating a Consumable

Go to your watch > This Room > Settings > and find the Consumables tab. You can add, edit, and delete your consumables here. To create a consumable, press “ADD CONSUMABLE” and add the Name, Description, Cost and Photo of your consumable.

Consumable-Cost-UI.jpg
  • The price for your consumable can be set in Rec Room Tokens or in a Room Currency.  Consumables can also be free.

  • Only RR+ members can set a Token price that’s not zero

 

Hooking Up the Circuitry

Now that you’ve created a consumable, let’s hook up the circuits! For this example, we’re going to create a consumable that gives a player a higher jump for 10 seconds.

Spawn in a CV1 Role Chip and rename it to the name of your Consumable (ex: JumpBoost). Go to This Room > Settings > Game Roles and configure to your desired settings. Next, we’ll wire up the CV2 circuitry that will interact with the new role. You’ll need the CV2 chips listed below.

needed chips.jpg

CV2 Chips:

  • Event Receiver

  • Constant (Consumable)

  • Equals

  • If

  • Variable (string)

  • Get Local Player

  • Player Add Role

  • Activate Consumable

  • Delay

  • Player Remove Role

  • Deactivate Consumable

Steps:

  1. Configure the Event Receiver to Consumable Used and wire the yellow Consumable port to the Equals chip

  2. Configure the Constant (Consumable) chip to your Consumable (e.g., Jump Boost) and wire it to the Equals chip

  3. From the Equals chip, wire Equals to the Condition of the If chip

  4. Connect the orange exec on the Event Receiver to the If chip

  5. Configure the value on Variable (string)—pictured as RoleName—to the role name (e.g., JumpBoost)

  6. From the If chip, wire the output Then to the input on the Variable (string)

  7. Wire the exec output on Variable (string) to the exec input on Player Add Role

  8. Connect Get Local Player to Target on Player Add Role

  9. Wire the exec output on Player Add Role to the exec input on Activate Consumable

  10. Connect the exec output of Activate Consumable to the Run input on Delay

  11. On the Delay chip, set the Delay (s) and wire After Delay to the input on Deactivate Consumable

  12. Wire the Constant (Consumable) chip to Consumable on both the Activate Consumable chip and Deactivate Consumable chip

  13. On Deactivate Consumable, connect the exec output to the exec input on Player Remove Role

  14. Wire Variable (string) to Value on Player Remove Role

  15. Hook up Get Local Player to Target on Player Remove Role

  16. Press the consumable button to try it out!

When a consumable is used by a player the Event Receiver will kick off our circuit. Using If and Equals chips, we compare the output of the Event Receiver to check which consumable was used. This consumable will then add a role to the local player and then call the Activate Consumable chip to confirm the role was added. This stays active for 10 seconds after which time we remove the player role and call Deactivate Consumable.

 

Making the Consumable Buyable

Now that we’ve created a consumable and hooked up the circuitry, players need to be able to buy it. You can find a new Prop in your Maker Pen palette called Consumable Store Button. This button allows players to purchase the consumable for the price you set when you created it.

To find the store button, select Open Palette on your Maker Pen menu, then select the Props tab and filter by Dynamic. After you spawn it in, use the Configure tool on your Maker Pen to select which consumable you want to sell. If you still haven’t created a consumable yet, select “Create New Consumable” and fill in the info.

 
 

Using the Consumable

backpack-inventory.jpg

Room owners can always purchase their consumables for free. Purchased consumables show up in your backpack under the This Room tab. From here, we can view and use the consumables in our inventory. Clicking Use will send the consumable into an activating state before confirming that it’s Active..


EXAMPLE ROOMS

^TheBucket Farm by AlexisVR & CaptainKoala Welcome to the Bucket Farm! Harvest Buckets with your friends to earn some Bucket Bucks! Try out the Consumable Upgrades to Boost your experience! Unlock all Bucket Seeds and get rich!

^TheBucket Farm by AlexisVR & CaptainKoala
Welcome to the Bucket Farm! Harvest Buckets with your friends to earn some Bucket Bucks! Try out the Consumable Upgrades to Boost your experience! Unlock all Bucket Seeds and get rich!

^PartyVenueDeluxe by Ranenbauer & whatsupbro3 You wanna play games? Maybe ride some rides? How about shooting both things and people? We've got it all at Ranen's Funhouse and Arcade! It's the perfect place to throw a party!

^PartyVenueDeluxe by Ranenbauer & whatsupbro3
You wanna play games? Maybe ride some rides? How about shooting both things and people? We've got it all at Ranen's Funhouse and Arcade! It's the perfect place to throw a party!

^CLASHofROYALS by Endgame A Clash Royale inspired 1v1 strategy game. Spawn troops and watch them fight! 95,832 different deck combinations!

^CLASHofROYALS by Endgame
A Clash Royale inspired 1v1 strategy game. Spawn troops and watch them fight! 95,832 different deck combinations!

^RetroRunner by Decoded, Muffin, & Rick4467 RetroRunner is an infinite runner designed in a broken dystopian program. Avoid any obstacles in your way as they will send you back to the lobby. Don't forget to buy Power Ups to save yourself or give you that extra boost.

^RetroRunner by Decoded, Muffin, & Rick4467
RetroRunner is an infinite runner designed in a broken dystopian program. Avoid any obstacles in your way as they will send you back to the lobby. Don't forget to buy Power Ups to save yourself or give you that extra boost.


TIPS

if-chips.jpg
Try-consumable.jpg
  • Use one Event Receiver chip if you have multiple consumables. Even if you have a correctly wired Consumable event, if there’s another Event Receiver for consumables that is not hooked up it can give an error. You can use one single event with a sequence of If chips.

  • Allow players to try the consumable for a small duration of time before purchasing.

  • Room Currency can be awarded for using Room Consumables! This can be useful for incentivizing players to use consumables (i.e, they gain XP by using them) or just for the fun of it.


Get Connected

Stay informed! Find more info on Community Commerce events and programs by joining the Creator Hub Discord. Find more info under the Community Commerce channels section.