English

kildtoken is a Paper plugin for Minecraft designed to add a simple but controlled PvP-based currency system. Whenever one player kills another player, a custom item called a Kill Token is dropped at the victim’s death location. By default, this item is a Nether Star with a custom name and lore, so it is clearly recognizable as a special currency item instead of a normal drop.

How it works

The plugin listens to player death events and checks whether the killer is another player. If that is the case, it spawns the configured currency item directly at the death location. The item includes fixed metadata such as name and lore, which makes sure the token always looks the same and is easy to identify on the server.

Anti-farming system

To prevent abuse and farming between the same players, the plugin uses a pair-based cooldown system. When Player A kills Player B, a cooldown of one minute is applied to this exact player pair. During that time:

• Player A killing Player B again will not drop a token
• Player B killing Player A again will also not drop a token

This prevents players from farming tokens from each other. The cooldown only applies to that specific pair and does not affect kills involving other players. For example, if Player A kills Player C, a token will still drop normally.

Currency customization

The currency can be changed dynamically with the command:

/killtoken set

When this command is used, the item currently held in the player’s main hand becomes the new currency item. From that point on, all future token drops will use this item instead of the default Nether Star. This allows the server owner to freely define the economy item without changing the code.

Deutsch

kildtoken ist ein Paper-Plugin für Minecraft, das ein einfaches, aber kontrolliertes PvP-Währungssystem einführt. Immer wenn ein Spieler einen anderen Spieler tötet, wird ein spezielles Item namens Kill Token am Todesort gedroppt. Standardmäßig ist dieses Item ein Netherstern mit individuellem Namen und Lore, damit es sich klar von normalen Items unterscheidet.

Funktionsweise

Das Plugin reagiert auf Spieler-Todes-Events und prüft, ob ein anderer Spieler der Killer war. Wenn das der Fall ist, wird das konfigurierte Währungs-Item direkt am Todesort gespawnt. Das Item enthält feste Metadaten wie Name und Lore, sodass der Token immer gleich aussieht und auf dem Server leicht zu erkennen ist.

Anti-Farming-System

Damit Spieler nicht miteinander Tokens farmen können, nutzt das Plugin ein paarweises Cooldown-System. Wenn Spieler A Spieler B tötet, wird für genau dieses Spielerpaar ein Cooldown von einer Minute gesetzt. Während dieser Zeit gilt:

• Wenn Spieler A erneut Spieler B tötet, droppt kein Token
• Wenn Spieler B erneut Spieler A tötet, droppt ebenfalls kein Token

So wird verhindert, dass Spieler sich gegenseitig Tokens farmen. Der Cooldown gilt nur für dieses konkrete Paar und beeinflusst keine anderen Kills. Wenn Spieler A zum Beispiel Spieler C tötet, droppt dort ganz normal wieder ein Token.

Währungs-Anpassung

Die Währung kann dynamisch mit folgendem Befehl geändert werden:

/killtoken set

Dabei wird das Item in der Main-Hand des Spielers als neue Währung festgelegt. Alle zukünftigen Token-Drops verwenden dann dieses Item anstelle des Standard-Nethersterns. Dadurch kann der Server die Währung frei anpassen, ohne den Code zu verändern.