feat: pizdec

README.md

@@ -0,0 +1,68 @@
+# AdminMode
+
+Плагин режима адмистратора для Paper 26.1.2.
+
+## Описание
+
+AdminMode - это плагин, который позволяет модераторам и администраторам входить в специальный режим с сохранением их текущего состояния. При активации режима администратора:
+
+- Сохраняется инвентарь, броня, предметы
+- Сохраняется позиция игрока
+- Сохраняется здоровье, голод, опыт
+- Сохраняются эффекты зелий
+- Выдаются временные права через LuckPerms (или OP)
+
+При выходе из режима все восстанавливается обратно.
+
+## Возможности
+
+- **Сохранение состояния в JSON** - все данные сохраняются на диск
+- **Интеграция с LuckPerms** - автоматическая выдача/отзыв групп
+- **Гибкие ограничения** - настройка что можно/нельзя делать в режиме
+- **Защита от читерства** - предотвращение переноса предметов
+
+## Команды
+
+- `/adminmode` (алиасы: `/adm`, `/am`) - включить/выключить режим администратора
+
+## Права
+
+- `adminmode.use` - разрешает использовать режим администратора (по умолчанию: OP)
+- `adminmode.punishment.warn` / `unwarn` - выдача и снятие предупреждений
+- `adminmode.punishment.mute` / `unmute` - выдача и снятие мута
+- `adminmode.punishment.kick` - отключение игрока
+- `adminmode.punishment.ban` / `unban` - выдача и снятие бана
+
+## Установка
+
+1. Установите Paper 26.1.2 build 74 или новее и Java 25.
+2. Установите LuckPerms 5.5.x.
+3. Скопируйте `AdminMode-1.2+26.1.2.jar` в папку `plugins/`.
+4. Перезапустите сервер и настройте `config.yml`.
+
+## Зависимости
+
+- **Обязательные**: Paper 26.1.2, Java 25, LuckPerms 5.5.x
+- **Опциональные**: CoreProtect
+
+Подробная пошаговая настройка групп и прав: [LUCKPERMS_SETUP.md](LUCKPERMS_SETUP.md).
+
+Контракт команд для отдельного плагина наказаний: [MODERATION_PLUGIN_CONTRACT.md](MODERATION_PLUGIN_CONTRACT.md).
+
+Команда снятия мута вызывается как `moderationcommands:unmute`, чтобы исключить конфликт с `/unmute` из FlectonePulse.
+
+## Сборка
+
+```bash
+./gradlew clean build
+```
+
+Готовый JAR: `build/libs/AdminMode-1.2+26.1.2.jar`.
+
+## Автор
+
+BelzeBool
+
+## Лицензия
+
+Эксклюзивно для сервера Шлакоблок