> For the complete documentation index, see [llms.txt](https://docs.nekiosetups.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nekiosetups.com/how-to-install-or-hytale-setups/survival-setup-or-hytale.md).

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