Cómo crear un plugin de economía para Minecraft

Paso a paso

1. 1.Decide qué es el plugin

   O bien es la economía (guarda los saldos y se registra como la economía de Vault), o bien usa una economía existente a través de Vault (una tienda, recompensas por cabezas, un plugin de trabajos). La mayoría de los servidores necesitan uno de cada tipo, no dos economías.

2. 2.Elige el servidor y la versión

   Escribe el software del servidor y la versión, por ejemplo Paper 1.21.4. El plugin se compila para la API y el nivel de Java de esa versión.

3. 3.Enumera los comandos y las reglas

   /balance, /pay <player> <amount>, /baltop y comandos de administración como /eco give|take|set. Añade el saldo inicial, el nombre de la moneda, los decimales y un pago mínimo.

4. 4.Elige dónde se guardan los saldos

   SQLite para un solo servidor, MySQL si varios servidores deben compartir los mismos saldos. El dinero tiene que sobrevivir a reinicios y caídas, así que nunca se guarda solo en memoria.

5. 5.Deja que Codexe lo escriba y lo compile

   Describe el plugin y nombra Vault de forma explícita para que se añada como dependencia. Codexe escribe el código Java, plugin.yml y config.yml, lo compila y corrige los errores de compilación antes de que el proyecto esté Listo.

6. 6.Prueba los pagos en el juego

   Pulsa Pruébalo ahora y entra al servidor de prueba. Haz pagos entre dos cuentas, prueba cantidades demasiado grandes, negativas o que no sean números, y luego reinicia y comprueba que los saldos siguen ahí.

7. 7.Instálalo

   Pon Vault y tu .jar en la carpeta plugins/ del servidor y reinícialo. Quita cualquier otro plugin de economía o decide cuál debe usar Vault.

Qué papel tiene Vault

Vault es un puente, no una economía. Un plugin de economía implementa la interfaz Economy de Vault y la registra en el gestor de servicios del servidor; los demás plugins la piden con getServer().getServicesManager().getRegistration(Economy.class) y llaman a métodos como getBalance, withdrawPlayer y depositPlayer.

Así, un plugin de tienda nunca necesita saber qué economía usas. En plugin.yml usa depend: [Vault] cuando el plugin no pueda funcionar sin él, o softdepend cuando Vault sea opcional. La API de Vault solo hace falta para compilar; Vault en sí se instala en el servidor.

Decisiones que escribir en la petición

• Formato del dinero: nombre de la moneda en singular y plural, símbolo y número de decimales.
• Límites: saldo inicial, saldo máximo y si los saldos pueden quedar en negativo.
• Jugadores desconectados: si /pay y /eco funcionan con jugadores que no están conectados.
• Registro: un historial de transacciones en la base de datos o en un archivo, para que el staff pueda revisar las disputas.
• Ganar dinero: matando mobs, recompensas por tiempo de juego, vendiendo objetos o solo con comandos de administración.

Dónde guardar los saldos

Descripción de ejemplo

«Un plugin de economía para Paper 1.21.4 llamado Coins que se registre como la economía de Vault. /balance [player], /pay <player> <amount> con un mínimo de 1, /baltop con el top 10 y /eco give|take|set para los jugadores con coins.admin. Los jugadores nuevos empiezan con 100 monedas. Dos decimales. Cada pago registrado con fecha, remitente, destinatario y cantidad. Saldos guardados en SQLite. Nombres de la moneda y todos los mensajes en config.yml.»

Codexe usa SQLite por defecto cuando no pides otra cosa. Si pides MySQL, el plugin se escribe con una opción storage-type, y el servidor de prueba le da su propia base de datos MySQL mientras lo pruebas.

Preguntas