Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/thomasugh/compoundv

A Minecraft Paper Plugin that adds superpowers from The Boys universe Compound V, Temp V & V One
https://github.com/thomasugh/compoundv

compound compoundv maven maven-plugin paper paper-plugin superhero-plugin theboys

Last synced: 6 days ago
JSON representation

A Minecraft Paper Plugin that adds superpowers from The Boys universe Compound V, Temp V & V One

Awesome Lists containing this project

README 

          


Logo



# 🧪 CompoundV



### *Inject the powers of* The Boys *into Minecraft.*



[![Minecraft](https://img.shields.io/badge/Minecraft-1.21.x-62B47A?style=for-the-badge&logo=minecraft&logoColor=white)](https://www.minecraft.net/)

[![Paper](https://img.shields.io/badge/Paper-F7E7CE?style=for-the-badge&logo=paper&logoColor=black)](https://papermc.io/)

[![Java](https://img.shields.io/badge/Java-21-ED1C24?style=for-the-badge&logo=openjdk&logoColor=white)](https://adoptium.net/)






---



> Most heroes don't get their powers in a lab.

> On your server, they will. **One bottle at a time.**



CompoundV is a modular ability plugin inspired by *The Boys*. Players drink experimental serums to roll for super powers — from flight and heat vision to a one-shot chest beam that vaporizes anyone in its path. Every ability has real controls, real cooldowns, and real consequences.






🧪 **Drink. Pray. Survive.** 🧪






---



## 🧪 The Serums



| Serum | Color | What it does |

| :-: | :-: | :-- |

| **Compound V** | 💙 | The classic. Random ability, permanent until death. Heroes are extremely rare. |

| **Temp V** | 💚 | A weaker, time-limited dose. Power fades after a configurable duration. |

| **V One** | 🩵 | The refined formula. Only rolls top-tier abilities. |

| **Anti V** | ❤️ | The cure. Drink to remove your current ability. |

| **V-Null Virus** | 🟣 | A bio-weapon. Infects and strips abilities from Compound V / Temp V / V One users on hit. |



> 🖱️ **Right-click** a bottle to drink. After a short activation, your power is unlocked.



All serums are crafted at the **workbench** using a chain of ingredients. Use `/cv tutorial` to receive the in-game handbook with every crafting step.



---



## 🦸 The Abilities



### 🔵 Compound V Pool



🔴 The Patriot — like Homelander





The face of Vought. Untouchable, arrogant, absolutely lethal. **Compound V's rarest roll** — the **V One variant** is even stronger.



- ✈️ **Permanent flight** — automatic, no toggle

- 🔥 **Heat Vision** — press **F** to toggle a high-damage eye beam with overheat system

- 👁️ **X-Ray** — **Sneak + Right-Click** to reveal nearby entities through walls

- 🚀 **Jump Start** — **Sneak**, look up, then **Jump** to launch yourself skyward

- 💥 **Sonic Boom Landing** — fall from 30+ blocks for a devastating impact explosion

- 💪 Permanent **Strength III**, **Resistance II**, **Regeneration** & **+10 bonus hearts**



> 🩸 *V One variant adds Strength IV, Resistance III, fire resistance, faster flight and a stronger Jump Start.*



🌊 The Diver — like The Deep





Ridiculous in every setting except water — where he's genuinely terrifying.



- 🐬 Extreme underwater speed with Dolphin's Grace and water-only movement boost

- 📡 **Sonar** — **Sneak + Right-Click** to ping and reveal nearby entities through walls

- ⚔️ Bonus Strength and Resistance while submerged



🏃 The Runner — like A-Train





The fastest man alive. Don't stand on the tracks.



- ⚡ **Speed stages** scaling up to top velocity — press **F** to toggle

- 💥 High-speed **impact damage** on collision with entities

- 🧊 Special movement buffs when sprinting over water



🦘 Jumper





- 💪 Passive **Strength I**

- 🦘 Press **F** — activates **Jump Boost V** and temporary fall damage immunity

- ⏱️ 15 second cooldown



💥 Shockwave





- 💪 Passive **Strength II**, **Resistance I**

- 💥 Press **F** — releases a 10-block pressure wave with heavy knockback (3 hearts vs players, 6 vs mobs)

- ⚡ Critical hits trigger **mini shockwaves** automatically

- ⏱️ 2 minute cooldown



⚡ Speedster





Press **F** to toggle **Speed IV**. Small Resistance bonus while sprinting. Outrun anything that breathes.



💪 Super Strength





Permanent **Strength III** and Resistance bonus. No toggle, no cooldown. You just hit harder. Forever.



👻 The Ghost — like Translucent





- Press **F** to activate Ghost Mode (**Invisibility II** + Resistance + Strength)

- 🔥 Passive **Fire Resistance**

- 🛡️ Immune to Heat Vision damage while invisible

- 🐺 Mobs stop targeting you while Ghost Mode is active

- ⏱️ 5 second toggle cooldown



♨️ Fire





Passive ring of fire ignites nearby enemies automatically. Comes with Fire Resistance.



✈️ Flight





Simple, clean, permanent creative-style flight. Includes a basic Jump Start.



🔥 Heat Vision I / II / III / IV





Four separately rollable tiers of eye-laser. Color indicates tier: blue → green → orange → red.



- Press **F** to toggle

- **Overheat system**: extended use triggers a cooldown. Toggle off early to reset the timer.

- Cooks raw mob drops on kill · clears vegetation in the beam path



👁️ Vision (X-Ray)





**Sneak + Right-Click** to reveal entities through walls with a glowing effect.



🌀 Teleporter





Short-range blink ability. V One upgrade available for longer range and reduced cooldown.



📏 Size Changer





- **Sneak + Left-Click looking up** → Giant form (2x size, +10 hearts, double melee, Jump Boost II)

- **Sneak + Left-Click looking down** → Tiny form (~3.5x smaller)

- Cooldown starts after returning to normal size

- V One upgrade available with stronger bonuses



🪱 The Worm





- ⛏️ Permanent **Haste IV** — mine through anything

- 👁️ Press **F** to toggle **Night Vision**

- 💪 Passive Strength I, Resistance I



💡 Flash Light





- 💪 Passive Strength II, Resistance I

- 💡 Press **F** — 15-block **Blindness burst** affecting all nearby entities

- 🔦 **Sneak + Left-Click** — focused light beam attack



🔥 FireSonic





- 🔥 Passive Fire Resistance, Strength I, Resistance I

- Press **F** — toggles a close-range **fire beam** dealing tick damage

- Melee hits apply fire pressure on every hit



☠️ Toxic Cloud





- 🧪 Permanent **Poison Immunity**

- Press **F** — releases a **poison gas cloud** around you

- **Sneak + Left-Click** — short-range **poison vomit** targeting entities in front



🔥 The Countess — like Crimson Countess





- 🔥 Passive Fire Resistance, Strength II, Resistance I

- Press **F** — launches a **fireball**

- Double jump activates a **fire jump boost** mid-air

- Melee hits apply burn damage



⚔️ The Warrior — like Queen Maeve





- 💪 Passive Strength III, Resistance II, Regeneration I, **+10 bonus hearts**

- Double jump available mid-air

- Landing from height triggers a **small shockwave**



💀 The Headpopper — like Victoria Neuman





- 💪 Passive Strength II, Resistance II, Regeneration I

- **Sneak + Right-Click** — locks a red mark on the target; hold sneak to trigger a countdown and heavy damage (release sneak to cancel)

- Press **F** — area pulse hitting all nearby entities

- Immune to Heat Vision



🕷️ SpiderWeaver





- 💪 Passive Strength I, Resistance I, Regeneration I

- Press **F** — fires a **web projectile** that traps entities in cobwebs

- **Sneak + Left-Click** — places a **cobweb trap** at your location

- 🧗 **Wall climbing** — hold sneak while touching a wall to climb



💣 The Detonator — like Naqib





- 🔥 Passive Fire Resistance, Strength II, Resistance I

- **Sneak (hold)** — charges a countdown, releases a **large explosion** centered on yourself

- Self-damage protection active during the explosion

- Every **3rd melee hit** triggers an **explosive strike**

- Melee hits apply fire damage



---



### 🩵 V One Exclusives



🟡 The Veteran — like Soldier Boy





The original supe. Pissed off, off the grid, and packing nuclear-grade firepower in his chest.



- 💪 Passive **Strength V**, **Resistance III**

- ☢️ **Chest Beam** — **Sneak + Right-Click** charges and fires a thick yellow energy beam

  - Tears through blocks · ignites everything · melts mobs

  - **Strips abilities from any supe it hits** — even another Patriot

- 💥 **Ground Zero** — massive visual shockwave on cast

- ⏱️ 45 second cooldown



🔵 Sonic Boom — like Bombsight





- 💪 Passive Strength IV, Resistance IV, **+10 bonus hearts**, projectile immunity

- ✈️ Electric flight at 3x speed with a powerful jump start

- **Sneak + Left-Click** — fires a **Sonic Beam** (Warden-style, 3s cooldown)

- Press **F** / offhand switch — launches a **Sonic Ring** (30s cooldown) with knockback and area damage

- 💥 Explosive landing from height (30s cooldown)



⚡ Stormstrike — like Stormfront





- 💪 Passive Strength, Resistance, extra hearts

- ✈️ Electric flight with lightning jump-start particles

- Press **F** — toggles a **lightning beam** dealing tick damage in a wide arc

- Melee hits trigger **real lightning strikes** on the target

- Fall impact calls **4 visible lightning effects**



💛 Heal Angel — like Private Angel





- 💪 Passive Strength II, Resistance II, Regeneration II, **+5 bonus hearts**

- **Sneak + Left-Click** — **heals** a nearby entity (min 1 heart, 1s cooldown)

- Press **F** — **commands** a nearby mob to follow and protect you (they won't attack their owner)



🌊 Submarine





A supercharged aquatic fighter — The Diver's true evolution.



- 💪 Double Strength and Resistance bonuses while submerged

- 📡 **Sneak + Left-Click** — extended **Sonar** pulse revealing entities through terrain

- Press **F** — powerful **Riptide Dash** (1s cooldown) for underwater combat mobility



---



## 🎮 Ability Controls — Quick Reference



| Action | Input |

| :-- | :-: |

| Toggle ability (Heat Vision, Speedster, Ghost Mode, Beams…) | **F** *(swap offhand)* |

| Secondary ability / Special attack | **Sneak + Left-Click** |

| Special ability 2 / X-Ray / Chest Beam | **Sneak + Right-Click** |

| Jump Start *(Patriot, Sonic Boom, Stormstrike…)* | **Sneak + look up + Jump** |

| Double Jump *(Countess, Warrior…)* | **Jump** while in the air |

| Wall Climb *(SpiderWeaver)* | **Sneak** while touching a wall |

| Drink a serum | **Right-Click** with bottle in hand |



> 📖 Run `/cv tutorial` in-game to receive a full written handbook with every crafting chain and control reference.



---



## 📋 Commands & Permissions



📜 Commands





Main command: `/compoundv` — alias: `/cv`



| Command | Description | Permission |

| :-- | :-- | :-: |

| `/cv help` | Show in-game help | everyone |

| `/cv info [player]` | View your or another player's active ability, version and plugin stats | everyone / admin |

| `/cv tutorial` | Receive the in-game crafting & ability handbook | everyone |

| `/cv give  bottle ` | Give a serum bottle | admin |

| `/cv give   [potionType]` | Directly assign an ability | admin |

| `/cv remove ` | Strip a player's ability | admin |

| `/cv reload` | Reload config and language files | admin |



> Aliases for `/cv tutorial`: `/cv guide`, `/cv book`



🔑 Permissions





| Permission | Default | Description |

| :-- | :-: | :-- |

| `compoundv.use` | `true` | Drink serums and use abilities |

| `compoundv.admin` | `op` | Access to all `/cv` admin commands |



---



## ❓ FAQ



💀 What happens when I die with an ability?





By default, you lose it. Same risk Vought's heroes never had — and exactly what makes serums valuable and PvP genuinely tense.



⏱️ How long do Temp V abilities last?





The duration is rolled per drink between `min_duration_minutes` and `max_duration_minutes` (default: 15–120 min). When the timer runs out, the ability fades automatically.



🎲 Why is The Patriot so rare?





By design. Default weight is `1` against a combined pool of ~100+, so expect many bottles per Patriot roll. Tweak the weight in `config.yml` if you want him more common.



🧪 Can two players have the same ability?





Yes. Every drink rolls independently — there's no global lock.



🔧 Can I disable abilities or change roll chances?





Yes. Set any ability's chance to `0` in `config.yml` to disable it, or adjust the number to influence roll frequency. Run `/cv reload` to apply without restart.



🌍 What languages are supported?





English, German, Spanish, French, Hindi, Turkish, Russian and Simplified Chinese ship out of the box. Set `language: en` (or `de`, `es`, `fr`, `hi`, `ru`, `zh`) in `config.yml`. Drop a custom file into `plugins/CompoundV/lang/` to add more.



---



## 📜 Credits






Created by **Thomas U.**



Inspired by *The Boys* (Amazon Prime Video / Garth Ennis & Darick Robertson).

This is a **fan-made, non-commercial project** and is not affiliated with, endorsed by, or sponsored by

Amazon, Sony Pictures Television, or the rights holders of *The Boys*.

All trademarks belong to their respective owners.



All character archetype names in-game *(The Patriot, The Veteran, etc.)*

are original references — no trademarked names are used.