Skip to content

TabPrefix is a lightweight Minecraft plugin that automatically displays LuckPerms player groups in the server tab list. Easy setup, instant integration, no config required!

License

Notifications You must be signed in to change notification settings

SnowySunCode/TabPrefix

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TabPrefix — Full Documentation Description TabPrefix is a Minecraft plugin that integrates with LuckPerms to display player groups and permissions in the player list (tab list). The plugin automatically reads group data from LuckPerms, requires no configuration, and provides a command to refresh the displayed data.

Features LuckPerms integration: Reads player groups from LuckPerms and displays them in the tab list next to player names. Automatic updates: Changes to LuckPerms groups are automatically detected and shown in the tab list. Manual refresh command: Allows administrators to refresh tab list data without restarting the server. Easy setup: No configuration files — the plugin is ready to use immediately after installation. Permissions system: Access to commands is managed via LuckPerms. Installation Requirements Minecraft server with plugin support (e.g., Paper or Spigot). LuckPerms plugin installed. Installation Steps Download the TabPrefix plugin. Place the TabPrefix.jar file in your server's plugins folder. Restart your server. Done! The plugin will automatically start displaying player groups from LuckPerms in the tab list.

Usage How the Plugin Works After installation and server restart:

The plugin automatically fetches groups from LuckPerms and displays them in the tab list. If you change groups or permissions in LuckPerms, use the /lptab reload command to update the tab list without restarting the server. Commands /lptab reload Description: Reloads group and permission data displayed in the tab list. Usage: /lptab reload Example: After adding a new group or changing permissions in LuckPerms, run this command to refresh the tab list. Permissions The plugin uses LuckPerms permission system to control access to its commands.

Permission List tabprefix.reload — permission to use the /lptab reload command. Example: Granting Permissions Grant permission to a player:

/lp user permission set tabprefix.reload true Grant permission to a group:

/lp group permission set tabprefix.reload true FAQ (Frequently Asked Questions) Q: Do I need to configure anything?

A: No. The plugin has no configuration files. It automatically integrates with LuckPerms and uses group data.

Q: How do I update the tab list after changes in LuckPerms?

A: Use the /lptab reload command.

Q: Can I hide group display in the tab list for specific players?

A: Currently, this feature isn't available. The plugin displays groups for all players using LuckPerms data.

Q: What if the /lptab reload command is unavailable?

A: Check if you have the tabprefix.reload permission. You can add it to yourself or your group via LuckPerms.

Example: Using LuckPerms with TabPrefix Step 1: Create a “VIP” group and add a player

/lp group VIP create /lp user parent add VIP Step 2: Set a prefix for the “VIP” group

/lp group VIP meta setprefix "&6[VIP] " Step 3: Reload tab list data to show the changes

/lptab reload After these commands, a player in the “VIP” group will appear in the tab list with the [VIP] prefix.

Troubleshooting Logs If you encounter issues with display or commands, check your server logs:

Look for TabPrefix messages in logs/latest.log. Make sure the plugin is loaded correctly and does not conflict with other plugins. Common Errors Error: “Unknown command” Make sure the plugin is in the plugins folder and is enabled. Use /plugins to check if TabPrefix appears in the list.

Permissions not updating after /lptab reload Ensure changes in LuckPerms are saved, and check logs for errors.

For Russian:

TabPrefix — Полная документация Описание TabPrefix — это плагин для Minecraft, который интегрируется с LuckPerms и отображает группы и привилегии игроков в таб-листе. Плагин автоматически считывает данные о группах из LuckPerms, не требует конфигурации и предоставляет команду для обновления отображаемых данных.

Возможности Интеграция с LuckPerms: Считывает группы игроков из LuckPerms и отображает их в таб-листе рядом с именами. Автоматическое обновление: Все изменения в группах LuckPerms сразу отображаются в таб-листе. Ручное обновление: Команда для обновления данных без перезагрузки сервера. Простота установки: Нет конфигурационных файлов — просто установите и используйте! Система разрешений: Управление доступом к командам через LuckPerms. Установка Требования Сервер Minecraft с поддержкой плагинов (например, Paper или Spigot). Установленный плагин LuckPerms. Шаги установки Скачайте плагин TabPrefix. Поместите файл TabPrefix.jar в папку plugins вашего сервера. Перезапустите сервер. Готово! Плагин автоматически начнет отображать группы игроков из LuckPerms в таб-листе.

Использование Как работает плагин После установки и перезапуска сервера:

Плагин автоматически подхватит группы из LuckPerms и начнет отображать их в таб-листе. Если вы изменили группы или права в LuckPerms, используйте команду /lptab reload для обновления отображения без перезагрузки сервера. Команды /lptab reload Описание: Перезагружает данные групп и привилегий, отображаемых в таб-листе. Использование: /lptab reload Пример: После добавления новой группы или изменения привилегий в LuckPerms выполните эту команду для обновления таб-листа. Разрешения Плагин использует систему разрешений LuckPerms для управления доступом к своим командам.

Список разрешений tabprefix.reload — разрешение на использование команды /lptab reload. Пример добавления разрешений Выдача разрешения игроку:

/lp user <ник игрока> permission set tabprefix.reload true Выдача разрешения группе:

/lp group <название группы> permission set tabprefix.reload true FAQ (Часто задаваемые вопросы) В: Нужно ли что-то настраивать в конфигурации?

О: Нет. Плагин не имеет файлов конфигурации. Он автоматически интегрируется с LuckPerms и использует данные о группах.

В: Как обновить таб-лист после изменений в LuckPerms?

О: Используйте команду /lptab reload.

В: Можно ли отключить отображение групп в таб-листе для определённых игроков?

О: На данный момент такая функция не предусмотрена. Плагин отображает группы для всех игроков, используя данные из LuckPerms.

В: Что делать, если команда /lptab reload недоступна?

О: Проверьте, есть ли у вас разрешение tabprefix.reload. Вы можете добавить его себе или группе через LuckPerms.

Пример использования LuckPerms с TabPrefix Шаг 1: Создайте группу “VIP” и добавьте игрока

/lp group VIP create /lp user <ник игрока> parent add VIP Шаг 2: Настройте префикс для группы “VIP”

/lp group VIP meta setprefix "&6[VIP] " Шаг 3: Перезагрузите данные в таб-листе для отображения изменений

/lptab reload После выполнения этих команд игрок с группой “VIP” будет отображаться в таб-листе с префиксом [VIP].

Отладка Логи Если возникают проблемы с отображением или командами:

В файле logs/latest.log ищите сообщения от плагина TabPrefix. Убедитесь, что плагин загружен корректно и не конфликтует с другими плагинами. Типичные ошибки Ошибка: “Unknown command” Проверьте, что плагин находится в папке plugins и активен. Используйте команду /plugins, чтобы убедиться, что TabPrefix отображается в списке.

Права не обновляются после команды /lptab reload Убедитесь, что изменения в LuckPerms сохранены, и проверьте логи на наличие ошибок.

About

TabPrefix is a lightweight Minecraft plugin that automatically displays LuckPerms player groups in the server tab list. Easy setup, instant integration, no config required!

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published