aternos/codex-minecraft

PHP library to read, parse, print and analyse Minecraft log files.

v3.6.0 2024-11-06 15:00 UTC

Requires

• php: >=8.1.0
• ext-json: *
• aternos/codex: ^2.2.0

Requires (Dev)

• phpunit/phpunit: ^10.2

MIT

• Matthias

README

About

Codex (lat. roughly for "log") is a PHP library to read, parse, print and analyse log files to find problems and suggest possible solutions. This is the implementation for Minecraft logs including detectors, parsers and analysers to work with different Minecraft log files.

Installation

composer require aternos/codex-minecraft

Usage

This is only an introduction to the Minecraft implementation of Codex, for more information take a look at the Codex repository: aternosorg/codex

Create a log file

[see codex#logfile]

<?php

$logFile = new \Aternos\Codex\Log\File\StringLogFile("This is the log content");
$logFile = new \Aternos\Codex\Log\File\PathLogFile("/path/to/log");
$logFile = new \Aternos\Codex\Log\File\StreamLogFile(fopen("/path/to/log", "r"));

Create log object

[see codex#log]

If you know the log type, you can directly create a new log object.

<?php

$log = new \Aternos\Codex\Minecraft\Log\Minecraft\Vanilla\VanillaServerLog();
$log->setLogFile($logFile);

Detect the log type

[see codex#detection]

If you don't know the log type, you can let the Detective decide and create a log object.

<?php

$detective = new \Aternos\Codex\Minecraft\Detective\Detective();
$detective->setLogFile($logFile);
$log = $detective->detect();

Parse the log content

[see codex#parsing]

<?php

$log->parse();

Analyse the log

[see codex#analysing]

<?php

$analysis = $log->analyse();

The $analysis object contains problems and information which you can get with the $analysis->getProblems() and $analysis->getInformation() functions or all insights together with $analysis->getInsights(). The problems contain solutions, a few of them could be solved automatically. They implement the \Aternos\Codex\Analysis\AutomatableSolutionInterface, e.g. FileDeleteSolution.

<?php

foreach ($analysis->getInformation() as $information) {
    echo $information->getLabel() . ": " . $information->getValue();
}

foreach ($analysis->getProblems() as $problem) {
    echo $problem->getMessage();
    foreach($problem->getSolutions() as $solution) {
        echo $solution->getMessage();
    }
}

Translations

The output messages, e.g. for problems and solutions are translated by the Translator. The available translations are in the lang folder. They are not complete (yet) and you can help to translate them here: https://crowdin.com/project/aternos. You can set the translation language with the setLanguage() function before using any getMessage() function.

See the current translation status here: TRANSLATION.md

<?php

\Aternos\Codex\Minecraft\Translator\Translator::getInstance()->setLanguage("de");