Log inGet started
World

Bastion Works: Towers, Turrets and Targeting Kit

Merged

turretsKit 2.2.0: target layers (ground/air) and stealth detection

#2
Author
claude-code @ auraAgent
Opened
Nov 11, 2026
From
contrib-059fp06f
Into
main
Merged
Nov 11, 2026

Adds target layers (ground/air) and stealth to turretsKit, fully backward compatible: every existing turret type and game behaves exactly as before.

What changed

  • Turret types may declare hits (list of "ground"/"air"; empty = both, the default), detects (bool, default false) and detectRange (metres, 0 = the turret's whole range; a tier may override). Added to turretType schema.yaml and its README.
  • Target candidates now carry layer and hidden. They come from a new hook, TK.setTargetInfo(fn(id, cand) -> { layer, hidden, lift?, progress? }) (targets.setInfo), from TK.addTarget(e, { layer, hidden }), or by default from spawnerKit: an enemy whose kind hovers (hover > 0) is "air", everything else "ground", nothing hidden. lift raises the aim/range point for fliers drawn above their entity; progress lets a roster kit correct path progress (e.g. enemies spawned mid-route).
  • targeting: new pure hitsSet, layerOk, canEngage(ctx, cand, dist); pick and eligible skip candidates in layers the turret does not hit and hidden ones unless it detects within detectRange. A tracked target that turns hidden or leaves the turret's layers is dropped (Turret scan refresh). TK.canEngage exposed.
  • Chain lightning only jumps to targets the turret could pick; the sniper's pierce only hurts those.
  • Area damage (splash, clouds, flame cone) respects layers but NOT stealth (a blast needs no sight) — so a game can reveal stealthed enemies by noticing they were hit. Walls only block ground targets; fliers pass over.
  • Turret src() carries the layer set so Combat.splash/clouds can filter.
  • README: new "Layers (air and ground) and stealth" section; API list updated.
  • testSuite: new describe "turretsKit layers and stealth" (4 tests: defaults unchanged + detection, hits limits, setTargetInfo reaching a real Turret scan incl. lift, splash vs layers/stealth). Whole suite passes.

Why Tower defense games need anti-air and detection towers (flying and invisible creeps). This was written for creepsKit (an enemy roster for spawnerKit) which installs the hook when turretsKit is present, but the feature is generic and the defaults keep every current game unchanged. Version bumped to 2.2.0 (package.yaml, TK.VERSION, README version history).

Source world: 37a76806-2009-4346-8a3a-e0c90581eb7b Contributed paths:

  • turretsKit.package/README.md
  • turretsKit.package/Turret.component/init.luau
  • turretsKit.package/api.module/init.luau
  • turretsKit.package/combat.module/init.luau
  • turretsKit.package/package.yaml
  • turretsKit.package/targeting.module/init.luau
  • turretsKit.package/targets.module/init.luau
  • turretsKit.package/turretType.dataType/README.md
  • turretsKit.package/turretType.dataType/schema.yaml
  • turretsKit.package/turretsKit.testSuite/init.luau
  • turretsKit.package
  • turretsKit.package/Turret.component
  • turretsKit.package/api.module
  • turretsKit.package/combat.module
  • turretsKit.package/targeting.module
  • turretsKit.package/targets.module
  • turretsKit.package/turretType.dataType
  • turretsKit.package/turretsKit.testSuite
  • gallery/PhoneFraming.component/init.luau
  • gallery/SwitchPad.component/init.luau
  • scenes/main.scene/build.luau
  • scenes/main.scene/entrypoint.luau
  • scenes/main.scene/scene.json
  • scenes/towerDefense.scene/entrypoint.luau
  • turretsKit.package/catalog.module/init.luau
  • turretsKit.package/turrets/cannon.data
  • turretsKit.package/turrets/flame.data
  • turretsKit.package/turrets/frost.data
  • turretsKit.package/turrets/laser.data
  • turretsKit.package/turrets/machineGun.data
  • turretsKit.package/turrets/missile.data
  • turretsKit.package/turrets/mortar.data
  • turretsKit.package/turrets/poison.data
  • turretsKit.package/turrets/sniper.data
  • turretsKit.package/turrets/support.data
  • turretsKit.package/turrets/tesla.data
  • turretsKit.package/turrets/wall.data

18 files changed

  • ChangedturretsKit.packageFolderBeforeAfter
  • ChangedturretsKit.package/README.md53.9 KB → 56.9 KBBeforeAfter
  • ChangedturretsKit.package/Turret.componentFolderBeforeAfter
  • ChangedturretsKit.package/Turret.component/init.luau36.4 KB → 36.8 KBBeforeAfter
  • ChangedturretsKit.package/api.moduleFolderBeforeAfter
  • ChangedturretsKit.package/api.module/init.luau30.8 KB → 30.9 KBBeforeAfter
  • ChangedturretsKit.package/combat.moduleFolderBeforeAfter
  • ChangedturretsKit.package/combat.module/init.luau15.1 KB → 15.6 KBBeforeAfter
  • ChangedturretsKit.package/package.yaml1.3 KB → 1.3 KBBeforeAfter
  • ChangedturretsKit.package/targeting.moduleFolderBeforeAfter
  • ChangedturretsKit.package/targeting.module/init.luau5.8 KB → 7.2 KBBeforeAfter
  • ChangedturretsKit.package/targets.moduleFolderBeforeAfter
  • ChangedturretsKit.package/targets.module/init.luau9.1 KB → 11.1 KBBeforeAfter
  • ChangedturretsKit.package/turretType.dataTypeFolderBeforeAfter
  • ChangedturretsKit.package/turretType.dataType/README.md5.4 KB → 5.7 KBBeforeAfter
  • ChangedturretsKit.package/turretType.dataType/schema.yaml3.8 KB → 4.2 KBBeforeAfter
  • ChangedturretsKit.package/turretsKit.testSuiteFolderBeforeAfter
  • ChangedturretsKit.package/turretsKit.testSuite/init.luau29.6 KB → 33.7 KBBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

No comments yet.

Sign in to comment or review.