REFERENCIA DE BLOQUES / VARIABLES

Variables

Guardar y cambiar valores: puntaje, vidas, estados, variables globales.

18 bloques

Calculate

Accióngame.calc
Calculate

Calcula a op b y guarda el resultado en una variable.

El juego se detiene con un error si a o b no es un número (por ejemplo, una plantilla que apunta a una variable que no existe), al dividir por cero o si no se encuentra el objeto destino.

CampoQué significa
settextoVariable a escribir: hp (este objeto), Enemy.hp (otro objeto) o global.hp (global).Por defecto: score
to {…}textoPrimer número. Acepta {plantillas} como {score} o {Enemy.hp}.Por defecto: {score}
oplistaOperación: +, -, *, /, min, max o random (un entero de a a b, ambos incluidos).Opciones: + · - · * · / · min · max · random
{…}textoSegundo número. Acepta {plantillas}.Por defecto: 1
roundinglistaRedondeo del resultado: off, round (las mitades suben), floor (hacia abajo) o ceil (hacia arriba).Opciones: off · round · floor · ceil

Ejemplo Asigná damage a {attack} - {Enemy.defense} con rounding en round.

Change global variable

Accióngame.change_global
Change global variable

Suma una cantidad a una variable global.

CampoQué significa
globaltextoNombre de la variable global. Si falta o no es un número, arranca desde 0.Por defecto: gold
by {…}textoNúmero a sumar (negativo para restar). Acepta {plantillas}; un texto que no sea número detiene el juego con un error.Por defecto: 1

Change Variable

Acciónvariables_change
Change Variable

Suma una cantidad a una de las variables de este objeto.

Si la variable no existe o no contiene un número, primero se toma como 0. El resultado se guarda como número decimal.

CampoQué significa
VariablelistaVariable de este objeto, de las definidas en su panel de variables.Por defecto: score
BynúmeroNúmero a sumar. Usá un número negativo para restar.Por defecto: 1
ByencastreNúmero a sumar. Usá un número negativo para restar.Por defecto: number, any

Ejemplo Change Variable score en 1 al juntar una moneda.

Change variable of object

Accióngame.change_var_of
Change variable of object

Suma una cantidad a una variable de otro objeto.

CampoQué significa
objecttextoNombre del objeto (sin distinguir mayúsculas). Dejalo vacío para este objeto.Por defecto: Player
variabletextoVariable a cambiar en ese objeto. Si falta o no es un número, arranca desde 0.Por defecto: score
amountnúmeroNúmero a sumar. Usá un número negativo para restar.Por defecto: 1

Ejemplo Desde una moneda: Change variable of object Player score en 1 y después destruí la moneda.

Clear all global variables

Accióngame.clear_globals
Clear all global variables

Borra todas las variables globales.

Después de esto, Global variable devuelve 0 para cualquier nombre. Las variables de los objetos no se ven afectadas.

Ejemplo Ejecutalo cuando el jugador elige New Game en el menú principal.

Compare variable

Condición→ booleangame.var_compare
Compare variable

Verdadero cuando una variable de este objeto cumple la comparación elegida con un valor.

Los números se comparan como números. Si algún lado no es número, se comparan como texto sin distinguir mayúsculas, y solo = y != pueden dar verdadero.

CampoQué significa
variablelistaVariable de este objeto, de las definidas en su panel de variables. Una variable que no existe cuenta como 0.Por defecto: score
islistaComparación: =, !=, <, >, <= o >=.Opciones: = · != · < · > · <= · >=
valuetextoValor con el que se compara (escrito, sin plantillas).Por defecto: 0

Ejemplo Compare variable hp <= 0 dentro de If para manejar una derrota.

Count down variable

Accióngame.countdown
Count down variable

Resta el tiempo del frame en segundos a una variable, frenando en 0.

Ponelo dentro de On Update para que la variable baje de a uno por cada segundo real. Nunca baja de 0.

CampoQué significa
variablelistaVariable de este objeto, de las definidas en su panel de variables. Una variable que no existe cuenta como 0.Por defecto: cooldown

Ejemplo Asigná cooldown en 0.5 al disparar y permití un nuevo disparo solo cuando cooldown sea 0.

Get Variable

Valor→ anyvariables_get
Get Variable

Devuelve el valor actual de una de las variables de este objeto.

En un hueco numérico, true cuenta como 1, false como 0, y un texto que no es número como 0. En un hueco de condición, 0, el texto vacío y false cuentan como falso.

CampoQué significa
VariablelistaVariable de este objeto, de las definidas en su panel de variables.Por defecto: score

Global variable

Valor→ anygame.global_value
Global variable

Devuelve el valor de una variable global, o 0 si todavía no existe.

CampoQué significa
nametextoNombre de la variable global (escrito exactamente, distingue mayúsculas).Por defecto: gold

Hide Variable

Acciónvariables_hide
Hide Variable

Oculta una variable que se mostró antes con Show Variable.

CampoQué significa
VariablelistaVariable de este objeto, de las definidas en su panel de variables.Por defecto: score

Look up in table

Accióngame.lookup
Look up in table

Asigna a una variable el valor guardado para una clave en una tabla clave=valor.

Los números y true/false del resultado se convierten; los demás valores se guardan como texto. Una entrada sin = detiene el juego con un error.

CampoQué significa
settextoVariable a escribir: hp (este objeto), Enemy.hp (otro objeto) o global.hp (global).Por defecto: price
key {…}textoClave a buscar, sin distinguir mayúsculas. Acepta {plantillas} como {item}.Por defecto: {item}
tabletextoEntradas escritas como key=value separadas por |, por ejemplo apple=3|pear=5. Los valores pueden tener {plantillas}.Por defecto: apple=3|pear=5
defaulttextoValor usado cuando la clave no está en la tabla. Acepta {plantillas}.Por defecto: 0

Pick random item

Accióngame.pick_random
Pick random item

Asigna a una variable un ítem al azar de una lista separada por |.

Los números y true/false se convierten. Si no hay ítems, el juego se detiene con un error.

CampoQué significa
settextoVariable a escribir: hp (este objeto), Enemy.hp (otro objeto) o global.hp (global).Por defecto: choice
fromtextoOpciones separadas por |, por ejemplo red|green|blue. Acepta {plantillas}. Los ítems vacíos se ignoran.Por defecto: red|green|blue

Remember best score

Accióngame.keep_best
Remember best score

Guarda en otra variable el valor más alto que alcanzó una variable, incluso entre reinicios.

El mejor valor se recuerda durante toda la sesión de juego, así que sobrevive a Restart game, pero no se guarda en disco al cerrar el juego. Los dos nombres son obligatorios; si falta alguno, el juego se detiene con un error.

CampoQué significa
variabletextoVariable de este objeto a observar, como score.Por defecto: score
best intextoVariable de este objeto que recibe el mejor valor, como best.Por defecto: best

Set global if missing

Accióngame.default_global
Set global if missing

Asigna una variable global solo si todavía no existe.

Sirve en When Game Starts para que una escena funcione al probarla sola, sin pisar valores que vienen de una escena anterior.

CampoQué significa
globaltextoNombre de la variable global.Por defecto: gold
to {…}textoValor inicial. Acepta {plantillas}. Los números y true/false se convierten.Por defecto: 0

Set global variable

Accióngame.set_global
Set global variable

Asigna una variable global, válida para todo el juego, que se conserva al cargar otra escena.

Leela con Global variable o como {global.name} en plantillas. Restart game devuelve las globales a los valores que tenían cuando empezó la escena.

CampoQué significa
globaltextoNombre de la variable global.Por defecto: gold
to {…}textoNuevo valor. Acepta {plantillas}. Los números y true/false se convierten; lo demás se guarda como texto.Por defecto: 0

Set Variable

Acciónvariables_set
Set Variable

Asigna un valor a una de las variables de este objeto.

La variable se crea si todavía no existe. Cada objeto (y cada clon) tiene su propia copia.

CampoQué significa
VariablelistaVariable de este objeto, de las definidas en su panel de variables.Por defecto: score
TypelistaTipo del valor escrito: bool, int, float o string. Se ignora si hay un bloque conectado en value.Opciones: bool · int · float · string
BoollistaValor usado cuando el tipo es bool: true o false.Opciones: true · false
IntnúmeroValor usado cuando el tipo es int. Los decimales se cortan (3.9 pasa a ser 3).Por defecto: 0
FloatnúmeroValor usado cuando el tipo es float.Por defecto: 0
StringtextoValor usado cuando el tipo es string.Por defecto: text
ValueencastreHueco opcional. Un bloque conectado (matemática, texto, ítem de lista, objeto...) se guarda tal cual y reemplaza el valor escrito.Por defecto: number, string, boolean, object, any

Set variable of object

Accióngame.set_var_of
Set variable of object

Asigna una variable en otro objeto y la crea si hace falta.

Si ningún objeto tiene ese nombre, no pasa nada.

CampoQué significa
objecttextoNombre del objeto (sin distinguir mayúsculas). Si varios comparten el nombre, se usa el primero que se encuentre. Dejalo vacío para este objeto.Por defecto: Player
variabletextoVariable a asignar en ese objeto.Por defecto: score
valuetextoNuevo valor. Acepta {plantillas}. Los números y true/false se convierten; lo demás se guarda como texto.Por defecto: 0

Show Variable

Acciónvariables_show
Show Variable

Muestra una variable y su valor en vivo en la esquina de la vista del juego.

El valor aparece como name: value arriba a la izquierda de la vista del juego y se actualiza en cada frame. La variable ya tiene que existir cuando corre el bloque; si no, no se muestra nada.

CampoQué significa
VariablelistaVariable de este objeto, de las definidas en su panel de variables.Por defecto: score

Ejemplo Usalo en When Game Starts para seguir un valor mientras probás.