Configuration

All configurations from the ULTIMATE Bliss SMP Plugin config

Special Items

The special-items section for configurable items that allow players to change or upgrade their gems.

Configuration Format

special-items:
  item-key:
    model: <Integer>
    can-drop: <true/false>
    name: <String>
    description:
      - <Lore line 1>
      - <Lore line 2>
    recipe:
      - - <material> - <material> - <material>
      - - <material> - <material> - <material>
      - - <material> - <material> - <material>

Gem Reroller

Key: reroller

Purpose: Allows players to reroll their currently equipped gem, and get a random new gem.

Usage: Right-click while holding the item to trigger a gem reroll.

Config

reroller:
  model: 420691
  can-drop: true
  name: §fGem Reroller
  description:
    - §7Reroll your current Gem
    - §7Right click to use
  recipe:
    - - minecraft:diamond
      - minecraft:fermented_spider_eye
      - minecraft:diamond
    - - minecraft:amethyst_shard
      - minecraft:ender_eye
      - minecraft:amethyst_shard
    - - minecraft:diamond
      - minecraft:nautilus_shell
      - minecraft:diamond

---

Gem Upgrader

Key: upgrader

Purpose: Upgrades a gem from level 1 to level 2, increasing its strength and unlocking new abilities. Only usable on eligible level 1 gems.

Usage: Right-click while holding the item and a valid gem to perform the upgrade.

Config

upgrader:
  model: 4206911
  can-drop: true
  name: §fGem Upgrader
  description:
    - §7Upgrade Gems to level 2
    - §7Right click to use
  recipe:
    - - minecraft:gold_block
      - minecraft:netherite_scrap
      - minecraft:gold_block
    - - minecraft:turtle_scute
      - minecraft:large_amethyst_bud
      - minecraft:turtle_scute
    - - minecraft:gold_block
      - minecraft:netherite_scrap
      - minecraft:gold_block

---

Gem Polisher

Key: polisher

Purpose: Polishes a level 2 gem to level 3 gem. It enhancing its abilities.

Usage: Right-click while holding the item and a valid level 2 gem to polish it.

Config

polisher:
  model: 310
  can-drop: true
  name: §fGem Polisher
  description:
    - §7Polish level 2 Gems
    - §7Right click to use
  recipe:
    - - minecraft:diamond_block
      - minecraft:piglin_head
      - minecraft:diamond_block
    - - minecraft:totem_of_undying
      - minecraft:heart_of_the_sea
      - minecraft:totem_of_undying
    - - minecraft:diamond_block
      - minecraft:trident
      - minecraft:diamond_block

---

Recipes

To change the recipes for special items, open the config file and locate the special-items section. Each item (e.g., reroller, upgrader, polisher) has a recipe key containing a 3x3 grid of ingredients. Modify the values under recipe to use different materials. Each inner list represents a row in the crafting grid.

Example

To change the Reroller recipe:

recipe:
  - - minecraft:emerald
    - minecraft:blaze_powder
    - minecraft:emerald
  - - minecraft:quartz
    - minecraft:eye_of_ender
    - minecraft:quartz
  - - minecraft:emerald
    - minecraft:ghast_tear
    - minecraft:emeral

Use valid Minecraft material IDs. Save the file and reload the plugin for changes to take effect!

---

Cooldowns

To change cooldowns, open the config file and edit the cooldowns section. Each key represents an ability, and its value is the cooldown time in seconds.

Example

To change dash from 45s to 60s:

dash: 60

Cooldowns are affected by modifiers in the cooldown-modifiers section. Each modifier includes:

• A permission string (e.g., blisssmp.vip)

• A reduction percentage

Players with a matching permission will have their cooldowns reduced accordingly. Higher entries in the list take priority.

Example Modifier

vip:
  permission: blisssmp.vip
  reduction: 15

---

Explanation:

• vip: This is the name of the modifier (can be anything).

• permission: The permission node players must have. In this case, blisssmp.vip.

• reduction: How much to reduce cooldowns, in percent. Here, 15%.

Example in Action:

If an ability has a base cooldown of 100 seconds, and the player has the blisssmp.vip permission:

• Final cooldown = 100 - (15% of 100) = 85 seconds.

Players with higher priority permissions (top to bottom order) get the best reduction available.

You can add more modifiers as needed. Save the config and reload the plugin to apply changes.

---

Change Lore of the Gems

Each gem in your config has multiple lore levels (e.g., lore-1, lore-2, lore-3), corresponding to its power level or upgrade stage. Here's how to modify or add to the lore:

🔹 Basic Format

gems:
  gem-id:
    lore-1:
      - Line 1 of lore
      - Line 2 of lore
      - ...
    lore-2:
      - ...

Each - represents a new line of lore in the item’s description.

Color Codes

Use #RRGGBB to color individual lines, or use § codes for advanced effects:

• §f – White

• §l – Bold

• §4, §5, etc. – Colored text

• Combine: §f§l → White and bold

Example: - §f§lᴍᴀɴᴀɢᴇ ᴛʜᴇ ᴛɪᴅᴇꜱ ᴏꜰ ᴛʜᴇ ᴄᴏꜱᴍᴏꜱ → Bold white text

---

Settings

To change core plugin behavior, open the config file and edit the settings section. This section allows you to control gem trading, item drops on death, and enable/disable specific gem abilities.

General Options

• keep-tier-on-trade: If true, gem tier will persist when rerolling.

• join-with-max-gems: If true, new players will start with tier 3 gems.

• drop-upgrader-on-death: If true, players with a tier 2 gem will drop an Upgrader item upon death.

• drop-polisher-on-death: If true, players with a tier 3 gem will drop a Polisher item upon death.

Ability Toggles

Use the deactivate-ability section to disable individual gem abilities. Set a value to true to disable the corresponding ability server-wide.

Example

deactivate-ability:
  fireball: true
  dash: false

In this case, Fireball is disabled, while Dash remains enabled.

You can disable as many or as few abilities as you want. Save the config and reload the plugin to apply changes.

---

More Help?

💬 Found a bug, want a feature, or need help? Join our Discord – we're happy to help!