> For the complete documentation index, see [llms.txt](https://adaptivehud.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adaptivehud.gitbook.io/docs/getting-started/basics.md).

# Basics

{% hint style="danger" %}
**THIS DOCUMENTATION IS NOT FINISHED. FOR HELP, JOIN OUR DISCORD SERVER**
{% endhint %}

**Discord server invite:** [**https://discord.gg/tqn38v6w7k**](https://discord.gg/tqn38v6w7k)

{% hint style="danger" %}
**The mod itself is still under development! If you find any bugs or have any feature suggestions, please let us know! (Report in our discord!)**
{% endhint %}

## Installing

To install the mod, start by downloading it from [Modrinth](https://modrinth.com/mod/adaptivehud), then place the jar file in your mods folder (`.minecraft/mods`). You also need to download the [Fabric API](https://modrinth.com/mod/fabric-api) (required), and if you want [modmenu ](https://modrinth.com/mod/modmenu) (optional).

## Edit Elements

You can edit elements both through the in game editor, which you can open using mod menu, or a key bind (default F8). On the right side of the screen you will find a list of all the loaded elements, you can click the name of these to edit them.

{% hint style="info" %}
(NOT RECOMMENDED) It's also possible to edit the element-files manually, these can be found at `.minecraft/config/adaptivehud/elements`.
{% endhint %}

When you first launch the game a couple of premade elements will appear, if you want to you can delete these.

## Move Screen

To move your elements you can use the dragging screen, to open it, click on "Move Elements" in the editor. If you want to select the position with more precision, you can edit the exact value inside the element editor. The value must be a full integer!

{% hint style="info" %}
You can also open the dragging screen using a keybind! (Default is "right shift")
{% endhint %}

The move screen has inbuilt snapping, meaning if one element gets close to another they will align next to each other, to bypass this, hold down shift. Snapping is indicated with white lines.

The move screen also has some red lines indicating its anchor point and text align, read more about that below.

## Other

The mod has three different stages of parsing.

1. First, all variables are parsed.
2. Then, all conditions are parsed.
3. And lastly, all math expressions.