Repository navigation
Pack‐Format
Expeditionary Hardcore supports both resource packs and data packs for customization.
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
.bbmodelfile. - 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/.
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"]
}
}
}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.
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"
]
}