Repository navigation
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
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).
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
}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
}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
}