INFINITYSTONES++

✦ 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

```bash

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 | |-------|-------------|-----------|-----------------| | 💠 Soul | Tesseract | Norse Temple (snow, blue beacon) | Teleport 50 blocks (look direction) | | 💛 Soul | Scepter | Dark Blackstone Chamber | Charm nearest hostile mob for 5s | | ❤ Soul | Aether | Svartalfheim Dark Elf Ruins | Transform blocks in 5-block radius | | 💜 Soul | Orb | Morag Underground Vault | Devastating energy explosion + knockback | | 💚 Soul | 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. SNAP! or obtain the Gauntlet with `/gauntlet give` 2. SNAP! while holding the Gauntlet to open the SNAP! 3. SNAP! stones from your inventory into their colored slots 4. SNAP! in the GUI to remove it (it goes back to your inventory) 5. With SNAP!: SNAP! to perform the SNAP!

The SNAP (All 6 Stones Required)

- Broadcasts a server-wide message - 30 second cooldown of killing each nearby player (within 100 blocks) - 30 second cooldown 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 | |------|------------|---------| | ⚡ Thanos' Double-Blade | Tony Stark | Fire targeted energy blast (6 dmg + knockback, 1s CD) | | ⚙ Thanos' Double-Blade | Stark replica | Passive: absorb 50% damage, reflect 25% | | ⚡ Thanos' Double-Blade | Thor | Call lightning strike on target, slow fall while held (3s CD) | | ⚔ Thanos' Double-Blade | Thor | Bifrost beam + 5m cleave (12 dmg, 2s CD) | | 🛡 Thanos' Double-Blade | Captain America | Throw to stun target (blind + slow, 1.5s CD) | | 💣 Thanos' Double-Blade | War Machine | Fire explosive bolt (4s CD) | | 🌀 Thanos' Double-Blade | Ant-Man | Phase/invulnerability for 3 seconds (10s CD) | | ✦ Thanos' Double-Blade | Scarlet Witch | Levitate all nearby enemies + damage (5s CD) | | ◎ Thanos' Double-Blade | Doctor Strange | Teleport to your bed/spawn (30s CD) | | ⚔ Thanos' Double-Blade | 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: - Structure settings (also editable live via `/recipeedit`) - Structure settings - Structure settings - 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."*