Back to Mods
Headstart

Headstart

miscephreal

Headstart allows server mods to determine exactly what items players receive in their hotbar when they have an empty inventory on first login or death.

About Headstart

Headstart

Headstart is a Hytale mod that allows you to customize the starting experience for a player. Depending on the configuration, players can receive items when:

They first log in

They log in with an empty inventory

They die with an empty inventory

By default, items are only granted on a player's first login.

Feel free to use this in any modpack so long as Headstart itself remains hosted on CurseForge.

Setup

Configuring Headstart is straightforward. You can either

create a config file for Headstart (see the example on Github) and place it in the world's mod folder

This is not the same folder you place the mod in. This folder only appears after creating a world.

log into your server and configure the mod through server commands.

If you've configured the mod through server commands, then

Use the headstart reset command below to clear the known player's list

remove all items from your inventory

log back in

Commands

Headstart has two commands

/headstart

The /headstart command allows you to modify the behavior of headstart itself.

Arguments

firstLogin (default true)

Determines whether Headstart only applies on a player's first login. If false, players receive items every time they log in with an empty inventory.

onDeath (default false)

Determines whether Headstart applies when a player dies. If true, players receive items when they die and have an empty inventory. onDeath is checked separately from firstLogin. If onDeath and firstLogin are both true, a player will still receive items if they die and have an empty inventory.

reset

Resets firstLogin and onDeath to defaults and clears the player list.

Examples

/headstart --firstLogin false /headstart --onDeath true /headstart --reset /headstart --firstLogin true --onDeath false

/hotbarcfg

/hotbarcfg customizes what items a player receives.

Required Arguments

slot (1-9) The slot number to configure

itemId an item ID from Hytale

Optional Default Arguments

Durability (default 100.0) The current durability of an item

maxDurability (default 100.0) The maximum durability the item should have

amount (default 1) The amount of items to place in that stack.

Examples

Set slot 1 to have 50 torches

/hotbarcfg 1 Furniture_Crude_Torch --durability 0 --maxDurability 0 --amount 50

Set slot 2 to have a scrap pickaxe with default durability

/hotbarcfg 2 Tool_Pickaxe_Scrap

Set slot 3 to have a crude hatchet with far more durability than is reasonable

/hotbarcfg 3 Tool_Hatchet_Crude --durability 1000 --maxDurability 1000

Bugs/Feature Requests

Please report bugs or make feature requests on GitHub.

Downloads
15
Created
Jan 24, 2026
Updated
Jan 24, 2026
Version
Early Access

Categories

MiscellaneousQuality of LifeUtility

Download Mod

Download on CurseForge
Free download • 15 total downloads

Need a Server?

Run Headstart on a dedicated Hytale server with easy mod management.

Get Hytale Hosting

Frequently Asked Questions

What is Headstart?

Headstart allows server mods to determine exactly what items players receive in their hotbar when they have an empty inventory on first login or death.

How do I download Headstart?

You can download Headstart for free from CurseForge. Click the "Download on CurseForge" button on this page to go directly to the download page.

Who created Headstart?

Headstart was created by ephreal. The mod has been downloaded 15 times.

Is Headstart compatible with Hytale servers?

Headstart is designed for Hytale and can be used on both single-player and multiplayer servers. Check the mod page on CurseForge for specific compatibility information.

How do I install Headstart?

To install Headstart: 1) Download the mod from CurseForge, 2) Place the file in your Hytale mods folder, 3) Restart the game. The mod should load automatically.