EvalBook

Minecraft ゲーム内でコードを本に書いて実行できるプラグイン

使い方

1. リリースページ から最新の EvalBook_vX.Y.Z.phar をダウンロードし、plugins フォルダーに移動させます。
2. コードを書きやすくするために EditerBook というリソースパックを入れることをおススメします。
3. サーバーを起動します。
4. plugin_data/EvalBook/allowlist.txt に自分のゲーマータグを記入します。
5. コンソールで evalbook reload コマンドを実行します。
6. サーバーに接続し /evalbook get で本を入手します。
7. コードを実行するには、スニークしながら本を捨てます。

コマンド

コマンド	説明	エイリアス
/evalbook get	EvalBookを手に入れます	new
/evalbook give [player]	指定したプレイヤーにEvalBookを与えます
/evalbook perm <default/op/everyone>	手持ちのEvalBookの実行権限を変更します	permission
/evalbook reload	allowlist.txt を再読み込みします
/evalbook name <any string>	手持ちのEvalBookのアイテムの名前を変更します	customname
/evalbook edit	手持ちの署名されたEvalBookを元に戻します	revert

コードの例

// コードを実行したプレイヤーにメッセージを送信します
$_player->sendMessage("Hello, EvalBook!");

// ジャンプしたらtipを送信します
$listener = new class() implements Listener{
    public function onJump(PlayerJumpEvent $event) : void{
        $event->getPlayer()->sendTip("Jump!");
    }
};
$this->getServer()->getPluginManager()->registerEvents($listener, $this);

// PluginManager->registerEvents() を使わないバージョン
$onJump = function(PlayerJumpEvent $event) : void{
    $event->getPlayer()->sendTip("Jump!");
};
$this->getServer()->getPluginManager()->registerEvent(PlayerJumpEvent::class, $onJump, EventPriority::NORMAL, $this);

// 1秒ごとに実行者にメッセージを送る
$task = new ClosureTask(fn() => $_player->sendMessage("Repeating task is easy"));
$this->getScheduler()->scheduleRepeatingTask($task, 20);

EvalBook の詳細

実行権限について

本に書かれているコードを実行するには、アイテムの lore の 1 行目に表示されている権限が必要です。
デフォルトは evalbook.group.operator になっています。変更するには /evalbook perm コマンドを使用します。

クラスのインポート (use文) について

PocketMine-MP に存在するクラスについては、自動的にインポート文が挿入されるため書く必要はありません。
ただし、pocketmine\item\Bedやpocketmine\block\Bed のような同じ名前のクラスは、以下のリストに載っているクラスを除き、インポートされません。

優先的にインポートされるクラス
pocketmine\Server
pocketmine\player\GameMode
pocketmine\network\mcpe\protocol\serializer\PacketSerializer
Ramsey\Uuid\Uuid
Ramsey\Uuid\UuidInterface

コードのエラーについて

EvalBookによるコードで発生したエラーはキャッチされ、実行者あるいは全体に通知されます。
ただし、fatal error が発生した場合はエラーがキャッチされず、サーバーがクラッシュします。

fatal error の例

⚠️ これらは try-catch や set_exception_handler を使ってもキャッチできません。

• 同じ名前のクラスや関数を2回以上定義しようとしたとき
• クラスの誤った継承(extends)や実装(implements)
• 同じクラス名を複数回インポートしようとしたとき

特殊な変数・関数について

予約変数

コードを実行したプレイヤーがあらかじめ代入されています。以下にリストされる12つの変数が予約されています。

$_player, $_PLAYER, $_player_, $_PLAYER_,
$_executor, $_EXECUTOR, $_executor_, $_EXECUTOR_,
$_executer, $_EXECUTER, $_executer_, $_EXECUTER_

デバッグ用関数

• var_dump_p(Player $player, mixed ...$value) : void
  • var_dump() の結果をプレイヤーに送信します。