AVP: ALIEN - HIVE CONFIG REFERENCE
==================================

Edit avp_alien-hive.json beside this file, or use
  /avp hive config set <field> <value>
in game, which applies immediately and saves.

This file is regenerated whenever the config is saved. Editing it does nothing.


BUILD-FREE MODE
---------------

  buildFreeModeEnabled = false
      Master switch. Hives claim, spread resin, lay eggs and fight, but never dig or build.
      For adventure maps and prebuilt bases. Everything below only matters when this is
      true.

  buildFreeQueenFoundsWherePlaced = false
      true: the queen founds exactly where you put her - use this for a set piece. false:
      she still travels and picks her own spot, she just never carves. NOTE: true forces
      daughter queens to 0, because a daughter could neither found inside her mother's
      territory nor dig elsewhere.

  buildFreeTerritoryRadiusChunks = 9
      How far the hive's territory reaches, in chunks from the queen. 9 gives a 19x19 area.

  buildFreeEmpressTerritoryRadiusChunks = 11
      Same, for a hive under an empress. 11 gives 23x23.

  buildFreeSlabHalfHeight = 24
      How far the hive reaches ABOVE and BELOW the queen, in blocks. 24 gives a 48-block
      band centred on her - raise it for a tall building so upper and lower floors are
      inside the hive.

  buildFreeActiveXenomorphs = 40
      How many xenomorphs wander the hive at rest. Raise it for a big building, lower it for
      a small one. Fights spawn extra on top of this, so it is not a hard limit on what you
      will face.

  buildFreeDaughterSlots = 2
      How many daughter queens this hive may ever send out to found their own. 0 keeps it a
      single hive. Max 4. Forced to 0 if the queen founds where placed.

  buildFreeRaidsEnabled = true
      Whether hives send raids at players who have angered them. Turn off for a map where
      you want the aliens to stay where you put them.

  buildFreeSurfacePartiesEnabled = true
      Whether hives send scouting parties to the surface. Turn OFF for an indoor map - the
      game reads the roof as the surface, so they will spend themselves on the skyline.

  buildFreeHostSurfacePartiesEnabled = true
      Whether hives send parties out to capture hosts. Same advice: off for indoor maps.

  buildFreeBiomassSurfacePartiesEnabled = true
      Whether hives send parties out to gather biomass. Same advice: off for indoor maps.

  buildFreeQueenEggClusterSize = 10
      Eggs laid in a ring around the queen herself. Max 30.

  buildFreeAdditionalEggClusters = true
      Whether extra egg clusters appear out in the territory as well as around the queen.

  buildFreeEggClusterSize = 6
      Eggs in each of those outlying clusters. Max 6.

  buildFreeEggClusterAmount = 4
      How many outlying egg clusters. Max 8.

  buildFreeJellyClusterAmount = 6
      Clusters of royal jelly vats scattered through the territory - the hive's stores, and
      worth raiding. Max 6.

  buildFreeScourgeClusterAmount = 1
      Clusters of scourge jelly vats. Max 1.

  buildFreeVentVerticalGap = 12
      Minimum vertical spacing between vents in blocks. Roughly one vent level per storey.

  buildFreeVentsPerChunkPerTier = 1
      How many vents may share one chunk at the same height.

  buildFreeVentChunkGap = 1
      How many chunks must separate vent-bearing chunks. Higher means fewer, more spread out
      doors.

  buildFreeVentMaxPerHive = 48
      Hard ceiling on vents per hive, whatever the spacing rules allow. Lower it if the
      walls look perforated.

  buildFreeInvasionClaimBiomassCost = 50
      What a rival hive pays, in biomass, to seize a chunk near your hive as a foothold to
      attack from.

  buildFreeInvasionReachChunks = 3
      How far beyond its own territory a rival hive may buy that foothold.

  buildFreeHarbingerRevealRadius = 16
      How close an intruder must get to the queen before the harbinger appears to defend
      her.

  buildFreeWorkerRetreatVentTimeoutSeconds = 120
      How long a retreating worker tries to reach a vent before hiding where it stands.



LINEAGE SEEDS
-------------

  protoHiveStageInterval = 6000



LOCATION LIFECYCLE
------------------

  settlementTicks = 200
      How long a queen must be undisturbed before she settles and founds a hive.

  locationMaxNoContactTicks = 336000

  locationBootstrapGraceTicks = 36000

  bossBarDisplayRadiusBlocks = 96

  angryGraceTicks = 1200

  contestTickWindow = 1200

  minimumHiveLocationDistanceChunks = 17
      Minimum distance between two hives, in chunks. Lower means a more crowded world.

  initialHiveLocationClaimRadiusChunks = 1



SHEDDING
--------

  shedGraceTicks = 6000

  minLineageAgeForShedding = 36000



CONVOYS
-------

  convoySpeedBlocksPerSecond = 10.0

  arrivalRadiusBlocks = 16

  manifestDistanceBlocks = 80

  convoyInterceptRadiusBlocks = 32

  reinforcementSpeedMultiplier = 1.0

  migrationSpeedMultiplier = 0.7

  raidSpeedMultiplier = 1.5



REINFORCEMENTS
--------------

  reinforcementSourceCooldownTicks = 6000

  reinforcementMinSize = 4

  reinforcementMaxSize = 10



MIGRATION
---------

  resettleGraceTicks = 6000

  migrationBiomassDecayTicks = 36000

  migrationTerritoryFloorChunks = 2

  migrationRallyTicks = 600

  migrationBiomassPayloadCap = 500



RAIDS
-----

  raidThresholdKills = 5

  raidAggroWindowTicks = 12000

  raidMinLocationSizeChunks = 8

  perSourceRaidCooldownTicks = 120000

  raidExpiryTicks = 36000
      How long a raid waits for a target who has logged out before giving up.

  baseRaidSize = 4

  raidSizePerClaimedChunk = 0.25

  raidEngageRadiusBlocks = 32

  raidFrenzyExtraMemberCap = 6

  raidLossDeathWindowTicks = 600

  raidLossDeathThreshold = 3

  raidLossDownGraceTicks = 1200

  raidLossAftermathTicks = 6000



COMBAT PRESSURE
---------------

  combatRespiteKillThreshold = 40

  combatRespiteMinTicks = 200

  combatRespiteMaxTicks = 1200



LEADERSHIP
----------

  empressMoltDurationTicks = 600

  localLeaderPickCadenceTicks = 100

  empressCandidateMinMembers = 0

  empressCrowningCooldownTicks = 120000

  empressCapPercent = 2

  empressRescuesPerHive = 6

  empressRescueBudget = 150

  maxDaughterHivesPerLocation = 2

  queenPromotionJellyCost = 50
      Royal jelly needed to raise a praetorian into a new queen.

  queenPromotionMoltTicks = 600

  firewallCooldownTicks = 168000

  firewallStabilityScanIntervalTicks = 6000

  firewallJellyFloor = 50

  firewallCrowningJellyCost = 100



ABSTRACT SPREAD
---------------

  maxLineageSpreadChunks = 32

  lineageSpreadCooldownTicks = 36000

  maxLocationsPerLineage = 8

  maxLocationsUnderEmpress = 8

  minimumPopulationForHiveSpread = 70

  abstractSpreadMinFounderGroupSize = 4

  abstractSpreadMaxFounderGroupSize = 10

  foragerJoinTicks = 600



CLAIMING AND RESIN
------------------

  claimActivityWindowTicks = 600

  perLocationClaimCooldownTicks = 600

  lineageScanIntervalTicks = 6000

  maxChunksPerLocation = 256
      Hard cap on how many chunks one hive may own, whatever its radius allows.

  maxTerritoryRadiusChunks = 9
      How far a normal (non build-free) hive's territory can reach from its centre.

  maxChunksPerLineage = 10000

  maxLineagesPerDimensionPerVariant = 16

  maxClaimsPerScan = 64

  resinFullDensityTicks = 24000

  maxPassiveClaimsPerUnloadedScan = 1



BIOMASS
-------

  baseChunkCost = 25

  ovipositorCreationBiomassCost = 100

  resinSpreadBiomassCost = 5

  growthFactor = 0.05

  baseUnloadedBiomassPerChunkPerSec = 0.05

  unloadedEmpressBonusPerSec = 1.0

  loadedBiomassPerLoadedXenomorphPerSec = 1.0

  loadedBiomassPerNonAlienKill = 25

  loadedBiomassPerResinBlockPlaced = 5

  loadedBiomassPerOvomorphPerSec = 0.5

  loadedBiomassEmpressPresentBonusPerSec = 5.0

  loadedBiomassIdleBonusPerSec = 0.1

  biomassAccumulationCapMultiplier = 100



PERSISTENCE
-----------

  biomassDirtyThreshold = 10

  lastGrowthTickDirtyThreshold = 36000

  slowPathLocationUpdatesPerTick = 4

  passiveClaimCatchUpWindowCap = 4



POPULATION AND SPAWNING
-----------------------

  populationPerChunk = 8
      How much population each claimed chunk supports. Raises or lowers the ceiling on every
      hive in the world.

  minimumPopulationRatioForClaiming = 0.5
      How full a hive must be before it claims more ground, and below which it starts losing
      ground.

  hiveSpawnerMinimumLoadedXenomorphs = 20
      Despite the name this is a MAXIMUM: how many xenomorphs wander a normal hive at rest.

  reserveSpawnsCanIgnoreResin = true

  hiveSpawnerIntervalTicks = 20

  hiveSpawnerMaxSpawnAttemptsPerLocation = 32

  hiveSpawnerMaxSpawnsPerLocation = 4

  royalJellyTicksPerProduction = 1200
      How long a queen takes to make one royal jelly, in ticks. 1200 is one in-game minute.
      Lower is faster.

  scourgeJellyTicksPerQueenProduction = 120000

  scourgeJellyTicksPerHarbingerProduction = 1200

  minRoyalJellyCap = 128



QUEEN LIFECYCLE
---------------

  queenFrontEndPhasesEnabled = true
      LEAVE THIS TRUE. It is a development switch: false stops queens developing, settling
      and founding entirely, so no hive is ever created.



PARTIES
-------

  surfacePartyBaseSize = 2

  surfacePartySizePerClaimedChunk = 0.15

  surfacePartyMaxSize = 5

  surfacePartyVentDropChance = 0.35

  surfacePartyMaxVentsPerClaim = 3

  surfacePartySurfaceBandBlocks = 6

  biomassHuntingPartyBaseSize = 2

  biomassHuntingPartySizePerClaimedChunk = 0.15

  biomassHuntingPartyMaxSize = 7

  hostHuntPartyBaseSize = 2

  hostHuntPartySizePerClaimedChunk = 0.1

  hostHuntPartyMaxSize = 4

  hostHuntPartyDurationTicks = 6000

  biomassHuntingPartyBonusSpitterCount = 1

  biomassHuntingPartyDurationTicks = 12000

  attackPartyBaseSize = 2

  attackPartySizePerClaimedChunk = 0.15

  attackPartyMaxSize = 8

  attackPartyCooldownTicks = 72000

  attackPartyWave1DelayTicks = 24000

  attackIntrusionDwellTicks = 600

  attackPartyDurationTicks = 12000

