Package mindustry.world.blocks.defense.turrets

Class Turret

java.lang.Object

mindustry.ctype.Content

mindustry.ctype.MappableContent

mindustry.ctype.UnlockableContent

mindustry.world.Block

mindustry.world.blocks.defense.turrets.BaseTurret

mindustry.world.blocks.defense.turrets.ReloadTurret

mindustry.world.blocks.defense.turrets.Turret

All Implemented Interfaces:

Comparable<Content>, Senseable

Direct Known Subclasses:

ContinuousTurret, ItemTurret, LiquidTurret, PayloadAmmoTurret, PowerTurret

public class Turret
extends ReloadTurret

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Turret.AmmoEntry
static class	Turret.BulletEntry
class	Turret.TurretBuild

Nested classes/interfaces inherited from class mindustry.world.blocks.defense.turrets.ReloadTurret

ReloadTurret.ReloadTurretBuild

Nested classes/interfaces inherited from class mindustry.world.blocks.defense.turrets.BaseTurret

BaseTurret.BaseTurretBuild

Nested classes/interfaces inherited from class mindustry.ctype.Content

Content.ModContentInfo

Field Summary

Fields

Modifier and Type	Field	Description
boolean	accurateDelay	If true, this turret will accurately target moving targets with respect to shoot.firstShotDelay.
boolean	alwaysShooting	If true, the turret will always shoot when it has ammo, regardless of targets in range or any control.
float	ammoEjectBack	Backwards Y offset of ammo eject effect.
int	ammoPerShot	Ammo units used per shot.
Effect	ammoUseEffect	Effect created when ammo is used.
arc.func.Boolf<mindustry.gen.Building>	buildingFilter	Filter for types of buildings to attack.
arc.audio.Sound	chargeSound	Sound emitted when shoot.firstShotDelay is >0 and shooting begins.
boolean	consumeAmmoOnce	If true, ammo is only consumed once per shot regardless of bullet count.
float	cooldownTime	ticks to cool down the heat region
boolean	displayAmmoMultiplier	If true, this block will display ammo multipliers in its stats (irrelevant for certain types of turrets).
DrawBlock	drawer	Defines drawing behavior for this turret.
boolean	drawMinRange	If true, a range ring is also drawn for minRange.
float	elevation	Visual elevation of turret shadow, -1 to use defaults.
arc.graphics.Color	heatColor	Color of heat region drawn on top (if found)
float	heatRequirement	Minimum input heat required to fire.
float	inaccuracy	Bullet angle randomness in degrees.
boolean	linearWarmup	If true, turret warmup is linear instead of a curve.
static final float	logicControlCooldown
arc.audio.Sound	loopSound	The sound that this block makes while active.
float	loopSoundVolume	Active sound base volume.
int	maxAmmo	Maximum ammo units stored.
float	maxHeatEfficiency	Maximum efficiency possible, if this turret uses heat.
float	minRange	Minimum bullet range.
float	minWarmup	Minimum warmup needed to fire.
boolean	moveWhileCharging	If false, this turret can't move while charging.
float	newTargetInterval	Target interval for when this turret already has a valid target.
boolean	playerControllable	If true, this turret can be controlled by players.
boolean	predictTarget	Whether this turret predicts unit movement.
float	recoil	Visual amount by which the turret recoils back per shot.
float	recoilPow	power curve applied to visual recoil
int	recoils	Number of additional counters for recoil.
float	recoilTime	ticks taken for turret to return to starting position in ticks.
boolean	reloadWhileCharging	If false, this turret can't reload while charging
float	scaleLifetimeOffset	Fraction of lifetime that is added to bullets with lifeScale.
float	shake	How much the screen shakes per shot.
ShootPattern	shoot	pattern used for bullets
float	shootCone	Maximum angle difference in degrees at which turret will still try to shoot.
Effect	shootEffect	Optional override for all shoot effects.
arc.audio.Sound	shootSound	Sound emitted when a single bullet is shot.
float	shootWarmupSpeed	Lerp speed of turret warmup.
float	shootX	Turret shoot point.
float	shootY	Turret shoot point.
Effect	smokeEffect	Optional override for all smoke effects.
float	soundPitchMax	Range for pitch of shoot sound.
float	soundPitchMin	Range for pitch of shoot sound.
boolean	targetAir	If true, this block targets air units.
boolean	targetBlocks	If true, this block targets blocks.
boolean	targetGround	If true, this block targets ground units and structures.
boolean	targetHealing	If true, this block targets friend blocks, to heal them.
float	targetInterval	Ticks between attempt at finding a target.
boolean	targetUnderBlocks	If false, 'under' blocks like conveyors are not targeted.
final int	timerTarget
float	trackingRange	Range at which it finds and locks on to the target, but does not shoot.
arc.func.Boolf<mindustry.gen.Unit>	unitFilter	Filter for types of units to attack.
Units.Sortf	unitSort	Function for choosing which unit to target.
float	velocityRnd	Fraction of bullet velocity that is random.
float	warmupMaintainTime	How long warmup is maintained even if this turret isn't shooting.
float	xRand	Random spread on the X axis.

Fields inherited from class mindustry.world.blocks.defense.turrets.ReloadTurret

reload

Fields inherited from class mindustry.world.blocks.defense.turrets.BaseTurret

coolant, coolantMultiplier, coolEffect, disableOverlapCheck, fogRadiusMultiplier, placeOverlapMargin, range, rotateSpeed

Fields inherited from class mindustry.world.Block

absorbLasers, acceptsItems, acceptsPayload, acceptsUnitPayloads, albedo, allowConfigInventory, allowDerelictRepair, allowDiagonal, allowRectanglePlacement, allowResupply, alwaysReplace, alwaysUpdateInUnits, ambientSound, ambientSoundVolume, armor, attacks, attributes, autoResetEnabled, barMap, baseExplosiveness, baseShake, breakable, breakEffect, breakPitchChange, breakSound, buildCostMultiplier, buildTime, buildType, buildVisibility, cacheLayer, canOverdrive, canPickup, category, clearOnDoubleTap, clipSize, commandable, conductivePower, configurable, configurations, connectedPower, consPower, consumeBuilder, consumers, consumesPower, consumesTap, conveyorPlacement, copyConfig, createRubble, crushDamageMultiplier, customShadow, customShadowRegion, deconstructDropAllLiquid, deconstructThreshold, destroyBullet, destroyBulletSameTeam, destroyEffect, destroyPitchMax, destroyPitchMin, destroySound, destructible, displayFlow, drawArrow, drawCracks, drawDisabled, drawLiquidLight, drawTeamOverlay, dumpTime, editorConfigurable, emitLight, enableDrawStatus, envDisabled, envEnabled, envRequired, explosivenessScale, fillsTile, flags, flammabilityScale, floating, fogRadius, forceDark, forceTeam, generatedIcons, group, hasColor, hasConsumers, hasItems, hasLiquids, hasPower, hasShadow, health, ignoreBuildDarkness, ignoreResizeConfig, inEditor, instantBuild, instantDeconstruct, instantTransfer, insulated, invertFlip, isDuct, itemCapacity, itemDrop, itemFilter, lastConfig, lightClipSize, lightColor, lightLiquid, lightRadius, liquidCapacity, liquidFilter, liquidPressure, lockRotation, logicConfigurable, mapColor, nonOptionalConsumers, noSideBlend, noUpdateDisabled, offset, optionalConsumers, outlineColor, outlinedIcon, outlineIcon, outlineRadius, outputFacing, outputsLiquid, outputsPayload, outputsPower, placeableLiquid, placeableOn, placeablePlayer, placeEffect, placeOverlapRange, placePitchChange, placeSound, playerUnmineable, priority, privileged, quickRotate, rebuildable, region, regionRotated1, regionRotated2, replaceable, requirements, requiresWater, researchCost, researchCostMultiplier, researchCostMultipliers, rotate, rotateDraw, rotateDrawEditor, saveConfig, saveData, scaledHealth, schematicPriority, selectionColumns, selectionRows, selectScroll, separateItemCapacity, size, sizeOffset, solid, solidifes, squareSprite, subclass, suppressable, swapDiagonalPlacement, sync, targetable, teamPassable, teamRegion, teamRegions, tempBuilds, tempTiles, timerDump, timers, underBullets, unitCapModifier, unitMoveBreakable, unloadable, update, updateConsumers, updateInUnits, useColor, variantRegions, variants, variantShadowRegions, visualRotationOffset

Fields inherited from class mindustry.ctype.UnlockableContent

allDatabaseTabs, alwaysUnlocked, databaseTabs, description, details, fullIcon, fullOverride, generateIcons, hideDatabase, hideDetails, inlineDescription, localizedName, selectionSize, shownPlanets, stats, techNode, techNodes, uiIcon, unlocked

Fields inherited from class mindustry.ctype.MappableContent

name

Fields inherited from class mindustry.ctype.Content

id, minfo

Fields inherited from interface mindustry.logic.Senseable

noSensed

Constructor Summary

Constructors

Constructor	Description
Turret(String name)

Method Summary

Modifier and Type	Method	Description
void	drawPlace(int x, int y, int rotation, boolean valid)	Drawn when you are placing a block.
void	drawPlanRegion(BuildPlan plan, arc.util.Eachable<BuildPlan> list)
void	getRegionsToOutline(arc.struct.Seq<arc.graphics.g2d.TextureRegion> out)
arc.graphics.g2d.TextureRegion[]	icons()
void	init()	Called after all blocks are created.
void	limitRange(BulletType bullet, float margin)
void	load()	Called after all content is created, only on non-headless versions.
boolean	outputsItems()
void	placeEnded(Tile tile, mindustry.gen.Unit builder, int rotation, Object config)	Called when building of this block ends.
void	setBars()
void	setStats()	Initializes stats on demand.

Methods inherited from class mindustry.world.Block

addBar, addLiquidBar, addLiquidBar, asFloor, beforePlaceBegan, blockChanged, bounds, buildEditorConfig, canBeBuilt, canBreak, canPlaceOn, canReplace, changePlacementPath, changePlacementPath, checkForceDark, config, configClear, configSenseable, consume, consumeCoolant, consumeCoolant, consumeItem, consumeItem, consumeItems, consumeLiquid, consumeLiquids, consumePower, consumePowerBuffered, consumePowerCond, consumePowerDynamic, consumePowerDynamic, consumesItem, consumesLiquid, createIcons, displayShadow, drawBase, drawDefaultPlanRegion, drawEnvironmentLight, drawOverlay, drawPlaceText, drawPlan, drawPlan, drawPlanConfig, drawPlanConfigCenter, drawPlanConfigCenter, drawPlanConfigTop, drawPotentialLinks, drawShadow, drawSideRegion, editorPicked, environmentBuildable, findConsumer, flipRotation, getConfig, getContentType, getDependencies, getDisplayIcon, getDisplayName, getEdges, getGeneratedIcons, getInsideEdges, getPlanConfigs, getPlanRegion, getReplacement, handlePlacementLine, hasBuilding, hasConsumer, initBuilding, isAccessible, isAir, isBanned, isDarkened, isFloor, isHidden, isMultiblock, isOverlay, isPlaceable, isStatic, isVisible, iterateTaken, listBars, logicVisible, makeIconRegions, minimapColor, nearbySide, newBuilding, nextConfig, onNewPlan, onPicked, percentSolid, placeBegan, placeBegan, planRotation, pointConfig, postInit, removeBar, removeConsumer, removeConsumers, requirements, requirements, requirements, researchRequirements, resetGeneratedIcons, rotatedOutput, rotatedOutput, sense, sense, senseObject, setupRequirements, setupRequirements, sumAttribute, supportsEnv, synthetic, updateClipRadius, variantRegions

Methods inherited from class mindustry.ctype.UnlockableContent

checkStats, clearUnlock, displayDescription, displayExtra, emoji, emojiChar, getLogicId, hasEmoji, isOnPlanet, loadIcon, locked, makeOutline, makeOutline, makeOutline, onUnlock, quietUnlock, showUnlock, unlock, unlocked, unlockedHost, unlockedNow, unlockedNowHost

Methods inherited from class mindustry.ctype.MappableContent

toString

Methods inherited from class mindustry.ctype.Content

compareTo, hasErrored, isModded, isVanilla

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

logicControlCooldown

public static final float logicControlCooldown

See Also:

• Constant Field Values

timerTarget

public final int timerTarget

targetInterval

public float targetInterval

Ticks between attempt at finding a target.

newTargetInterval

public float newTargetInterval

Target interval for when this turret already has a valid target. -1 = targetInterval

maxAmmo

public int maxAmmo

Maximum ammo units stored.

ammoPerShot

public int ammoPerShot

Ammo units used per shot.

consumeAmmoOnce

public boolean consumeAmmoOnce

If true, ammo is only consumed once per shot regardless of bullet count.

heatRequirement

public float heatRequirement

Minimum input heat required to fire.

maxHeatEfficiency

public float maxHeatEfficiency

Maximum efficiency possible, if this turret uses heat.

inaccuracy

public float inaccuracy

Bullet angle randomness in degrees.

velocityRnd

public float velocityRnd

Fraction of bullet velocity that is random.

scaleLifetimeOffset

public float scaleLifetimeOffset

Fraction of lifetime that is added to bullets with lifeScale.

shootCone

public float shootCone

Maximum angle difference in degrees at which turret will still try to shoot.

shootX

public float shootX

Turret shoot point.

shootY

public float shootY

Turret shoot point.

xRand

public float xRand

Random spread on the X axis.

drawMinRange

public boolean drawMinRange

If true, a range ring is also drawn for minRange.

trackingRange

public float trackingRange

Range at which it finds and locks on to the target, but does not shoot.

minRange

public float minRange

Minimum bullet range. Used for artillery only.

minWarmup

public float minWarmup

Minimum warmup needed to fire.

accurateDelay

public boolean accurateDelay

If true, this turret will accurately target moving targets with respect to shoot.firstShotDelay.

moveWhileCharging

public boolean moveWhileCharging

If false, this turret can't move while charging.

reloadWhileCharging

public boolean reloadWhileCharging

If false, this turret can't reload while charging

warmupMaintainTime

public float warmupMaintainTime

How long warmup is maintained even if this turret isn't shooting.

shoot

public ShootPattern shoot

pattern used for bullets

targetAir

public boolean targetAir

If true, this block targets air units.

targetGround

public boolean targetGround

If true, this block targets ground units and structures.

targetBlocks

public boolean targetBlocks

If true, this block targets blocks.

targetHealing

public boolean targetHealing

If true, this block targets friend blocks, to heal them.

playerControllable

public boolean playerControllable

If true, this turret can be controlled by players.

displayAmmoMultiplier

public boolean displayAmmoMultiplier

If true, this block will display ammo multipliers in its stats (irrelevant for certain types of turrets).

targetUnderBlocks

public boolean targetUnderBlocks

If false, 'under' blocks like conveyors are not targeted.

alwaysShooting

public boolean alwaysShooting

If true, the turret will always shoot when it has ammo, regardless of targets in range or any control.

predictTarget

public boolean predictTarget

Whether this turret predicts unit movement.

unitSort

public Units.Sortf unitSort

Function for choosing which unit to target.

unitFilter

public arc.func.Boolf<mindustry.gen.Unit> unitFilter

Filter for types of units to attack.

buildingFilter

public arc.func.Boolf<mindustry.gen.Building> buildingFilter

Filter for types of buildings to attack.

heatColor

public arc.graphics.Color heatColor

Color of heat region drawn on top (if found)

shootEffect

@Nullable
public Effect shootEffect

Optional override for all shoot effects.

smokeEffect

@Nullable
public Effect smokeEffect

Optional override for all smoke effects.

ammoUseEffect

public Effect ammoUseEffect

Effect created when ammo is used. Not optional.

shootSound

public arc.audio.Sound shootSound

Sound emitted when a single bullet is shot.

chargeSound

public arc.audio.Sound chargeSound

Sound emitted when shoot.firstShotDelay is >0 and shooting begins.

loopSound

public arc.audio.Sound loopSound

The sound that this block makes while active. One sound loop. Do not overuse.

loopSoundVolume

public float loopSoundVolume

Active sound base volume.

soundPitchMin

public float soundPitchMin

Range for pitch of shoot sound.

soundPitchMax

public float soundPitchMax

Range for pitch of shoot sound.

ammoEjectBack

public float ammoEjectBack

Backwards Y offset of ammo eject effect.

shootWarmupSpeed

public float shootWarmupSpeed

Lerp speed of turret warmup.

linearWarmup

public boolean linearWarmup

If true, turret warmup is linear instead of a curve.

recoil

public float recoil

Visual amount by which the turret recoils back per shot.

recoils

public int recoils

Number of additional counters for recoil.

recoilTime

public float recoilTime

ticks taken for turret to return to starting position in ticks. uses reload time by default

recoilPow

public float recoilPow

power curve applied to visual recoil

cooldownTime

public float cooldownTime

ticks to cool down the heat region

elevation

public float elevation

Visual elevation of turret shadow, -1 to use defaults.

shake

public float shake

How much the screen shakes per shot.

drawer

public DrawBlock drawer

Defines drawing behavior for this turret.

Constructor Details

Turret

public Turret(String name)

Method Details

outputsItems

public boolean outputsItems()

Overrides:

outputsItems in class Block

setStats

public void setStats()

Description copied from class: UnlockableContent

Initializes stats on demand. Should only be called once. Only called before something is displayed.

Overrides:

setStats in class ReloadTurret

setBars

public void setBars()

Overrides:

setBars in class Block

init

public void init()

Description copied from class: Block

Called after all blocks are created.

Overrides:

init in class BaseTurret

load

public void load()

Description copied from class: Content

Called after all content is created, only on non-headless versions. Use for loading regions or other image data.

Overrides:

load in class Block

drawPlanRegion

public void drawPlanRegion(BuildPlan plan,
 arc.util.Eachable<BuildPlan> list)

Overrides:

drawPlanRegion in class Block

icons

public arc.graphics.g2d.TextureRegion[] icons()

Overrides:

icons in class Block

getRegionsToOutline

public void getRegionsToOutline(arc.struct.Seq<arc.graphics.g2d.TextureRegion> out)

Overrides:

getRegionsToOutline in class Block

limitRange

public void limitRange(BulletType bullet,
 float margin)

drawPlace

public void drawPlace(int x,
 int y,
 int rotation,
 boolean valid)

Description copied from class: Block

Drawn when you are placing a block.

Overrides:

drawPlace in class BaseTurret

placeEnded

public void placeEnded(Tile tile,
 @Nullable
 mindustry.gen.Unit builder,
 int rotation,
 @Nullable
 Object config)

Description copied from class: Block

Called when building of this block ends.

Overrides:

placeEnded in class Block