Actkillsbar

ActKillsBar – Professional Tournament Kill Counter
Overview
ActKillsBar is a premium, feature-rich Minecraft PaperMC plugin engineered for competitive servers and tournament events. It delivers real-time kill tracking with a sophisticated UI system, advanced player management, and complete data persistence—all fully customizable through an intuitive configuration system.

✨ Core Features
📊 Action Bar & Kill Counter
Real-time kill display with customizable formatting and currency system

Gold gradient styling with professional color schemes

Automatic updates on every player kill with sound effects

Fully configurable labels, colors, and display format

🎯 Professional Scoreboard System
Live player rankings displaying top killers with real-time updates

Online/offline status indicators for each player

Customizable titles, colors, and rank formatting via config.yml

Toggle on/off globally or per-player with dedicated commands

Small caps font styling for premium appearance

Gradient coloring for enhanced visual hierarchy

🎮 Advanced Player Management GUI

Intuitive chest-based interface with pagination support

Player information display (kills, currency, status)

Individual kill reset functionality per player

Teleportation system with two modes:

Online players: Instant direct teleport to current location

Offline players: Teleport to last known saved location

Offline player management: View, manage, and reset kills for offline players

Professional layout with clear visual hierarchy and navigation

💾 Persistent Data Management
Automatic data saving every 5 minutes

Server restart resilience: All kill counts, player names, and locations persist

Multi-file storage system:

datakills.yml – Kill counts and tournament data

playernames.yml – Player name caching (for offline players)

playerlocations.yml – Last player locations

No data loss on unexpected shutdowns

🎪 Tournament Management System
Start/Stop tournament with dedicated commands

Real-time kill tracking during active tournaments

Automatic tournament state persistence

Reset all tournament data with single command

Currency system (configurable kills-to-money conversion)

⚙️ Full Customization via Config.yml
Scoreboard settings: Title, top-players count, colors, ranks

Action bar format: Custom labels and currency symbols

GUI layout customization

Online/offline indicators: Customizable symbols and colors

Tournament labels and messaging

Color gradients and small-caps formatting

All in-game messages: Editable and customizable

🔄 Advanced Reload System
Single command reload: /acttournamentkills reload

Simultaneous reload of:

config.yml (all settings)

datakills.yml (kill data)

playernames.yml (cached names)

playerlocations.yml (player locations)

Tournament state

All active scoreboards

Zero downtime updates – players stay online during reload

Live scoreboard refresh after configuration changes

👥 Offline & Online Player Support
Seamless offline handling: Player names and stats preserved

Last location tracking: Automatically saved on player quit

Manage any player: Whether online or offline

Name persistence: Never lose player identification

📋 Commands
Command Permission Function
/starttournamentkills actkillsbar.start Begin tournament and kill tracking
/stoptournamentkills actkillsbar.stop End active tournament
/resettournamentkills actkillsbar.reset Reset all tournament kills and data
/resetplayerkills actkillsbar.reset Reset specific player's kill count
/admintournamentkillsgui actkillsbar.admin Open admin management interface
/togglescoreboard actkillsbar.togglescoreboard Toggle scoreboard visibility
/acttournamentkills reload actkillsbar.reload Full plugin reload with data sync
🔐 Permissions
text
actkillsbar.admin # Full admin access
actkillsbar.start # Start tournaments
actkillsbar.stop # Stop tournaments
actkillsbar.reset # Reset kill data
actkillsbar.gui # Access GUI system
actkillsbar.reload # Reload plugin
actkillsbar.togglescoreboard # Toggle scoreboard
🛠️ Technical Specifications
Requirements:

Server Type: PaperMC 1.20.4+

Java Version: Java 17+

Dependencies: None (standalone plugin)

File Format: Compiled JAR (DRM-protected)

Performance:

Lightweight design with minimal server impact

Efficient data serialization (YAML-based)

Auto-save interval: 5 minutes

Real-time updates without lag

📦 Installation & Setup
Step 1: Download & Install
Download ActKillsBar.jar from your purchase

Place in your PaperMC server's plugins/ directory

Restart your server

Step 2: Initial Configuration
On first startup, the plugin generates:

config.yml – Main configuration file

datakills.yml – Kill tracking database

playernames.yml – Player name cache

playerlocations.yml – Player location data

Step 3: Customize
Edit config.yml to customize:

Scoreboard appearance and text

Action bar format and colors

GUI layout and messaging

Tournament settings

Currency conversion rates

Step 4: Reload & Deploy
Make configuration changes

Run /acttournamentkills reload (or restart)

Start tournament with /starttournamentkills

Enjoy real-time kill tracking!

🎨 Customization Examples
Scoreboard Configuration
text
scoreboard:
enabled: true
title: "Tournament Kills"
top-players-count: 5
your-kills-label: "Your Kills: "
rank-1-color: "§6" # Gold
rank-2-color: "§7" # Silver
rank-3-color: "§c" # Copper
online-indicator: "§a●"
offline-indicator: "§8○"
Action Bar Format
text
action-bar:
format: "%kills% kills - %currency%₹"
currency-per-kill: 10

🎯 Use Cases
PvP Tournaments: Track kills in real-time competitions

Event Management: Organize and manage kill-based events

Competitive Servers: Maintain persistent leaderboards

Mini-games: Integrate kill counting into custom game modes

Faction Servers: Track faction member kills and contributions

Survival Servers: Gamify PvP interactions with rewards

🚀 Advanced Features
Pagination System: Browse unlimited players with Next/Previous

Status Indicators: Clear online/offline visual distinction

Location Caching: Automatic last-location saving

Currency Integration: Kill-to-money conversion system

Sound Effects: Customizable audio feedback on kills

Gradient Colors: Professional color schemes with small-caps formatting

Tournament State Persistence: Resume tournaments after restarts

💬 Support & Updates
Support Duration: 1 year included with purchase

Updates: Bug fixes and compatibility updates

Contact: Reach out via BuiltByBit/Modrinth DMs for issues

Custom Features: Available upon request

📝 License & Terms
Source Code: Proprietary – DRM-protected compiled JAR only

Usage: Single server license per purchase

Modifications: Decompilation and modification prohibited

Redistribution: Strictly prohibited

🎁 What's Included
✅ Complete compiled JAR plugin
✅ Configuration templates
✅ All data management systems
✅ Full feature set (no addons required)
✅ 1 year of support
✅ Free bug fixes and maintenance

ActKillsBar – Professional Tournament Management for Minecraft Servers!