Kether

Programación de scripts Kether

El lenguaje Kether está creado por el proyecto de TabooLib para funcionar en los servidores de Minecraft en múltiples plataformas de servidor, ya sea Bukkit, Spigot, Sponge, Nukkit y otras.

Página oficial de Kether: https://kether.tabooproject.org/

Kether se categoriza por ser un lenguaje de scrips altamente rápido en su ejecución, es incluso más rápido que Javascript debido a que se especializa en servidores de Minecraft y no en otras cosas.

1. Información General

• Las aplicaciones de Kether van desde revisar si una condición se cumple hasta ejecutar múltiples acciones que interactúan con el jugador y el servidor.

• Kether es un lenguaje completamente fácil de aprender y entender para su uso en servidor de Minecraft.

• Solamente TrMenu 3.0 o superior es compatible con Kether.

2. Formato

El formato de Kether se divide en argumentos, métodos, variables y comparadores. Dale click aquí para ver una lista completa de las cosas de Kether.

2.1 Argumentos

• Los argumentos en Kether se definen por empezar por *, por ejemplo *hola.

• En caso de ser un argumento de múltiples palabras o usa caracteres especiales como tildes se debe escribir entre "", por ejemplo *"árbol verde".

2.2 Métodos

• Los métodos ejecutan cosas mediante argumentos, por ejemplo metodo *argumento.

• Algunos métodos no requieren argumentos.

• Los métodos interactúan con el servidor, jugador o cualquier otra cosa que se les permita.

2.3 Variables

• Las variables son cosas como que como su nombre lo dice pueden variar, en otras palabras, su valor puede cambiar.

• Las variables devuelven objetos como texto, número o boolean (verdadero o falso) y pueden ser utilizadas como argumentos.

• Una variable puede ser obtenida mediante un método.

• Las condiciones de TrMenu aceptan variables que devuelvan un boolean (un valor que se expresa como verdadero o falso).

2.4 Comparadores

• Los comparadores mediante uno o varios métodos compara que se cumpla una variable o método. Por ejemplo, confirmar que un número es más alto que otro.

• Un comparador devuelve un boolean (un valor que se expresa como verdadero o falso).

• Las condiciones de TrMenu en sí son comparadores.

3. Ejemplos

Aquí una lista de ejemplos básicos que usan el lenguaje Kether, igualmente se sugiere revisar la documentación de Kether para obtener una lista completa delos métodos disponibles.

3.1 Revisar permiso

• Puedes revisar con facilidad si el jugador tiene algún permiso.

# Con esto revisas si el jugador tiene el permiso "permiso.123.asd"
# El método es "perm"
# El argumento es "*permiso.123.asd"
# Y todo esto devuelve una variable de tipo boolean
condition: 'perm *permiso.123.asd'

3.2 Revisar dinero

• Puedes revisar si el jugador tiene cierta cantidad de dinero.

• Este método requiere el plugin Vault para funcionar.

# Con esto revisas si el jugador tiene al menos 150 de dinero
# El método es "money"
# El argumento es "*150"
# Y todo esto devuelve una variable de tipo boolean
condition: 'money *150'

3.3 Obtener placeholder

• En Kether los placeholders son variables que requieren ser invocadas para obtener el valor de lo que significan.

# Con este método obtienes el resultado de un placeholder
# El método es "placeholder"
# El argumento es '*"%player_name%"'
# Todo esto devuelve una variable tipo texto que
# representa el resultado del placeholder
placeholder *"%player_name%"

3.4 Comparar dos cosas

• Kether admite expresiones de comparación, pero requieren ser invocadas con el método check.

Tipo de expresión	Descripción
== | is	Compara que 2 cosas sean iguales.
!= | not	Compara que 2 cosas NO sean iguales.
=? | is?	Compara que 2 textos sean casi iguales, por ejemplo "hola" y "HoLa" se les considera iguales.
=! | is!	Compara que 2 cosas sean exactamente iguales desde el punto de vista de su instancia en la memoria.
> | gt	Compara que el primer argumento sea mayor que el segundo.
>=	Compara que el primer argumento se mayor o igual que el segundo.
< | lt	Compara que el primer argumento sea menor que el segundo.
<=	Compara que el primer argumento sea menor o igual que el segundo.

# Comparación de que un texto sea IGUAL a otro
# El método es "check"
# El primer argumento es "texto"
# El segundo argumento es "manzana"
# La expresión de comparación es "=="
condition: 'check *"texto" == *"manzana'

# Comparación de que un número sea mayor igual que otro
# En este caso se invoca un placeholder
condition: 'check placeholder *"%vault_eco_balance%" >= 2500'

3.5 Verificación de múltiples cosas

• Puedes verificar múltiples cosas al mismo tiempo con Kether.

• Mediante el método all verificas que todo dentro de una lista devuelva un valor verdadero, si la verificación se cumple el método también devolverá un valor verdadero, de la contrario será falso.

• Con el método any verificas que al menos una cosa en una lista se cumpla.

• Las listas se invocan con [ ] y dentro metes los métodos, variables y todo lo que quieras verificar.

# Con esto revisas si el jugador tiene TODOS los permisos
# de una lista de varios permisos
condition: 'all [ perm *permiso.123 perm *trmenu.use perm *otro.permiso ]'

# Con esto revisas si el jugador tiene AL MENOS UNO de
# los permisos en una lista
condition: 'any [ perm *permiso.123 perm *trmenu.use perm *otro.permiso ]'