CustomKill

💀 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)

• Deca (retired) (https://github.com/decaprime) [OG Killfeed author]
• Sunrise (https://github.com/SunrisesvRising/BestKillfeed)
• Morphine (Phlebotomist) (https://github.com/phlebotomist/PvPDetails)

🔧 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.