# ULTIMATE Bliss SMP Plugin

## Description

The Ultimate Bliss Plugin adds a powerful and customizable gem system to your Minecraft server. Upon joining, each player receives one random gem out of eight unique gems, and they can only hold one gem at a time. This creates unique playstyles and encourages players to experiment or trade using the available gem-switching mechanics.

\
Players can upgrade their gem through three tiers. To upgrade from Tier 1 to Tier 2, they’ll need an Upgrader item, and to reach Tier 3, a Polisher is required. If players want to switch their gem, they can use a Trader item. All of these items come with crafting recipes that are fully configurable in the plugin's settings.\
\
Most gem ability strengths can also be adjusted in the config, giving server owners full control over balancing. The plugin is designed for Paper 1.21. It may also work on newer versions, but some bugs may occur. Textures are not included with the base plugin—they’re available separately in the Texture Pack Addon.

> This is NOT the real Bliss SMP plugin, it is a fanmade replica This plugin was made by VAST Studios

## Commands

<details>

<summary>/reloadblissconfig</summary>

Reload the plugin without reloading the whole server.

{% hint style="danger" %}
Some changes still require a restart!
{% endhint %}

</details>

<details>

<summary>/trust &#x3C;player> | /untrust &#x3C;player></summary>

Trust: Use positive abilities and avoid using negative abilities on a player

Untrust: Revoke trust from a player

</details>

<details>

<summary>/give-item &#x3C;player> &#x3C;item_name> [amount]</summary>

Give custom gem modifier items. Available: reroller, upgrader, polisher

</details>

<details>

<summary>/setgem &#x3C;player> &#x3C;gem_name> &#x3C;level></summary>

Sets the user a specified gem.

Levels: none (Tier 1), upgraded (Tier 2), polished (Tier 3)

</details>

***

## Configuration Settings

{% content-ref url="/pages/bn3IRfBL7GVpzlTIqv3C" %}
[Configuration](/vast-docs/vast-studios/ultimate-bliss-smp-plugin/configuration.md)
{% endcontent-ref %}

***

## Dependencies

<details>

<summary>World Guard  <a href="https://dev.bukkit.org/projects/worldguard" class="button secondary">Download</a></summary>

If World Guard is installed, you can disable abilities in specific regions using the `disabled-regions` section in the config:

```yaml
disabled-regions:
  astral-projection:
    - spawn
    - afk
  breezy-bash:
    - spawn
    - afk
  chad-strength:
    - spawn
    - afk
  circle-of-life:
    - spawn
    - afk
  cozy-campfire:
    - spawn
    - afk
  daggers:
    - spawn
    - afk
```

In this example, abilities are disabled in the `spawn` and `afk` World Guard regions.

</details>

***

## Abilities

{% content-ref url="/pages/na9fQGwyt4kf3s37gcsD" %}
[Abilities](/vast-docs/vast-studios/ultimate-bliss-smp-plugin/abilities.md)
{% endcontent-ref %}

***

## More Help?

💬 **Found a bug, want a feature, or need help?**\
Join our [Discord](https://discord.com/invite/2PtWdj2GeP) – we're happy to help!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://vast-3.gitbook.io/vast-docs/vast-studios/ultimate-bliss-smp-plugin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.