Ballistics

Siegeworks projectiles use data-driven physical profiles for flight, penetration, direct damage, shock and explosions. See Data Pack Reference for the JSON fields.

Flight and energy

Engine projectile speed is defined in blocks per second and converted to blocks per tick when fired. Weapons with adjustable tension multiply that initial speed by the selected value.

initial speed = projectileSpeed / 20 × tension
kinetic energy = 0.5 × mass × speed²
penetration power = kinetic energy × penetration

Drag removes a fraction of velocity each tick. Gravity then produces the different trajectories of bolts, cannon balls, rockets and thrown stone.

Penetration and damage

A projectile continues through a block only when its penetration power covers the block's cost. Hardness, blast resistance, material density and profile multipliers contribute to that cost. The remaining energy determines the projectile's new speed.

Direct entity damage scales with speed, the engine's base damage and the projectile profile. armorPiercing reduces the armour mitigation applied to the hit; it does not bypass armour completely.

Both bolt types can penetrate leaves and tagged glass. The Tower Crossbow Bolt can also penetrate planks, wooden doors, wooden trapdoors, wooden fences and fence gates.

Structural damage

Impacts can damage blocks without breaking them immediately. Damage accumulates at each block position and uses the vanilla break-stage overlay. The block breaks when accumulated progress reaches its limit; replacing the block clears that record.

Destroyed blocks may produce short-lived physical debris. Debris has a shared per-world limit and can be disabled independently of actual damage in Server Configuration.

Built-in profiles

Projectile	Mass	Penetration	Block damage	Entity damage	Base explosion
Short Tower Crossbow Bolt	16	0.85	0.25	1.10	0
Tower Crossbow Bolt	28	1.25	0.45	1.35	0
Cannon Ball	52	0.95	1.10	1.30	0
Giant Cannon Ball	220	1.55	1.60	1.43	3.8
Mangonel Stone	60	0.35	0.80	1.55	1.0
Trebuchet Stone	90	0.55	1.90	1.50	2.6
Scattershot Pellet	1.5	0.06	0.08	0.90	0
Singijeon	1.2	0.08	0	1.10	0