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


---

# 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://docs.nekiosetups.com/how-to-install-or-hytale-setups/survival-setup-or-hytale.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.