Variables

Works with

This page will teach you some things about variables.

What is a variable

A variable is a value that holds data like states or numbers or even words for later use. They are useful when needing to test if something is happening or if a word is the same as something else, they can also be used in math to test for number values.

Variable types

There are four kinds of variables, Logic, String, Numbers, and Itemstack. Each type holds specific types of data.

  • Logic: Stores true or false data to blocks, worlds or maps. The real term for this kind of a variable is a boolean.
  • String: Stores text data to blocks, worlds or maps. The real term for this kind of a variable is actually a string.
  • Number: Stores solid or decimal numbers data to blocks, world or maps. The real term for this kind of a variable is an integer.
  • Itemstack: Stores Minecraft item or blockitem data to blocks, world or maps. The real term for this kind of a variable is an itemstack.

(Global) variables

Global variables save variable data to dimensions or entire maps or only run during a session or to a player instance. Below lists each global variable type and some of the key features each one has to offer.

  • Global session: Sets a variable to all worlds, main screen, and menus, but does not save them.
  • Global world: Sets and saves a variable to a dimension.
  • Global map: Sets and saves a variable to the entire map.
  • Player lifetime: A variable specific to each player, it holds its value for the time of player living and is reset when a player dies. This variable is synced to the clients, unlike entity NBT tags.
  • Player persistent: A variable specific to each player. This variable is synced to the clients, unlike entity NBT tags.

Local variables

Local variables can be used in mod elements are store the variable locally within that element. Each procedure execution will reset these variables, thus local. They use all four variable types listed above.

Local variables are meant to be used to store value for the time of procedure execution, for example a counter inside a while block. They can not be used for tick counters, for example, as they will reset each tick trigger.

NBT variables/tags

NBT are variable types like local entities however rather than having a worldwide variable set per element you can target a specific block, item or entity to have a variable stored in them.

Block and item NBT variables are synced to the clients, but entity NBT variables hold own instance for server and client-side and are not synced.

If you want to display, for example, player stats in an overlay which is client-side, use player variables instead as they are synced for you to the client for display.

Variables explained in videos

If you prefer to watch the video, you can find the wiki page above summarized in videos below:

 

 

 

 



Donate to MCreator

By donating to developers you can speed up development, as with more resources, we can dedicate more time to MCreator. It is a free project made by developers working on it in their free time.