✦ Infinity Gauntlet Plugin ✦

A Marvel-themed Minecraft Plugin for Spigot 1.20.4

---

📦 Installation

Requirements

• Spigot / Paper 1.20.4
• Java 17+

Building from Source

# 1. Install Spigot API locally (first time only)
mkdir ~/spigot-build && cd ~/spigot-build
curl -o BuildTools.jar https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar
java -jar BuildTools.jar --rev 1.20.4

# 2. Install the API to local Maven cache
mvn install:install-file \
  -Dfile=~/spigot-build/Spigot/Spigot-API/target/spigot-api-1.20.4-R0.1-SNAPSHOT.jar \
  -DgroupId=org.spigotmc \
  -DartifactId=spigot-api \
  -Dversion=1.20.4-R0.1-SNAPSHOT \
  -Dpackaging=jar

# 3. Build the plugin
cd InfinityGauntlet
mvn package

# 4. Copy the jar to your server
cp target/InfinityGauntlet-1.0.0.jar /path/to/server/plugins/

---

✦ THE 6 INFINITY STONES

Each stone is found inside a lore-accurate structure and can be used individually OR inserted into the Infinity Gauntlet for amplified powers.

Stone	MCU Artifact	Structure	Individual Power
💠 Space	Tesseract	Norse Temple (snow, blue beacon)	Teleport 50 blocks (look direction)
💛 Mind	Scepter	Dark Blackstone Chamber	Charm nearest hostile mob for 5s
❤ Reality	Aether	Svartalfheim Dark Elf Ruins	Transform blocks in 5-block radius
💜 Power	Orb	Morag Underground Vault	Devastating energy explosion + knockback
💚 Time	Eye of Agamotto	Kamar-Taj Sanctum Library	Haste/regen for player, slow nearby enemies
🧡 Soul	Soul Stone	Vormir Sacrificial Cliff	Drain life from all nearby mobs → heals you

---

🥊 THE INFINITY GAUNTLET

Crafting Recipe (Default)

[Gold] [Gold] [Gold]
[Gold] [Diam] [Gold]
[ -- ] [Gold] [ -- ]

The recipe is fully configurable via the GUI editor! /recipeedit

How to Use

1. Craft or obtain the Gauntlet with /gauntlet give
2. Right-click while holding the Gauntlet to open the Stone Manager GUI
3. Drag & Drop stones from your inventory into their colored slots
4. Click an inserted stone in the GUI to remove it (it goes back to your inventory)
5. With all 6 stones: Shift + Right-click to perform the SNAP!

The SNAP (All 6 Stones Required)

• Broadcasts a server-wide message
• 50% chance of killing each nearby player (within 100 blocks)
• 50% chance of killing each nearby mob (within 50 blocks)
• Survivors glow briefly
• Drains the wielder's health and applies weakness
• 30 second cooldown

---

⚔ MARVEL ENDGAME ITEMS (Balance Items)

These items let other players compete against a Gauntlet wielder!

Item	Inspired By	Ability
⚡ Iron Man Repulsor	Tony Stark	Fire targeted energy blast (6 dmg + knockback, 1s CD)
⚙ Nano Gauntlet	Stark replica	Passive: absorb 50% damage, reflect 25%
⚡ Mjolnir	Thor	Call lightning strike on target, slow fall while held (3s CD)
⚔ Stormbreaker	Thor	Bifrost beam + 5m cleave (12 dmg, 2s CD)
🛡 Vibranium Shield	Captain America	Throw to stun target (blind + slow, 1.5s CD)
💣 War Machine Cannon	War Machine	Fire explosive bolt (4s CD)
🌀 Quantum Tunnel Device	Ant-Man	Phase/invulnerability for 3 seconds (10s CD)
✦ Chaos Crystal	Scarlet Witch	Levitate all nearby enemies + damage (5s CD)
◎ Sling Ring	Doctor Strange	Teleport to your bed/spawn (30s CD)
⚔ Vibranium Spear	Okoye	Life steal: heals 30% of damage dealt
⚔ Thanos' Double-Blade	Thanos	+15 dmg, ignores 50% of armor

---

🏛 STRUCTURES

Each structure is themed after the MCU location where each stone was found:

Stone	Location	Structure Details
Space	Norway/Asgard	Stone brick Norse temple, snow floor, blue beacon, blue glass altar
Mind	Thanos ship	Enclosed gilded blackstone chamber, gold altar, soul torches
Reality	Svartalfheim	Broken deepslate ruins, cracked pillars, magma/red glass Aether pool
Power	Morag	Underground purpur vault, purple pillars, magma traps in corners
Time	Kamar-Taj	Sandstone sanctum, bookshelf walls, enchanting table, sea lantern altar
Soul	Vormir	Red sandstone cliff plateau, soul sand shrine, obsidian monoliths, soul fire

Each structure contains a chest with the corresponding Infinity Stone inside.

Spawn structures with:

• /spawnstructure <STONE> — at your current location
• /spawnstructure ALL — spawns all 6 spaced 30 blocks apart

---

💬 COMMANDS

Command	Permission	Description
/gauntlet	infinitygauntlet.admin	Main command + subcommands
/gauntlet give	admin	Give yourself the Infinity Gauntlet
/gauntlet stones	admin	List all stone give commands
/gauntlet structures	admin	Info on all structures
/gauntlet recipe	admin	Info on the crafting recipe
/givestone <player> <stone|ALL>	admin	Give a specific stone or all 6
/giveitem <player> <item|ALL>	admin	Give a Marvel weapon/device
/recipeedit	admin	Open the Gauntlet recipe editor GUI
/spawnstructure <stone|ALL>	admin	Spawn a stone structure at your location

---

⚙ CONFIG

config.yml controls:

• Gauntlet recipe (also editable live via /recipeedit)
• Per-stone cooldowns
• Power multipliers
• Structure settings

---

📁 File Structure

InfinityGauntlet/
├── pom.xml
└── src/main/
    ├── resources/
    │   ├── plugin.yml
    │   └── config.yml
    └── java/com/marvel/infinitygauntlet/
        ├── InfinityGauntletPlugin.java      ← Main class
        ├── items/
        │   ├── InfinityStone.java           ← 6 stone definitions
        │   └── MarvelItem.java              ← 11 Marvel weapons/devices
        ├── managers/
        │   ├── StoneManager.java            ← Stone ItemStack creation & NBT
        │   ├── GauntletManager.java         ← Stone insert/remove/lore update
        │   ├── RecipeManager.java           ← Configurable crafting recipe
        │   ├── StructureManager.java        ← 6 lore-accurate structures
        │   ├── MarvelItemManager.java       ← Marvel weapon ItemStack creation
        │   └── CooldownManager.java        ← Per-player per-ability cooldowns
        ├── gui/
        │   ├── GauntletGUI.java            ← Stone drag-drop management GUI
        │   └── RecipeEditorGUI.java        ← Live recipe editor GUI
        ├── listeners/
        │   ├── GauntletListener.java       ← Gauntlet right-click + snap
        │   ├── StoneListener.java          ← Individual stone powers
        │   ├── MarvelItemListener.java     ← All Endgame weapon abilities
        │   └── StructureListener.java      ← Structure protection (expandable)
        └── commands/
            ├── GauntletCommand.java
            ├── GiveStoneCommand.java
            ├── GiveItemCommand.java
            ├── RecipeEditCommand.java
            └── SpawnStructureCommand.java

---

🎮 GAMEPLAY FLOW

Explore world → Find structure → Loot stone from chest
      ↓
Craft Infinity Gauntlet (or get from admin)
      ↓
Right-click Gauntlet → Open Stone Manager GUI
      ↓
Drag stones from inventory into colored slots
      ↓
With all 6: Shift+Right-click → SNAP!

Other players fight back using Marvel Endgame weapons (balanced via cooldowns and targeted powers).

---

"Perfectly balanced, as all things should be."