DevTools para PocketMine-MP: de la carpeta del plugin al PHAR

Crea un comando funcional de PocketMine, empaquétalo con DevTools 1.17.2 y comprueba después el PHAR en un servidor limpio sin DevTools.

Idioma del contenido

DevTools convierte una carpeta editable de un plugin de PocketMine en un PHAR que puedes llevar a otro servidor. Crea el pequeño comando ModonixWorkshop de abajo, empaquétalo y comprueba su respuesta dentro de Minecraft. Mantener sencillo ese primer comando facilita seguir el recorrido del código fuente al plugin funcional.

Instala DevTools en un servidor PocketMine compatible. Los comandos de abajo se ejecutan en la consola del servidor, sin barra inicial; usa /workshop para la comprobación final dentro del juego.

El PHAR de ModonixWorkshop instalado responde en Bedrock 26.52 junto a nuestro muelle de madera del vestíbulo.

El PHAR de ejemplo instalado responde «ModonixWorkshop 0.0.1 is ready.». El muelle es una construcción de nuestra demostración, no un mapa incluido en DevTools.

Empieza con el servidor y el archivo DevTools correspondientes

Para este ejemplo, inicia Axolotl-PM 5.49.1 en una carpeta de desarrollo aparte con PHP 8.3.29 ZTS y las extensiones que exige el servidor. Mantén tu servidor habitual separado mientras aprendes los pasos de creación. Solo necesitas un cliente de Minecraft si quieres probar el comando en el juego.

Detén ese servidor, coloca DevTools 1.17.2 en su carpeta plugins como DevTools.phar y vuelve a iniciarlo. Introduce:

plugins
genplugin ModonixWorkshop Modonix

El primer comando enumera los plugins cargados. El segundo crea plugins/ModonixWorkshop/plugin.yml y plugins/ModonixWorkshop/src/Main.php. Usa estos nombres en el código de ejemplo de abajo: el nombre del autor también pasa a formar parte del espacio de nombres de PHP.

Crear la carpeta no carga inmediatamente el plugin nuevo. Detén el servidor antes de editar estos archivos y reinícialo después de los cambios.

Dale al ejemplo un comando que puedas probar

Reemplaza plugins/ModonixWorkshop/plugin.yml por:

name: ModonixWorkshop
version: 0.0.1
main: Modonix\ModonixWorkshop\Main
api: 5.44.3
src-namespace-prefix: Modonix\ModonixWorkshop
commands:
  workshop:
    description: Check the workshop plugin
    permission: modonixworkshop.command.workshop
permissions:
  modonixworkshop.command.workshop:
    default: op

El ejemplo conserva API 5.44.3 como mínimo del tutorial original. Un archivo recién generado puede indicar en su lugar la API del servidor que se está ejecutando; el valor de aquí es la declaración del ejemplo. DevTools declara una API mínima de 5.0.0. Cambiar cualquiera de esos números no adapta el código del plugin a una API anterior.

Reemplaza plugins/ModonixWorkshop/src/Main.php por:

<?php
declare(strict_types=1);

namespace Modonix\ModonixWorkshop;

use pocketmine\command\Command;
use pocketmine\command\CommandSender;
use pocketmine\plugin\PluginBase;

class Main extends PluginBase{
    public function onCommand(CommandSender $sender, Command $command, string $label, array $args): bool{
        if($command->getName() !== "workshop"){
            return false;
        }
        $sender->sendMessage("ModonixWorkshop 0.0.1 is ready.");
        return true;
    }
}

Reinicia el servidor. DevTools permite cargar plugins desde carpetas, así que plugins enumera tanto DevTools como ModonixWorkshop. Ejecuta workshop; el comando responde ModonixWorkshop 0.0.1 is ready. Así tienes un resultado sencillo que comprobar antes de empaquetar.

El permiso del comando corresponde por defecto a los operadores. Usa una cuenta de operador para la primera prueba de /workshop en el juego. Si después los jugadores normales necesitan el comando, concédeles deliberadamente el permiso modonixworkshop.command.workshop en vez de convertir a todos en operadores.

Crea el PHAR desde la carpeta cargada

Con ModonixWorkshop cargado, introduce:

makeplugin ModonixWorkshop

DevTools escribe el archivo en plugin_data/DevTools/ModonixWorkshop_v0.0.1.phar. Conserva la carpeta de código fuente ModonixWorkshop como proyecto editable. El PHAR es la copia que instalas en el otro servidor.

Si makeplugin indica un nombre de plugin no válido, ejecuta plugins y comprueba que ModonixWorkshop se cargó tras reiniciar. Si hay un error de carga, corrige el primer error pertinente de la consola antes de empaquetar. Si PHP dice que la creación de PHAR está desactivada, establece phar.readonly=0 en la configuración PHP del servidor de desarrollo y reinícialo.

Instala el paquete en otro servidor

Para llevar el plugin a otra instalación, prepara un servidor aparte con la misma configuración de servidor y PHP. Mientras esté detenido, copia el archivo a su directorio plugins; ModonixWorkshop.phar es un nombre práctico. El nombre del plugin sigue procediendo de plugin.yml dentro del archivo.

Deja DevTools y la carpeta editable de código fuente en el primer servidor. Inicia el segundo y ejecuta:

plugins
workshop

El segundo servidor debería cargar ModonixWorkshop y el comando debería devolver ModonixWorkshop 0.0.1 is ready. Mantén la carpeta y el PHAR en servidores separados para no cargar dos veces el mismo plugin. También puedes comprobar la versión empaquetada en tu servidor de desarrollo: detenlo, saca la carpeta de código fuente de su directorio activo de plugins, instala el PHAR y reinicia. Esa es la versión empaquetada que muestra la imagen de Minecraft de arriba.

Mantén compatibles el cliente y el servidor

Elige la API de servidor indicada para el archivo seleccionado en Archivos. Comprueba por separado que el cliente de Bedrock que se conecta coincide con el protocolo del juego del servidor, independientemente de la API mínima del plugin.

Los repositorios originales de PocketMine-MP y DevTools están archivados. Usa la configuración compatible indicada junto al archivo al estudiar o mantener este servidor; un cliente más nuevo no puede conectarse a todos los protocolos de servidor antiguos.

Aún no hay valoraciones

Archivos

Filtrar archivos Archivos: 3Versión estable

Versión 1.17.2

Estable

DevTools.phar

Software del servidor: PocketMine-MP
1 descarga
Descargar · 43,7 KB
Requisitos y detalles
  • Software del servidor: PocketMine-MP · Versión de la API del servidor: 5.0.0

Detén el servidor de desarrollo, coloca DevTools.phar en plugins y reinicia. DevTools 1.17.2 declara una API mínima de PocketMine de 5.0.0. Reinicia después de generar o editar un plugin de código fuente antes de ejecutar makeplugin. Mantén su carpeta editable y el PHAR creado en directorios activos de plugins separados. Los pasos de creación en la consola del servidor no requieren un cliente de Minecraft.

Requisitos y notas
Problemas conocidos
Loading a source folder and its PHAR together can cause duplicate-plugin errors. Restart after editing source files. PocketMine-MP 5.44.3 targets Bedrock 26.30; match player clients to the server protocol. The example plugin requires API 5.44.3.
Requisitos del entorno del servidor
The original PHAR-building walkthrough used PocketMine-MP 5.44.3 with PHP 8.3.29 ZTS on Windows; that server targets Bedrock 26.30. The additional in-game /workshop example uses DevTools 1.17.2 on Axolotl-PM 5.49.1 with PHP 8.3.29 ZTS and Bedrock 26.52 on Windows. DevTools still declares minimum API 5.0.0; the example does not establish support for other server or client versions.

Versión 1.17.0

Estable

DevTools.phar

Software del servidor: PocketMine-MP
0 descargas
Descargar · 43,4 KB
Requisitos y detalles
  • Software del servidor: PocketMine-MP · Versión de la API del servidor: 5.0.0
Requisitos y notas
Requisitos del entorno del servidor
A compatible PocketMine-MP server and its supported PHP runtime.

Versión 1.16.0

Estable

DevTools.phar

Software del servidor: PocketMine-MP
0 descargas
Descargar · 36,4 KB
Requisitos y detalles
  • Software del servidor: PocketMine-MP · Versión de la API del servidor: 4.0.0
Requisitos y notas
Requisitos del entorno del servidor
A compatible PocketMine-MP server and its supported PHP runtime.

Novedades de las versiones

Versión 1.17.2

Estable

Fecha de publicación original: 2025-02-01.

Código fuente exacto correspondiente: Código fuente de DevTools 1.17.2

Fuente: Notas de la versión DevTools 1.17.2
Los detalles de compatibilidad de abajo reflejan los destinos declarados por el autor. Consulta la fuente enlazada para toda la información sobre versiones y dispositivos.

Ver archivos

Versión 1.17.0

Estable

Fecha de publicación original: 2023-06-01.

Código fuente exacto correspondiente: Código fuente de DevTools 1.17.0

Fuente: Notas de la versión DevTools 1.17.0
Los detalles de compatibilidad de abajo reflejan los destinos declarados por el autor. Consulta la fuente enlazada para toda la información sobre versiones y dispositivos.

Ver archivos

Versión 1.16.0

Estable

Fecha de publicación original: 2022-09-24.

Código fuente exacto correspondiente: Código fuente de DevTools 1.16.0

Fuente: Notas de la versión DevTools 1.16.0
Los detalles de compatibilidad de abajo reflejan los destinos declarados por el autor. Consulta la fuente enlazada para toda la información sobre versiones y dispositivos.

Ver archivos

Comentarios 0

Comparte lo que funcionó, pide ayuda o responde a otro jugador.

Únete a la conversación

1Tu nombre y correo

No necesitas una cuenta. Confirma tu correo con un código antes de tu primer comentario. Solo aparece una dirección parcialmente oculta junto a tu nombre. Los comentarios de invitados se revisan antes de publicarse.

2Verificar y publicar

Aún no hay comentarios. Comparte lo que te funcionó.

Buscar en Modonix

Buscar en