VoteKick

A democratic voting system that allows players to collectively remove disruptive players from the server through a clean, fair voting process.

Features

• Simple Voting Interface - Unobtrusive UI with F1/F2 keybinds or chat commands
• Anti-Abuse Protection - Prevents harassment and vote spam with cooldowns and immunity periods
• Configurable Client UI - Adjustable scaling, positioning, and visual options
• Real-time Vote Tracking - Live progress bars and vote counts
• Flexible Configuration - Extensive server-side settings for fine-tuning

Usage

Starting a Vote

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

Voting

• Press F1 for YES (kick player)
• Press F2 for NO (keep player)
• Commands: /vote yes or /vote no

Status

/vote status

Admin Commands

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

Requires the votekick.admin permission (or op level configured in permissions_admin_default_level). cancel ends the active vote without a kick; force ends it as passed.

Configuration

Server Configuration

Located in 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

Client Configuration

Customize your voting experience through:

• ModMenu Integration - Graphical configuration screen
• Properties File - config/votekick-client.properties for manual editing

Options include UI scaling, panel positioning, sound controls, and animation settings.

Permissions

Permission nodes:

• votekick.start — allow starting votes
• votekick.vote — allow casting votes
• votekick.admin — allow admin commands
• votekick.exempt — exempt a player from being vote-kicked

Defaults are controlled by permissions_*_default_level in the server config (0 = all, 2 = ops). If a permissions API is present (Fabric Permissions API or LuckPerms on Fabric/NeoForge), the nodes above are checked; otherwise the defaults apply.

LuckPerms setup

• Fabric: install LuckPerms and fabric-permissions-api on the server.
• NeoForge: install LuckPerms on the server.

Example grants:

/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

Vote History

History is stored in config/votekick_history.json and follows the retention/max entry limits.

Anti-Abuse Features

• New Player Protection - Grace period for first-time joiners
• Post-Kick Immunity - Temporary protection after being kicked
• Harassment Detection - Automatic protection for repeatedly targeted players
• Vote Cooldowns - Prevents spam voting and target harassment
• Threshold Modifiers - Requires more votes to kick frequently kicked players

Requirements

• Fabric: Fabric API (required), ModMenu (optional for GUI configuration)
• NeoForge: no extra dependencies
• Must be installed on both client and server

Default Behavior

• Server operators and players with permission level 2+ are exempt from being vote-kicked.
• All other players can participate in voting (unless protected).

Compatibility

• Minecraft 1.20.1 (Fabric only)
• Minecraft 1.20.4, 1.20.6, 1.21.1, 1.21.4 (Fabric + NeoForge)