Paper plugin for a custom Villain SMP game mode — custom items, combat mechanics & resource pack
Find a file
Luxx fb33077309 Update LICENSE to Creative Commons Attribution-NonCommercial 4.0 International
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-24 14:52:54 +02:00
gradle/wrapper Initial commit: VillainSMP plugin 2026-05-23 22:23:08 +02:00
src/main Release v1.1: dynamic MOTD, server icon, and role-based chat formatting 2026-05-23 23:56:20 +02:00
VillainPack Initial commit: VillainSMP plugin 2026-05-23 22:23:08 +02:00
.gitattributes Initial commit: VillainSMP plugin 2026-05-23 22:23:08 +02:00
.gitignore Initial commit: VillainSMP plugin 2026-05-23 22:23:08 +02:00
build.gradle.kts Initial commit: VillainSMP plugin 2026-05-23 22:23:08 +02:00
CHANGELOG.md Release v1.1: dynamic MOTD, server icon, and role-based chat formatting 2026-05-23 23:56:20 +02:00
gradle.properties Release v1.1: dynamic MOTD, server icon, and role-based chat formatting 2026-05-23 23:56:20 +02:00
gradlew Initial commit: VillainSMP plugin 2026-05-23 22:23:08 +02:00
gradlew.bat Initial commit: VillainSMP plugin 2026-05-23 22:23:08 +02:00
LICENSE Update LICENSE to Creative Commons Attribution-NonCommercial 4.0 International 2026-05-24 14:52:54 +02:00
README.md Update README.md 2026-05-24 08:06:39 +00:00
settings.gradle.kts Initial commit: VillainSMP plugin 2026-05-23 22:23:08 +02:00

VillainSMP

A Paper plugin for a custom Villain SMP game mode on Minecraft 1.21+.

Concept

At the start of the game one random player is chosen as the Villain. All other players are Survivors. The Villain must eliminate every Survivor; Survivors must hunt down and kill all Villains before they are converted.

  • Villain kills Survivor → Survivor becomes a Villain
  • Survivor kills Villain → Villain is eliminated from the game
  • Survivors win when all Villains have been eliminated
  • Villains win when only one Survivor remains

Features

Feature Details
Spawn protection 15-minute grace period at game start — PvP is disabled until it expires
World border Set to 5 000 blocks on game start, resets when the game ends
Villain glow Active Villains permanently glow and have Strength I
Combat tag Ender pearls are disabled for 11 minutes after taking/dealing damage
Cobweb limit Max 64 cobwebs placeable while in combat
Mace limit Only one Mace may exist in the world at a time
Knockback ban Knockback enchantment is restricted to iron-tier weapons and below
Tab list Live header/footer showing game status and remaining spawn-protection time

Custom Items

Amulet

A Totem of Undying variant held in the offhand that grants +10 hearts of max health.

Recipe (crafting table):

N D N
D T D
N D N

N = Netherite Ingot · D = Diamond · T = Totem of Undying


Survivor Potion

Consumed by a Villain to revert themselves back to a Survivor.

Recipe (crafting table):

N B N
E E E
G G G

N = Netherite Ingot · B = Blaze Powder · E = XP Bottle · G = Glass


Cobweb

Craftable tactical cobweb (limited to 64 placements per combat tag).

Recipe: 9× String in a 3×3 grid

Commands

Command Permission Description
/smp start villain.admin Picks a random Villain and starts the game
/smp stop villain.admin Ends the game immediately
/smp skiptimer villain.admin Skips the spawn-protection countdown

Resource Pack

The VillainPack/ folder contains a resource pack that provides custom textures for the Amulet and Survivor Potion. Serve it via your server's resource-pack setting in server.properties.

Requirements

  • Paper 1.21.4+
  • Java 21+

Building

./gradlew build

The plugin jar is output to build/libs/.