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


---

# 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://adaptivehud.gitbook.io/docs/getting-started/basics.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.