Kill Aura
Configure SoulFire's kill-aura plugin for combat testing with sane ranges, cooldown behavior, whitelist protection, and wall checks.
What this is for
kill-aura is the built-in combat automation plugin that makes a bot look at nearby targets and attack them when they enter the configured ranges.
This is useful for:
- combat testing
- PvP behavior experiments
- checking entity targeting under load
It is not a general-purpose movement or navigation system. It only takes over the parts of control needed for targeting, looking, swinging, and attacking.
What the main settings mean
| Setting | What it controls |
|---|---|
whitelisted-users | Player names that must never be attacked |
look-range | How close a target must be before the bot starts looking at it |
swing-range | How close a target must be before the bot swings its arm |
hit-range | How close a target must be before the bot actually attacks |
check-walls | Whether targets behind walls should be ignored |
ignore-cooldown | Whether to ignore the normal 1.9+ attack cooldown model |
attack-delay-ticks | Extra randomized delay used for pre-1.9 behavior, or when cooldown is ignored |
The important relationship is:
look-rangeshould usually be the largestswing-rangeshould usually be smaller thanlook-rangehit-rangeshould usually be the smallest and most conservative
Enable and tune kill-aura
Enable the plugin
Open Plugins and enable Kill Aura.
Add any protected player names
Fill whitelisted-users first.
If there are names the bot must never target, protect them before you test.
Start with conservative ranges
Use the default ranges first unless you have a strong reason to change them.
Keep wall checks on initially
Leave check-walls enabled until you know you need different behavior.
Test with one bot
Confirm targeting and attack timing with one bot before scaling out.
How the range settings interact
Look range
This controls when the bot begins orienting toward a target.
If it is too small, the bot may react late. If it is too large, the bot may look unnatural or overreact to distant entities.
Swing range
This controls arm swing behavior. It can be larger than hit range so the bot visually starts reacting before an actual attack is possible.
If you set it to 0, swing-only behavior is disabled.
Hit range
This is the real attack threshold. Keep it conservative unless you are explicitly testing edge cases.
If your hit-range is too aggressive, you are more likely to create behavior that is unrealistic or inconsistent with the target environment.
Cooldown and version behavior
kill-aura respects normal attack strength behavior by default.
The plugin adds custom attack delay logic in two situations:
- on protocol versions up to 1.8
- when
ignore-cooldownis enabled
That means attack-delay-ticks matters most when you want older-style or intentionally cooldown-ignoring behavior.
If you leave ignore-cooldown off on modern versions, normal attack readiness remains the safer default.
Wall checks and visibility
With check-walls enabled, the bot avoids attacking targets it should not really be able to reach or see cleanly.
That is the safer choice for realistic testing.
Turn it off only if:
- you are testing a very specific environment
- you understand the tradeoff
- you do not care about natural-looking line-of-sight behavior
Safe tuning workflow
Use this order:
- enable the plugin
- fill
whitelisted-users - leave
check-wallsenabled - test default ranges
- adjust one range at a time
- only then decide whether cooldown changes are necessary
That keeps your changes attributable. If you alter every range and timing value at once, it becomes much harder to understand what actually improved or broke the behavior.
Common failure patterns
The bot looks at targets but does not hit
look-range is large enough, but hit-range is too small or the cooldown timing is preventing an attack.
The bot swings too early
Your swing-range is larger than needed for the environment you are testing.
The bot attacks through unrealistic angles
Check whether check-walls is disabled or your ranges are too aggressive.
Friendly or protected players get targeted
Your whitelisted-users list is incomplete or misspelled.
Set whitelisted-users before testing around real players.
The plugin does exactly what you configure, not what you intended.
Related pages
How is this page?
Last updated on