Killstreaks Plugin for Hytale

A powerful killstreak reward system for Hytale servers. Players earn awesome rewards as they get consecutive kills without dying!

What Does This Plugin Do?

When players kill other players, they build up a "killstreak". As they reach certain kill counts, they unlock rewards like:

• Weapons and armor
• Speed boosts
• Health regeneration
• Stamina restoration
• And more!

When a player dies, their streak resets to zero and they lose their active buffs.

Features

• Tiered Rewards - Create as many tiers as you want with custom kill requirements
• Multiple Reward Types - Give items, speed boosts, healing, stamina regen, and more
• Repeating Buffs - Set up rewards that tick every few seconds (like health regen every 3 seconds)
• Until Death Rewards - Some rewards can last until the player dies (even if they log out and back in!)
• Chat Prefixes - Show the player's current tier in chat: [Berserkr] PlayerName: hello
• Chat Suffixes - Show the player's all-time best killstreak: PlayerName[30]: hello
• Custom Icons - Each tier can have its own icon in the rewards menu
• Leaderboards - See who has the best killstreaks with /ks top
• Easy Configuration - Change everything in a simple text file

Quick Start

1. Put Killstreaks-1.1.0.jar in your server's mods/ folder
2. Start the server - it creates a default config automatically
3. Play! Get 3 kills to unlock your first tier
4. Type /ks rewards to see all available tiers

Commands

Files and Folders

Everything is stored in plugins/killstreaks/:

plugins/killstreaks/
├── config.properties        <- All your settings go here!
├── data.properties          <- Stores all-time best killstreaks
└── active_rewards.properties <- Tracks active "until death" rewards

config.properties

This is where you set up everything - tiers, rewards, colors, and more.

data.properties

This file automatically saves each player's best killstreak ever. You don't need to edit this.

active_rewards.properties

This tracks rewards that last "until death" so they survive even if the player logs out.

Configuration Guide

Open plugins/killstreaks/config.properties in any text editor.

General Settings

These control the whole plugin:

Example:

enabled=true
broadcast.chat=true
broadcast.title=true
theme.name=Nordic
debug.logging=false

Tip: Set debug.logging=false on live servers to reduce console spam!

Chat Prefix Settings

The prefix shows the player's CURRENT tier name in chat. It disappears when they die.

What it looks like: [Berserkr] PlayerName: hello everyone

Chat Suffix Settings

The suffix shows the player's ALL-TIME BEST killstreak. It NEVER resets!

What it looks like: PlayerName[30]: hello everyone

Both together: [Berserkr] PlayerName[30]: hello everyone

Creating Tiers

Each tier uses the format tier.X.property where X is the tier number (1, 2, 3, etc).

Basic Tier Settings

Every tier needs these:

Example - A basic tier:

tier.1.kills=3
tier.1.name=Kringla
tier.1.meaning=Circle/Beginning
tier.1.color=#C0C0C0
tier.1.description=Random Copper Weapon

Giving Items

Give players weapons, armor, or other items!

Example - Give a random copper weapon:

tier.1.items=Weapon_Sword_Copper,Weapon_Axe_Copper,Weapon_Mace_Copper
tier.1.itemQuantity=1

Example - Give 2 pieces of adamantite armor:

tier.6.items=Armor_Adamantite_Chest,Armor_Adamantite_Head,Armor_Adamantite_Legs
tier.6.itemQuantity=2

Giving Buffs (Commands)

Buff players with speed, healing, or stat restoration!

Available commands:

• speed {player} 1.2 - Make player 20% faster (1.0 = normal)
• heal {player} 5 - Heal 5 health
• restore {player} <stat> <amount> - Restore a specific stat

Available stats for restore command:

The {player} part gets replaced with the player's name automatically!

Example: One-Time Speed Boost

Speed boost that lasts 3 minutes:

tier.2.commands=speed {player} 1.1
tier.2.commandInterval=0
tier.2.commandDuration=180

• commandInterval=0 means "run once" (not repeating)
• commandDuration=180 means it lasts 180 seconds (3 minutes)

Example: Repeating Health Regen

Heal 3 HP every 5 seconds for 5 minutes:

tier.4.commands=heal {player} 3
tier.4.commandInterval=5000
tier.4.commandDuration=300

• commandInterval=5000 means "every 5000 milliseconds" (5 seconds)
• commandDuration=300 means "for 300 seconds total" (5 minutes)

Example: Until Death Buffs

Speed, healing, AND stamina that lasts until the player dies:

tier.5.commands=speed {player} 1.3;heal {player} 5;restore {player} stamina 10
tier.5.commandInterval=5000
tier.5.commandDuration=0
tier.5.untilDeath=true

• Multiple commands are separated by ;
• untilDeath=true means it lasts until they die (even if they log out!)
• commandDuration=0 when using untilDeath (duration doesn't matter)

Custom Icons

Set a custom icon for each tier in the /ks rewards menu:

Example:

tier.6.iconItemId=Armor_Adamantite_Head

Tip: If you don't set an icon, the first item from tier.X.items is used automatically!

Complete Tier Example

Here's a fully configured tier with everything:

# Tier 6: Ragnarok - The ultimate tier!
tier.6.kills=30
tier.6.name=Ragnarok
tier.6.meaning=Twilight of Gods
tier.6.color=#FFD700
tier.6.description=Full God Mode until death

# Give 2 pieces of Adamantite gear
tier.6.items=Armor_Adamantite_Chest,Armor_Adamantite_Head,Armor_Adamantite_Legs,Armor_Adamantite_Hands
tier.6.itemQuantity=2

# Buffs that repeat every 3 seconds until death
tier.6.commands=speed {player} 1.5;heal {player} 10;restore {player} stamina 15
tier.6.commandInterval=3000
tier.6.commandDuration=0
tier.6.untilDeath=true

# Custom icon in the menu
tier.6.iconItemId=Armor_Adamantite_Head

Color Codes

Use hex color codes for all colors. Here are some popular ones:

Important: Always put # before the color code in the config file!

Default Tiers (Nordic Theme)

The plugin comes with these tiers pre-configured:

Feel free to change these or add your own!

Tips and Tricks

1. Test Before Going Live - Use /ks testreward <tier> <playername> to test rewards
2. Turn Off Debug Logs - Set debug.logging=false on production servers
3. Balance Your Tiers - Start with small rewards, make high tiers really powerful
4. Use Until Death Sparingly - Save it for high kill counts (15+) to keep it special
5. Reload Without Restart - Use /ks reload after editing the config

Troubleshooting

Chat prefix not showing?

• You need at least 3 kills to reach the first tier

Rewards not working?

• Check that enabled=true in the config
• Use /ks testreward to test manually
• Set debug.logging=true and check console for errors

Wrong icon showing?

• Make sure iconItemId uses the exact item ID from the game
• The property name is lowercase: iconItemId (not IconItemId)

Config not loading?

• Check for typos in property names
• Make sure every line has an = sign
• Use /ks reload after making changes

Need Help?

• Type /ks help in-game for command help
• Check the console for error messages (set debug.logging=true)
• Make sure your config file has no typos

Version: 1.1.0
Requires: Hytale Server