AdminMode

Version: 1.0.0 Minecraft: 1.20.1 Mod loader: Fabric Author: gloyer057

What it does

AdminMode is a server-side administration tool that lets you create named staff positions and give players controlled access to an "admin mode" — a temporary elevated state with a dedicated LuckPerms group, restricted interactions, and full session tracking.

When a player enters admin mode, their inventory and position are saved, their position's LuckPerms group is applied, and they lose the ability to break or place blocks, pick up or drop items, and interact with blocks or entities. When they exit, everything is reversed: they are teleported back, their inventory is restored, the group is removed, and god/fly/vanish are disabled. Every enable and disable event is written to a persistent log file.

Dependencies

Dependency	Version	Required
Fabric Loader	≥ 0.15.11	✅
Fabric API	0.92.2+1.20.1 or newer	✅
LuckPerms (Fabric)	any	✅
Java	17	✅

The mod must be installed on both the server and every client connecting to it.

Installation

1. Download adminmode-1.0.0.jar
2. Place it in the mods/ folder on the server
3. Place the same jar in the mods/ folder on each client
4. Make sure LuckPerms and Fabric API are also present
5. Start the server — the mod initializes automatically

Getting started

1. Create a position

/adminmode create admin

This registers a position called admin and creates a matching LuckPerms group.

2. Give a player access

/adminmode add Steve admin

Steve receives the permissions adminmode.use and adminmode.admin automatically. He can now use /adminmode enable.

3. Player enters admin mode

/adminmode enable

Steve's inventory and position are saved. The admin LuckPerms group is applied. Block/item interactions are restricted.

4. Player exits admin mode

/adminmode disable

Steve is teleported back, inventory restored, group removed, god/fly/vanish disabled, gamemode set to survival.

5. Revoke access

/adminmode remove Steve admin

Permissions are removed. If Steve is currently in admin mode, it is force-disabled.

Configuration

There is no config file. All data (positions and player assignments) is stored in config/adminmode_data.json and is managed entirely through in-game commands. The event log is written to config/adminmode_log.log.

Notes

• Sessions are in-memory only. If the server restarts while a player is in admin mode, the session is lost. Their LuckPerms group may remain — remove it manually if needed.
• The adminmode.bypass permission allows a player to use admin mode without any interaction restrictions. Useful for senior staff who need full access.
• Positions support only lowercase latin letters, digits, and underscores (a-z, 0-9, _).
• Tab completion for position names updates automatically when positions are created or deleted.

---

AdminMode

Версия: 1.0.0 Minecraft: 1.20.1 Загрузчик: Fabric Автор: gloyer057

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

AdminMode — инструмент администрирования сервера, позволяющий создавать именованные должности и давать игрокам контролируемый доступ к «админ-моду» — временному состоянию с отдельной LuckPerms-группой, ограниченными взаимодействиями и полным логированием сессий.

При входе в админ-мод инвентарь и позиция игрока сохраняются, применяется LuckPerms-группа его должности, и он теряет возможность ломать и ставить блоки, подбирать и выбрасывать предметы, взаимодействовать с блоками и сущностями. При выходе всё возвращается: игрок телепортируется обратно, инвентарь восстанавливается, группа снимается, god/fly/vanish отключаются. Каждое включение и выключение записывается в постоянный лог-файл.

Зависимости

Зависимость	Версия	Обязательна
Fabric Loader	≥ 0.15.11	✅
Fabric API	0.92.2+1.20.1 или новее	✅
LuckPerms (Fabric)	любая	✅
Java	17	✅

Мод должен быть установлен и на сервере, и у каждого клиента, подключающегося к нему.

Установка

1. Скачайте adminmode-1.0.0.jar
2. Положите его в папку mods/ на сервере
3. Положите тот же jar в папку mods/ на каждом клиенте
4. Убедитесь что LuckPerms и Fabric API тоже присутствуют
5. Запустите сервер — мод инициализируется автоматически

Быстрый старт

1. Создайте должность

/adminmode create admin

Регистрирует должность admin и создаёт соответствующую группу в LuckPerms.

2. Выдайте доступ игроку

/adminmode add Steve admin

Steve автоматически получает права adminmode.use и adminmode.admin. Теперь он может использовать /adminmode enable.

3. Игрок входит в админ-мод

/adminmode enable

Инвентарь и позиция Steve сохраняются. Применяется LuckPerms-группа admin. Взаимодействия с блоками и предметами блокируются.

4. Игрок выходит из админ-мода

/adminmode disable

Steve телепортируется обратно, инвентарь восстанавливается, группа снимается, god/fly/vanish отключаются, gamemode устанавливается в survival.

5. Снятие доступа

/adminmode remove Steve admin

Права снимаются. Если Steve сейчас в админ-моде — он принудительно из него выходит.

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

Файла конфигурации нет. Все данные (должности и назначения игроков) хранятся в config/adminmode_data.json и управляются исключительно через команды в игре. Лог событий записывается в config/adminmode_log.log.

Примечания

• Сессии хранятся только в памяти. Если сервер перезапустится пока игрок в админ-моде, сессия пропадёт. LuckPerms-группа может остаться — при необходимости удалите её вручную.
• Право adminmode.bypass позволяет использовать админ-мод без ограничений на взаимодействия. Полезно для старшего персонала которому нужен полный доступ.
• Названия должностей поддерживают только строчные латинские буквы, цифры и подчёркивание (a-z, 0-9, _).
• Tab-дополнение для названий должностей обновляется автоматически при их создании и удалении.