MankeDoMath

Калькулятор внутри Minecraft, который знает, что такое шалкер. Быстрые вычисления, не выходя из игры и не хватаясь за телефон, заточенные под то, что технический игрок реально считает: скорость ферм, сколько шалкеров в куче предметов, сколько времени что-то заполняется. Только на стороне сервера. Игрокам ничего устанавливать не нужно. Сервер регистрирует команду и отправляет дерево ванильному клиенту, который сам её автодополняет.

/m 3456 items in sb      ->  2 шалкера
/m 5sb / 2h              ->  4320 предметов/час (2.5 sb/час)
/m (16*16*64) in st      ->  256 стаков, сколько стоит одна секция чанка
/m 20st in sb            ->  0.7407 шалкера
/m 1h + 30m              ->  108000 тиков (1ч 30м)

Результаты видит только тот, кто спросил. Калькулятор, который орёт в общий чат, — это калькулятор, который люди отключают.

Установка

Поддерживает Minecraft с 1.21 по 26.3. Скачай jar для своей версии Minecraft с GitHub Releases или Modrinth, положи в папку mods/ сервера и перезапусти. Игрокам мод не нужен. Minecraft 26.3 требует Java 25, Fabric Loader 0.19.5 или новее и Fabric API для 26.3. Более ранние версии 1.21 используют Java 21. При обновлении замени старый jar и сохрани config/mankedomath.conf, чтобы не потерять настройки.

Команды

Единицы

Это та часть, которая делает его калькулятором Minecraft, а не просто калькулятором.

Длинные написания тоже работают (stacks, shulkerboxes, items, minutes, chunks), с пробелом после числа или без. sh по-прежнему принимается для шалкера, если твои пальцы уже так привыкли. Конвертируй через in:

/math 3456 items in sb
/math 100 blocks in c
/math 5sb in st

Единицы переносятся через арифметику, так что мод знает, что 5sb / 2h — это скорость, и выводит её в час, а 1sb + 1h — это вопрос без ответа. Операторы: + - * / % ^, скобки и одиночный x между числами как умножение. Функции: sqrt min max abs floor ceil round log ln.

Когда ошибаешься

/m 1/0        ->  деление на ноль — так призывают всякое. Cannot divide by zero
/m 1sb + 1h   ->  нельзя складывать котов и вторники. Cannot add time and items
/m 9^9^9      ->  это число не влезает в minecraft. Exponent 387420489 is over the limit of 64
/m banana     ->  manke умеет считать, но не читать мысли. Unknown name 'banana'

Шутка никогда не заменяет причину, она только подводит к ней, и Brigadier всё ещё подчёркивает именно тот символ, который сломался. Смешная ошибка, из-за которой ты застрял, перестаёт быть смешной со второго раза. Поставь funny_errors=false для калькулятора без мнений.

Безопасность

Здесь нет eval и нет движка скриптов. Парсер написан вручную и читает одну маленькую грамматику и ничего больше, потому что ставить интерпретатор на публичный сервер, чтобы люди могли складывать два числа, — это открывать дверь кому угодно, кто мимо пройдёт. Длина выражения, глубина вложенности и количество операций проверяются до того, как произойдёт хоть одно умножение, а лимит степени проверяется перед каждым возведением в степень, так что 9^9^9 отскакивает с сообщением, а не съедает тик. Все четыре лимита в конфиге.

Конфиг

config/mankedomath.conf, обычный текст key=value, с комментариями. Всё перезагружается через /math reload, кроме имён команд, которые встроены в дерево команд при старте сервера. В файле сказано, что есть что.

short_alias=true
aliases=math, m
funny_errors=true
max_length=256
max_depth=16
max_exponent=64
max_operations=500
decimals=4
click_to_copy=true
share_needs_permission=false

Сборка

./gradlew build

Нужен JDK 21. Jar появляется в build/libs/. Пакет math — это чистый Java без Minecraft, и у него есть свои тесты, которые запускаются в CI при каждом пуше:

./gradlew test

Лицензия

MIT. Часть W4VE, Ware 4 Vanilla Experience.