BulletType

Built-in constants:

placeholder spaceLiquid damageLightning damageLightningGround damageLightningAir fireball

BulletType

extends Content

field	type	default	notes
lifetime	float	40.0	Lifetime in ticks.
lifeScaleRandMin	float	1.0	Min/max multipliers for lifetime applied to this bullet when spawned.
lifeScaleRandMax	float	1.0	Min/max multipliers for lifetime applied to this bullet when spawned.
speed	float	1.0	Speed in units/tick.
velocityScaleRandMin	float	1.0	Min/max multipliers for velocity applied to this bullet when spawned.
velocityScaleRandMax	float	1.0	Min/max multipliers for velocity applied to this bullet when spawned.
damage	float	1.0	Direct damage dealt on hit.
hitSize	float	4.0	Hitbox size.
drawSize	float	40.0	Clipping hitbox.
angleOffset	float	0.0	Angle offset applied to bullet when spawned each time.
randomAngleOffset	float	0.0	Angle offset applied to bullet when spawned each time.
drag	float	0.0	Drag as fraction of velocity.
accel	float	0.0	Acceleration per frame.
pierce	boolean	false	Whether to pierce units.
pierceBuilding	boolean	false	Whether to pierce buildings.
pierceCap	int	-1	Maximum # of pierced objects.
pierceDamageFactor	float	0.0	Multiplier of damage decreased per health pierced.
maxDamageFraction	float	-1.0	If positive, limits non-splash damage dealt to a fraction of the target's maximum health.
removeAfterPierce	boolean	true	If false, this bullet isn't removed after pierceCap is exceeded. Expert usage only.
laserAbsorb	boolean	true	For piercing lasers, setting this to true makes it get absorbed by plastanium walls.
optimalLifeFract	float	0.0	Life fraction at which this bullet has the best range/damage/etc. Used for lasers and continuous turrets.
layer	float	100.0	Z layer to drawn on.
hitEffect	Effect	hitBulletSmall	Effect shown on direct hit.
despawnEffect	Effect	hitBulletSmall	Effect shown when bullet despawns.
shootEffect	Effect	shootSmall	Effect created when shooting.
chargeEffect	Effect	none	Effect created when charging starts; only usable in single-shot weapons with a firstShotDelay / shotDelay.
smokeEffect	Effect	shootSmallSmoke	Extra smoke effect created when shooting.
hitSound	Sound	none	Sound made when hitting something or getting removed.
despawnSound	Sound	none	Sound made when hitting something or getting removed.
hitSoundPitch	float	1.0	Pitch of the sound made when hitting something
hitSoundVolume	float	1.0	Volume of the sound made when hitting something
inaccuracy	float	0.0	Extra inaccuracy when firing.
ammoMultiplier	float	2.0	How many bullets get created per ammo item/liquid.
reloadMultiplier	float	1.0	Multiplied by turret reload speed to get final shoot speed.
buildingDamageMultiplier	float	1.0	Multiplier of how much base damage is done to tiles.
shieldDamageMultiplier	float	1.0	Multiplier of how much base damage is done to force shields.
recoil	float	0.0	Recoil from shooter entities.
killShooter	boolean	false	Whether to kill the shooter when this is shot. For suicide bombers.
instantDisappear	boolean	false	Whether to instantly make the bullet disappear.
splashDamage	float	0.0	Damage dealt in splash. 0 to disable.
scaledSplashDamage	boolean	false	If true, splash damage is "correctly" affected by unit hitbox size. Used for projectiles that do not collide / have splash as their main source of damage.
knockback	float	0.0	Knockback in velocity.
impact	boolean	false	Should knockback follow the bullet's direction
status	StatusEffect	none	Status effect applied on hit.
statusDuration	float	480.0	Intensity of applied status effect in terms of duration.
targetBlocks	boolean	true	Turret only. If false, blocks will not be targeted.
targetMissiles	boolean	true	Turret only. If false, missiles will not be targeted.
collidesTiles	boolean	true	Whether this bullet type collides with tiles.
collidesTeam	boolean	false	Whether this bullet type collides with tiles that are of the same team.
collidesAir	boolean	true	Whether this bullet type collides with air/ground units.
collidesGround	boolean	true	Whether this bullet type collides with air/ground units.
collides	boolean	true	Whether this bullet types collides with anything at all.
collideFloor	boolean	false	If true, this projectile collides with non-surface floors.
collideTerrain	boolean	false	If true, this projectile collides with static walls
keepVelocity	boolean	true	Whether velocity is inherited from the shooter.
scaleLife	boolean	false	Whether to scale lifetime (not actually velocity!) to disappear at the target position. Used for artillery.
hittable	boolean	true	Whether this bullet can be hit by point defense.
reflectable	boolean	true	Whether this bullet can be reflected.
absorbable	boolean	true	Whether this projectile can be absorbed by shields.
backMove	boolean	true	Whether to move the bullet back depending on delta to fix some delta-time related issues. Do not change unless you know what you're doing.
ignoreSpawnAngle	boolean	false	If true, the angle param in create is ignored.
createChance	float	1.0	Chance for this bullet to be created.
maxRange	float	-1.0	Bullet range positive override.
rangeOverride	float	-1.0	When > 0, overrides range even if smaller than base range.
rangeChange	float	0.0	When used in a turret with multiple ammo types, this can be set to a non-zero value to influence range.
extraRangeMargin	float	0.0	When used in turrets with limitRange() applied, this adds extra range to the bullets that extends past targeting range. Only particularly relevant in vanilla.
range	float	0.0	Range initialized in init().
minRangeChange	float	0.0	When used in a turret with multiple ammoo types, this can be set to a non-zero value to influence minRange
healPercent	float	0.0	% of block health healed *
healAmount	float	0.0	flat amount of block health healed
lifesteal	float	0.0	Fraction of bullet damage that heals that shooter.
makeFire	boolean	false	Whether to make fire on impact
hitUnder	boolean	false	Whether this bullet will always hit blocks under it.
despawnHit	boolean	false	Whether to create hit effects on despawn. Forced to true if this bullet has any special effects like splash damage.
fragOnHit	boolean	true	If true, this bullet will create bullets when it hits anything, not just when it despawns.
fragOnAbsorb	boolean	true	If false, this bullet will not create fraags when absorbed by a shield.
pierceArmor	boolean	false	If true, unit armor is ignored in damage calculations.
sticky	boolean	false	If true, the bullet will "stick" to enemies and get deactivated on collision.
stickyExtraLifetime	float	0.0	Extra time added to bullet when it sticks to something.
setDefaults	boolean	true	Whether status and despawnHit should automatically be set.
hitShake	float	0.0	Amount of shaking produced when this bullet hits something or despawns.
despawnShake	float	0.0	Amount of shaking produced when this bullet hits something or despawns.
fragBullet	BulletType	null	Bullet type that is created when this bullet expires.
delayFrags	boolean	false	If true, frag bullets are delayed to the next frame. Fixes obscure bugs with piercing bullet types spawning frags immediately and screwing up the Damage temporary variables.
fragRandomSpread	float	360.0	Degree spread range of fragmentation bullets.
fragSpread	float	0.0	Uniform spread between each frag bullet in degrees.
fragAngle	float	0.0	Angle offset of fragmentation bullets.
fragBullets	int	9	Number of fragmentation bullets created.
fragVelocityMin	float	0.2	Random range of frag velocity as a multiplier.
fragVelocityMax	float	1.0	Random range of frag velocity as a multiplier.
fragLifeMin	float	1.0	Random range of frag lifetime as a multiplier.
fragLifeMax	float	1.0	Random range of frag lifetime as a multiplier.
fragOffsetMin	float	1.0	Random offset of frag bullets from the parent bullet.
fragOffsetMax	float	7.0	Random offset of frag bullets from the parent bullet.
pierceFragCap	int	-1	How many times this bullet can release frag bullets, if pierce = true.
intervalBullet	BulletType	null	Bullet that is created at a fixed interval.
bulletInterval	float	20.0	Interval, in ticks, between which bullet spawn.
intervalBullets	int	1	Number of bullet spawned per interval.
intervalRandomSpread	float	360.0	Random angle added to interval bullets.
intervalSpread	float	0.0	Angle spread between individual interval bullets.
intervalAngle	float	0.0	Angle offset for interval bullets.
intervalDelay	float	-1.0	Use a negative value to disable interval bullet delay.
underwater	boolean	false	If true, this bullet is rendered underwater. Highly experimental!
hitColor	Color	ffffffff	Color used for hit/despawn effects.
healColor	Color	98ffa9ff	Color used for block heal effects.
healEffect	Effect	healBlockFull	Effect emitted upon blocks that are healed.
spawnBullets	Seq	new Seq<>()	Bullets spawned when this bullet is created. Rarely necessary, used for visuals.
spawnBulletRandomSpread	float	0.0	Random angle spread of spawn bullets.
spawnUnit	UnitType	null	Unit spawned instead of this bullet. Useful for missiles.
despawnUnit	UnitType	null	Unit spawned when this bullet hits something or despawns due to it hitting the end of its lifetime.
despawnUnitChance	float	1.0	The chance for despawn units to spawn.
despawnUnitCount	int	1	Amount of units spawned when this bullet despawns.
despawnUnitRadius	float	0.1	Random offset distance from the original bullet despawn/hit coordinate.
faceOutwards	boolean	false	If true, units spawned when this bullet despawns face away from the bullet instead of the same direction as the bullet.
parts	Seq	new Seq<>()	Extra visual parts for this bullet.
trailColor	Color	e58956ff	Color of trail behind bullet.
trailChance	float	-1.0E-4	Chance of trail effect spawning on bullet per tick.
trailInterval	float	0.0	Uniform interval in which trail effect is spawned.
trailMinVelocity	float	0.0	Min velocity required for trail effect to spawn.
trailEffect	Effect	missileTrail	Trail effect that is spawned.
trailSpread	float	0.0	Random offset of trail effect.
trailParam	float	2.0	Rotation/size parameter that is passed to trail. Usually, this controls size.
trailRotation	boolean	false	Whether the parameter passed to the trail is the bullet rotation, instead of a flat value.
trailInterp	Interp	one	Interpolation for trail width as function of bullet lifetime
trailLength	int	-1	Length of trail quads. Any value <= 0 disables the trail.
trailWidth	float	2.0	Width of trail, if trailLength > 0
trailSinMag	float	0.0	If trailSinMag > 0, these values are applied as a sine curve to trail width.
trailSinScl	float	3.0	If trailSinMag > 0, these values are applied as a sine curve to trail width.
circleShooter	boolean	false	If true, the bullet will attempt to circle around its shooting entity.
circleShooterRadius	float	13.0	Radius that the bullet attempts to circle at.
circleShooterRadiusSmooth	float	10.0	Smooth extra radius value for circling.
circleShooterRotateSpeed	float	0.3	Multiplier of speed that is used to adjust velocity when circling.
splashDamageRadius	float	-1.0	Use a negative value to disable splash damage.
splashDamagePierce	boolean	false	If true, splash damage pierces through tiles.
incendAmount	int	0	Amount of fires attempted around bullet.
incendSpread	float	8.0	Spread of fires around bullet.
incendChance	float	1.0	Chance of fire being created.
homingPower	float	0.0	Power of bullet ability. Usually a number between 0 and 1; try 0.1 as a starting point.
homingRange	float	50.0	Range of homing effect around bullet.
homingDelay	float	-1.0	Use a negative value to disable homing delay.
suppressionRange	float	-1.0	Range of healing block suppression effect.
suppressionDuration	float	480.0	Duration of healing block suppression effect.
suppressionEffectChance	float	50.0	Chance of suppression effect occurring on block, scaled down by number of blocks.
suppressColor	Color	bf92f9ff	Color used for the regenSuppressSeek effect.
lightningColor	Color	f3e979ff	Color of lightning created by bullet.
lightning	int	0	Number of separate lightning "roots".
lightningLength	int	5	Length of each lightning strand.
lightningLengthRand	int	0	Extra random length added onto base length of lightning.
lightningDamage	float	-1.0	Use a negative value to use default bullet damage.
lightningCone	float	360.0	Spread of lightning, relative to bullet rotation.
lightningAngle	float	0.0	Offset of lightning relative to bullet rotation.
lightningType	BulletType	null	The bullet created at lightning points.
weaveScale	float	1.0	Scale of bullet weave pattern. Higher -> less vibration.
weaveMag	float	0.0	Intensity of bullet weaving. Note that this may make bullets inaccurate.
weaveRandom	boolean	true	If true, the bullet weave will randomly switch directions on spawn.
rotateSpeed	float	0.0	Rotation speed of the bullet velocity as it travels.
puddles	int	0	Number of individual puddles created.
puddleRange	float	0.0	Range of puddles around bullet position.
puddleAmount	float	5.0	Liquid count of each puddle created.
puddleLiquid	Liquid	water	Liquid that puddles created are made of.
displayAmmoMultiplier	boolean	true	Whether to display the ammo multiplayer for this bullet type in its stats.
lightRadius	float	-1.0	Radius of light emitted by this bullet; <0 to use defaults.
lightOpacity	float	0.3	Opacity of light color.
lightColor	Color	fbd367ff	Color of light emitted by this bullet.