📢 Discord

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

More Help?

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

PreviousULTIMATE Bliss SMP PluginNextAbilities

Last updated