Description
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.


