promotional bannermobile promotional banner

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.

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.

The Headstart Team

profile avatar
Owner
  • 1
    Projects
  • 53
    Downloads