Variables del panel

Utilice variables para manipular paneles.

¿Qué son las variables de panel?

Las variables de panel son marcadores de posición personalizados o datos de un panel que pueden utilizarse en otro panel. Estas variables básicamente llevan valores de un panel a otro o pueden guardarse permanentemente para que el complemento las recuerde la próxima vez que se abra un panel.

Variables de placeholder

Creando placeholders

Para definir un marcador de posición y su valor, utilice el siguiente comando. Deberá introducir el nombre del panel que desea abrir y, a continuación, las siguientes palabras deberán seguir este formato: [placeholder:valor] Los valores del marcador de posición pueden contener espacios, y los propios marcadores de posición no deben tener mayúsculas.

'0':
  material: STONE
  commands:
  - open= panel-3 [example1:PlaceHolder Value] [mat:STONE]
  - msg= The value of the placeholder is %cp-example1%

Una vez definidos los marcadores de posición, utilícelos donde quiera en el panel que desee abrir. En el ejemplo anterior, el marcador de posición es ejemplo1 lo que significa que utilizará%cp-example1%.

Editando placeholders

Si desea editar un marcador de posición en el panel actual, no puede utilizar open= como se muestra arriba. En su lugar, cambie open= por placeholder= y utilice el mismo proceso, esto le permitirá editar marcadores de posición en el panel actual. Sólo necesitará definir el/los marcador/es de posición que está editando, cualquier otro marcador de posición permanecerá igual si no se añade. Por ejemplo, usando el ejemplo anterior, si el panel-3 estuviera abierto y usted quisiera que uno de los elementos cambiara el marcador de posición %cp-mat% a BEACON en su lugar, usted usaría el siguiente comando:

'7':
  material: BEACON
  commands:
  - placeholder= [%cp-mat%:BEACON]

Variables de datos

Creación de variables de datos

Estas variables son más permanentes que las anteriores. Estos valores se guardarán permanentemente en un archivo incluso si se reinicia el servidor. Tendrá que utilizar una de las siguientes etiquetas de comando para establecer un valor.

Añadir valor

add-data= [dataName] [valor] [jugador opcional]

Al utilizar esta opción no se sobrescribirán los datos antiguos, pero si el reproductor no tiene datos establecidos para este dataName, escribirá el valor en él. Esto es útil para colocar en la sección de comandos al abrir de un panel, para asegurarse de que los datos se han establecido antes de continuar utilizando el panel.

Poner valor

set-data= [dataName] [valor] [jugador opcional]]

Usando esto se establecerán los datos a un nuevo valor incluso si el dataName ya tiene un valor.

Eliminar valor

del-data= [dataName] [nombre del jugador opcional]

Esto borrará permanentemente un valor específico para un jugador. Esto significa que la etiqueta add-data se puede utilizar porque ya no existen datos en el determinado dataName para el jugador.

clear-data= [nombre del jugador]

Esto borrará todos los datos que un jugador pueda haber guardado. Puedes usar %cp-nombre-jugador% para especificar el jugador que ha abierto el panel.

Usando matemáticas

math-data= [dataName] [operación] [nombre del jugador opcional]

Se utiliza para modificar datos numéricos. Uso: math-data= [dataName] [operación]. Sólo hay cuatro tipos de operaciones, + - * /. Usted debe poner una operación al principio y un número al final, algunos ejemplos como una operación: +1, +0.1, -15, *3, /5. Tomará el número actual almacenado y le sumará la operación.

Visualización de variables de datos

Para ver una variable de datos, sólo tendrá que utilizar el siguiente marcador de posición. %cp-data-[dataName]% replace [dataName] con el nombre de los datos que desea visualizar. %cp-data-[dataName],[nombre del jugador]%para ver los datos de otros jugadores.

Establecimiento de variables con placeholders

Los datos también pueden manipularse utilizando marcadores de posición. Véase el siguiente marcador de posición %cp-setdata-[dataName],[nuevo valor]% sustituya [dataName] por el nombre de los datos que desea editar.

Algunos consejos

• Si abre el panel directamente sin definir una variable, los marcadores de posición aparecerán en bruto sin ningún valor al intentar visualizarlos.

• Para que los elementos tengan un aspecto diferente en función del valor del marcador de posición, utilice una sección hasvalue para cambiar el elemento por lo que desee.

• Las claves/nombres de los datos no deben tener mayúsculas.