Skip to content

Features

filloax edited this page Nov 13, 2026 · 2 revisions

Features

Expeditionary Hardcore turns each death into a new character with a random starting location, a randomized loadout, an optional life quirk, and a new player model. All of these features are controlled by the Expedition Mode gamerule and can be heavily customized through the config and data/resource packs.


Expedition Mode

Expedition Mode is selected during world creation (as a gamemode like Hardcore, etc.). It's a gamerule (exphardcore.expedition). When off, the game behaves like vanilla. When on:

  • Respawn is overridden to a random location.
  • Each respawn creates a new character (life).
  • Players receive a starting loadout and a life quirk (if enabled).
  • A new player model is assigned.
  • Every character has their own Ender Chest.
  • Difficulty is forced and locked to Hard.
  • The /spawnpoint command is disabled.

Toggle also via command if op:

/exphardcore enabled on
/exphardcore enabled off
/exphardcore enabled status

Or you can use normal /gamerule.


Random Respawn

On each death, the mod picks a new respawn point according to the respawn configuration. The algorithm:

  1. Selects a center (world origin, nearest stronghold, or the player's last respawn point, see respawnCenter in Config).
  2. Picks a random point within a distance from the center, within the configured min/max radius. The distance distribution can be uniform, biased toward the edge/center, or gaussian around a midpoint (see respawnDistribution).
  3. Checks the result against conditions: avoids ocean biomes if configured, and enforces a minimum distance from the previous respawn point (unless the center is already the last respawn point).
  4. Retries up to 20 times if conditions aren't met; uses the last result if all attempts fail.

If forcedRespawnLocations is configured (only via Apibalego), the algorithm is skipped entirely and a random entry from that list is used instead.


Characters and Lives

Every respawn begins a new character. Each character has:

  • A unique ID
  • A name chosen by the player through the Expeditioner's Logbook
  • A recorded spawn point
  • A life quirk (if enabled)
  • A player model assignment

On respawn, the player must set a name by using the Expeditioner's Logbook

Character data persists on the server and is synced to the client. The player's display name in the tab list and above their head reflects their current character's name.

A player's full character history can be viewed with /exphardcore history, which also shows each character's spawn coordinates.


Life Quirks

If enabled (see enableLifeQuirks in Config), each new character is randomly assigned a life quirk, a minor passive effect that lasts for the whole life.

Quirks can:

  • Modify player attributes (movement speed, max health, attack damage, etc.)
  • Trigger custom behavior on specific events (fall damage, periodic ticks)

The quirk icon and description appear in the player's effects HUD. The list of built-in quirks:

Quirk Effect
Slow −10% movement speed
Frail −2 max health (1 heart)
Clumsy −10% attack speed
Weak −10% attack damage
Airless −20% oxygen bonus underwater
Heavy-Boned Falls deal more damage and briefly apply slowness and blindness
Paranoia Occasionally plays ambient sounds and briefly applies Darkness

Custom quirks can be added via datapack — see Pack Format.


Character Loadout

On each respawn, the player receives a random starting loadout drawn from a loot table. One loot table is picked randomly from the exphardcore:character_loadout tag (or exphardcore:character_loadout_override if that tag is non-empty).

Items from the loot table are automatically distributed:

  • Weapons and tools go to hotbar slots (weapons first).
  • Armor pieces are equipped in the appropriate slots (best available by armor value).
  • A shield or banner goes to the offhand.
  • Remaining items fill the inventory randomly.

The last hotbar slot is reserved for the Expeditioner's Logbook.

The built-in loadout pool contains two loot tables:

  • Warrior: leather armor, wooden sword, shield, bread
  • Miner: wooden pickaxe, wooden shovel, shield, bread, coal

Custom loadout tables can be added or the defaults replaced via datapack, see Pack Format.

In multiplayer teams, secondary players (those who respawn near the team's main player) only receive a loadout once per main-player life cycle. After that, they join without items until the main player dies and a new life starts.


Player Models

If enabled (see replacePlayerModel in Config), each character is assigned a custom player model for their life, with standard vanilla animations.

Models are .bbmodel files (BlockBench format) with an embedded texture, placed in assets/<namespace>/exphard_playermodels/. Each model also requires a data-pack entry pointing to the file (see Pack Format).

Note that player "models" included in the mod are the same as the normal player model just with a different skin, but resource packs can add custom models.

Clone this wiki locally