VoteKick

VoteKick

Демократичная система голосования, позволяющая игрокам сообща убирать с сервера мешающих игроков через честный и понятный процесс голосования.

Возможности

• Простой интерфейс голосования — ненавязчивый UI с горячими клавишами F1/F2 или чат-командами
• Защита от злоупотреблений — предотвращает травлю и спам голосованиями с помощью кулдаунов и периодов иммунитета
• Настраиваемый клиентский UI — регулируемый масштаб, положение и визуальные опции
• Отслеживание голосов в реальном времени — живые полосы прогресса и счётчики голосов
• Гибкая конфигурация — обширные серверные настройки для тонкой подгонки

Использование

Запуск голосования

/votekick <player> <reason>
/vk <player> <reason>

Голосование

• Нажмите F1 для ДА (кикнуть игрока)
• Нажмите F2 для НЕТ (оставить игрока)
• Команды: /vote yes или /vote no

Статус

/vote status

Админ-команды

/votekick-admin cancel
/votekick-admin force
/votekick-admin reload
/votekick-admin history [page]

Требуется разрешение votekick.admin (или уровень op, заданный в permissions_admin_default_level). cancel завершает активное голосование без кика; force завершает его как прошедшее.

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

Серверная конфигурация

Находится в config/votekick.properties:

# Basic Settings
vote_duration_seconds=30
vote_pass_percentage=0.6
minimum_players=2
cooldown_seconds=120

# Protection System
new_player_protection_enabled=true
post_kick_protection_enabled=true
harassment_detection_enabled=true
vote_threshold_modifiers_enabled=true

# Customization
require_kick_reason=true
allow_self_voting=false

# Permissions (default op levels)
permissions_enabled=true
permissions_start_default_level=0
permissions_vote_default_level=0
permissions_admin_default_level=2
permissions_exempt_default_level=2

# Vote History
vote_history_enabled=true
vote_history_max_entries=200
vote_history_retention_days=90

Клиентская конфигурация

Настройте свой опыт голосования через:

• Интеграцию с ModMenu — графический экран настроек
• Файл свойств — config/votekick-client.properties для ручного редактирования

Опции включают масштаб UI, положение панели, управление звуком и настройки анимации.

Разрешения

Узлы разрешений:

• votekick.start — разрешить запуск голосований
• votekick.vote — разрешить голосовать
• votekick.admin — разрешить админ-команды
• votekick.exempt — освободить игрока от голосования за кик

Значения по умолчанию управляются через permissions_*_default_level в серверной конфиге (0 = все, 2 = операторы). Если присутствует API разрешений (Fabric Permissions API или LuckPerms на Fabric/NeoForge), проверяются узлы выше; иначе применяются значения по умолчанию.

Настройка LuckPerms

• Fabric: установите LuckPerms и fabric-permissions-api на сервер.
• NeoForge: установите LuckPerms на сервер.

Примеры выдачи:

/lp group default permission set votekick.start true
/lp group default permission set votekick.vote true
/lp group mod permission set votekick.admin true
/lp group mod permission set votekick.exempt true

История голосований

История хранится в config/votekick_history.json и подчиняется лимитам хранения и максимального числа записей.

Защита от злоупотреблений

• Защита новых игроков — льготный период для впервые зашедших
• Иммунитет после кика — временная защита после того, как игрока кикнули
• Обнаружение травли — автоматическая защита для игроков, которых постоянно выбирают целью
• Кулдауны голосования — предотвращают спам голосованиями и травлю цели
• Модификаторы порога — требуют больше голосов для кика часто кикаемых игроков

Требования

• Fabric: Fabric API (обязательно), ModMenu (опционально для настройки через GUI)
• NeoForge: дополнительных зависимостей нет
• Должен быть установлен и на клиенте, и на сервере

Поведение по умолчанию

• Операторы сервера и игроки с уровнем прав 2+ не могут быть кикнуты голосованием.
• Все остальные игроки могут участвовать в голосовании (если не защищены).

Совместимость

• Minecraft 1.20.1 (только Fabric)
• Minecraft 1.20.4, 1.20.6, 1.21.1, 1.21.4 (Fabric + NeoForge)