DevTools untuk PocketMine-MP: dari folder plugin menjadi PHAR

Buat perintah PocketMine yang berfungsi, kemas dengan DevTools 1.17.2, lalu periksa PHAR di server bersih tanpa DevTools.

Bahasa konten

DevTools mengubah folder plugin PocketMine yang dapat diedit menjadi PHAR yang bisa dipindahkan ke server lain. Buat perintah kecil ModonixWorkshop di bawah, kemas pluginnya, lalu periksa balasannya di Minecraft. Perintah pertama yang sederhana membuat proses dari kode sumber sampai plugin yang berfungsi mudah diikuti.

Pasang DevTools di server PocketMine yang kompatibel. Perintah di bawah dijalankan di konsol server, tanpa garis miring di awal; gunakan /workshop untuk pemeriksaan terakhir di dalam game.

PHAR ModonixWorkshop yang terpasang memberikan balasan di Bedrock 26.52 di samping dermaga kayu lobi kami.

Contoh PHAR yang terpasang membalas “ModonixWorkshop 0.0.1 is ready.” Dermaga ini adalah bangunan demonstrasi kami, bukan peta yang disertakan bersama DevTools.

Mulai dengan server dan berkas DevTools yang sesuai

Untuk contoh ini, jalankan Axolotl-PM 5.49.1 di folder pengembangan terpisah dengan PHP 8.3.29 ZTS dan ekstensi yang diperlukan server. Pisahkan server regulermu selagi mempelajari langkah-langkah pembuatannya. Klien Minecraft hanya diperlukan ketika kamu ingin mencoba perintah di dalam game.

Hentikan server itu, letakkan DevTools 1.17.2 di folder plugins dengan nama DevTools.phar, lalu jalankan kembali. Masukkan:

plugins
genplugin ModonixWorkshop Modonix

Perintah pertama menampilkan daftar plugin yang dimuat. Perintah kedua membuat plugins/ModonixWorkshop/plugin.yml dan plugins/ModonixWorkshop/src/Main.php. Gunakan nama-nama ini dalam contoh kode di bawah: nama pembuat juga menjadi bagian dari namespace PHP.

Membuat folder tidak langsung memuat plugin baru. Hentikan server sebelum mengedit berkas-berkas ini, lalu mulai ulang setelah perubahan selesai.

Berikan contoh ini satu perintah yang bisa diuji

Ganti isi plugins/ModonixWorkshop/plugin.yml dengan:

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

Contoh di atas mempertahankan API 5.44.3 sebagai versi minimum dari panduan asal. Berkas yang baru dihasilkan bisa mencantumkan API server yang sedang berjalan; nilai di sini adalah deklarasi contoh tersebut. DevTools sendiri menyatakan API minimum 5.0.0. Mengubah salah satu angka itu tidak memperbarui kode plugin agar sesuai dengan API yang lebih lama.

Ganti isi plugins/ModonixWorkshop/src/Main.php dengan:

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

Mulai ulang server. DevTools memungkinkan pemuatan plugin dari folder, sehingga plugins menampilkan DevTools dan ModonixWorkshop. Jalankan workshop; perintah itu membalas ModonixWorkshop 0.0.1 is ready. Ini memberi hasil sederhana yang bisa diperiksa sebelum pengemasan.

Izin perintah secara bawaan diberikan kepada operator. Gunakan akun operator untuk pemeriksaan pertama /workshop di dalam game. Jika nantinya pemain biasa memerlukan perintah ini, berikan izin modonixworkshop.command.workshop dengan sengaja, alih-alih menjadikan semua orang operator.

Buat PHAR dari folder yang sudah dimuat

Setelah ModonixWorkshop dimuat, masukkan:

makeplugin ModonixWorkshop

DevTools menulis arsip ke plugin_data/DevTools/ModonixWorkshop_v0.0.1.phar. Simpan folder sumber ModonixWorkshop sebagai proyek yang dapat diedit. PHAR adalah salinan untuk dipasang di server lain.

Jika makeplugin melaporkan nama plugin tidak valid, jalankan plugins dan periksa apakah ModonixWorkshop dimuat setelah mulai ulang. Jika terjadi kesalahan pemuatan, perbaiki kesalahan konsol pertama yang terkait sebelum mengemas plugin. Jika PHP melaporkan pembuatan PHAR dinonaktifkan, tetapkan phar.readonly=0 dalam konfigurasi PHP server pengembangan dan mulai ulang.

Pasang paket di server terpisah

Untuk memindahkan plugin ke instalasi lain, siapkan server terpisah dengan server dan konfigurasi PHP yang sama. Ketika server itu berhenti, salin arsip ke direktori plugins; ModonixWorkshop.phar adalah nama berkas yang praktis. Nama plugin tetap diambil dari plugin.yml di dalam arsip.

Biarkan DevTools dan folder sumber yang dapat diedit di server pertama. Jalankan server kedua dan masukkan:

plugins
workshop

Server kedua seharusnya memuat ModonixWorkshop dan perintahnya mengembalikan ModonixWorkshop 0.0.1 is ready. Simpan folder dan PHAR di server terpisah agar plugin yang sama tidak dimuat dua kali. Kamu juga bisa memeriksa versi yang sudah dikemas di server pengembangan: hentikan server, pindahkan folder sumber keluar dari direktori plugin aktifnya, pasang PHAR, lalu mulai ulang. Versi yang sudah dikemas itulah yang ditampilkan dalam gambar Minecraft di atas.

Jaga kecocokan klien dan server

Pilih API server yang tercantum untuk berkas pilihan di bagian Berkas. Cocokkan klien Bedrock yang terhubung dengan protokol game server secara terpisah dari API minimum plugin.

Repositori asal PocketMine-MP dan DevTools telah diarsipkan. Gunakan konfigurasi yang didukung dan tercantum bersama berkas saat mempelajari atau memelihara server ini; klien yang lebih baru tidak bisa terhubung ke setiap protokol server lama.

Belum ada penilaian

File

Filter file File: 3Rilis stabil
Tampilkan semua file

Versi 1.17.2

Stabil

DevTools.phar

Perangkat lunak server: PocketMine-MP
1 unduhan
Unduh · 43,7 KB
Persyaratan dan detail
  • Perangkat lunak server: PocketMine-MP · Versi API server: 5.0.0

Hentikan server pengembangan, letakkan DevTools.phar di plugins, lalu mulai ulang. DevTools 1.17.2 menyatakan PocketMine API minimum 5.0.0. Mulai ulang setelah menghasilkan atau mengedit plugin sumber sebelum menjalankan makeplugin. Pisahkan folder yang dapat diedit dan PHAR yang sudah dibuat ke direktori plugin aktif yang berbeda. Langkah pembuatan melalui konsol server tidak memerlukan klien Minecraft.

Persyaratan dan catatan
Masalah yang diketahui
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.
Persyaratan runtime server
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 1.17.0

Stabil

DevTools.phar

Perangkat lunak server: PocketMine-MP
0 unduhan
Unduh · 43,4 KB
Persyaratan dan detail
  • Perangkat lunak server: PocketMine-MP · Versi API server: 5.0.0
Persyaratan dan catatan
Persyaratan runtime server
A compatible PocketMine-MP server and its supported PHP runtime.

Versi 1.16.0

Stabil

DevTools.phar

Perangkat lunak server: PocketMine-MP
0 unduhan
Unduh · 36,4 KB
Persyaratan dan detail
  • Perangkat lunak server: PocketMine-MP · Versi API server: 4.0.0
Persyaratan dan catatan
Persyaratan runtime server
A compatible PocketMine-MP server and its supported PHP runtime.

Pembaruan rilis

Versi 1.17.2

Stabil

Tanggal rilis proyek asal: 2025-02-01.

Kode sumber yang tepat untuk versi ini: DevTools 1.17.2: kode sumber

Sumber: DevTools 1.17.2: catatan rilis
Rincian kompatibilitas di bawah mengikuti sasaran yang dinyatakan pembuat. Lihat sumber tertaut untuk informasi versi dan perangkat selengkapnya.

Lihat file

Versi 1.17.0

Stabil

Tanggal rilis proyek asal: 2023-06-01.

Kode sumber yang tepat untuk versi ini: DevTools 1.17.0: kode sumber

Sumber: DevTools 1.17.0: catatan rilis
Rincian kompatibilitas di bawah mengikuti sasaran yang dinyatakan pembuat. Lihat sumber tertaut untuk informasi versi dan perangkat selengkapnya.

Lihat file

Versi 1.16.0

Stabil

Tanggal rilis proyek asal: 2022-09-24.

Kode sumber yang tepat untuk versi ini: DevTools 1.16.0: kode sumber

Sumber: DevTools 1.16.0: catatan rilis
Rincian kompatibilitas di bawah mengikuti sasaran yang dinyatakan pembuat. Lihat sumber tertaut untuk informasi versi dan perangkat selengkapnya.

Lihat file

Komentar 0

Bagikan yang berhasil, minta bantuan, atau balas pemain lain.

Ikuti percakapan

1Nama dan emailmu

Tidak perlu akun. Konfirmasikan email dengan kode sebelum komentar pertamamu. Hanya alamat yang disamarkan ditampilkan bersama namamu. Komentar tamu ditinjau sebelum diterbitkan.

2Verifikasi dan kirim

Belum ada komentar. Bagikan yang berhasil untukmu.

Cari di Modonix

Cari di