Моддинг Minecraft с PHP — Здания из кода!

На этот раз мы потратили немного больше времени, но по сути дела делаем то же самое. Давайте посмотрим на код для определения команд игрока:

 define("LOG_PATH", "/path/to/logs/latest.log");

$files = Amp\File\filesystem();

// get reference data

$commands = [];
$timestamp = yield $filesystem->mtime(LOG_PATH);

// listen for player requests

Amp\repeat(function() use ($files, &$commands, &$timestamp) {
    $contents = yield from getContents(
        $files, LOG_PATH, $timestamp
    );

    if (!empty($contents)) {
        $lines = array_reverse(explode(PHP_EOL, $contents));

        foreach ($lines as $line) {
            $isCommand = stristr($line, "> >") !== false;
            $isNotRepeat = !in_array($line, $commands);

            if ($isCommand && $isNotRepeat) {
                // execute mod command

                array_push($commands, $line);

                print "executing: " . $line . PHP_EOL;
                break;
            }
        }
    }
}, 500);

Мы начнем с получения контрольной отметки временного файла. Мы используем это, чтобы выяснить, изменился ли файл (в функции getContents Мы также создаем пустой список, в котором мы будем хранить все команды, которые мы уже выполнили. Этот список поможет нам избежать выполнения одной и той же команды дважды.

Вам нужно заменить /path/to/logs/latest.log Я рекомендую запустить автономный сервер Minecraft , который должен поместить logs/latest.log

Мы сказали Amp\repeat500 В это время мы проверяем изменения файла. Если временная метка изменилась, мы разбиваем строки файла журнала на массив и переворачиваем его (так что сначала мы читаем самые последние сообщения).

Если строка содержит «>>» (как это произошло бы, если игрок набрал «> некоторую команду»), мы предполагаем, что строка содержит инструкцию команды.

Создание чертежей

Одна из самых трудоемких вещей в Minecraft — это строительство больших конструкций. Было бы намного проще, если бы я мог их спланировать (используя какой-то шикарный 3D-конструктор JavaScript), а затем поместить их в мир, используя специальную команду.

Мы можем использовать слегка модифицированную версию компоновщика, который я описал в другом вышеупомянутом посте, чтобы сгенерировать список пользовательских блоков:

На данный момент этот застройщик допускает размещение только грязевых блоков. Генерируемая им структура массива — это координаты xyz Мы можем скопировать это в скрипт PHP, над которым мы работаем. Мы также должны выяснить, как определить точную команду для построения любой структуры, которую мы проектируем:

 $isCommand = stristr($line, "> >") !== false;
$isNotRepeat = !in_array($line, $commands);

if ($isCommand && $isNotRepeat) {
    array_push($commands, $line);
    executeCommand($line);
    break;
}

// ...later

function executeCommand($raw) {
    $command = trim(
        substr($raw, stripos($raw, "> >") + 3)
    );

    if ($command === "build") {
        $blocks = [
            // ...from the 3D builder
        ];

        foreach ($block as $block) {
            // ... place each block
        }
    }
}

Каждый раз, когда мы получаем команду, мы можем передать ее в функцию executeCommand Там мы извлекаем от второго > Нам нужно только определить команды build

Разговор с сервером

Прослушивание логов — это одно, но как мы можем общаться с сервером? Автономный сервер запускает сервер чата администратора (называется RCON). Это тот же сервер администратора, который включает моды в других играх, таких как Counter-Strike.

Оказывается, кто-то уже создал клиент RCON (хотя и блокирует), и недавно я написал для этого хорошую оболочку. Мы можем установить его с:

 composer require theory/builder

Позвольте мне извиниться за то, насколько велика эта библиотека. Я включил версию автономного сервера Minecraft, чтобы я мог создавать автоматизированные тесты для библиотеки. Что за спешка…

Нам нужно настроить наш автономный сервер, чтобы мы могли подключаться к нему через RCON. Добавьте следующее в файл server.propertiesjar

 enable-query=true
enable-rcon=true
query.port=25565
rcon.port=25575
rcon.password=password

После перезапуска мы сможем подключиться к серверу, используя код, похожий на следующий:

 $builder = new Client("127.0.0.1", 25575, "password");
$builder->exec("/say hello world");

Мы можем модифицировать нашу функцию executeCommand

 function executeCommand($builder, $raw) {
    $command = trim(
        substr($raw, stripos($raw, "> >") + 3)
    );

    if (stripos($command, "build") === 0) {
        $parts = explode(" ", $command);

        if (count($parts) < 4) {
            print "invalid coordinates";
            return;
        }

        $x = $parts[1];
        $y = $parts[2];
        $z = $parts[3];

        $blocks = [
            // ...from the 3D builder
        ];

        $builder->exec("/say building...");

        foreach ($blocks as $block) {
            $dx = $block[0] + $x;
            $dy = $block[1] + $y;
            $dz = $block[2] + $z;

            $builder->exec(
                "/setblock {$dx} {$dy} {$dz} dirt"
            );

            usleep(500000);
        }
    }
}

Новая и улучшенная функция executeCommand<player_name> > build

Если бы конструктор был неблокирующим, было бы намного лучше использовать yield new Amp\Pause(500)usleep(500000) Нам также нужно обрабатывать executeCommandyield executeCommand(...)

Если это так, команда разделяется пробелами, чтобы получить координаты xyz Затем он берет массив, сгенерированный нами из конструктора, и размещает каждый блок в мире.

Где отсюда?

Вероятно, вы можете представить множество забавных расширений этого простого мода-подобного скрипта, который мы только что создали. Конструктор может быть расширен для создания аранжировок, состоящих из множества различных видов и конфигураций блоков.

Сценарий мода может быть расширен для получения обновлений через JSON API, чтобы разработчик мог отправлять именованные проекты, а команда build

Я оставлю эти идеи в качестве упражнения для вас. Не забудьте проверить сопутствующий пост JavaScript , и если у вас есть какие-либо идеи или комментарии, пожалуйста, делайте это в комментариях!