Version 1.0.0
2 downloads
RHG Killstreak Rewards is a fully configurable kill streak system for Rust servers. Players earn tiered item rewards and temporary micro-buffs as they chain kills without dying. The plugin ships with seven reward tiers that trigger at 3, 5, 8, 10, 12, 15, and 20 kills. Each tier grants a configurable item bundle and one or more short-lived buffs chosen from four types: outgoing damage boost, incoming damage reduction, movement speed increase, and HP restoration per kill (vampire). All thresholds, amounts, and buff values are editable in the JSON config file with no code changes required.
A bottom-right HUD bar displays the remaining buff duration in real time. A top-center kill notification banner shows the tier colour, the list of reward items received, and progress toward the next threshold. When a player ends someone's streak, a separate streak-break panel appears for that player so the two elements never conflict. Victims killed by a streaking player receive a targeted chat message. Configurable server-wide announcements fire on both milestone rewards and streak breaks.
The anti-abuse system blocks same-victim kill chaining within a configurable cooldown window and can require the attacker to be alive at the time the kill is counted. When a speed buff is active the plugin automatically suppresses FlyHack and SpeedHack false positives for that player.
Admin commands allow resetting any player's streak, reloading the config live without a server restart, and simulating any reward tier for testing. The plugin integrates optionally with RHG Player Intelligence to modify or block rewards based on a player's behavior record, and exposes API hooks for RHG Event Intelligence to apply event-duration reward multipliers.
This plugin was developed with the assistance of AI tools (GitHub Copilot / Claude). All logic, balancing, and configuration were reviewed and finalized by a human author.
FEATURES
- 7 configurable reward tiers at kill milestones: 3 / 5 / 8 / 10 / 12 / 15 / 20
- 4 buff types stackable per tier: outgoing damage boost, incoming damage reduction, movement speed boost, heal per kill (vampire)
- Persistent buff bar — bottom-right HUD widget that counts down in real time
- Kill notification HUD — top-center banner with tier color, reward item list, and next-threshold progress
- Streak-break HUD — separate panel shown to the player who ends someone's streak (no UI conflict)
- Victim notification — targeted chat message when killed by a streaking player
- Server-wide announcements for streak milestones and streak breaks
- Anti-abuse system — same-victim chain protection, attacker-must-be-alive check
- Speed buff anti-cheat bypass — suppresses FlyHack / SpeedHack false positives for buffed players
- Admin commands — reset, reload config, and simulate any reward tier
PERMISSIONS
rhgkillstreakrewards.admin — Access to /ks.reset, /ks.reload, /ks.test
Grant with:
oxide.grant user <name/steamid> rhgkillstreakrewards.admin
oxide.grant group admin rhgkillstreakrewards.admin
COMMANDS
Player Commands:
/ks — Show your active streak count and buff status
Admin Commands:
/ks.reset <name|steamid> — Reset a player's streak and buff
/ks.reload — Reload config without restarting the server
/ks.test <name|steamid> <threshold> — Simulate a reward tier
Valid thresholds for /ks.test: 3, 5, 8, 10, 12, 15, 20
RHG PLAYER INTELLIGENCE INTEGRATION (OPTIONAL)
If RHGPlayerIntelligence is loaded, GiveReward applies the following rules:
Toxic / Griefer / Menace → NO reward (behavior record blocks streak rewards)
RiskScore > 70 → Reward amount x0.50 (halved)
Veteran / Trusted → Reward amount x1.20 (+20% bonus)
Survivor / Hunter → Reward amount x1.10 (+10% bonus)
Others → Normal reward
None of these rules apply if the core is not loaded — the plugin works normally.
Additionally, if RHGEventIntelligence starts an active event, a multiplier is applied via the KSR_SetEventMultiplier hook, increasing reward amounts for the event duration.
DEFAULT REWARD TIERS
3 kills — Bronze — 50 Scrap, 100 Metal Frags, 50 Rifle Ammo — +5% Outgoing Damage — 30s
5 kills — Silver — 150 Scrap, 200 HQ Metal Ore, 1x Python — +10% Outgoing Damage — 45s
8 kills — Gold — 300 Scrap, 500 Sulfur Ore, 1x C4 — -15% Incoming Damage — 60s
10 kills — Platinum — 500 Sulfur, 300 Metal Frags, 2x Syringe — +15% Movement Speed — 25s
12 kills — Diamond — 400 Scrap, 500 HQ Ore, 1x AK-47 — +12% DMG / -10% INC — 50s
15 kills — Master — 600 Scrap, 3x Large Medkit, 5x HV Rocket — +15 HP per Kill (Vampire) — 40s
20 kills — Legend — 1000 Scrap, 1000 Sulfur, 5x C4, 1x Rocket Launcher — +20% DMG / -20% INC / +10% SPD / 10 HP/Kill — 90s
All items and buff values are fully customizable in the config.
CONFIGURATION
Default config path: oxide/config/RHGKillstreakRewards.json
Rewards[].Kills — Kill count that triggers this tier
Rewards[].TierColor — RGBA color of the HUD panel for this tier
Buff.OutgoingDamageMultiplier — Multiplier on damage dealt (1.10 = +10%)
Buff.IncomingDamageMultiplier — Multiplier on damage received (0.85 = -15%)
Buff.SpeedMultiplier — Movement speed multiplier (1.15 = +15%)
Buff.HealPerKill — HP restored on each kill while buff is active
AntiAbuse.MinSecondsSameVictim — Cooldown before the same victim can be counted again
Announce.StreakBreakMinKills — Minimum streak needed to trigger a streak-break broadcast
UI.BuffBarAnchorMin/Max — Screen position of the persistent buff countdown bar
STREAKS RESET WHEN
- Player dies (respawn hook)
- Player disconnects
- Admin runs /ks.reset
ANTI-CHEAT NOTE
When a player has an active speed buff, the plugin automatically suppresses FlyHack and SpeedHack anti-hack violations for that player via OnPlayerViolation. The effect is minor (+10-15% speed) and ceases immediately when the buff expires.
LOCALIZATION / TEXT
All broadcast and chat messages use {player} as the name placeholder in AnnounceText. All UI text and messages are in English and configurable directly in the source or config.
CHANGELOG
v1.2.0
- RHG Player Intelligence integration (optional)
- Toxic / Griefer / Menace tag: streak reward fully blocked
- RiskScore > 70: reward x0.50
- Veteran / Trusted: reward x1.20
- Survivor / Hunter: reward x1.10
- KSR_SetEventMultiplier API hook added (called by RHGEventIntelligence)
- KSR_ClearEventMultiplier and KSR_GetStreak API hooks added
- PI null-guard: all PI logic skipped when core is not loaded
v1.1.0
- Added 4 new tiers: 10 (speed), 12 (combined), 15 (vampire), 20 (legend)
- Added SpeedMultiplier and HealPerKill buff types
- Added persistent buff countdown bar (RHGKS.BUFF) with 1-second refresh
- Redesigned kill notification HUD with tier-colored panels and item list
- Added streak-break HUD (RHGKS.SBREAK) — separate element, no conflict with kill HUD
- Added victim notification on kill
- Added server-wide streak-break broadcast
- Fixed PreventSameVictimChain flag being ignored
- Fixed RequireAttackerAlive never being checked
- Fixed ClearState leaking BuffBarTimer on disconnect
- Fixed /ks.reset help text
v1.0.2
- Initial public release
AI DISCLOSURE
This plugin was developed with the assistance of AI tools (GitHub Copilot / Claude). All logic, configuration defaults, balancing decisions, and final code were reviewed and verified by a human author before release.