> For the complete documentation index, see [llms.txt](https://ney.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://ney.gitbook.io/docs/mythichud-extension.md).

# MythicHUD Extension

MythicHUD Extension adds Typewriter dialogue entries that render through MythicHUD layouts and PlaceholderAPI.

Before using the extension, familiarize yourself with the plugins it builds upon.

### Prerequisites

#### Understanding Typewriter

BetterHud Extension builds upon Typewriter's powerful system. You should understand:

* **Pages**: How Typewriter organizes content into Sequence and Manifest pages
* **Entries**: The building blocks - Events, Actions, and Manifest entries
* **Facts System**: Typewriter's variables that track player data and progression

**Learn Typewriter**: [Typewriter Documentation](https://docs.typewritermc.com/beta/docs/getting-started)

Take time to explore the documentation and understand Typewriter's core mechanics before proceeding.

#### Understanding MythicHUD

MythicHUD controls the visual side of the dialogue. You should know how to work with:

* **Assets**: Collections of text, texture, and head layers.
* **Layouts**: Positioning assets on the player's screen.

**Learn MythicHUD**: [MythicHUD Documentation](https://git.mythiccraft.io/mythiccraft/mythichud/-/wikis/home)

Make sure you understand how to create layouts and configure basic HUD elements.

#### Understanding PlaceholderAPI

Dialogue content is passed from Typewriter to MythicHUD through PlaceholderAPI. All extension placeholders use this format:

```
%typewriter_mythichud_<variable>%
```

See [Variables](/docs/mythichud-extension/variables.md) for the complete list.

***

### Requirements

* Paper
* Java 21
* Typewriter
* MythicHUD
* PlaceholderAPI

***

**Ready to start?** Now that you're familiar with the basics, let's explore what BetterHud Extension can do!