Cómo configurar MyCommand en un server de Minecraft

Qué hace MyCommand

MyCommand, también llamado MyCMD, es un plugin de Minecraft para crear comandos personalizados y funciones de server. Puede crear comandos de texto simples, atajos de comandos, mensajes clicables, broadcasts, menús, trades tipo tienda, aliases y más.

Esto es útil cuando un plugin existente casi hace lo que un server necesita, pero la sintaxis del comando es demasiado larga, demasiado incómoda o no lo bastante amigable para los jugadores. En lugar de pedirles a los jugadores que recuerden un párrafo disfrazado de comando, MyCommand permite a los administradores crear comandos más limpios con salida y permisos personalizados.

El plugin es poderoso, pero eso también significa que su configuración puede ser exigente. La mayor parte del trabajo ocurre dentro de archivos YAML, así que los espacios, nombres de comandos, opciones y variables deben escribirse con cuidado.

Instalando MyCommand

1. Abre la página de MyCommand en Spigot y haz clic en Download en la esquina superior derecha.

1. Abre el panel del server, ve al administrador de archivos o FTP e inicia sesión con la contraseña del server.

1. Entra a la carpeta `plugins` y elige Upload.

1. Arrastra el archivo `.jar` de MyCommand al área de upload.

1. Espera hasta que el upload llegue al 100%, luego reinicia el server de Minecraft.

Después del reinicio, MyCommand debería generar su carpeta de plugin y archivos predeterminados. Si la carpeta no aparece, confirma que el server esté ejecutando una plataforma compatible con plugin, como Paper, Spigot o Bukkit.

Entendiendo la configuración de MyCommand

MyCommand se controla principalmente mediante archivos, no con comandos de configuración dentro del juego. Eso lo hace flexible, pero también significa que cada comando necesita la estructura correcta.

Un comando personalizado normalmente incluye:

• Un nombre de comando
• Un tipo de comando
• Una o más líneas de salida o acciones
• Permisos opcionales
• Variables opcionales, como nombres de jugadores o argumentos de comando

Tipos de comandos comunes

MyCommand admite muchos tipos de comandos, pero estos son algunos de los puntos de partida más comunes:

• `TEXT`: Crea un comando que envía texto plano al jugador.
• `RAW_TEXT`: Envía texto con formato y puede incluir elementos clicables o que aparecen al pasar el cursor.
• `RUN_COMMAND`: Ejecuta otro comando, a menudo con variables.
• `ALIAS`: Crea una versión más corta de un comando existente sin manejo de variables.

Usa `TEXT` para comandos informativos, `RAW_TEXT` para listas clicables, `RUN_COMMAND` para atajos que necesitan argumentos y `ALIAS` para reemplazos simples de comandos.

Variables útiles

Las variables permiten que un comando reaccione al jugador que lo usa o a los argumentos que escribe.

• `$arg1`, `$arg2`, `$arg3`: Lee argumentos específicos del comando.
• `$multiargs`: Lee varios argumentos, normalmente para mensajes personalizados.
• `$player`: Devuelve el nombre de usuario de quien envía el comando.
• `$world`: Devuelve el mundo actual de quien envía el comando.
• `$online`: Muestra el número de jugadores en línea.
• `$money`: Muestra el balance de moneda de quien envía el comando cuando Vault está instalado.

Por ejemplo, si un comando usa `$arg1` y un jugador ejecuta `/vip Steve`, entonces `$arg1` se convierte en `Steve`.

Opciones comunes

Las opciones controlan cómo se comporta el comando dentro del juego.

• `registered: true` o `false`: Controla si el comando aparece en el autocompletado con tab.
• `permission-required: true` o `false`: Controla si se necesita un permiso.
• `permission-node: example.permission`: Establece el nodo de permiso para el comando.
• `permission-error: 'Message here'`: Envía un mensaje personalizado cuando un jugador no tiene permiso.

Los permisos son especialmente útiles para comandos de staff, herramientas de rango o cualquier cosa que no deba entregarse a todos los jugadores como un objeto sospechosamente filoso.

Creando un archivo de comandos

Antes de agregar comandos personalizados, crea un nuevo archivo YAML dentro de la carpeta de comandos de MyCommand. Mantener los comandos separados por categoría puede hacer que el plugin sea mucho más fácil de administrar después.

1. Abre el panel del server y ve al administrador de archivos o FTP.
2. Entra a la carpeta `plugins`.
3. Abre la carpeta `MyCommand`.
4. Abre la carpeta `commands`.
5. Haz clic en New file.
6. Nombra el archivo según su propósito y termínalo con `.yml`, como `aliases.yml`, `rules.yml` o `shop.yml`.
7. Agrega la configuración del comando, guarda el archivo y reinicia el server.

Después de editar archivos de comandos, MyCommand también se puede recargar dentro del juego con:

```text /mycmd-reload commands all ```

La carpeta `commands` puede incluir un archivo `examples.yml`. Puede ser útil como referencia, pero recuerda que los comandos dentro de archivos habilitados podrían ser usados por jugadores. Elimina o desactiva los comandos de ejemplo que no deberían estar activos en el server.

Ejemplos prácticos de MyCommand

MyCommand puede manejar muchas cosas, así que los ejemplos son la forma más rápida de entender cómo encajan las piezas.

Comando de atajo para un Warp

Un alias simple puede convertir un comando más largo de un plugin en algo más fácil de recordar para los jugadores. Por ejemplo, si el server tiene un warp de arena PvP, un alias podría convertir un comando de warp más largo en `/pvp`.

Esto es mejor para comandos que siempre se ejecutan de la misma manera y no necesitan input del jugador.

Comando de atajo con un argumento

Para comandos que necesitan el nombre de un jugador, una cantidad de items u otro valor, usa variables como `$arg1`.

Un ejemplo común es un atajo de staff para LuckPerms. En lugar de escribir un comando de rango largo cada vez, un comando personalizado puede aceptar el nombre de un jugador como primer argumento y pasarlo al comando completo.

Si el comando es `/vip Steve`, entonces `$arg1` se convierte en `Steve`. La opción de permiso puede limitar el uso a miembros del staff o administradores de rangos. Por ejemplo, los jugadores podrían necesitar un nodo de permiso como `server.vip` antes de poder ejecutarlo.

Comando de reglas

Un comando de reglas es uno de los usos más simples de MyCommand. Cada línea configurada se muestra como texto en el chat cuando un jugador ejecuta el comando.

Esta misma configuración se puede usar para:

• `/rules`
• `/help`
• `/info`
• `/discord`
• `/store`

Se pueden agregar códigos de color para un formato más limpio, siempre que la versión del server y la configuración del chat los soporten.

Links de votación

Un comando de voto puede mostrar una lista de sitios de votación con links clicables. Para líneas de URL clicables, MyCommand usa `$OPEN_URL$` antes del texto mostrado, luego separa el texto al pasar el cursor y la URL con punto y coma.

Las líneas de texto normal se pueden mezclar como etiquetas o instrucciones. Esto hace que el comando sea útil para listas de voto, links de sitios web, mapas, páginas de reglas o cualquier recurso externo que los jugadores necesiten con frecuencia.

Comando de trade personalizado

MyCommand también puede crear trades estilo villager que funcionan como una tienda pequeña. Estos trades pueden usar items del juego, definir costos requeridos y establecer usos máximos.

El formato general de `merchant_items` es:

```text item:amount(cost)item:amount(max_uses)number ```

El primer item y la cantidad son lo que recibe el jugador. El item después de `(cost)` es lo que el jugador debe pagar. Se pueden agregar más líneas de `merchant_items` para crear varias opciones de trade.

Solución de problemas

Los comandos registrados no funcionan

Si `registered: true` está configurado pero el comando aún no aparece o no se ejecuta correctamente, primero reinicia el server. Si eso no lo corrige, recarga un archivo de comando específico dentro del juego:

```text /mycmd-reload commands file_name ```

Reemplaza `file_name` con el nombre exacto del archivo que contiene el comando. Si el archivo se llama `rules.yml`, usa el nombre correspondiente que espera el comando del plugin.

Los comandos personalizados no se ejecutan

La mayoría de los problemas de MyCommand vienen del formato YAML o de conflictos de comandos. Revisa primero estos puntos:

• El comando tiene un tipo válido.
• La indentación es correcta.
• Los espacios requeridos están presentes.
• El nombre del comando no está siendo usado ya por otro plugin.
• Las variables coinciden con el comando que se está ejecutando.
• Los settings de permisos no están bloqueando al jugador.

Si un comando personalizado tiene el mismo nombre que un comando de otro plugin, MyCommand podría no sobrescribirlo. En ese caso, elige un nombre de comando diferente o ajusta los settings del plugin original si admite aliases de comandos.

Notas finales

MyCommand es un plugin flexible para convertir comandos largos, páginas de información, links, trades y herramientas de server en comandos personalizados más limpios. Empieza con un archivo YAML pequeño, prueba un comando a la vez y recarga o reinicia después de los cambios. Una vez que el formato tiene sentido, el plugin se vuelve mucho más fácil de manejar y mucho menos propenso a quejarse por un espacio faltante como si tuviera departamento legal.