> For the complete documentation index, see [llms.txt](https://vast-3.gitbook.io/vast-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vast-3.gitbook.io/vast-docs/vast-studios/ultimate-bliss-smp-plugin/addons.md).

# Addons

{% hint style="info" %}
All addons are lifetime purchases — buy once and receive all future updates at no additional cost!
{% endhint %}

## Texture Pack  <a href="https://builtbybit.com/resources/ultimate-bliss-smp-plugin.66455/" class="button secondary">Buy</a>&#x20;

The Texture Pack Addon includes all necessary visuals for the gem system, as well as textures for items used in the Energy Addon.

## Energy System  <a href="https://builtbybit.com/resources/ultimate-bliss-smp-plugin.66455/" class="button secondary">Buy</a>

The optional Energy Addon introduces a competitive energy mechanic:\
Players lose 1 energy on death, and if their energy falls below -5, they will either downgrade their gem, lose it, or be banned—depending on config settings. Energy is gained by killing other players, adding a PvP-driven progression element.\
\
Gem abilities and cooldowns dynamically scale based on energy using the general formula:\
x \* y / 100 + x,\
where x is the base value (like damage or cooldown) and y is the player’s current energy. Positive energy boosts abilities and reduces cooldowns, while negative energy weakens abilities and increases cooldowns.\
\
There is also a configurable item that allows players to revive or recraft lost gems, adding a recovery option to the system.

{% hint style="warning" %}
The textures of the Energy System are in the Texture Pack addon and not included in the Energy System addon!
{% endhint %}

### How does it work?

After purchasing the Energy System Addon on [BuiltByBit](https://builtbybit.com/resources/ultimate-bliss-smp-plugin.66455/), wait 2–3 minutes for the transaction to process. Then, restart your server. As long as the addon is **enabled in your configuration file**, it will automatically load during startup. You should see confirmation in your server logs that the energy system was successfully loaded.

{% hint style="info" %}
If it doesn’t load—even after purchase and proper configuration—please open a support ticket for assistance.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/addons.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.
