💀 CustomKill
CustomKill A custom V-Rising killfeed plugin utilizing existing foundations, made for easier configuration and customization for server owners.
Originally forked from BestKillfeed + PvP Details to use existing framework/foundations.
Credits and copyright:
Credit for original author(s)
🔧 Main Features
- [Clan name] + Player Name + Level in feed
- Damage / Kills / Deaths / Assists / MaxStreak system
- LiteDB persistent data storage
☑️ Enhanced Killfeed in Chat
- Displays clan, player name, and max level for each kill.
- Automatically detects player max levels on login, kill, or when executing the
.pi command
🛡️ Kill-Steal Protection
- If Player A downs Player B, but Player C finishes them, the kill is credited to Player A.
- Credit to Sunrise (left code source in place but updated namespace for attribution and file matching)
🚫 Anti-Grief Level Difference System
- Configurable level-difference protection:
- For level 91: max difference = 10 levels
- For levels below 91: max difference = 15 levels
- Player levels are shown in red if they exceed the allowed difference.
- Credit again to Sunrise (thanks big guy)
📊 Custom Commands
.pi – Player Info
- Displays detailed player info:
- Name, clan, level, clan members, and connection status
- Name in green = connected
- Name in red = offline
- Credit yet again to Sunrise (left this system in place)
.stats - Stats
- Displays users stats including:
- Damage, Kills, Deaths, Assists, Killstreak, Max Killstreak
- Future:
damage tracking (DONE) , assist tracking (Needs testing)
.kd & .kda
- Display your Kill/Death or K/D/Assist ratio
- Utilizes simple K/D and K/D/A math
- Added to eliminate need for additional plugins and for simplicity
.top [category] – Leaderboard (top 5 players)
- Displays an aesthetic leaderboard with:
- Kills, deaths, max killstreaks
- Pagination and ranking system
- Categories including clan, damage, kills, deaths, assists, ms (maxstreak)
- Future:
damage category (DONE) , top clan category (DONE) [kills / deaths ]
.rs - Reset Stats
- Wipes database of player information, clan association, members, and stats
- Prompt system to avoid accidental deletion (
.y or .n )
- Future TODO:
Export database to file (DONE) | Discord command to commit stats (DONE)
.exportstats - Export Stats
- Writes all stats to 2 separate HTML files currently
- Designed for easier reading/tracking
- Found in CustomKill/Exports folder when searching for the files
- Writes a Player stats HTML based on the wipe cycle
- Writes a Clan stats HTML based on the wipe cycle
- This command is meant to be used at the end of your wipe cycle (I highly recommend not using it for more than its intention)
- File names: WipeCycle_PlayerStats.html , WipeCycle_ClanStats.html
.ptd - Post To Discord
- Post to discord command unification (post stats to a discord webhook)
- Uses a secondary webhook URL entry in main config (customkill.cfg)
- Will post the top 10 players and top 5 clans.
- Output lists player names and clan names in bold for easier reading
- Has been confirmed working as of 7/22/25
⚙️ Easy Configuration
- Edit the
CustomKill.cfg file to customize:
- Text colors
- Level difference thresholds
- Discord webhook URL for kill notifications
- Displays webhook name as "app" (i.e. if webhook is named FozzyBear, when a kill takes place the webhook will show "FozzyBear 'APP'") for high customization
🎨 Color Settings (.top / .stats)
- Customizable color settings
- Title (change appearance when --Top 5 players-- or --Username Stats-- is read from config)
- Damage/Kills/Deaths/Assists/Killstreak/Maxstreak
- Customizable for both .top and .stats respectively
❗ Admin Flagging System
- Configurable system for adding admin only restrictions
- Config file of CustomKill.cfg
- Configurable to set each category as viewable by all or by admin
- Config flag field:
RestrictKillsToAdmin = boolean (true / false)
💾 Persistent Data Storage
-Uses LiteDB for efficient data storage, ensuring:
- Better overhead performance and reliability.
- Reduced load for server resources (i.e. no saving to json file)
Misc Info:
All source is distributed as is. I do not own any strict rights to any material contained within.
You are free to copy, modify, change, enhance, distribute as you see fit.
I ask that you include the original authors (top of the readme) and myself for credits and contributions.
You can contact me on discord in the V-Rising Modding discord. Username BeardMagics.
📝 License
This mod is distributed under the MIT License.
You are free to modify and redistribute it, as long as proper credit is given to the original author.
