DevTools para PocketMine-MP: da pasta do plugin ao PHAR

Crie um comando funcional de PocketMine, empacote com DevTools 1.17.2 e confira o PHAR em um servidor limpo sem DevTools.

Idioma do conteúdo

DevTools transforma uma pasta editável de plugin do PocketMine em um PHAR que você pode levar para outro servidor. Crie o pequeno comando ModonixWorkshop abaixo, empacote e confira a resposta dentro do Minecraft. Manter esse primeiro comando simples facilita acompanhar o caminho do código-fonte ao plugin funcionando.

Instale DevTools em um servidor PocketMine compatível. Os comandos abaixo são executados no console do servidor, sem uma barra no início; use /workshop para a verificação final dentro do jogo.

O PHAR de ModonixWorkshop instalado responde no Bedrock 26.52 ao lado de nosso píer de madeira do saguão.

O PHAR de exemplo instalado responde “ModonixWorkshop 0.0.1 is ready.”. O píer é nossa construção de demonstração, não um mapa fornecido com DevTools.

Comece com o servidor e o arquivo DevTools correspondentes

Neste exemplo, inicie Axolotl-PM 5.49.1 em uma pasta de desenvolvimento separada com PHP 8.3.29 ZTS e as extensões exigidas pelo servidor. Mantenha seu servidor habitual separado enquanto aprende os passos de criação. Você só precisa de um cliente de Minecraft quando quiser experimentar o comando no jogo.

Pare esse servidor, coloque DevTools 1.17.2 em sua pasta plugins como DevTools.phar e inicie novamente. Digite:

plugins
genplugin ModonixWorkshop Modonix

O primeiro comando lista os plugins carregados. O segundo cria plugins/ModonixWorkshop/plugin.yml e plugins/ModonixWorkshop/src/Main.php. Use esses nomes no código de exemplo abaixo: o nome do autor também passa a fazer parte do namespace PHP.

Criar a pasta não carrega o novo plugin imediatamente. Pare o servidor antes de editar esses arquivos e reinicie após as mudanças.

Dê ao exemplo um comando que você possa testar

Substitua 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

O exemplo mantém API 5.44.3 como mínimo do tutorial original. Um arquivo recém-gerado pode indicar a API do servidor em execução; o valor mostrado aqui é a declaração do exemplo. DevTools declara API mínima 5.0.0. Alterar qualquer um desses números não adapta o código do plugin para uma API mais antiga.

Substitua 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;
    }
}

Reinicie o servidor. DevTools permite carregar plugins de pastas, então plugins lista DevTools e ModonixWorkshop. Execute workshop; o comando responde ModonixWorkshop 0.0.1 is ready. Isso fornece um resultado simples para conferir antes de empacotar.

A permissão do comando é concedida por padrão a operadores. Use uma conta de operador para a primeira verificação de /workshop no jogo. Se jogadores comuns precisarem do comando depois, conceda deliberadamente a permissão modonixworkshop.command.workshop em vez de tornar todos operadores.

Crie o PHAR a partir da pasta carregada

Com ModonixWorkshop carregado, digite:

makeplugin ModonixWorkshop

DevTools grava o arquivo em plugin_data/DevTools/ModonixWorkshop_v0.0.1.phar. Mantenha a pasta de código-fonte ModonixWorkshop como projeto editável. O PHAR é a cópia para instalar no outro servidor.

Se makeplugin informar um nome de plugin inválido, execute plugins e confira se ModonixWorkshop carregou após reiniciar. Em caso de erro de carregamento, corrija o primeiro erro relevante do console antes de empacotar. Se PHP informar que a criação de PHAR está desativada, defina phar.readonly=0 na configuração PHP do servidor de desenvolvimento e reinicie.

Instale o pacote em um servidor separado

Para levar o plugin para outra instalação, prepare um servidor separado com a mesma configuração de servidor e PHP. Enquanto ele estiver parado, copie o arquivo para o diretório plugins; ModonixWorkshop.phar é um nome conveniente. O nome do plugin continua vindo do plugin.yml dentro do arquivo.

Mantenha DevTools e a pasta editável de código-fonte no primeiro servidor. Inicie o segundo servidor e execute:

plugins
workshop

O segundo servidor deve carregar ModonixWorkshop e o comando deve retornar ModonixWorkshop 0.0.1 is ready. Mantenha a pasta e o PHAR em servidores separados para não carregar o mesmo plugin duas vezes. Você também pode conferir a versão empacotada no servidor de desenvolvimento: pare-o, tire a pasta de código-fonte do diretório ativo de plugins, instale o PHAR e reinicie. Essa é a versão empacotada mostrada na imagem de Minecraft acima.

Mantenha o cliente e o servidor compatíveis

Escolha a API do servidor indicada para o arquivo selecionado em Arquivos. Confira separadamente se o cliente de Bedrock que vai se conectar corresponde ao protocolo de jogo do servidor, independentemente da API mínima do plugin.

Os repositórios originais de PocketMine-MP e DevTools estão arquivados. Use a configuração compatível indicada junto ao arquivo ao estudar ou manter esse servidor; um cliente mais recente não se conecta a todos os protocolos de servidor antigos.

Ainda sem avaliações

Arquivos

Filtrar arquivos Arquivos: 3Versão estável

Versão 1.17.2

Estável

DevTools.phar

Software do servidor: PocketMine-MP
1 download
Baixar · 43,7 KB
Requisitos e detalhes
  • Software do servidor: PocketMine-MP · Versão da API do servidor: 5.0.0

Pare o servidor de desenvolvimento, coloque DevTools.phar em plugins e reinicie. DevTools 1.17.2 declara API mínima de PocketMine 5.0.0. Reinicie após gerar ou editar um plugin de código-fonte antes de executar makeplugin. Mantenha a pasta editável e o PHAR criado em diretórios ativos de plugins separados. Os passos de criação no console do servidor não exigem um cliente de Minecraft.

Requisitos e observações
Problemas conhecidos
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 do ambiente do 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.

Versão 1.17.0

Estável

DevTools.phar

Software do servidor: PocketMine-MP
0 downloads
Baixar · 43,4 KB
Requisitos e detalhes
  • Software do servidor: PocketMine-MP · Versão da API do servidor: 5.0.0
Requisitos e observações
Requisitos do ambiente do servidor
A compatible PocketMine-MP server and its supported PHP runtime.

Versão 1.16.0

Estável

DevTools.phar

Software do servidor: PocketMine-MP
0 downloads
Baixar · 36,4 KB
Requisitos e detalhes
  • Software do servidor: PocketMine-MP · Versão da API do servidor: 4.0.0
Requisitos e observações
Requisitos do ambiente do servidor
A compatible PocketMine-MP server and its supported PHP runtime.

Novidades das versões

Versão 1.17.2

Estável

Data de lançamento original: 2025-02-01.

Código-fonte exato correspondente: Código-fonte de DevTools 1.17.2

Fonte: Notas da versão DevTools 1.17.2
Os detalhes de compatibilidade abaixo refletem os ambientes declarados pelo autor. Consulte a fonte vinculada para obter todas as informações de versões e dispositivos.

Ver arquivos

Versão 1.17.0

Estável

Data de lançamento original: 2023-06-01.

Código-fonte exato correspondente: Código-fonte de DevTools 1.17.0

Fonte: Notas da versão DevTools 1.17.0
Os detalhes de compatibilidade abaixo refletem os ambientes declarados pelo autor. Consulte a fonte vinculada para obter todas as informações de versões e dispositivos.

Ver arquivos

Versão 1.16.0

Estável

Data de lançamento original: 2022-09-24.

Código-fonte exato correspondente: Código-fonte de DevTools 1.16.0

Fonte: Notas da versão DevTools 1.16.0
Os detalhes de compatibilidade abaixo refletem os ambientes declarados pelo autor. Consulte a fonte vinculada para obter todas as informações de versões e dispositivos.

Ver arquivos

Comentários 0

Compartilhe o que funcionou, peça ajuda ou responda a outro jogador.

Participe da conversa

1Seu nome e e-mail

Não é preciso ter uma conta. Confirme seu e-mail com um código antes do primeiro comentário. Somente um endereço parcialmente oculto aparece com seu nome. Os comentários de visitantes são revisados antes da publicação.

2Verificar e publicar

Ainda não há comentários. Compartilhe o que funcionou para você.

Buscar no Modonix

Buscar em