**UltimateBliss** is a comprehensive class-based power system plugin for Minecraft servers running paper1.21.11. It introduces a unique **Gem System** where each player possesses one of 8 distinct Gems, each granting unique passive abilities and active skills.

Key Features

| Feature | Description |

|---------|-------------|

| **8 Unique Gems** | Each with 4 abilities and distinct playstyles |

| **Dynamic Energy System** | Power fluctuates based on PvP performance |

| **3-Tier Progression** | Evolve your gem to unlock more abilities |

| **Custom Items** | Upgraders, traders, repair items |

| **Visual Effects** | Particles, sounds, and glow effects |

| **Full GUI System** | Interactive menus for gem selection |

| **Persistent Data** | Uses PDC for reliable data storage |

| **Highly Configurable** | Every value can be customized |

---

Core Concepts

How It Works

```

┌─────────────────────────────────────────────────────────────┐

│ ULTIMATEBLISS FLOW │

├─────────────────────────────────────────────────────────────┤

│ │

│ Player Joins → Selects Gem → Uses Abilities → Gains Energy │

│ ↓ ↓ ↓ ↓ │

│ Load Data Open Menu Click Actions Kill Players │

│ ↓ ↓ ↓ │

│ Get Tier 1 Gem Cooldowns +1 Energy │

│ ↓ ↓ ↓ │

│ Upgrade Tier Deal Damage Power Up │

│ ↓ ↓ ↓ │

│ Unlock More Win Fights Max at 10 │

│ Abilities │

│ │

│ Death = -1 Energy → Broken at 0 → Repair at Pedestal │

└─────────────────────────────────────────────────────────────┘

```

The Power Triangle

```

┌──────────────┐

│ GEM TYPE │

│ (Abilities) │

└──────┬───────┘

│

┌────────┴────────┐

▼ ▼

┌──────────────┐ ┌──────────────┐

│ TIER │ │ ENERGY │

│ (Unlocks & │ │ (Power Level │

│ Multiplier) │ │ & Effects) │

└──────────────┘ └──────────────┘

```

---

The 8 Gems - Complete Guide

---

⚡ FLUX GEM

*"Control electrical energy"*

**Theme:** Electricity, lightning, and kinetic energy

**Color:** Yellow

**Icon:** Lightning Rod

Passives

| Passive | Description | Requirements |

|---------|-------------|--------------|

| **Flow State** | Speed and attack speed buffs that increase while running/fighting. Stacks up to 5 levels. Resets when you stop moving. | Always active |

| **Conduction** | Sneak + Left Click on a copper block within 20 blocks to teleport to it with lightning effects. | Sneaking near copper |

| **Tireless** | Complete immunity to Weakness, Slowness, and Hunger effects. | Always active |

| **Shocking Chance** | 15% chance on arrow hit to stun enemy (no movement for 1 second). | Arrow hits |

Active Abilities

|---------|------|------|-------------|----------|

Charge Mechanic

- **Hold Right Click** to charge (visualized on XP bar)

- **0-100%** = Normal charge (3 seconds)

- **100-200%** = Overcharge (additional 2 seconds, XP bar flashes)

- **Release** with F key (swap hands) or stop sneaking

- **Interrupted** if you take damage or switch items

Controls

| Action | Effect |

|--------|--------|

| Right Click (Hold) | Start charging |

| F Key / Stop Sneaking | Release charge |

| Shift + Right Click | Cycle ability selection |

| Shift + Left Click | Conduction teleport |

| Left Click | Cancel charge |

---

🔥 FIRE GEM

*"Harness the power of flames"*

**Theme:** Fire, heat, and destruction

**Color:** Red

**Icon:** Blaze Powder

Passives

| Passive | Description | Requirements |

|---------|-------------|--------------|

| **Fire Resistance** | Permanent immunity to fire and lava damage. | Always active |

| **Ember Trail** | Leave fire particles behind when sprinting. | Sprinting |

| **Heat Aura** | Nearby enemies take small fire damage every 2 seconds and catch fire. 4 block radius. | Always active |

| **Burning Strikes** | Melee attacks set targets on fire for 3 seconds. | Melee hits |

Active Abilities

|---------|------|------|-------------|----------|

Controls

| Action | Effect |

|--------|--------|

| Right Click (Hold) | Charge Fireball |

| F Key | Release Fireball |

| Shift + Left Click | Crisp |

| Shift + Right Click | Toggle Blaze Aura |

---

🗡️ ASTRA GEM

*"Master of shadows and daggers"*

**Theme:** Stealth, assassination, and shadows

**Color:** Dark Purple

**Icon:** Amethyst Shard

Passives

| Passive | Description | Requirements |

|---------|-------------|--------------|

| **Night Vision** | Permanent night vision effect. | Always active |

| **Shadow Cloak** | While sneaking, mobs have 50% reduced chance to target you. Gain brief invisibility. | Sneaking |

| **Backstab** | Deal 50% extra damage when attacking enemies from behind. | Attacking from behind |

Active Abilities

|---------|------|------|-------------|----------|

Controls

| Action | Effect |

|--------|--------|

| Left Click | Throw Dagger |

| Right Click | Toggle Invisibility |

| Shift + Right Click | Activate Phase |

| Shift + Left Click | Shadow Step to target |

---

💚 LIFE GEM

*"Manipulate health and vitality"*

**Theme:** Healing, support, and vampirism

**Color:** Green

**Icon:** Glistering Melon Slice

Passives

| Passive | Description | Requirements |

|---------|-------------|--------------|

| **Natural Regeneration** | Enhanced health regeneration (0.5 hearts every 2 seconds). | Always active |

| **Life Sense** | See nearby players' health on action bar. Warns when allies are low. | Always active |

| **Vitality** | Increased maximum health: +4/+8/+12 HP based on tier. | Always active |

Active Abilities

|---------|------|------|-------------|----------|

Controls

| Action | Effect |

|--------|--------|

| Right Click | Health Share |

| Shift + Right Click | Toggle Heart Lock |

| Shift + Left Click | Regeneration Burst |

| Left Click | Toggle Lifesteal Aura (Tier 3) |

---

🌬️ PUFF GEM

*"Master of air and mobility"*

**Theme:** Air, movement, and flight

**Color:** White

**Icon:** Feather

Passives

| Passive | Description | Requirements |

|---------|-------------|--------------|

| **Feather Fall** | Complete immunity to fall damage. Soft landing particles. | Always active |

| **Air Cushion** | 40% reduced knockback received. | Always active |

| **Glide** | While sneaking in air, slow falling with forward momentum. | Sneaking while airborne |

Active Abilities

|---------|------|------|-------------|----------|

Controls

| Action | Effect |

|--------|--------|

| Right Click (in air) | Double Jump |

| Right Click (on ground) | Cloud Dash |

| Left Click | Updraft |

| Shift + Left Click | Tornado (Tier 3) |

---

⚡ SPEED GEM

*"Lightning fast reflexes"*

**Theme:** Speed, lightning, and time manipulation

**Color:** Aqua

**Icon:** Sugar

Passives

| Passive | Description | Requirements |

|---------|-------------|--------------|

| **Swift** | Permanent Speed I-III based on tier. | Always active |

| **Quick Reflexes** | Increased attack speed (Haste effect). | Always active |

| **Momentum** | Speed increases while sprinting continuously. Stacks up to 5 levels. Bonus damage at max. | Continuous sprinting |

Active Abilities

|---------|------|------|-------------|----------|

Controls

| Action | Effect |

|--------|--------|

| Left Click | Lightning Strike |

| Right Click | Dash |

| Shift + Right Click | Speed Boost |

| Shift + Left Click | Time Slow (Tier 3) |

---

💪 STRENGTH GEM

*"Raw power and tracking"*

**Theme:** Brute force, hunting, and nullification

**Color:** Gold

**Icon:** Blaze Rod

Passives

| Passive | Description | Requirements |

|---------|-------------|--------------|

| **Titan** | Permanent Strength I-III based on tier. | Always active |

| **Armor Piercing** | Attacks ignore 10-30% of enemy armor (based on tier). | Melee attacks |

| **Heavy Hitter** | 30% increased knockback dealt to enemies. | Melee attacks |

| **Combo Damage** | Consecutive hits increase damage. Resets when hit or after 3 seconds. | Continuous combat |

Active Abilities

|---------|------|------|-------------|----------|

Controls

| Action | Effect |

|--------|--------|

| Right Click | Start Power Strike charge |

| Left Click | Release Power Strike (when charged) |

| Shift + Left Click | Nullify |

| Shift + Right Click | Bounty Tracker / Iron Skin |

---

💰 WEALTH GEM

*"Virtual storage and protection"*

**Theme:** Fortune, storage, and item protection

**Color:** Yellow

**Icon:** Gold Ingot

Passives

| Passive | Description | Requirements |

|---------|-------------|--------------|

| **Fortune** | 15-45% chance for double drops from ores and mobs (based on tier). Triple drops possible at Tier 3. | Breaking ores, killing mobs |

| **Miser** | 20-60% chance to prevent durability loss on tools (based on tier). | Using tools |

| **Greed** | 10-30% bonus XP from all sources (based on tier). | Collecting XP |

Active Abilities

|---------|------|------|-------------|----------|

Controls

| Action | Effect |

|--------|--------|

| Right Click | Open Virtual Pocket |

| Left Click | Toggle Item Lock on held item |

| Shift + Right Click | Fortune Boost (Tier 2) |

| Shift + Left Click | Midas Touch (Tier 3) |

---

Energy System

Energy Scale

```

Energy State Effect Visual

──────────────────────────────────────────────────

10 Pristine +5 150% power GLOWING ✨

9 Pristine +4 140% power GLOWING ✨

8 Pristine +3 130% power

7 Pristine +2 120% power

6 Pristine +1 110% power

5 Pristine 100% power ← Starting

4 Scratched 90% power

3 Cracked 80% power

2 Shattered 70% power

1 Ruined 50% power ⚠️ Passives OFF

0 Broken 0% power ❌ ALL OFF

```

Energy Bar Visualization

```

[██████████] = 10 Energy (Pristine +5)

[████████░░] = 8 Energy (Pristine +3)

[█████░░░░░] = 5 Energy (Pristine)

[███░░░░░░░] = 3 Energy (Cracked)

[█░░░░░░░░░] = 1 Energy (Ruined)

[░░░░░░░░░░] = 0 Energy (Broken)

```

Gaining & Losing Energy

| Action | Energy Change |

|--------|---------------|

| Kill a player | +1 |

| Die to a player | -1 |

| Use Reparation Shard | +1 |

| Use Reparation Pedestal | +5 (costs diamonds) |

Broken State

When energy reaches 0:

- ❌ All abilities disabled

- ❌ All passives disabled

- ✅ No death ban

- ✅ Can still play normally otherwise

- 🔧 Must repair at Pedestal or use Reparation Shards

---

Tier System

Tier Comparison

|--------|---------------------|-----------------|-------------------|

| **Damage Multiplier** | 1.0x | 1.25x | 1.5x |

| **Symbol** | [I] | [II] | [III] |

Upgrading Tiers

```

Tier I ──[Gem Upgrader]──> Tier II ──[Gem Polisher]──> Tier III

```

Combined Power Calculation

```

Final Power = Energy Multiplier × Tier Multiplier

Example (Max Power):

Energy 10 (1.5x) × Tier III (1.5x) = 2.25x damage/effect power

Example (Low Power):

Energy 3 (0.8x) × Tier I (1.0x) = 0.8x damage/effect power

```

---

Custom Items

Gem Upgrader

```

┌─────────────────────────────────┐

│ ◆ Gem Upgrader │

│ Material: Amethyst Shard │

│ Function: Tier I → Tier II │

├─────────────────────────────────┤

│ Recipe: │

│ D A D │

│ A E A D = Diamond │

│ D A D A = Amethyst Shard │

│ E = Emerald │

└─────────────────────────────────┘

```

Gem Polisher

```

┌─────────────────────────────────┐

│ ◆ Gem Polisher │

│ Material: Amethyst Cluster │

│ Function: Tier II → Tier III │

├─────────────────────────────────┤

│ Recipe: │

│ N G N │

│ G E G N = Netherite Ingot │

│ N G N G = Gold Block │

│ E = End Crystal │

└─────────────────────────────────┘

```

Gem Trader

```

┌─────────────────────────────────┐

│ ◆ Gem Trader │

│ Material: Ender Eye │

│ Function: Reroll gem type │

│ Note: Keeps tier and energy! │

├─────────────────────────────────┤

│ Recipe: │

│ E P E │

│ P N P E = Ender Eye │

│ E P E P = Ender Pearl │

│ N = Nether Star │

└─────────────────────────────────┘

```

Reparation Shard

```

┌─────────────────────────────────┐

│ ◆ Reparation Shard │

│ Material: Prismarine Shard │

│ Function: +1 Energy │

├─────────────────────────────────┤

│ Recipe: │

│ . D . │

│ D P D D = Diamond │

│ . D . P = Prismarine Shard│

└─────────────────────────────────┘

```

Reparation Pedestal

```

┌─────────────────────────────────┐

│ ◆ Reparation Pedestal │

│ Material: Lodestone (placeable)│

│ Function: Full repair station │

│ Cost: 5 Diamonds per use │

│ Effect: +5 Energy │

│ Cooldown: 5 minutes │

├─────────────────────────────────┤

│ Recipe: │

│ D E D │

│ E L E D = Diamond Block │

│ O O O E = Emerald Block │

│ L = Lodestone │

│ O = Obsidian │

└─────────────────────────────────┘

```

---

Teams Smp