Bastion Works: Towers, Turrets and Targeting Kit
- 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) anddetectRange(metres, 0 = the turret's whole range; a tier may override). Added to turretType schema.yaml and its README. - Target candidates now carry
layerandhidden. They come from a new hook,TK.setTargetInfo(fn(id, cand) -> { layer, hidden, lift?, progress? })(targets.setInfo), fromTK.addTarget(e, { layer, hidden }), or by default from spawnerKit: an enemy whose kind hovers (hover > 0) is "air", everything else "ground", nothing hidden.liftraises the aim/range point for fliers drawn above their entity;progresslets a roster kit correct path progress (e.g. enemies spawned mid-route). - targeting: new pure
hitsSet,layerOk,canEngage(ctx, cand, dist);pickandeligibleskip 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.canEngageexposed. - 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.