Skip to content

Pack‐Format

filloax edited this page Nov 13, 2026 · 2 revisions

Pack Format

Expeditionary Hardcore supports both resource packs and data packs for customization.


Resource Packs

Player Models

Custom player models can be added or replaced through resource packs. The mod uses BlockBench .bbmodel files with an embedded texture.

Location: assets/<namespace>/exphard_playermodels/<id>.bbmodel

The model ID used in data packs (see Player Model Definitions below) is <namespace>:<id>: for example a file at assets/mynamespace/exphard_playermodels/my_model.bbmodel has the ID mynamespace:my_model.

Notes:

  • The texture must be embedded directly in the .bbmodel file.
  • Uses vanilla player animations, so the model must have vanilla layer names (can have sub-groups with whatever name under them)
  • Built-in models are at assets/exphardcore/exphard_playermodels/.

Data Packs

Life Quirks

Life quirks are small per-life passive effects assigned randomly to a player's character. Each quirk is a JSON file loaded as a data-driven resource.

Location: data/<namespace>/exphard_quirks/<id>.json

Fields:

Field Type Default Description
name string (none) Translation key or plain display name. Falls back to the effect name if omitted.
description string (none) Translation key or plain description text.
icon ResourceLocation required Icon for this quirk. Meaning depends on iconIsVanillaEffect.
iconIsVanillaEffect boolean required If true, icon is a vanilla mob effect ID and that effect's icon is used. If false, icon resolves to assets/<namespace>/textures/quirk_icon/<path>.png.
weight int 10 Relative weight for random selection. Higher = more likely.
enabled boolean true Set to false to exclude this quirk from selection.
builtin boolean false Marks a quirk as built-in. Built-in quirks can be disabled via Apibalego.
attributeModifiers array [] List of attribute changes applied while this quirk is active.
behavior object (none) Optional custom behavior beyond simple attribute changes.

attributeModifiers entry fields:

Field Type Description
attribute ResourceLocation Vanilla attribute ID (e.g. "minecraft:movement_speed").
operation string One of "add_value", "add_multiplied_base", "add_multiplied_total".
amount double Amount to modify by.

behavior field:

Field Type Description
type ResourceLocation Behavior type. See below for available types.
params object Parameters specific to the behavior type (optional, defaults apply).

Behavior types:

exphardcore:fall_impact

Increases fall damage and applies brief effects on landing.

Param Type Default Description
damageMultiplier float 1.25 Multiplier applied to vanilla fall damage.
effectDurationTicks int 20 Duration of applied effects, in ticks.
effects ResourceLocation[] ["minecraft:blindness", "minecraft:slowness"] Effects applied on landing.
effectAmplifier int 0 Amplifier for the applied effects.
exphardcore:random_ambient_sound

Periodically plays a random ambient sound and optionally applies an effect.

Param Type Default Description
tickCheckFrequencyTicks int 20 How often the chance check runs, in ticks.
minDelayTicks int 100 Minimum ticks between sound plays.
chanceEachCheck double 0.01 Probability each check triggers the sound.
applyEffect ResourceLocation "minecraft:darkness" Effect to apply when the sound plays. Set to null for no effect.
applyEffectDurationTicks int 100 Duration of the applied effect, in ticks.
exphardcore:hunger_modifier

Applies multiplicative modifier to speed of hunger drain.

Param Type Default Description
exhaustionMultiplier float 1.05 Multipèlier of hunger drain. >1 => drains faster, <1 => drains slower.

Example: simple attribute quirk

{
  "name": "effect.mymod.quirk.clumsy",
  "description": "effect.mymod.quirk.clumsy.desc",
  "icon": "minecraft:mining_fatigue",
  "iconIsVanillaEffect": true,
  "weight": 8,
  "attributeModifiers": [
    {
      "attribute": "minecraft:attack_speed",
      "operation": "add_multiplied_total",
      "amount": -0.1
    }
  ]
}

Example: behavior quirk

{
  "name": "effect.mymod.quirk.heavy_boned",
  "description": "effect.mymod.quirk.heavy_boned.desc",
  "icon": "mymod:heavy_boned",
  "iconIsVanillaEffect": false,
  "behavior": {
    "type": "exphardcore:fall_impact",
    "params": {
      "effectDurationTicks": 60,
      "effects": ["minecraft:slowness", "minecraft:blindness"]
    }
  }
}

Player Model Definitions

The data pack side of custom player models used to sync them between players. Each file points to a .bbmodel asset (see Player Models).

Location: data/<namespace>/exphard_playermodels/<id>.json

Fields:

Field Type Default Description
model ResourceLocation required Resource ID of the .bbmodel file, without the extension. E.g. "exphardcore:cydonia" resolves to assets/exphardcore/exphard_playermodels/cydonia.bbmodel.
builtin boolean false Marks this entry as built-in. Built-in entries can be replaced via Apibalego.

Example:

{
  "model": "mymod:explorer",
  "builtin": false
}

The model definition and the .bbmodel file in your resource pack must have matching IDs.

Character Loadout

The starting loadout given to each new character is drawn from a Minecraft loot table (as in, the vanilla data type) chosen randomly from a specific custom tag. You can add custom loadouts or replace the defaults entirely.

Tags:

Tag Description
exphardcore:character_loadout Pool of loot tables to pick from. A random table is selected each new life. The mod includes some tables in this tag.
exphardcore:character_loadout_override If non-empty, this tag is used instead of character_loadout. Use this to fully replace the default loadouts.

Tag location: data/<namespace>/tags/loot_table/exphardcore/character_loadout.json (and character_loadout_override.json)

Loot tables should use "type": "minecraft:gift". Items are automatically sorted into appropriate inventory slots: weapons and tools go to the hotbar, armor is equipped, shields or banners go to the offhand, and remaining items fill the inventory.

Example tag: adding a custom loadout

{
  "values": [
    "mymod:loadout/archer"
  ]
}

Clone this wiki locally