Variables made easy with the new Data Storage

Everything you built keeps working

Your variables, stored values and commands are untouched. Older variables such as getHighestUser and printAllValues work exactly as before, and the Classic Variable Formats switch in Builder Settings shows them in the variable picker again.

Variables now read left to right

The new variables read in one direction: the variable, a dot, then what you want from it. No brackets inside brackets.

A top 10 leaderboard used to take twenty variables, a {getHighestUser(BGVAR_coins)[1]} and a {getHighestValue(BGVAR_coins)[1]} for every place. Now it takes one: {BGVAR_coins.leaderboard.10} prints the whole top 10, one member per line.

You don't have to remember any of these. Open a variable in the builder's variable picker, or press How to use on the Data Storage page, and click the one you want.

Collection of objects

A new kind of variable: a list where every item has its own keys. Think of a shop where each item has a name, a price and a stock, a warning log, or a backpack for every member. Items don't all need the same keys.

Read it as the list, then the item, then the key. {BGVAR_shop.0.name} is the first item's name, and {BGVAR_shop[name=Potion].price} finds an item by one of its keys. Fill a list in on the page, import it from JSON, or let your commands add to it:

• Set Variable adds an item, sets or removes a key, removes an item or clears the whole list. Pick the item By position or By a key's value.
• Run Equation on Variable does maths on one key, such as taking 1 off the Potion's stock.
• Run a Loop has a new Each item in a list option, with {item.name}, {item.price} and so on ready inside the loop.

Start from 41 ready ideas

1. Open Data Storage and press Create a new variable.
2. Under What do you want to make?, pick an idea such as Coins, Shop, Warning log or Counting game, or search all 41.
3. Everything is filled in for you. Change anything you like, then create the variable.

If nothing fits, Start from scratch sits right underneath.

If / Else

The Comparison Condition block is now called If / Else and walks you through three steps: What do you want to check?, Your checks and If more than one check is true. Choose One of my variables and it asks what about it (the value, a rank, how many items) and whose. Your existing blocks work as they did, and the Advanced switch brings back the classic fields.

Good to know

• Positions in a list start at 0, so .0 is the first one. Leaderboard places and ranks start at 1.
• Leaderboard variables work on number variables that every member has, like coins or XP.
• A Collection of objects holds up to 1,000 items, each with up to 50 keys.