Skip to content

Compatibility and API

MKI edited this page Nov 9, 2026 · 1 revision

Compatibility and API

Siege Core has no Java API. Modpacks and other mods connect through the config and through entity tags.

Adding mobs from other mods

Set customInvasionMobsEnabled to true and add entries to customInvasionMobs in config/siegecore/config.json. Entries for mods that are not installed are ignored.

{
  "entity": "wildcreatures:bear",
  "displayName": "Siege Bear",
  "displayNameKey": "",
  "weight": 5,
  "fromStage": 2,
  "fromWave": 3,
  "fromInfinityLevel": 1,
  "untilWave": 0,
  "untilStage": 0,
  "untilInfinityLevel": 0,
  "maxPerWave": 2,
  "healthMultiplier": 1.0,
  "damageMultiplier": 1.0,
  "speedMultiplier": 1.0,
  "countsAsElite": false,
  "countsAsBoss": false,
  "flying": false,
  "allowedEvents": []
}
Field Meaning
entity Entity id
displayName Name to show. Empty uses the entity's own name
displayNameKey Language key, used instead of displayName
weight How often this mob is picked
fromStage, fromWave, fromInfinityLevel When it can first appear
untilStage, untilWave, untilInfinityLevel When it stops appearing. 0 means no limit
maxPerWave Most per wave
healthMultiplier, damageMultiplier, speedMultiplier Stat changes
countsAsElite Treated as an Elite
countsAsBoss Used as a boss instead of a wave mob
flying Spawns in the air
allowedEvents Only appears during these events, for example blood_moon or sapper_raid; none is a wave without an event. Empty means always

By default a mob's weight competes with customMobVanillaWeight: a weight of 10 against a vanilla weight of 20 makes about a third of the wave custom mobs. See Configuration.

Flyers must have the minecraft:flying_speed attribute, otherwise they are skipped to protect the server.

Boss milestones

bossMilestones adds extra boss fights:

{ "level": 5, "wave": 10, "bossCount": 2, "infinityOnly": false, "exactLevel": false }

Loot lists

giant_zombie_loot, ravager_loot, wither_skeleton_loot, invasion_reward_loot and infinity_reward_loot use this format:

{ "item": "minecraft:diamond", "minCount": 1, "maxCount": 3, "chance": 0.35 }

Trophy drops are normal loot tables, for example siegecore:entities/warlord, and a data pack can replace them.

Entity tags

Siege mobs carry scoreboard tags that commands and other mods can read.

Tag Meaning
siegecore_mob Any siege mob
siegecore_base_<id> The base it belongs to
siegecore_boss A boss
siegecore_elite An Elite
siegecore_custom_mob From the custom pool
siegecore_event_<event> Spawned during that event
siegecore_boss_modifier_<modifier> The boss's modifier
/effect give @e[tag=siegecore_boss] minecraft:glowing 10

Entity and block ids

Monsters: siegecore:sapper, siegecore:harrier, siegecore:shield_bearer, siegecore:shaman, siegecore:battering_ram

Bosses: siegecore:warlord, siegecore:siege_colossus, siegecore:storm_wyvern

Blocks: siegecore:siege_core, siegecore:siege_barricade, siegecore:spike_trap, siegecore:slow_trap, siegecore:flame_trap, siegecore:frost_totem, siegecore:repair_pylon, siegecore:ballista_turret, siegecore:sky_guard_turret, siegecore:war_horn

Other mods

Pets of team members count as defenders, so siege mobs may fight them and they may fight back. This includes companions from Loyal Companions.

Clone this wiki locally