# First run (installation)

{% hint style="info" %}
WIthout any of hitbox setup, your players can´t spin the wheel.

Go [to this article](/fortunewheel/wheels/hitbox-setup-interaction-blocks.md) to see more about hitboxes.
{% endhint %}

{% hint style="danger" %}
**REWARD ITEMS NOT VISIBLE**\
If you did not see any display type entites on the wheel, you have to fix your version-adapter setting in the config.yml 

By default, we set that value to AUTO mode, but minecraft server **forks** on versions from 1.19.4 to 1.20.2 works differently every time. So sometimes, the version adapter can not use AUTO mode and you have to set it by yourself.

There is two other modes (OLD and NEW). Our plugin should write you on plugin load to the console, what type the AUTO mode choosed. Just set it to the other setting and it should work well.
{% endhint %}

### Installation:

When oyu install the plugin to your minecraft server and do restart, an error message will appear in your console log.  Config files will be automatically generated. Continue setup with guide below. 

1. Go to the: plugins/FortuneWheel/config.yml
2. Set resourcepack provider depending on [this article](#resourcepack-setup)
3. Go to the: plugins/FortuneWheel/wheels/example.yml
4. Set value "location" to your existing location.\
   Format: "world(x;y;z)"
5. Restart your minecraft server
6. **Now, you will see a paper instead of wheel.**
7. Reload your resource pack\
   (if you are have custom pack, you have to setup time manually in wheel config)
8. Run /fw reload
9. You are done.

### Resourcepack setup:

We provide you a special feature called "Automatic resourcepack builder". Our builder can build your resourcepack automatically and instantly during the restart. Soo you can easily just upload only the wheel texture and plugin will setup your Oraxen/IA files itself.

Supported providers list:

```
ITEMSADDER - Auto build for ItemsAdder plugin
ORAXEN - Auto build for Oraxen plugin
CUSTOM - You have to build your own pack
```

### Moving wheel to specific location

Plugin on first run automatically creates example wheel in "wheels" folder.

File is named example.yml and you have to open this file and change location to your required location for the wheel. Then you can continue the setup in other sections of this wiki page.


---

# 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://wiki.gennario.eu/fortunewheel/setup/first-run-installation.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.