Theosis — RPG Progression (Apotheosis for Servers)

Theosis is the ultimate plugin reinterpretation of the Apotheosis mod. It brings a deep RPG progression experience to your server without any mods, while fully preserving the vanilla essence.

The gameplay loop is highly addictive: better loot ➔ stronger builds ➔ harder bosses ➔ greater rewards. Everything is fully optimized for servers and 100% configurable.

NOTE:
The plugin works with Spigot, Paper, and Purpur.
However, Paper or Purpur are recommended, as some perks may not function correctly in Spigot (due to technical limitations).

---

⚙️ Plugin Modules

The plugin is divided into independent modules that you can easily toggle on or off in the configuration:

⚔️ perks: true (Item Skills)

All tools and armor pieces can receive unique advantages (perks) that grant special abilities. There are over 100 unique skills distributed across all equipment types in the game!
!

---

💎 gems: true (Gem System)

Players can find sockets and gems within the loot from towers. Gems feature 3 purity levels:

Level I ➔ Level II ➔ Level III

• Upgrading: You can upgrade a gem's tier by combining two gems of the same level inside an anvil (e.g., combining two Level I gems creates a Level II gem).
• Socketing: These gems can be fused into any weapon or armor piece with open slots (sockets) using an anvil. This process costs experience and inflicts wear on the anvil.
  
  

---

🏰 structures: true (Structures)

Enables the generation of custom towers featuring dimension-specific loot tables. The tougher the dimension, the better the rewards.

👑 bosses: true (Boss Encounters)

Bosses are categorized by dimension, and their stats scale dynamically based on the tier of the player fighting them:

• Overworld: SLIME, SKELETON, ZOMBIE, PILLAGER, WITCH
• Nether: WITHER_SKELETON, BLAZE, WITCH, ENDERMAN
• End: SHULKER, ENDERMAN

---

📊 tiers: true (Progression Tiers)

This module introduces a player-tier system to manage difficulty scaling across the server:

• Tier 1: The starting level. Bosses are at their weakest.
• Tier 2: Automatically unlocked when a player equips at least 3 armor pieces with a rarity of COMMON, UNCOMMON, or RARE.
• Tier 3: Unlocked upon traveling to the Nether.
• Tier 4: Unlocked after defeating the Wither or the Ender Dragon.
• Tier 5: The ultimate tier. Achieved by equipping an item with MYTHIC rarity.

---

👹 variants: true (Mob Variants)

Allows vanilla mobs to spawn as elite variants equipped with unique combat mechanics. There are 9 available variants:

• Brute Creeper: Doesn't know how to detonate, so it charges forward to attack you with melee strikes.
• Enderman Warp: Teleports you randomly upon hitting you.
• Zombie Venom: Inflicts a poison effect whenever it lands a hit.
• Phantom Grabber: Snatches you up, flies high into the air, and drops you from above.
• Spider Web Trapper: Traps you in a cobweb for 1 to 2 seconds during combat.
• Spider Brood: Spawns a cluster of baby spiders upon death.
• Arcane Archer: A smarter, deadlier skeleton equipped with a magical bow.
• Mummified Leader: Spawns exclusively in desert biomes. Striking it causes it to summon reinforcing minions.
• Wither Knight: Launches you vertically into the air on hit and deals significantly higher Wither damage than normal.

---

📚 enchant_library: true (Arcane Library)

A specialized utility structure that allows you to store, centralize, and boost your enchantments far beyond vanilla limitations.

• Crafting: Crafted using Eyes of Ender, a Nether Star, and a Barrel.
• Activation: The barrel must be completely surrounded by bookshelves (either standard or chiseled) to activate.
• Mechanics: Deposit your duplicate enchanted books to accumulate "Power Points" for that specific enchantment. For instance, storing multiple Sharpness IV books will let you extract a single book with a superior tier, such as Sharpness VII.
  [ Eye of Ender ] [ Eye of Ender ] [ Eye of Ender ]
  [ Eye of Ender ] [ Barrel ] [ Eye of Ender ]
  [ - ] [ Nether Star ] [ - ]

Arcane Library

---

Arcane Decomposition Table

Turn your gems into valuable arcane dust.

Different gem tiers now produce dust of varying quality:

• • Tier I Gems → Raw Dust
• • Tier II Gems → Refined Dust
• • Tier III Gems → Pure Dust

Crafted using:

Respawn Anchor
Barrel

(Place the Respawn Anchor above the Barrel)

The table can process up to 16 gems at once, taking longer depending on the gem quality and amount inserted.

Dust finally gives stored gems a meaningful endgame purpose.

---

📚 Arcane Tomes

You can now create Arcane Tomes from Arcane Dust.

Recipe:

• D.D.D
• D.B.D
• D.D.D

D = Arcane Dust
B = Book

Three qualities are available:

Raw Arcane Tome

• Extracts approximately 50% of enchantments.

• The item is consumed.

Refined Arcane Tome

• Extracts 100% of enchantments.

• The item is consumed.

Perfect Arcane Tome

• Extracts 100% of enchantments.

• Retains the original item.

• Ignores cursed enchantments.

Players can finally recover valuable enchantments from their best gear.

---

🔨 New Feature - Arcane Chisel

Customize your gear like never before.

Crafting Recipe:

Stone Cutter
⬇
Crafting Table
⬇
Hopper

Pattern:

The Arcane Chisel uses Resonance Points.

Resonance is obtained by sacrificing weapons, armor, and tools of a certain rarity.

Higher rarity items grant more Resonance.

In the interface, players can:

• Change Perks.

• Remove Perks (Shift + Click).

• Engrave desired Perks.

• Create fully customized gear.

Each item is unique, as perk slots depend on rarity.

---

🔧 Anvil Support System

A configurable cost system has been added for the anvil.

Several predefined configurations are available, allowing server administrators to decide the cost of using the anvil.

Everything can be configured directly in config.yml.

---

🔍 Gameplay Overview

Build Customization

Every tool and armor piece drops with random perks and an unpredictable number of sockets. Combined with base attack/defense stats and item rarity, this guarantees that every piece of loot found in your world feels entirely unique.

There are 15 distinct types of gems, each offering a specific attribute. Players must carefully match the right gem type with the corresponding equipment to successfully activate its effects.

Smart Boss Spawning

Bosses spawn dynamically throughout the world at a safe distance, giving players the choice to engage in the encounter or avoid it entirely. An on-screen boss health bar reflects the boss's tier color, letting players instantly know exactly what level of threat they are facing.

---

📌 Admin Commands

Boss & Gem Management

• /theosis boss spawn [player] — Spawns a custom boss near the targeted player.
• /theosis boss clear [all] — Instantly clears active bosses.
• /theosis gem [gem_name] — Grants a specific gem type.
• /theosis perk — Manually applies random perks to the item currently held in your hand.

UI Menus & Core System

• /theosis hub — Opens an interactive GUI menu to easily apply/remove perks and manage gems visually. (A friendly alternative to typing individual commands).
• /theosis reload — Reloads all .yml configuration files.

Tier Management

• /theosistier add [player] — Promotes a player's progression tier.
• /theosistier clear [player] — Resets a player's progression tier to default.
• /theosistier get [player] — Displays a player's current progression level.
• /theosistier set/lock/unlock — Adjusts, locks, or unlocks specific tier progression paths.