Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
๐ UltimateBliss
A class-based Gem system with Energy mechanics for Minecraft servers.
Assign players powerful Gems with unique abilities, an Energy system that rewards skill and punishes death, and a deep progression system through three tiers of power.
๐ Overview
UltimateBliss is a class-based combat plugin designed to give every player a unique identity through Gems โ magical artifacts that grant passive abilities, active skills, and special powers.
Each of the 8 Gem types has its own playstyle, 4 tiered abilities, and passive effects that activate automatically. Gems are powered by an Energy system that fluctuates with kills, deaths, and repairs, acting as a living measure of a player's condition. As a gem takes damage (loses energy), its effectiveness degrades โ and at zero energy, abilities are fully disabled until the gem is repaired.
โจ Why Choose UltimateBliss?
โก 8 Unique Gem Classes โ Every player plays differently with Fire, Astra, Flux, Life, Puff, Speed, Strength, and Wealth gems.
๐จ Deep Tier Progression โ Three tiers (Apprentice โ Adept โ Master) unlock new abilities and amplify existing ones.
๐ง Three Gamemodes โ ENGRAVED (no item needed), PHYSICAL (hold gem in offhand), and CLICK_MODE (hold gem in mainhand) to suit your server's style.
๐ Performance Friendly โ Configurable particle rates, passive tick intervals, and per-player particle caps keep overhead low.
๐ ๏ธ Highly Configurable โ Every ability cooldown, energy value, gem assignment mode, feedback message, and control scheme is configurable.
โจ Features
๐ด Core Features
โ๏ธ 8 distinct Gem classes with fully unique ability sets
๐ 3-tier upgrade path unlocking new abilities and damage multipliers
โ๏ธ Energy system (0โ10) with 11 degradation states affecting ability strength
๐ Kill reward and death penalty energy system
๐ฏ Configurable gem assignment: random or player-choice GUI
๐ก Advanced Systems
๐ฏ Chargeable abilities with Boss Bar / XP Bar / Action Bar charge display
๐ก๏ธ Cooldown system per-ability with global cooldown support
๐ฅ Three gem gamemodes (ENGRAVED, PHYSICAL, CLICK_MODE) with fully configurable controls
๐ World blacklist โ disable abilities in specific worlds
๐ฆ Auto-save task with configurable interval
๐ข Customization & Integration
๐จ Fully configurable config.yml, cooldowns.yml, messages.yml, and recipes.yml
๐ PlaceholderAPI support
๐ฆ Custom craftable items: Upgrader, Polisher, Trader, Reparation Shard, Reparation Pedestal, Energy Bottles
๐ Documentation
โก Energy System
Every player's gem has an energy level from 0 to 10, which degrades through 11 named states that affect ability multipliers and passive availability.
| State | Energy | Multiplier | Notes |
|---|---|---|---|
| Pristine 5 | 10 | ร1.5 | Glows |
| Pristine 4 | 9 | ร1.4 | Glows |
| Pristine 3 | 8 | ร1.3 | Glows |
| Pristine 2 | 7 | ร1.2 | โ |
| Pristine 1 | 6 | ร1.1 | โ |
| Pristine | 5 | ร1.0 | Default |
| Scratched | 4 | ร0.9 | โ |
| Cracked | 3 | ร0.8 | โ |
| Shattered | 2 | ร0.7 | โ |
| Ruined | 1 | ร0.5 | Passives disabled |
| Broken | 0 | ร0.0 | All abilities disabled |
๐ข Kill Reward โ Killing a player whose gem is not broken grants +1 energy.
๐ด Death Penalty โ Being killed by a player costs โ1 energy (PvP only by default).
๐ Gem Tiers
| Tier | Name | Abilities Unlocked | Damage Multiplier |
|---|---|---|---|
| 1 | Apprentice | 2 | ร1.0 |
| 2 | Adept | 3 | ร1.5 |
| 3 | Master | 4 | ร2.0 |
Upgrade from Tier 1 โ 2 with the Gem Upgrader item, and Tier 2 โ 3 with the Gem Polisher item.
๐ฎ Gem Gamemodes
ENGRAVED โ The gem is bound to the player soul. No item is required; abilities activate on click or keybind.
PHYSICAL โ Requires holding the physical gem item in the offhand. Configurable death behavior: keep, drop, or destroy.
CLICK_MODE โ Hold the gem in the mainhand. Fully configurable per-button activation (LEFT_CLICK, RIGHT_CLICK, OFFHAND click) for each of the 4 abilities.
Players can switch modes with /bliss gamemode <ENGRAVED|PHYSICAL|CLICK_MODE> if allow-switching: true.
๐ฎ Gem Types & Abilities
๐ฃ Astra Gem โ Master of shadows and daggers
| Ability | Tier | Description | Cooldown |
|---|---|---|---|
| Dagger Throw | 1 | Launch a poisoned gravity-defying arrow | 5s |
| Invisibility | 1 | Become invisible; deactivates on taking damage or attacking | 25s |
| Phase | 2 | Phase through walls with temporary damage immunity | 15s |
| Shadow Step | 3 | Teleport behind a targeted entity | 8s |
Passives: Permanent Night Vision. Shadow Cloak โ become briefly invisible while sneaking.
Backstab โ deal bonus damage when attacking a target from behind.
๐ด Fire Gem โ Harness the power of flames
| Ability | Tier | Description | Cooldown |
|---|---|---|---|
| Fireball | 1 | Charge and release a scaling explosive fireball | 10s |
| Crisp | 1 | Evaporate water in an area; deals bonus damage to water mobs | 8s |
| Blaze Aura | 2 | Surround yourself with a damaging ring of flames | 30s |
| Inferno | 3 | Massive area fire explosion; ignites the terrain | 45s |
Passives: Permanent Fire Resistance. Ember Trail while sprinting. Heat Aura passively damages nearby enemies every 2 seconds.
๐ก Flux Gem โ Control electrical energy
| Ability | Tier | Description | Cooldown |
|---|---|---|---|
| Flashbang | 1 | Charge and release a blinding AoE burst | 15s |
| Flux Beam | 1 | Charge and fire a piercing electric beam | 8s |
| Ground | 2 | Freeze a targeted entity in place | 20s |
| Kinetic Burst | 1 | Charge and release a radial knockback blast | 12s |
Passives: Immunity to Weakness, Slowness, and Hunger. Flow State โ build speed and haste stacks while moving or in combat. Conduction โ sneak to teleport to a targeted copper block or lightning rod. Shocking โ 15% chance to stun enemies hit by arrows.
The Flux Gem uses a cycle system: while charging, use Shift+Right Click to cycle through which of the 4 abilities to release.
๐ข Life Gem โ Manipulate health and vitality
| Ability | Tier | Description | Cooldown |
|---|---|---|---|
| Health Share | 1 | Donate a portion of your health to nearby allies | 20s |
| Heart Lock | 1 | Lock your health at its current value for a duration | 60s |
| Regeneration Burst | 2 | Apply strong Regeneration and Absorption to yourself | 30s |
| Lifesteal Aura | 3 | Heal for 20% of damage dealt on attacks | 0.5s internal |
Passives: Permanent bonus max health (scales with tier). Natural regeneration every 2 seconds. Life Sense โ action bar warning when a nearby ally drops below 50% health.
โช Puff Gem โ Master of air and mobility
| Ability | Tier | Description | Cooldown |
|---|---|---|---|
| Double Jump | 1 | Perform a second jump while airborne | 3s |
| Cloud Dash | 1 | Dash forward, dealing damage and leaving a cloud trail | 10s |
| Updraft | 2 | Launch yourself and nearby entities upward | 15s |
| Tornado | 3 | Summon a traveling tornado that pulls and damages enemies | โ |
Passives: Feather Fall while airborne. Glide by sneaking in mid-air. No fall damage while passives are active. Cloud particle landing effects.
๐ต Speed Gem โ Lightning fast reflexes
| Ability | Tier | Description | Cooldown |
|---|---|---|---|
| Lightning Strike | 1 | Call a lightning strike on your targeted location | 12s |
| Speed Boost | 1 | Massively amplify your movement speed temporarily | 20s |
| Dash | 2 | Short-range instant teleport (2 charges, 3s recharge) | โ |
| Time Slow | 3 | Slow all nearby enemies while you move faster | 45s |
Passives: Permanent Speed (scales with tier). Quick Reflexes โ Haste buff. Momentum โ build speed stacks while sprinting; lose them when stopping or taking damage. Momentum bonus applies to attack damage.
๐ Strength Gem โ Raw power and tracking
| Ability | Tier | Description | Cooldown |
|---|---|---|---|
| Nullify | 1 | Strip all positive potion effects from nearby enemies | 25s |
| Power Strike | 2 | Charge a melee attack; next hit deals massive bonus damage with knockback | 15s |
| Iron Skin | 3 | Temporary Resistance III and Fire Resistance | 40s |
Passives: Permanent Strength (scales with tier). Increased knockback on all hits. Armor Pierce โ bonus damage based on target's armor value. Consecutive Hits โ Power Strike damage scales with combo.
๐ก Wealth Gem โ Virtual storage and protection
| Ability | Tier | Description | Cooldown |
|---|---|---|---|
| Virtual Pocket | 1 | Open a personal persistent inventory (9 slots ร tier) | โ |
| Item Lock | 1 | Lock held item slots to protect them on death (up to 3 ร tier slots) | 10s |
| Fortune Boost | 2 | Triple drop-rate chance for a duration | 60s |
| Midas Touch | 3 | Convert nearby dropped items to gold | โ |
Passives: Fortune โ passive 15% ร tier chance for extra drops. Miser โ reduced death-drop penalty. Greed โ bonus XP gain on kills.
๐ ๏ธ Custom Items
| Item | Description | Recipe |
|---|---|---|
| Gem Upgrader | Upgrades a gem from Tier 1 to Tier 2 | 4ร Diamond + 4ร Amethyst Shard + 1ร Emerald (shaped) |
| Gem Polisher | Upgrades a gem from Tier 2 to Tier 3 | 4ร Netherite Ingot + 4ร Gold Block + 1ร End Crystal (shaped) |
| Gem Trader | Rerolls gem type while keeping tier | 4ร Ender Eye + 4ร Ender Pearl + 1ร Nether Star (shaped) |
| Reparation Shard | Restores 1 Energy | 4ร Diamond + 1ร Prismarine Shard (shaped) |
| Reparation Pedestal | Block: automatically restores energy on a cooldown | 2ร Diamond Block + 2ร Emerald Block + 1ร Lodestone + 3ร Obsidian (shaped) |
| Energy Bottle (Small) | Restores 1 Energy | Craftable (see recipes.yml) |
| Energy Bottle (Medium) | Restores 2 Energy | Craftable (see recipes.yml) |
| Energy Bottle (Large) | Restores 5 Energy | Craftable (see recipes.yml) |
โ๏ธ Configuration
Configuration files: config.yml ยท cooldowns.yml ยท messages.yml ยท recipes.yml
# Key settings in config.yml
settings:
debug: false
save-interval: 300 # Auto-save interval in seconds
gem-assignment:
mode: "random" # "random" or "choose"
gamemode:
default: PHYSICAL # ENGRAVED, PHYSICAL, or CLICK_MODE
allow-switching: true
energy:
default: 5
max: 10
kill-reward:
enabled: true
death-penalty:
enabled: true
only-pvp: true
tiers:
1:
name: "Apprentice"
damage_multiplier: 1.0
abilities_unlocked: 2
2:
name: "Adept"
damage_multiplier: 1.5
abilities_unlocked: 3
3:
name: "Master"
damage_multiplier: 2.0
abilities_unlocked: 4
pedestal:
repair_cost: 5 # Energy cost to use pedestal
energy_restored: 5
cooldown: 300 # Seconds
charge-display:
type: BOSS_BAR # BOSS_BAR, XP_BAR, or ACTION_BAR
disabled_worlds:
- "example_nether"
- "creative"
๐ Notable Configuration Options
| Option | Description | Default |
|---|---|---|
gem-assignment.mode |
random or choose for new players |
random |
gamemode.default |
Starting gamemode for all players | PHYSICAL |
controls.command-only-mode |
Abilities only via /bliss use |
false |
controls.keybinds-enabled |
Use F key / keybinds instead of clicks | false |
charge-display.type |
Display type for charge abilities | BOSS_BAR |
physical.death-behavior |
keep, drop, or destroy on death |
keep |
energy.kill-reward.enabled |
Gain energy on player kill | true |
energy.death-penalty.only-pvp |
Only lose energy from player deaths | true |
effects.particles_enabled |
Enable visual particles | true |
performance.max_particles_per_player |
Particle cap per player | 50 |
database.type |
Storage type (currently YAML) | YAML |
๐ก Note: Most changes require a /blissadmin reload or server restart to take effect.
๐ป Commands
๐ค Player Commands
| Command | Description | Permission |
|---|---|---|
/bliss |
Show help menu | ultimatebliss.use |
/bliss info |
View your gem, tier, and energy status | ultimatebliss.use |
/bliss select |
Open gem selection GUI (if applicable) | ultimatebliss.use |
/bliss abilities |
List your gem's abilities and cooldowns | ultimatebliss.use |
/bliss energy |
View current energy and state | ultimatebliss.use |
/bliss withdraw <amount> |
Sacrifice energy from your gem | ultimatebliss.use |
/bliss toggle |
Toggle gem abilities on/off | ultimatebliss.use |
/bliss gamemode <mode> |
Switch gem gamemode | ultimatebliss.use |
/bliss use <ability> |
Activate an ability by name | ultimatebliss.use |
/bliss help |
Display command help | ultimatebliss.use |
Aliases: /ub, /gem, /gems
๐ง Admin Commands
| Command | Description | Permission |
|---|---|---|
/blissadmin give <player> <gem> [tier] |
Give a player a gem | ultimatebliss.admin |
/blissadmin remove <player> |
Remove a player's gem | ultimatebliss.admin |
/blissadmin trade <player> |
Open the trade menu for a player | ultimatebliss.admin |
/blissadmin settier <player> <1-3> |
Set a player's gem tier | ultimatebliss.admin |
/blissadmin setenergy <player> <0-10> |
Set a player's energy level | ultimatebliss.admin |
/blissadmin repair <player> |
Fully repair a player's gem | ultimatebliss.admin |
/blissadmin giveitem <player> <item> [amount] |
Give a custom plugin item | ultimatebliss.admin |
/blissadmin info <player> |
View a player's gem details | ultimatebliss.admin |
/blissadmin reload |
Reload all configuration files | ultimatebliss.admin |
Aliases: /uba, /gemadmin
๐ Permissions
ultimatebliss.*
โโโ ultimatebliss.use
โโโ ultimatebliss.admin
โโโ ultimatebliss.bypass.cooldown
โโโ ultimatebliss.bypass.energy
| Permission | Description | Default |
|---|---|---|
ultimatebliss.use |
Access gem abilities and player commands | true |
ultimatebliss.admin |
Access all admin commands | op |
ultimatebliss.bypass.cooldown |
Bypass ability cooldowns | op |
ultimatebliss.bypass.energy |
Bypass energy requirements | op |
๐ค PlaceholderAPI
UltimateBliss supports PlaceholderAPI!
| Placeholder | Description |
|---|---|
%ultimatebliss_gem% |
Player's current gem type |
%ultimatebliss_tier% |
Player's gem tier (1โ3) |
%ultimatebliss_energy% |
Player's current energy value |
%ultimatebliss_state% |
Player's current energy state name |
Requirements: PlaceholderAPI must be installed. Enable in config.yml under integrations.placeholderapi.enabled: true.
๐ฅ Installation
Getting started is easy!
๐ Requirements
| Requirement | Version |
|---|---|
| Minecraft | 1.21x โ 26.x |
| Server Software | Paper |
| Java | 21+ |
| Dependencies | None |
Optional integrations:
- PlaceholderAPI
- Vault (config option, disabled by default)
- WorldGuard (config option, disabled by default)
๐ Installation Steps
- ๐ฆ Download the latest version of UltimateBliss.
- ๐ Place the
.jarfile inside your server'splugins/folder. - ๐ Restart your server.
- โ๏ธ Configure the plugin inside
plugins/UltimateBliss/config.ymland the other generated files. - ๐ Enjoy!
๐จ Resource Pack
The official UltimateBliss resource pack is available through our Discord server:
https://discord.com/invite/ZNAv5KWM7q
๐ Support & Bug Reports
Need help, found a bug, or have a suggestion?
Join the GetUrPlugins Discord community!
๐ Bug Reports โ Report bugs and unexpected behavior.
๐ฌ Support โ Get help with installation and configuration.
๐ก Suggestions โ Share ideas for future improvements.
๐ข Announcements โ Stay informed about updates and releases.
โ ๏ธ Please include your Minecraft version, server software, and relevant error logs when reporting an issue.
๐ Credits & License
Developed by: GetUrPlugins
License: All Rights Reserved (ARR).
ยฉ GetUrPlugins. All rights reserved.
โ Unauthorized redistribution or resale is prohibited.
โ Modification, decompilation, or republishing is prohibited without explicit permission.
โ
Usage is permitted under the conditions set by the author.
See https://gcl.onl/licenses/arr for the full license terms.
Made with โค๏ธ by GetUrPlugins
๐ UltimateBliss โ Power your server with Gem-based class combat.