StarterBoost - Client Edition

Automatic configurable starter items and Pals for Singleplayer and Co-op worlds.

StarterBoost gives each player a configurable starter kit the first time they enter a world.

The Client Edition is intended for Singleplayer and player-hosted Co-op sessions and only needs to be installed by the host.

Guests can receive their own starter items and Pals without installing StarterBoost themselves.

Main Features

• []Automatic starter item delivery[/]

  []Automatic starter Pal delivery[/]

  []Configurable item IDs and quantities[/]

  []Configurable Pal IDs and levels[/]

  []Up to 5 starter Pals[/]

  []Separate persistence for every player[/]

  []Separate persistence for every world[/]

  []No duplicate delivery when reconnecting[/]

  []New worlds allow a new starter kit[/]

  []Guests do not need the mod installed[/]

  []Persistent state stored outside the Palworld save[/]

How persistence works

Older player-only persistence would identify a player only by their Player UID.

That means the same player entering another world could incorrectly be considered already served.

StarterBoost Client Edition instead uses:

WorldSaveDirectoryName::PlayerUIdExample:

World A :: Host

DB9433814FE014EAD16B539CBEBE4C8C::0_0_0_1

World A :: Guest

DB9433814FE014EAD16B539CBEBE4C8C::2091718538_0_0_0

World B :: Host

04303D4A48BC0B90C5C0C8A0D5647D91::0_0_0_1

World B :: Guest

04303D4A48BC0B90C5C0C8A0D5647D91::2091718538_0_0_0As a result:

Same world + same player

= no duplicate kit

Different world + same player

Same world + different player

= separate kit

Requirements

• []Palworld[/]

  []UE4SS[/]

Installation

Extract/copy the

StarterBoostfolder to:

Palworld/Mods/NativeMods/UE4SS/Mods/Expected structure:

StarterBoost/

├── enabled.txt

└── Scripts/

├── config.lua

├── main.lua

├── give_starter_pal.lua

└── starter_state.luaFor Co-op:

HOST      → StarterBoost installed

GUEST     → No installation requiredStart the game and load the world normally.

Configuration

StarterBoost/Scripts/config.luaThe starter item list can contain multiple entries with an item ID and quantity.

Starter Pals can also be configured individually with their Pal ID and level.

Config. StarterPal = {

{ PalID = "Garm", Level = 1 },

{ PalID = "GrimGirl", Level = 1 },

}The mod supports a maximum of 5 starter Pals.

Default test configuration

The current configuration has been tested with automatic delivery of:

FurHelmet_5        x1

ClothArmor_5       x1

BowGun_5           x1

Arrow               x25

Wood                x15

Stone               x15

Pal_crystal_S       x15

PalSphere           x15

Baked_Berries       x5

Money               x500

Wool                x5

SkillUnlock_Garm    x1Starter Pals:

Garm       Lv. 1

GrimGirl   Lv. 1The contents can be changed in config.lua.

Persistent State

StarterBoost automatically creates:

starterboost_delivered.txtExample:

# StarterBoost persistent state v3

# WorldKey::PlayerUId|items=0/1|pals=PalKey1,PalKey2The file records item delivery and individual Pal delivery separately.

This also allows StarterBoost to recover from partial delivery instead of treating the entire kit as one single operation.

Deleting the persistence file resets StarterBoost's delivery history.

Multiplayer

For player-hosted Co-op, StarterBoost runs on the host.

The host can detect and deliver the kit to joining players, so guests do not need UE4SS or StarterBoost installed for this mod.

Each guest is tracked using their own Player UID.

Dedicated Servers

This edition is intended for Singleplayer and player-hosted Co-op.

For a dedicated Palworld server, use StarterBoost Server Edition.

Credits

Code created with the assistance of AI.