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