Skip to content

Apibalego‐Integration

filloax edited this page Jul 26, 2026 · 1 revision

Apibalego Integration

Expeditionary Hardcore optionally integrates with Apibalego, a companion mod that connects Minecraft to an external web server (the "gamemaster"), allowing runtime configuration and data sync without restarting the game.

When Apibalego is not installed, all features on this page have no effect

This mod was originally made for a livestream series, so this mostly exists in that context. Still, there is the Egobalego at Home webtool to use this in normal playthroughs


API Entries

The following API entries are registered by Expeditionary Hardcore. Each entry is pushed from the gamemaster server and takes effect immediately on the running server, overriding the local config where applicable.

Also, as by base APIBalego functionality anything that can be added via datapack or resourcepack can be added by making APIBalego download a custom data/resourcepack. The mod entries include ways to disable builtin data to only have custom data (so you can only have the stuff set via APIBalego).


exphardcore:respawn_config

Overrides respawn behavior at runtime. Any field can be omitted: omitted fields fall back to the local config value.

Schema (RespawnConfigDto):

Field Type Default Description
respawnRadiusMin int 500 Minimum distance from the center where players can respawn.
respawnRadiusMax int 5000 Maximum distance from the center.
minDistanceFromLastRespawn int 1000 Minimum distance from the previous respawn point. Not used when respawnCenter is LAST_RESPAWN_POINT.
respawnCenter string "WORLD_ORIGIN" The origin point for respawn radius. One of WORLD_ORIGIN, STRONGHOLD, LAST_RESPAWN_POINT.
respawnDistribution string "UNIFORM" How distance is distributed within the radius. One of UNIFORM, NEARER_MORE_LIKELY, FURTHER_MORE_LIKELY, MIDPOINT_MORE_LIKELY.
respawnDistributionMidpoint int -1 Distance from center where respawns cluster (only for MIDPOINT_MORE_LIKELY). -1 uses the halfway point between min and max.
avoidOceans boolean true Skip ocean biomes when picking a respawn position.
forcedRespawnLocations BlockPos[] (none) If set, ignores random selection and cycles through this list of positions instead.

BlockPos format: {"x": 0, "y": 64, "z": 0}

Example

{
  "respawnCenter": "STRONGHOLD",
  "respawnRadiusMin": 1000,
  "respawnRadiusMax": 8000,
  "respawnDistribution": "MIDPOINT_MORE_LIKELY",
  "avoidOceans": true
}

exphardcore:life_quirks_config

Controls whether life quirks are active and whether the built-in quirks are included in the pool.

Schema (ApibalegoQuirkConfig):

Field Type Default Description
enabled boolean true If false, no quirk is assigned to new characters, regardless of the local config.
disableBuiltins boolean false If true, removes all built-in quirks (those with "builtin": true) from the pool. Only quirks added via datapack (so possibly also by APIBalego) remain.

Example: disable built-ins to use only custom datapack quirks

{
  "enabled": true,
  "disableBuiltins": true
}

exphardcore:player_models

Pushes additional player model IDs from the gamemaster and optionally replaces all built-in models.

Schema (PlayerModelApibalegoDetails):

Field Type Default Description
models ResourceLocation[] [] List of additional model IDs to include in the per-life random model pool. These must still be present as .bbmodel files in a loaded resource pack (add it via APIBalego).
replaceBuiltins boolean false If true, built-in models (those with "builtin": true in their data pack entry) are excluded from selection. Only the models listed here are used.

Example: add a custom model and replace built-ins

{
  "models": ["mymod:explorer", "mymod:scout"],
  "replaceBuiltins": true
}

Clone this wiki locally