# Welcome to Nekio Setups

Here, you will find detailed guides on how to install, customize, and operate our Minecraft setups. We cover a range of popular game modes, ensuring that your server runs smoothly and your players enjoy the best experience.

All of our setups have been rigorously tested with over **100 active players** on [**Arefy**](https://arefy.net/), guaranteeing unmatched quality and optimization that you won’t find with any of our competitors.

<mark style="color:orange;">🛠</mark> **Heads-up**: Each setup comes with its own unique configuration guide. Be sure to follow the right one to match the setup you've bought

{% hint style="success" %}
📢 **Need Assistance?**\
Got questions or ran into an issue? No worries! Join our Discord server, where we offer support and help you get everything running smoothly. Make sure you go into **#tickets** and then open a ticket in **Nekio Setups** category

**Join our Discord here:** [**discord.nekiosetups.com**](https://discord.nekiosetups.com/)
{% endhint %}

<div align="center"><figure><img src="/files/41BoXG3BatH7GFrqTqtp" alt=""><figcaption></figcaption></figure></div>


# Prison Setup

This guide will walk you through the steps to install, configure, and modify the Premium Prison Setup.

<figure><img src="/files/G0SDT4V3z7D7BWvjfq7z" alt=""><figcaption></figcaption></figure>

## **Installation Instructions**

Follow the steps below to set up the **Premium Prison Setup** on your server. You will need to have purchased our [**Premium Prison Setup**](https://builtbybit.com/resources/premium-prison-setup-nekio.44464/) first. Once you have made the purchase, download it and continue with the instructions.

{% hint style="info" %}
It is highly recommended to install **Paper** **1.12.2** with java 11 as your server's base software for optimal performance. You can download the latest version from [**here**](https://papermc.io/downloads/all). We suggest using **Paper** because of its advanced optimization features, which are specifically designed to handle high player counts and improve server stability.
{% endhint %}

## ![](https://wiki.arefy.net/~gitbook/image?url=https%3A%2F%2F1987155368-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MR_H5ewvyOa3SDGl4ba%252F-MWAXlpNfmXjaa3JGM4S%252F-MWAYLWHghlnVa8FNon5%252FPrueba-1.png%3Falt%3Dmedia%26token%3D41a1de74-3189-4dd4-a167-e3f0520ebb58\&width=300\&dpr=1\&quality=100\&sign=3802d380\&sv=1) 1. Uploading all downloaded files into your hosting folder

Upload all files that you have download into your hosting folder, you just have to drag and drop them into the FTP that they gave you, as simple as that

<figure><img src="https://i.imgur.com/J2CPQo9.gif" alt=""><figcaption></figcaption></figure>

## ![](https://wiki.arefy.net/~gitbook/image?url=https%3A%2F%2F1987155368-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MR_H5ewvyOa3SDGl4ba%252F-MWAXlpNfmXjaa3JGM4S%252F-MWAYSEk5tVsi3CUtOU7%252FPrueba-1.png%3Falt%3Dmedia%26token%3D1ebf222f-5e8c-4408-b103-e573b8ac6eaf\&width=300\&dpr=1\&quality=100\&sign=4aee3df2\&sv=1) 2. Installing dependencies

Due redistribution rights that builtbybit has, we can't include some plugins in the setup, so you will have to download them and install them

{% hint style="warning" %}
Download all dependencies and install them in your **/plugins** folder
{% endhint %}

> **Citizens** [*(Download it here)*](https://ci.citizensnpcs.co/job/citizens2/2901/)
>
> **Tab** [*(Download it here)*](https://www.spigotmc.org/resources/tab-1-5-1-21-1.57806/)

## ![](https://wiki.arefy.net/~gitbook/image?url=https%3A%2F%2F1987155368-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MR_H5ewvyOa3SDGl4ba%252F-MWAXlpNfmXjaa3JGM4S%252F-MWAYXmGtPlIlKN6ydQQ%252FPrueba-1.png%3Falt%3Dmedia%26token%3D3443d9f1-c86e-4c4f-99a2-4c70cea1ad46\&width=300\&dpr=1\&quality=100\&sign=d93f368d\&sv=1) 3. Setting up MySQL for our custom plugins

**Setting up MySQL** is crucial for optimizing our custom plugins. It allows for better performance by efficiently handling data, especially with a larger player base.&#x20;

To configure it, create a MySQL database on your hosting provider and enter the database credentials (name, username, password, and host) into the plugin config files. This will improve server optimization and ensure smoother data management for features like robots, prestiges and private mines.

You will have to setup mysql in these three plugins:

* **Arefy Robots** *(*[*config.yml*](https://pastebin.com/7gh55JJ0)*,* [*view.yml*](https://pastebin.com/w4qhQvKE)*)*
* **Arefy Prestiges** *(*[*config.yml*](https://pastebin.com/wpdwd5xP)*,* [*messages.yml*](https://pastebin.com/qc7Q0t1H)*)*
* **Arefy Private Mines** *(*[*config.yml*](https://pastebin.com/aYf3tziP)*)*

*If you are using Pebble Host, there is an example of how can you get MySQL details*

<figure><img src="/files/jLmr1IDyqp5mIQqsohaQ" alt=""><figcaption><p><em>Database information on Pebble Host (it should be the same on other hoster providers)</em></p></figcaption></figure>

Now that we have connection details of our myqsl database, we can fill them

```
database:
  host: "eu01-sql.pebblehost.com"
  port: 3306
  username: "customer_837440_mines"
  password: "password"
  database: "customer_837440_mines"
  use-ssl: true
```

## 4. ✅ Installation completed

Now you will be able to start the server and join through your host IP

{% hint style="info" %}
You can make yourself **Owner and Operator** by running on console the next commands
{% endhint %}

```
op %player%
```

```
lp user %player% parent add Owner
```

## Editing files and giving pets, armors, skins, robots...

All files are configurable, here is a list of most important files that you can edit (like enchantments rewards, robots, private mines primary blocks, etc)

<details>

<summary>Changing Private Mine's Schematic</summary>

* First, create your new schematic, **use beacons as mine corners** (as shown on the image below)**, and furnace as player spawn**

*(Don't use beacons and furnaces to decorate your mines, there must be only two beacons for mine borders and furnace for players spawn in the entire schematic)*

* Copy the schematic and save it, then paste it to `/plugins/PrivateMines/schematics`
* With server stopped, remove `Minas` world and [Private Mines database](#user-content-fn-1)[^1]
* Remove old **Privates Mines** regions on `/plugins/WorldGuard/worlds/Minas/regions.yml`
* Generate new mines with the new schematic you've created with `/pmine generate <number of mines>` *(pregenerating your mines will help you to prevent lagging when many people claiming them on seasons releases and/or large playerbases)*
* ✅ Claim your new mine with **/pmine**

</details>

<figure><img src="https://m.arefy.net/hM937IO.png" alt=""><figcaption><p><strong>Private Mine schematic</strong> example <em>(there must be two Beacons as mine corners, and one Furnace as player spawn</em>)</p></figcaption></figure>

<details>

<summary>How to level up your pickaxe / Add blocks to your pickaxe/player</summary>

*You can give blocks yourself to your pickaxe using **/bb pickaxe \<player> add|set|remove block|level \<amount>***

*Or in case you want to give player blocks broken, use  **/bb player \<player> add|set|remove block|level \<amount>***

</details>

<details>

<summary>Robots</summary>

*All Robots revenues (tokens/gems) can be edited on **ARobots > config.yml***

*You can also edit main gui on **ARobots > view\.yml***

</details>

<details>

<summary>Private Mines blocks</summary>

*Main Private Mines blocks can be modified on **Private Mines > config.yml***

</details>

<details>

<summary>Prestiges cost expression</summary>

Cost expression, rewards on prestiging and actionbar can be modified on  ***PrisonPrestige > config.yml***

</details>

<details>

<summary>Pets max levels, cost to levelup (broken blocks) and basehead</summary>

You can change head, max level, and level cost (blocks broken) on **APets > config.yml**

Here's an example of the [Token Mythic pet](https://pastebin.com/WZtwCiH5)

</details>

<details>

<summary>Enchantments rewards</summary>

If you want to edit some enchantments rewards, you can do that on **Brokenblocks > config.yml**

</details>

<details>

<summary>How to give currencies to other players</summary>

You can give currencies to other players by using **/tokens add %player% %amount%, /blocks, /gems**

</details>

<details>

<summary>How to give yourself Pets, Armors, Skins, Robots</summary>

* **Pets**: /apets give \<tab to see all pets types>
* **Armors**: /varmor give \<tab to see all armor types>
* **Skins**: /voucher give Skins %player%
* **Robots**: /voucher give Robots/Robotsepic 1 %player%

</details>

[^1]: You can pregenerate your Private Mines database by clearing/removing tbl\_generated\_mines and tbl\_mines


# Survival Setup

This guide will walk you through the steps to install, configure, and modify the Premium Survival Setup.

<figure><img src="/files/CjrnISf8CZSmDDcujfKZ" alt=""><figcaption></figcaption></figure>

## **Installation Instructions**

Follow the steps below to set up the **Premium Survival Setup** on your server. You will need to have purchased our [**Premium Survival Setup**](https://builtbybit.com/resources/premium-survival-setup-nekio.53508) first. Once you have made the purchase, download it and continue with the instructions.

{% hint style="info" %}
It is highly recommended to install **Pufferfish 1.21.1** as your server's base software for optimal performance. You can download the latest version from [**here**](https://ci.pufferfish.host/job/Pufferfish-1.21/21/artifact/build/libs/pufferfish-paperclip-1.21.1-R0.1-SNAPSHOT-mojmap.jar). We suggest using **Pufferfish** because of its advanced optimization features, which are specifically designed to handle high player counts and improve server stability.
{% endhint %}

## ![](https://wiki.arefy.net/~gitbook/image?url=https%3A%2F%2F1987155368-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MR_H5ewvyOa3SDGl4ba%252F-MWAXlpNfmXjaa3JGM4S%252F-MWAYLWHghlnVa8FNon5%252FPrueba-1.png%3Falt%3Dmedia%26token%3D41a1de74-3189-4dd4-a167-e3f0520ebb58\&width=300\&dpr=1\&quality=100\&sign=3802d380\&sv=1) 1. Uploading all downloaded files into your hosting folder

Upload all files that you have download into your hosting folder, you just have to drag and drop them into the FTP that they gave you, as simple as that

<figure><img src="https://i.imgur.com/sBtTZCZ.gif" alt=""><figcaption></figcaption></figure>

## ![](https://wiki.arefy.net/~gitbook/image?url=https%3A%2F%2F1987155368-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MR_H5ewvyOa3SDGl4ba%252F-MWAXlpNfmXjaa3JGM4S%252F-MWAYSEk5tVsi3CUtOU7%252FPrueba-1.png%3Falt%3Dmedia%26token%3D1ebf222f-5e8c-4408-b103-e573b8ac6eaf\&width=300\&dpr=1\&quality=100\&sign=4aee3df2\&sv=1) 2. Installing dependencies

Due redistribution rights that builtbybit has, we can't include some plugins in the setup, so you will have to download them and install them

{% hint style="warning" %}
Download all dependencies and install them in your **/plugins** folder
{% endhint %}

> **Tab** [*(Download it here)*](https://www.spigotmc.org/resources/tab-1-5-1-21-1.57806/)

## 3. ✅ Installation completed

Now you will be able to start the server and join through your host IP

{% hint style="info" %}
You can make yourself **Owner and Operator** by running on console the next commands
{% endhint %}

```
op %player%
```

```
lp user %player% parent add Owner
```

## Editing files and giving money, keys...

All files are configurable, here is a list of most important files that you can edit (like enchantments levels, shop prices, etc)

<details>

<summary>How to give keys to players</summary>

You will only need to run as operator `/crate keys give <player> <crate> <amount>`, you can choose between **Vote, Epic, Mystic and Legendary**

</details>

<details>

<summary>How to set rankup/level to a specific player</summary>

`/svar set level <level> <player>`, you can add up to **20 leve**ls

</details>

<details>

<summary>How to give money to other players</summary>

`/eco give <player> <amount>`

</details>

<details>

<summary>Why do I see two holograms above NPCS</summary>

It's because you have all permissions (OP), and you're seeing text entities and holograms from both versions.

You will have to run `/lp user <player> permission set holograma.bajo false`

</details>


# Skyblock Setup

This guide will walk you through the steps to install, configure, and modify the Premium Skyblock Setup.

## **Installation Instructions**

Follow the steps below to set up the **Premium Skyblock Setup** on your server. You will need to have purchased our [**Premium Skyblock Setup**](https://builtbybit.com/resources/premium-skyblock-setup-nekio.57966/) first. Once you have made the purchase, download it and continue with the instructions.

{% hint style="info" %}
It is highly recommended to install **Pufferfish 1.21.1** as your server's base software for optimal performance. You can download the latest version from [**here**](https://ci.pufferfish.host/job/Pufferfish-1.21/21/artifact/build/libs/pufferfish-paperclip-1.21.1-R0.1-SNAPSHOT-mojmap.jar). We suggest using **Pufferfish** because of its advanced optimization features, which are specifically designed to handle high player counts and improve server stability.
{% endhint %}

## ![](https://wiki.arefy.net/~gitbook/image?url=https%3A%2F%2F1987155368-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MR_H5ewvyOa3SDGl4ba%252F-MWAXlpNfmXjaa3JGM4S%252F-MWAYLWHghlnVa8FNon5%252FPrueba-1.png%3Falt%3Dmedia%26token%3D41a1de74-3189-4dd4-a167-e3f0520ebb58\&width=300\&dpr=1\&quality=100\&sign=3802d380\&sv=1) 1. Uploading all downloaded files into your hosting folder

Upload all files that you have download into your hosting folder, you just have to drag and drop them into the FTP that they gave you, as simple as that

<figure><img src="https://i.imgur.com/R7iiETT.gif" alt=""><figcaption></figcaption></figure>

## ![](https://wiki.arefy.net/~gitbook/image?url=https%3A%2F%2F1987155368-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MR_H5ewvyOa3SDGl4ba%252F-MWAXlpNfmXjaa3JGM4S%252F-MWAYSEk5tVsi3CUtOU7%252FPrueba-1.png%3Falt%3Dmedia%26token%3D1ebf222f-5e8c-4408-b103-e573b8ac6eaf\&width=300\&dpr=1\&quality=100\&sign=4aee3df2\&sv=1) 2. Installing dependencies

Due redistribution rights that builtbybit has, we can't include some plugins in the setup, so you will have to download them and install them

{% hint style="warning" %}
Download all dependencies and install them in your **/plugins** folder
{% endhint %}

> **Tab** [*(Download it here)*](https://www.spigotmc.org/resources/tab-1-5-1-21-1.57806/)
>
> **MythicMobs** [*(Download it here)*](https://www.mythiccraft.io/downloads/mythicmobs/free/MythicMobs-5.7.2.jar)
>
> **ModelEngine** [*(Download it here)*](https://mythiccraft.io/index.php?pages/official-modelengine4-download/\&download=free\&f=4.0.7)

## 3. ✅ Installation completed

Now you will be able to start the server and join through your host IP

{% hint style="info" %}
You can make yourself **Owner and Operator** by running on console the next commands
{% endhint %}

```
op %player%
```

```
lp user %player% parent add Owner
```

## Editing files and giving money, keys...

All files are configurable, here is a list of most important files that you can edit (like enchantments levels, shop prices, etc)

<details>

<summary>How to give keys to players</summary>

You will only need to run as operator `/crate keys give <player> <crate> <amount>`, you can choose between **Vote, Epic, Mystic and Legendary**

</details>

<details>

<summary>How to give money to other players</summary>

`/eco give <player> <amount>`

</details>

<details>

<summary>Why do I see two holograms above NPCS</summary>

It's because you have all permissions (OP), and you're seeing text entities and holograms from both versions.

You will have to run `/lp user <player> permission set holograma.bajo false`

</details>


# Lobby Setup

This guide will walk you through the steps to install, configure, and modify the Premium Lobby Setup.

<figure><img src="/files/3BINrKerQ1S2K5YmSMrJ" alt=""><figcaption></figcaption></figure>

## **Installation Instructions**

Follow the steps below to set up the **Premium Lobby Setup** on your server. You will need to have purchased our [**Premium Lobby Setup**](https://builtbybit.com/resources/premium-lobby-setup-nekio.53675) first. Once you have made the purchase, download it and continue with the instructions.

{% hint style="info" %}
It is highly recommended to install **Pufferfish 1.21.1** as your server's base software for optimal performance. You can download the latest version from [**here**](https://ci.pufferfish.host/job/Pufferfish-1.21/21/artifact/build/libs/pufferfish-paperclip-1.21.1-R0.1-SNAPSHOT-mojmap.jar). We suggest using **Pufferfish** because of its advanced optimization features, which are specifically designed to handle high player counts and improve server stability.
{% endhint %}

## ![](https://wiki.arefy.net/~gitbook/image?url=https%3A%2F%2F1987155368-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MR_H5ewvyOa3SDGl4ba%252F-MWAXlpNfmXjaa3JGM4S%252F-MWAYLWHghlnVa8FNon5%252FPrueba-1.png%3Falt%3Dmedia%26token%3D41a1de74-3189-4dd4-a167-e3f0520ebb58\&width=300\&dpr=1\&quality=100\&sign=3802d380\&sv=1) 1. Uploading all downloaded files into your hosting folder

Upload all files that you have download into your hosting folder, you just have to drag and drop them into the FTP that they gave you, as simple as that

<figure><img src="https://i.imgur.com/R1dpgX2.gif" alt=""><figcaption></figcaption></figure>

## ![](https://wiki.arefy.net/~gitbook/image?url=https%3A%2F%2F1987155368-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MR_H5ewvyOa3SDGl4ba%252F-MWAXlpNfmXjaa3JGM4S%252F-MWAYSEk5tVsi3CUtOU7%252FPrueba-1.png%3Falt%3Dmedia%26token%3D1ebf222f-5e8c-4408-b103-e573b8ac6eaf\&width=300\&dpr=1\&quality=100\&sign=4aee3df2\&sv=1) 2. Installing dependencies

Due redistribution rights that builtbybit has, we can't include some plugins in the setup, so you will have to download them and install them

{% hint style="warning" %}
Download all dependencies and install them in your **/plugins** folder
{% endhint %}

> **Tab** [*(Download it here)*](https://www.spigotmc.org/resources/tab-1-5-1-21-1.57806/)

## 3. ✅ Installation completed

Now you will be able to start the server and join through your host IP

{% hint style="info" %}
You can make yourself **Owner and Operator** by running on console the next commands
{% endhint %}

```
op %player%
```

```
lp user %player% parent add Owner
```

## Adding new gamemodes selector, giving money, etc...

All files are configurable, here is a list of most important files that you can edit (like enchantments levels, shop prices, etc)

<details>

<summary>How can I remove armorstands/npcs from gamemodes</summary>

If, for example, you want to replace Lifesteal with Skywars (or another gamemode, just as an example), stand in the center of the block (see the image below) and run `/minecraft:kill @e[type=armor_stand,distance=..5]`.&#x20;

This will remove all armor stands within a *5-block radius*. You can then place other functions (see below).

</details>

<figure><img src="https://i.imgur.com/ZLS9Zzq.png" alt=""><figcaption><p>Stand in the center of the gamemode zone and run the command from above to remove armorstands</p></figcaption></figure>

<details>

<summary>How can I place new armorstands/npcs for new gamemodes</summary>

After removing the gamemodes you don’t want, you can add new ones by placing armor stands. You’ll be able to choose from all our available models:

* **Prison Climber**: `/function #mch:mch001643_miner-climbing-ladder`
* **Survival Lumberjack**: `/function #mch:mch001276_man-carrying-logs` / **Logs**: `/function #mch:mch001270_logs-with-axe`
* **Lifesteal Killer**: `/function #mch:mch000452_jeff-the-killer` / **Heart**: `/function #mch:mch001508_valentines-heart`
* **Events Pumpkin**: `/function #mch:mch001331_halloween-pumpkin-ii`

You can use any functions from this list for other gamemodes as well. Just run any function command (for example, for Climber, `/function #mch:mch001643_miner-climbing-ladder`) and move it wherever you like.

</details>

<details>

<summary>How can I add new images for new gamemodes</summary>

Simply run `/imageframe create <name> <image link> <width> <height> nearest-color`. For example, to create a Skywars gamemode with a width of 3 blocks and a height of 1 block, use:

```bash
/imageframe create Skywars https://i.imgur.com/1nTxrSt.png 3 1 nearest-color
```

If you don’t have a text image for your gamemode, you can join our [Discord](https://discord.gg/arefy) and open a ticket *on Nekio Setups category*. We’ll create one for you *(one image free of charge; additional images require purchasing a setup addon)*.

</details>

<details>

<summary>How can I add/remove gamemodes on the gamemode selector menu</summary>

You'll need to edit `/plugins/DeluxeMenus/gui_menus/gamemodes.yml`

</details>

<details>

<summary>How can I give players money/points</summary>

You'll need to run `/points give <player> <points`>

</details>


# Survival Setup | Hytale

This guide will walk you through the steps to install, configure, and modify the Premium Survival Setup | Hytale

## **Installation Instructions**

Follow the steps below to set up the **Premium Survival Setup | Hytale** on your server. You will need to have purchased our [**Premium Survival Hytale Setup**](https://builtbybit.com/hytalesetup) first. Once you have made the purchase, download it and continue with the instructions.

You will need:

* The setup files extracted with winrar/zip (from your purchase download)
* The official Hytale dedicated server files (generated after installing the game)

{% hint style="danger" %}
You will need to add to the setup folder these **two files**

* **Assets.zip**
* **HytaleServer.jar**

***You will find these after installing Hytale game on:***

**Assets.zip**

```
C:\Users\...\AppData\Roaming\Hytale\install\release\package\game\latest
```

**HytaleServer.jar**

```
C:\Users\...\AppData\Roaming\Hytale\install\release\package\game\latest\Server
```

{% endhint %}

## ![](https://wiki.arefy.net/~gitbook/image?url=https%3A%2F%2F1987155368-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MR_H5ewvyOa3SDGl4ba%252F-MWAXlpNfmXjaa3JGM4S%252F-MWAYLWHghlnVa8FNon5%252FPrueba-1.png%3Falt%3Dmedia%26token%3D41a1de74-3189-4dd4-a167-e3f0520ebb58\&width=300\&dpr=1\&quality=100\&sign=3802d380\&sv=1) 1. Uploading all downloaded files into your hosting folder

Upload all setup files into your server folder.

Just drag & drop the setup contents into your host via FTP.

<figure><img src="/files/ceURi8LzSSeOoJRAWA33" alt=""><figcaption></figcaption></figure>

## ![](https://wiki.arefy.net/~gitbook/image?url=https%3A%2F%2F1987155368-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-MR_H5ewvyOa3SDGl4ba%252F-MWAXlpNfmXjaa3JGM4S%252F-MWAYSEk5tVsi3CUtOU7%252FPrueba-1.png%3Falt%3Dmedia%26token%3D1ebf222f-5e8c-4408-b103-e573b8ac6eaf\&width=300\&dpr=1\&quality=100\&sign=4aee3df2\&sv=1) 2. Authentificating with Hytale

### First run + auth (required)

Start the server once.

Then authenticate in the server console using Hytale’s device flow:

```
> auth login device
===================================================================
DEVICE AUTHORIZATION
===================================================================
Visit: https://accounts.hytale.com/device
Enter code: ABCD-1234
Or visit: https://accounts.hytale.com/device?user_code=ABCD-1234
===================================================================
Waiting for authorization (expires in 900 seconds)...

[User completes authorization in browser]

> Authentication successful! Mode: OAUTH_DEVICE
```

Stop the server and start it again after auth completes.

This ensures the server can finish downloading/validating required content.

## 3. ✅ Installation completed

Now you can start the server and join using your host IP.

{% hint style="info" %}
You can make yourself operator and give an admin rank by executing from the console:
{% endhint %}

```
op add %player%
```

```
lp user <player> parent add Admin
```

## Editing files and giving money, keys...

All files are configurable, here is a list of most important files that you can edit

<details>

<summary>How to give keys to players</summary>

You will only need to run as operator `/crate givekey <crate> <player> <amount>`, you can choose between **Vote, Epic, Mystic and Legendary**

</details>

<details>

<summary>How to give money to other players</summary>

`/economy` (You will have to be op before opening economy UI)

</details>

<details>

<summary>How to add more categories or items to the shop</summary>

Edit `shop.json` in `Server/mods/ArefyShop/`

<p align="center"><em>For example, this is an example for <strong>Weapons category</strong> with a Mithril Longsword</em></p>

```
{
  "categories": [
    {
      "id": "weapons",
      "displayName": "Weapons",
      "iconItemId": "Weapon_Sword_Iron",
      "description": "Swords, axes, bows and more",
      "items": [
        {
          "itemId": "Weapon_Longsword_Mithril",
          "displayName": "Mithril Longsword",
          "buyPrice": 6000,
          "sellPrice": 1200,
          "maxStack": 64,
          "canBuy": true,
          "canSell": true
        }
      ]
    }
  ]
}
```

</details>

<details>

<summary>How to add new crates or rewards</summary>

Edit `crates.json` in `Server/mods/ArefyCrates/`

<p align="center"><em>Example: a <strong>Vote Crate</strong>. You can change chances, add rewards, or create new crates.</em></p>

```
{
  "crates": [
    {
      "id": "vote",
      "displayName": "Vote Crate",
      "description": "Basic rewards for voting",
      "iconItemId": "Furniture_Temple_Emerald_Chest_Small",
      "keyItemId": "Ore_Copper",
      "keyDisplayName": "Vote Key",
      "particleId": "Portal_Ground_Hedera",
      "particleInterval": -1,
      "locations": [
        {
          "world": "Lobby",
          "x": 302.5,
          "y": 226.5,
          "z": 193.5
        }
      ],
      "rewards": [
        {
          "itemId": "Food_Bread",
          "displayName": "Bread",
          "minAmount": 5,
          "maxAmount": 15,
          "chance": 20.0,
          "rarity": "common"
        },
        {
          "itemId": "Food_Cheese",
          "displayName": "Cheese",
          "minAmount": 3,
          "maxAmount": 10,
          "chance": 15.0,
          "rarity": "common"
        },
        {
          "itemId": "Food_Egg",
          "displayName": "Eggs",
          "minAmount": 5,
          "maxAmount": 20,
          "chance": 15.0,
          "rarity": "common"
        },
        {
          "itemId": "Food_Fish_Raw",
          "displayName": "Raw Fish",
          "minAmount": 3,
          "maxAmount": 10,
          "chance": 10.0,
          "rarity": "common"
        },
        {
          "itemId": "Ore_Copper",
          "displayName": "Copper Ore",
          "minAmount": 5,
          "maxAmount": 15,
          "chance": 10.0,
          "rarity": "uncommon"
        },
        {
          "itemId": "Ingredient_Bar_Copper",
          "displayName": "Copper Bar",
          "minAmount": 2,
          "maxAmount": 8,
          "chance": 8.0,
          "rarity": "uncommon"
        },
        {
          "itemId": "Tool_Pickaxe_Copper",
          "displayName": "Copper Pickaxe",
          "minAmount": 1,
          "maxAmount": 1,
          "chance": 8.0,
          "rarity": "uncommon"
        },
        {
          "itemId": "Tool_Hatchet_Copper",
          "displayName": "Copper Hatchet",
          "minAmount": 1,
          "maxAmount": 1,
          "chance": 6.0,
          "rarity": "uncommon"
        },
        {
          "itemId": "Tool_Shovel_Copper",
          "displayName": "Copper Shovel",
          "minAmount": 1,
          "maxAmount": 1,
          "chance": 5.0,
          "rarity": "uncommon"
        },
        {
          "itemId": "Weapon_Sword_Copper",
          "displayName": "Copper Sword",
          "minAmount": 1,
          "maxAmount": 1,
          "chance": 2.0,
          "rarity": "rare"
        },
        {
          "itemId": "Weapon_Shield_Copper",
          "displayName": "Copper Shield",
          "minAmount": 1,
          "maxAmount": 1,
          "chance": 1.0,
          "rarity": "rare"
        }
      ],
      "enabled": true
    }
  ]
}

```

</details>

<details>

<summary>How to add AFK rewards, cuboid zone where player have to stand and edit time required to receive rewards</summary>

Edit `afk.json` in `Server/mods/ArefyAFK/`

```
{
  "zones": [
    {
      "id": "main_afk",
      "displayName": "AFK Zone",
      "world": "Lobby",
      "pos1": {
        "x": 327,
        "y": 225,
        "z": 210
      },
      "pos2": {
        "x": 360,
        "y": 247,
        "z": 175
      },
      "timeRequiredMinutes": 10,
      "rewards": [
        {
          "itemId": "Coin_Gold",
          "amount": 5,
          "chance": 50.0,
          "displayName": "5 Gold Coins"
        },
        {
          "itemId": "Weapon_Sword_Iron",
          "amount": 1,
          "chance": 10.0,
          "displayName": "Iron Sword"
        },
        {
          "itemId": "Food_Bread",
          "amount": 10,
          "chance": 40.0,
          "displayName": "10 Bread"
        }
      ]
    }
  ],
  "titleUpdateIntervalSeconds": 1,
  "mainTitle": "AFK Zone",
  "subtitleFormat": "{time} left"
}
```

</details>

<details>

<summary>How to add or edit current random teleport blocks for donor ranks</summary>

Edit `ArefyRandomTeleport.json` in `Server/mods/ArefyEconomy_ArefyRandomTeleport/`

```
{
  "TargetWorld": "Survival",
  "GlobalCooldownSeconds": 30,
  "MinYLevel": 64,
  "MaxYLevel": 120,
  "RtpOptions": {
    "regional": {
      "Name": "Regional",
      "Description": "Teleport further",
      "IconItemId": "Alchemy_Cauldron",
      "MinRange": 500,
      "MaxRange": 2500,
      "TitleColor": "#2196F3"
    },
    "global": {
      "Name": "Global",
      "Description": "Teleport far away",
      "IconItemId": "Alchemy_Cauldron_Big",
      "MinRange": 1000,
      "MaxRange": 5000,
      "TitleColor": "#9C27B0"
    },
    "local": {
      "Name": "Local",
      "Description": "Teleport nearby",
      "IconItemId": "Deco_Bucket",
      "MinRange": 100,
      "MaxRange": 1000,
      "TitleColor": "#4CAF50"
    }
  },
  "OpenGuiZone": {
    "Enabled": true,
    "World": "Lobby",
    "Pos1": {
      "X": 306,
      "Y": 226,
      "Z": 197
    },
    "Pos2": {
      "X": 298,
      "Y": 226,
      "Z": 189
    }
  }
}
```

</details>

<details>

<summary>How to edit current holograms or add new ones</summary>

For editing holograms, you only need to be an operator and execute `/holo ui` ingame to edit all of them or add new ones

</details>