# How to Install FinalPack

```apex
final/
├─ config.json            (not required – can be ignored)
└─ target/
   ├─ geyser_mappings.json
   └─ packaged/
      └─ geyser_resources.zip
```

***

### 1️⃣ Install `geyser_mappings.json`

This file is used to map **custom items, models, and GUIs** for Geyser.

#### 📁 Installation Path

```
/velocity/plugins/Geyser/custom_mappings/geyser_mappings.json
```

or (non-Velocity setups):

```
/server/plugins/Geyser/custom_mappings/geyser_mappings.json
```

#### Notes

* If a `geyser_mappings.json` file already exists, **back it up first**, then replace it.
* The filename must be exactly: `geyser_mappings.json`

***

### 2️⃣ Install `geyser_resources.zip`

This is the **Bedrock resource pack** generated by the converter.\
It contains all textures, models, and GUIs.

#### 📁 Installation Path

```
/velocity/plugins/Geyser/packs/geyser_resources.zip
```

or (non-Velocity setups):

```
/server/plugins/Geyser/packs/geyser_resources.zip
```

#### Notes

* Do **not** extract the ZIP file
* The file must remain as `.zip` or  `.mcpack` 
* Using the name `geyser_resources.zip` is strongly recommended
* Geyser will load this pack automatically

***

### 3️⃣ Restart the Server / Proxy

After placing both files, **restart your server or proxy**.

⚠️ Do **not** use `/geyser reload` or `/reload` \
A full restart is required for:

* Reloading Geyser mappings
* Sending the updated resource pack to Bedrock clients

***

### 4️⃣ Test In-Game (Bedrock Edition)

1. Join the server using a **Bedrock client**
2. Connect via **Floodgate / Geyser**
3. Verify that the following work correctly:
   * ✅ Custom items
   * ✅ Models
   * ✅ Animations
   * ✅ GUIs (including 1×9 / 2×9 / 4×9 / 5×9 if used)

***

### ✅ Quick Checklist

* `geyser_mappings.json` placed in the correct folder
* `geyser_resources.zip` placed in the correct folder
* Server / proxy restarted
* Tested successfully on Bedrock


---

# 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://kaizermc-wiki.gitbook.io/j2b-converter/how-to-install/how-to-install-finalpack.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.