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.