Private Chests

Простая и мощная защита контейнеров для вашего Minecraft-сервера. Защищайте сундуки и бочки с помощью настенных табличек с [private] или [public]. Никакой сложной настройки — просто поставьте табличку, и ваш контейнер защищён.

Что делает этот мод?

Private Chests — это серверный мод для Fabric, который позволяет игрокам защищать сундуки и бочки от других игроков.

Прикрепите настенную табличку к сундуку или бочке и напишите:

• [private] — доступ только для владельца, с возможностью предоставить доступ другим
• [public] — открыть может любой, но контейнер остаётся защищённым от гриферства

Мод обрабатывает защиту автоматически — блокирует несанкционированный доступ, предотвращает эксплойты с расширением сундуков, останавливает кражи через воронки и защищает контейнеры от взрывов и огня.

Только для сервера — клиентский мод не нужен. Игроки могут заходить с ванильными клиентами.

Возможности

🔒 Простая защита через таблички

• Поставьте настенную табличку на любой сундук или бочку
• Напишите [private] или [public] в первой строке
• [private] поддерживает дополнительные имена игроков в остальных строках
• Поддерживаются имена через запятую: Player1, Player2
• Используйте обе стороны таблички

🛡️ Полная защита

• Приватные контейнеры — открыть могут только владелец и указанные игроки
• Публичные контейнеры — открыть может любой, но они остаются защищёнными
• Предотвращает эксплойты с расширением сундуков — не-владельцы не могут ставить сундуки рядом с защищёнными контейнерами
• Останавливает кражи через воронки — воронки не могут перемещать предметы в защищённые контейнеры или из них
• Защита от взрывов — TNT и криперы не разрушат защищённые контейнеры
• Защита от огня — огонь не распространяется на защищённые контейнеры
• Защита табличек — только владелец или админ может редактировать или ломать защитные таблички

🎮 Удобство для игроков

• Поддержка двойных сундуков — автоматически обрабатывает двойные сундуки
• Расширение владельцем — владельцы могут расширить свой одиночный сундук до двойного
• Лёгкое удаление — сломайте свой защищённый сундук/контейнер напрямую (защита снимается автоматически)
• Не нужны команды для игроков — игроки просто используют таблички

🌍 Кроссплатформенная совместимость

• Полная поддержка Bedrock через Floodgate/Geyser
• Игроки Bedrock могут создавать и использовать защищённые контейнеры
• Настраиваемый префикс имени для игроков Bedrock

⚙️ Инструменты для админов

Команды для управления сервером:

• /private_chests list
• /private_chests list public
• /private_chests list private
• /private_chests list_in_area [radius]
• /private_chests list_in_area [radius] public
• /private_chests list_in_area [radius] private
• `/private_chests info `
• `/private_chests unlock `
• /private_chests cleanup
• Алиас: /pchests

Как использовать

Создание приватного контейнера

1. Поставьте сундук или бочку
2. Прикрепите настенную табличку
3. Напишите:

[private] PlayerName1 Player2, Player3

Открыть смогут только вы и указанные игроки.

Создание публичного контейнера

1. Поставьте сундук или бочку
2. Прикрепите настенную табличку
3. Напишите:

[public]

Открыть может любой, но управлять защитой может только владелец таблички или админ.

Правила формата табличек

• [private] и [public] должны быть только в первой строке
• Маркер нечувствителен к регистру
• Маркер может быть на лицевой или обратной стороне
• [private] позволяет указывать имена игроков в остальных строках
• Владелец автоматически получает доступ

Управление защитой

Чтобы изменить доступ:

• Отредактируйте текст таблички
• Только владелец или админ может редактировать активную защитную табличку

Чтобы снять защиту:

• Уберите маркер защиты с активной таблички
• Или сломайте свой защищённый сундук/контейнер напрямую

Неактивные таблички:

• Если у защищённого контейнера уже есть активная табличка защиты, дополнительные таблички [private] или [public] не перехватывают защиту автоматически
• Они активируются позже, только если контейнер остался без защиты, а владелец таблички/админ активирует их повторно

Команды администратора

Все команды требуют прав администратора (настраивается, по умолчанию уровень 3).

/private_chests list

Показывает защищённые контейнеры на всём сервере.

/private_chests list public

Показывает только публичные защищённые контейнеры.

/private_chests list private

Показывает только приватные защищённые контейнеры.

/private_chests list_in_area [radius]

Показывает защищённые контейнеры рядом с вами.

`/private_chests info `

Показывает подробную информацию:

• Тип контейнера и местоположение
• Имя владельца
• Режим защиты (private или public)
• Список разрешённых игроков
• Время создания
• Время последнего обновления

`/private_chests unlock `

Принудительно снимает защиту с контейнера.

/private_chests cleanup

Удаляет устаревшие записи активных замков и неактивных табличек в загруженных чанках.

Конфигурация

Файл конфигурации: config/private-chests.json

 {
   "floodgatePrefix": ".",
   "adminPermissionLevel": 3,
   "maxLocksPerPlayer": 0,
   "listMaxEntries": 50,
   "listPreviewEntries": 20,
   "disableProtectionIfOwnerBanned": true
 }

Некорректные значения автоматически исправляются при запуске.

Известные проблемы

Из-за клиентского предсказания Minecraft могут возникать небольшие визуальные глюки.

Исчезновение текста на табличке

Когда игроки без прав пытаются сломать защищённую табличку:

• Табличка остаётся целой на сервере
• Текст может временно исчезнуть на клиенте
• Решение: кликните левой или правой кнопкой по табличке, чтобы обновить её

Предмет «исчезает» при блокировке

При попытке поставить блоки рядом с защищёнными контейнерами:

• Установка корректно блокируется сервером
• Предмет может временно исчезнуть из хотбара
• Решение: переключитесь на этот слот или переместите предмет
• Предмет на самом деле никогда не теряется

Это только визуальные проблемы на стороне клиента.

Технические детали

• Только серверная часть
• Постоянные данные хранятся в world/data/private-chests.dat
• Защита на уровне пакетов для ломания табличек
• Эффективный поиск и кэширование
• Поддерживает Minecraft 26.1.1

Установка

Установка на сервер

1. Скачай JAR-файл мода
2. Положи его в папку mods на сервере
3. Убедись, что также установлен Fabric API
4. Запусти сервер
5. (Необязательно) настрой config/private-chests.json