ItemBan для Minecraft: полный контроль над предметами на сервере
Каждый владелец сервера рано или поздно сталкивается с ситуацией, когда игроки находят дыру в балансе: дюпают ценные ресурсы, крафтят запрещённые вещи или строят из блоков, которых в вашей сборке быть не должно. ItemBan — это серверный мод, который решает проблему раз и навсегда. Он позволяет вести чёрный список предметов и блоков, удалять запрещённые рецепты и вычищать уже существующие стаки из инвентарей, сундуков, рамок и даже из мира.
Что умеет ItemBan
Мод работает целиком на стороне сервера. Обычным игрокам не нужно ничего устанавливать на клиент — они просто заходят и играют по вашим правилам. Основные возможности:
- Удаление рецептов: если результат крафта в чёрном списке, рецепт вырезается из таблицы сервера — крафт, плавка, камнерез, кузнечное дело и другие типы.
- Автоматическая чистка: запрещённые предметы исчезают из инвентарей игроков, открытых контейнеров, рамок, выпавших дропов и, при желании, из блоков мира.
- NBT и SNBT-правила: можно забанить весь ID целиком или только те стаки и блоки, что совпадают с частью NBT-компаунда.
- Совместимость с модовыми хранилищами: AE2, Create, Sophisticated Backpacks, Storage Drawers и другие стандартные контейнеры.
- Веб-панель администратора на localhost по умолчанию: чёрные списки, исключения аудита, переключатели функций, логи и управление аккаунтами.
- Внутриигровой GUI через команду /itemban gui, который открывается отдельным админ-модом под конкретный сервер.
Поддерживаемые версии и загрузчики
Мод активно развивается и покрывает широкий спектр версий Minecraft. Скачать itemban можно для следующих сборок:
- Minecraft 1.16.5 — Forge
- Minecraft 1.18.2 — Forge
- Minecraft 1.19.2 — Forge
- Minecraft 1.20.1 — Forge
- Minecraft 1.21.1 — Forge и NeoForge
- Minecraft 1.21.11 — Forge и NeoForge
- Minecraft 26.1.2 — Forge и NeoForge
Если вы держите несколько серверов на разных версиях, удобно собирать сборки через лаунчер foxygame.net: там каталог дополнений позволяет подключить itemban к нужному профилю в один клик, а автообновление подтянет свежую сборку мода без ручной возни с jar-файлами.
Как установить ItemBan
Установка максимально простая и не требует правки конфигов на старте:
- Скачайте jar, соответствующий вашей версии Minecraft и загрузчику.
- Положите его в папку mods на сервере и перезапустите сервер.
- Обычным игрокам ничего на клиент ставить не нужно.
- Для внутриигрового GUI скопируйте в клиентскую папку mods и сам ItemBan, и сгенерированный админ-мод.
При первом запуске сервер создаёт случайный админ-ключ и записывает файл config/ItemBan/admin-key.json, а также генерирует ItemBan-Admin-*.jar в папке config/ItemBan/admin-mods/. Ключ сохраняется между перезапусками. Команда /itemban adminmod regen меняет ключ на лету — старые админ-моды сразу перестают работать. Можно держать на клиенте несколько админ-модов одновременно: игра сама выберет тот, что подходит к серверу, куда вы заходите.
Веб-панель и команды
По умолчанию панель слушает только localhost на http://127.0.0.1:25580. Чтобы открыть её с другой машины, пропишите в config/ItemBan/config.json параметр "webBind": "0.0.0.0". При первом старте создаётся одноразовый пароль для админ-аккаунта — он показывается в логе сервера и по команде /itemban web. После входа пароль нужно сменить; также его можно задать напрямую через /itemban web password. Пароли хранятся как PBKDF2-хеши, а не в открытом виде.
Роли в веб-панели делятся на admin/owner и user. Владелец управляет аккаунтами, а обычный пользователь может править чёрные списки и переключатели, но не менять авто-кик и не трогать аккаунты.
Все внутриигровые команды требуют право itemban.ban, которое по умолчанию выдано OP уровня 2. Консоль имеет его всегда. Среди ключевых команд: /itemban add, /itemban remove, /itemban list, /itemban reload, /itemban announce, /itemban autoban, /itemban dropdetect, /itemban blockscan, /itemban block add/remove/list, /itemban logexclude, /itemban gui и /itemban adminmod.
Настройка конфигурации
Все файлы лежат в config/ItemBan/. В blacklist.json хранится список предметов, в block_blacklist.json — блоков, в config.json — переключатели функций, порт и адрес веб-панели, хешированные аккаунты. Отдельно ведутся логи аудита в logs/ItemBan/, причём ID можно исключить из лога, оставив при этом удаление предмета.
Дополнительно доступны чат-объявления и опциональный авто-кик или авто-бан через ванильный бан-лист, а при наличии мода LnsanesBan — каскадный бан. Режим Creative и обладатели права itemban.ban освобождены от сканирования.
Итог
ItemBan — это аккуратный и мощный инструмент для администрирования сервера. Он не грузит клиент игроков, гибко настраивается через NBT-правила и закрывает сразу несколько проблем: запрет крафта, чистку уже существующих предметов и контроль блоков в мире. Если вы хотите держать экономику и баланс под контролем, itemban для Minecraft станет надёжным помощником в вашем арсенале администратора.