- Поддерживаемые версии
- 1.16
- 1.17
- 1.18
- 1.19
- 1.20
- 1.21
pnStaffWork — Документация
Плагин для учёта рабочего времени сотрудников на Minecraft-сервере.
Требования
| Зависимость | Версия | Обязательно |
|---|
| Paper / Spigot | 1.16.5+ | |
| LuckPerms | 5.x | |
| PlaceholderAPI | 2.11+ | (опционально) |
Установка
- Скачайте
pnStaffWork.jar и поместите в папку /plugins/
- Убедитесь, что LuckPerms установлен и запущен
- (Опционально) Установите PlaceholderAPI для доступа к плейсхолдерам
- Перезапустите сервер
- Плагин автоматически создаст
config.yml и подключится к базе данных
Команды
Основная команда:
/pnstaffwork (псевдоним:
/psw)
| Команда | Описание | Право |
|---|
/psw start | Начать рабочую сессию | pnstaffwork.use |
/psw stop | Завершить рабочую сессию | pnstaffwork.use |
/psw status | Посмотреть текущий статус | pnstaffwork.use |
/psw stats [игрок] | Статистика игрока | pnstaffwork.stats |
/psw stats [игрок] [период] | Статистика за период | pnstaffwork.stats |
/psw reload | Перезагрузить конфиг | pnstaffwork.admin |
Периоды для /psw stats
| Значение | Описание |
|---|
день | За текущий день |
неделя | За текущую неделю |
месяц | За текущий месяц |
все | За всё время |
Пример:
Код:
/psw stats Steve неделя
/psw stats Steve все
Права
| Право | Описание | По умолчанию |
|---|
pnstaffwork.use | Запуск/остановка сессий, просмотр своего статуса | op |
pnstaffwork.stats | Просмотр статистики любого игрока | op |
pnstaffwork.admin | Административные команды (reload и др.) | op |
Пример выдачи прав через LuckPerms
Код:
# Выдать сотруднику базовые права
/lp user Steve permission set pnstaffwork.use true
/lp user Steve permission set pnstaffwork.stats true
# Выдать группе
/lp group staff permission set pnstaffwork.use true
PlaceholderAPI
Если установлен PlaceholderAPI, доступны следующие плейсхолдеры:
| Плейсхолдер | Описание | Пример значения |
|---|
%pnstaffwork_working% | Работает ли сейчас игрок | Да / Нет |
%pnstaffwork_session_time% | Время текущей сессии | 1ч 23м 45с |
%pnstaffwork_total_time% | Суммарное время за всё время | 12ч 5м 30с |
%pnstaffwork_actions% | Количество действий | 142 |
%pnstaffwork_mutes% | Количество мутов | 8 |
%pnstaffwork_bans% | Количество банов | 3 |
%pnstaffwork_sessions% | Количество сессий | 27 |
Плейсхолдеры можно использовать в TAB, scoreboard, чат-плагинах и т.д.
Возможные ошибки при запуске
| Ошибка в консоли | Причина | Решение |
|---|
LuckPerms не найден! Плагин отключается. | LuckPerms не установлен или загружен позже | Убедитесь, что LuckPerms в /plugins/ и загружается раньше |
| Ошибка подключения к БД | Неверные данные в config.yml | Проверьте host, port, user, password |
PlaceholderAPI не подключился | PAPI не установлен | Установите PlaceholderAPI или игнорируйте (необязательно) |
Плагин взят с spig**.ru. Вместо того чтобы продавать, я написал такой же плагин с таким же функционалом, в случае багов или проблем пишете коменты, отвечу.