Team 1 Enemies and Bosses Test Plan - UQcsse3200/2026-studio-4 GitHub Wiki
Testing is divided into automated unit tests and manual gameplay tests.
This plan covers Team 1 enemies, minibosses, the Final Boss and ordinary-drop magnetic pickup. Shared systems are checked where they interact with these features.
Tested revision: 88c3393, merged into main through PR #388. Reports generated on 21 October 2026.
Run from the repository root with JDK 21:
cd source
./gradlew :core:clean spotlessCheck :core:test :core:jacocoTestReport --console=plainOn Windows, use .\gradlew.bat in place of ./gradlew.
The expanded inventory below combines the locally inspected test files with the new Snake dust-anchor test documented in PR #388. Paths are relative to source/core/src/test/com/csse3200/game/. This is 137 test source files, not 137 executed test cases. The supplied results and coverage below remain tied to tested revision 88c3393. The expanded list is not a new test execution.
The previous local inventory was inspected at HEAD bf987adb7c768e32aff59adcf13851aef293192b; the new dust-anchor entry and updated report figures come from the supplied latest plan. These sources are distinguished rather than treating the old local inspection as verification of the new commit.
PR #388 regression additions: SnakeBurrowDustAnchorTest.java checks dust alignment with the enlarged ground collider; SnakeBurrowVisualComponentTest.java adds dust clearance from walls and room boundaries, slow-frame checks and cleanup. The supplied latest report records 3/3 and 10/10 passing tests respectively.
Factory assembly, variants, health display, contact damage, splitting, hitboxes and disposal. Shared-system tests are regression dependencies, not a claim of sole Team 1 ownership.
entities/enemy/BombEnemyTest.javaentities/enemy/ChaseEnemyTest.javacomponents/CombatStatsComponentTest.javacomponents/CombatStatsImmobilisedAttackerTest.javacomponents/npc/EnemyAnimationDisposalTest.javacomponents/EnemyDeathComponentTest.javacomponents/npc/EnemyStatDisplayTest.javaentities/enemy/FloatingDemonTest.javaentities/enemy/GiantEnemyTest.javaphysics/HitboxComponentTest.javaentities/factories/HitboxFactoryTest.javaentities/factories/HitboxSpecTest.javacomponents/weapons/LifetimeComponentTest.javaentities/factories/NPCFactoryTest.javacomponents/SplitComponentTest.javacomponents/TouchAttackComponentTest.java
Room ownership, spawn rejection, split children, scaling, loot, repeated death events and disposal. EnemyManagerComponentTest checks Cerberus reporting only after all heads die; AchievementsTest checks configured miniboss achievements against matching kills. RoomAssetsTest uses mocked loading and does not prove every atlas/PNG path exists.
components/achievements/AchievementReportersTest.javaservices/AchievementServiceTest.javacomponents/achievements/AchievementsTest.javacomponents/rooms/EnemyManagerComponentTest.javacomponents/rooms/EntityManagerComponentTest.javacomponents/rooms/RoomAssetsTest.java
Movement and navigation; Medusa recovery; Minotaur attack timing and rendering.
components/tasks/ChaseTaskTest.javacomponents/tasks/GroundChaseTaskTest.javacomponents/tasks/LungeAttackTaskTest.javacomponents/npc/MedusaHitRecoveryComponentTest.javacomponents/npc/MinotaurAnimationControllerTest.javarendering/MinotaurAttackRenderComponentTest.javaentities/enemy/MinotaurCombatIntegrationTest.javarendering/MinotaurDashTrailComponentTest.javacomponents/tasks/MovementTaskTest.javaai/movement/ObstacleNavigationTest.javacomponents/tasks/WaitTaskTest.javacomponents/tasks/WanderTaskTest.java
Patrol, ranged attacks, movement and wall checks. The current FloatingDemonProjectileFactoryTest checks player-collision damage; themed-art fallback requires additional real-resource/gameplay verification.
entities/factories/FloatingDemonProjectileFactoryTest.javacomponents/npc/FlyingEnemyPatrolComponentTest.javacomponents/tasks/PatrolTaskTest.javacomponents/npc/ProjectileMovementComponentTest.javacomponents/tasks/RangedAttackTaskTest.java
Complete dedicated suite: independent heads, combined/scaled-health phases, sequential/concurrent attacks, bite, mist, queued fireballs, layered animations, enrage, chain rendering/geometry and movement restriction. Homing movement tests cover turning, range and overshoot, not wall blocking.
components/miniboss/cerberus/CerberusAttackCoordinationTest.javacomponents/miniboss/cerberus/CerberusAttackCoordinatorTest.javacomponents/miniboss/cerberus/CerberusBiteComponentTest.javacomponents/miniboss/cerberus/CerberusChainComponentTest.javacomponents/miniboss/cerberus/CerberusChainRenderComponentTest.javacomponents/miniboss/cerberus/CerberusDeathComponentTest.javacomponents/miniboss/cerberus/CerberusEnrageVisualComponentTest.javacomponents/miniboss/cerberus/CerberusLayeredRenderComponentTest.javacomponents/miniboss/cerberus/CerberusMistComponentTest.javacomponents/miniboss/cerberus/CerberusPhaseComponentTest.javacomponents/miniboss/cerberus/CerberusProjectileComponentTest.javaentities/factories/CerberusProjectileFactoryTest.javaentities/factories/CerberusStatusEffectsTest.javaentities/enemy/CerberusTest.javacomponents/ChainRestrictionComponentTest.javacomponents/HeadAttachmentComponentTest.javacomponents/miniboss/cerberus/HomingProjectileMovementComponentTest.java
Complete dedicated suite: factory assembly, actual-max-health phases, attack scheduling, Thunder Orb tracking/lifetime/one-hit/obstacles, Cloud Dash warnings/locked direction/distance/damage/recovery, Storm Zone delays, animation and visual cleanup. The factory assembly file is DragonTest.java, not DragonFactoryTest.java.
components/miniboss/dragon/DragonAnimationControllerTest.javacomponents/miniboss/dragon/DragonAttackCoordinatorComponentTest.javacomponents/miniboss/dragon/DragonCloudDashComponentTest.javacomponents/miniboss/dragon/DragonCloudDashMovementComponentTest.javacomponents/miniboss/dragon/DragonCloudDashVisualComponentTest.javacomponents/miniboss/dragon/DragonEnrageVisualComponentTest.javacomponents/miniboss/dragon/DragonPhaseComponentTest.javacomponents/miniboss/dragon/DragonStormZoneComponentTest.javacomponents/miniboss/dragon/DragonStormZoneVisualComponentTest.javaentities/enemy/DragonTest.javacomponents/miniboss/dragon/DragonThunderOrbComponentTest.javaentities/factories/ThunderOrbFactoryTest.javacomponents/miniboss/dragon/ThunderOrbHitComponentTest.javacomponents/miniboss/dragon/ThunderOrbMovementComponentTest.java
Complete dedicated suite: burrow navigation/arena/room traversal, collision, warnings, visuals, poison volleys, shields and gem placement. NPCFactoryTest also contains Snake integration tests.
components/miniboss/snake/SnakeBurrowArenaTest.javacomponents/miniboss/snake/SnakeBurrowComponentTest.java-
components/miniboss/snake/SnakeBurrowDustAnchorTest.javaβ Added in PR #388; the supplied latest plan reports 3/3 passing anchor tests. components/miniboss/snake/SnakeBurrowNavigatorTest.javacomponents/miniboss/snake/SnakeBurrowRoomTraversalTest.javacomponents/miniboss/snake/SnakeBurrowVisualComponentTest.javacomponents/miniboss/snake/SnakeBurrowWallCollisionTest.javacomponents/miniboss/snake/SnakeGemSpawnAreaTest.javacomponents/miniboss/snake/SnakePlayerHitVisualComponentTest.javacomponents/miniboss/snake/SnakePoisonCollisionTest.javacomponents/miniboss/snake/SnakePoisonVolleyComponentTest.javacomponents/miniboss/snake/SnakeShieldComponentTest.javacomponents/miniboss/snake/SnakeShieldPickupComponentTest.java
Factory and attack-task tests. SleipnirEnemyTest is under components/miniboss.
components/tasks/EarthquakeAttackTest.javacomponents/tasks/OneAttackTest.javacomponents/miniboss/SleipnirEnemyTest.javacomponents/tasks/StampedeTest.java
Complete dedicated suite for configuration, stages, movement, damage, summons, assets, ice/fire/cover/input/pickups, statues/tornadoes and ending. FinalBossAchievementComponentTest covers the Stage 1 break challenge; it does not establish coverage of all seven challenges.
components/boss/FinalBossAchievementComponentTest.javacomponents/boss/FinalBossDamageControllerComponentTest.javacomponents/boss/FinalBossExplosiveSummonComponentTest.javacomponents/boss/FinalBossGrandpaReturnTest.javacomponents/boss/FinalBossHealthProgressionTest.javacomponents/boss/FinalBossMovementComponentTest.javacomponents/boss/FinalBossPetrificationComponentTest.javacomponents/boss/FinalBossPhaseControllerComponentTest.javacomponents/boss/FinalBossProximityDamageComponentTest.javaentities/configs/FinalBossStageOneConfigTest.javacomponents/boss/FinalBossStageOneEntranceTest.javacomponents/boss/FinalBossStageThreeAssetsTest.javacomponents/boss/FinalBossStageThreeComponentTest.javaentities/configs/FinalBossStageThreeConfigTest.javacomponents/boss/FinalBossStageThreeSlamTest.javacomponents/boss/FinalBossStageThreeVolleyTest.javacomponents/boss/FinalBossStageTwoArenaComponentTest.javacomponents/boss/FinalBossStageTwoAssetsTest.javacomponents/boss/FinalBossStageTwoComponentTest.javaentities/configs/FinalBossStageTwoConfigTest.javacomponents/boss/FinalBossStageTwoFireControllerTest.javacomponents/boss/FinalBossStageTwoFireIntegrationTest.javacomponents/boss/FinalBossStageTwoIceControllerTest.javacomponents/boss/FinalBossStageTwoIceInputTest.javacomponents/boss/FinalBossStageTwoIceIntegrationTest.javacomponents/boss/FinalBossStageTwoIceVisualsTest.javacomponents/boss/FinalBossStageTwoPickupControllerTest.javacomponents/boss/FinalBossStageTwoPickupIntegrationTest.javacomponents/boss/FinalBossStageTwoPickupVisualsTest.javacomponents/boss/FinalBossStageTwoPlayerIceControllerTest.javacomponents/boss/FinalBossStageTwoPlayerIceIntegrationTest.javacomponents/boss/FinalBossStageTwoPlayerIceVisualsTest.javacomponents/boss/FinalBossStageTwoVisualComponentTest.javacomponents/boss/FinalBossStatueClusteringTest.javacomponents/boss/FinalBossStatueCollisionTest.javacomponents/boss/FinalBossStatueEvadeTest.javacomponents/boss/FinalBossStatueSpacingTest.javacomponents/boss/FinalBossSummonMovementComponentTest.javacomponents/boss/FinalBossTornadoControllerTest.javacomponents/boss/FinalBossTornadoDamageIntegrationTest.javacomponents/boss/FinalBossTornadoIntegrationTest.javacomponents/boss/FinalBossTornadoSpacingIntegrationTest.java
Shared drop, reward, pickup and magnetic-interaction regression tests.
components/items/EnemyLootPickupIntegrationTest.javacomponents/items/ItemDropAnimationComponentTest.javaentities/factories/ItemFactoryTest.javacomponents/items/ItemPickupComponentTest.javaitems/LootTableTest.javacomponents/player/MagnetUseIntegrationTest.javacomponents/maingame/MagneticPickupHintDisplayTest.javacomponents/items/RoomMagneticPickupComponentTest.java
- Real atlas/page loading must still be checked in game; mocked loading is insufficient.
- Solid-wall checks do not prove that black/void gaps have collision geometry.
- Cerberus and Dragon both include scaled-health regression tests for premature enrage.
- A listed file is not proof that its tests passed on the current revision.
The full local :core:test run at 88c3393 completed with 2,709 tests, 0 failures and 0 ignored tests in 43.766 seconds. This is the complete core test suite, including all teams' tests. The report's test-commit.txt records 88c3393741c72d66a030e25bff6c05f63a2e7014.
The Game Unit Tests run and Java Format run also passed for the same commit.
Screenshot 1 β Successful CI run after PR #388 was merged.
Screenshot 2 β Local full-suite test summary: 2,709 tests passed.
Screenshot 3 β Final Boss Stage 1 break achievement regression tests. The local report records 16/16 passing tests in FinalBossAchievementComponentTest; the screenshot shows the matching CI job.
Screenshot 4 β Snake underground navigation regression tests. All 13 tests in SnakeBurrowNavigatorTest passed, covering wall corners, the Snake's collision footprint, unreachable targets and route updates.
The following results come from the Gradle and JaCoCo reports generated by the same local full-suite run. Package names are relative to com.csse3200.game; coverage percentages match the JaCoCo HTML display.
| Package | Tests passed in the matching test package | Instruction coverage | Branch coverage |
|---|---|---|---|
components.boss |
454 | 79% | 62% |
components.miniboss.snake |
185 | 97% | 82% |
components.miniboss.cerberus |
81 | 76% | 67% |
components.miniboss.dragon |
111 | 80% | 71% |
components.npc |
34 | 88% | 70% |
components.tasks |
100 | 95% | 83% |
ai.movement |
9 | 93% | 81% |
These are selected enemy and boss packages. Factory, room, item and other integration tests are also included in the full suite above.
Screenshot 5 β Final Boss coverage by class.
Screenshot 6 β Final Boss package totals: 79% instruction coverage and 62% branch coverage.
Screenshot 7 β Snake package coverage: 97% instruction coverage and 82% branch coverage. SnakeBurrowVisualComponent reaches 100% instruction coverage and 92% branch coverage, including the dust-boundary tests added in PR #388.
DragonοΌ
Cerberus
Achievement coverage remains partial: FinalBossAchievementComponent has 47% instruction and 15% branch coverage, while SnakeAchievementComponent has 59% and 28%. The dedicated Final Boss achievement tests cover the Stage 1 break challenge. The other six Final Boss achievement paths and the three Snake challenge conditions remain in the manual checks below.
Local report locations:
- Test report:
source/core/build/reports/tests/test/index.html - Coverage report:
source/core/build/reports/jacoco/test/html/index.html - Coverage counters:
source/core/build/reports/jacoco/test/jacocoTestReport.xml
Historical coverage remains on the Snake remake and Final Boss remake pages under their original revisions.
Use a fresh run or encounter for each achievement attempt. Record the commit, save state, actual result and a screenshot or short video when completing a check. The steps below describe the expected behaviour; manual results for this revision have not yet been recorded.
| Key | Action |
|---|---|
| W / A / S / D | Move |
| Space | Dash; jump when enabled during the Final Boss statue phase |
| J | Normal attack; hold to fire collected ice in Final Boss Stage 2 |
| K | Heavy weapon attack |
| E | Short interaction; hold for 1 second to collect ordinary drops magnetically |
| F1 | Open or close the debug terminal |
Use room goto <roomId> in the terminal to reach a boss room:
| Boss | Room ID |
|---|---|
| Cerberus | dungeonOneEnd |
| Snake | dungeonTwoEnd |
| Sleipnir | dungeonThreeEnd |
| Dragon | dungeonFourEnd |
| Final Boss | finalBossRoom |
From outside the Final Boss room, room fb_stage 1, room fb_stage 2 or room fb_stage 3 starts a fresh encounter at that stage. Test kill and challenge conditions through normal combat; room clear bypasses those conditions. For unlock checks, use a save where the relevant achievement is still locked.
-
Regular enemy variants β Visit all four dungeon themes, including the enemy placements updated in PR #388. Check that spawn points match
rooms.jsonand remain on walkable ground. Check skin/animation/health bar, bomb fuse and dodge, parent death producing exactly two nonrecursive children, and non-splitting chase variants. Expected: Bomb damages only eligible overlap at fuse expiry; children are tracked; room clears after all tracked enemies die. -
Walls, crowds and interrupted pursuit β Chase around corners/doorways with several enemies; interrupt with lunge/recovery; conceal the player; test near room boundaries. Expected: No footprint clipping or waypoint overshoot; blocked enemies stop/replan/yield; chase resumes appropriately and concealment suppresses acquisition.
-
Medusa and Minotaur β Hit Medusa during lunge preparation and movement, including a child; repeat during recovery. Observe Minotaur axe and post-charge attacks. Expected: Medusa recovery refreshes without contact damage/knockback; Minotaur damage matches its attack window and each attack hits at most once.
-
Flying enemies and resources β Observe Wasp, Harpy, Crow and Jingwei in their rooms; move behind walls and watch volleys/impact animation. Expected: Patrol stays spawn-relative; three-shot spread uses the themed regions; shots cannot pass through walls. Fallback resources remain valid.
-
Scaling and health display β Enter boss rooms after different completed-dungeon counts; inspect starting/current/max health and damage to the half-health boundary. Expected: Full health at spawn, correctly filled bars and no premature phase transition. Dragon base maximum is 200; phase threshold is half actual maximum.
-
Cerberus β Kill the middle head first, then side heads; enter/leave mist, let it expire, kill its source, and observe movement/status restoration. Expected: Surviving heads keep functioning; chain/body persist while required; one complete-boss achievement after all heads die. Record mist-effect restoration, not only visual removal.
-
Snake routes and shield β Fight near solid corners; observe underground detours/warnings; enter Phase 2; collect/refill gems at health below and at 40%; consume all six blocks. Expected: No wall crossing or unsafe emergence; visible reachable pickups; refill does not stack, qualifying heal is 15% of max, and the sixth block prevents damage.
-
Snake achievements β Use separate fresh attempts for no-gem victory and first Phase 2 pickup. Hit during EXPOSED (including lethal hit), then compare poison windup/firing and blocked hits. Expected: Only the correct three challenge conditions unlock; no-gem attempt requires living player at defeat; later attempts do not inherit prior pickup/hit state.
-
Dragon and Sleipnir β Check both phases, moving/attack animations, wall interactions, skill cleanup, Sleipnir dust and each defeat achievement. Expected: Skills match phase plans, cancelled/owned effects clear on death, and one matching boss kill is reported.
-
Final Boss Stage 1 β Run both summon waves and the full break. Dodge/stay in petrification warnings. Use separate attempts for no hit, blocked hit, pre-fired projectile and damage over time during the break. Expected: Eight then sixteen summons; full 7-second break; 0.5-second petrification warning; only an uninterrupted qualifying break unlocks the achievement.
-
Final Boss Stage 2 β Collect reserves, hold/release J, fire at walls/cover/boss, exhaust reserves and complete the stage. Compare fireball avoidance with shielded contact. Expected: Four accepted 0.25 impacts remove 1 HP; normal attacks are blocked; an actual ice hit unlocks its challenge; any boss-fireball hit invalidates fireproof; phase exit clears input/hints/resources.
-
Final Boss Stage 3 achievements β Take ice hits in three separate consecutive volleys; repeat with a missed volley and multiple hits in one volley. Compare sword/dagger with ranged hits; trigger a statue evade teleport. Expected: One streak count per volley, miss resets, qualifying melee and first successful statue teleport unlock only their matching achievements.
-
Statues, tornadoes and ending β Observe five statues, wall/spacing behaviour, ground shockwaves and tornado contact including overlap/jumping; defeat the last statue. Expected: At most four tornadoes, one shared damage clock; jumping avoids ground shockwaves but does not avoid tornado contact; hazards/locks clear and peaceful Grandpa completes the room.
-
Ordinary-drop magnetic pickup β Use short E, a full 1-second hold, release during flight, then create new drops and hold again; test room exit/death and nearby boss-specific pickups. Expected: Short interaction and completed hold do not both trigger; travelling drops keep moving, new drops need a new hold, rewards are not duplicated, and boss ice/gems retain separate collection.
-
Cleanup and repeated attempts β Leave/re-enter rooms, die during warnings, and dispose encounters while projectiles/effects/spawns are pending. Expected: No lingering UI, damage, timers, frozen controls or duplicate rewards; a fresh encounter starts with fresh attempt state.
-
Snake size, health and dust (PR #388) β Start an unscaled Snake encounter, check its 250 maximum HP and enlarged sprite, then observe burrowing, movement and emergence beside walls and room edges in both phases. Expected: The enlarged collider can traverse the room; dust follows the ground contact point and stays outside walls and within the room; the warning centre and attack radius keep their combat behaviour.
-
Cerberus detailed regression checks β Use separate encounters for middle-first and side-first defeat orders. Check independent head health, head visibility and surviving attacks. Compare sequential Phase 1 attacks with concurrent Phase 2 attacks; test above, at and below half combined scaled maximum health. Dodge bite windup, observe fireball tracking/impact, and verify that the wall anchor remains fixed while the chain follows the body. Expected: No premature enrage, dead heads stop while surviving heads continue, chain restriction remains effective, and complete defeat is reported only once after all heads die. A middle-head death alone must not unlock the achievement. Confirm mist status restoration and body/chain cleanup. Homing movement tests do not establish projectile wall blocking; verify that separately in gameplay.
-
Chinese Dragon detailed regression checks β Verify full scaled health at spawn and transition at half actual maximum. Observe Phase 1 sequential skills and Phase 2 combinations/recovery windows. Test Thunder Orb tracking, lifetime, one-hit damage and solid-obstacle impact. Dodge Cloud Dash after its warning and check direction locking, distance limit, wall stopping and recovery. Leave Storm Zone circles before delayed strikes and observe separately warned Phase 2 zones. Kill the Dragon during queued shots, dash warnings and storm warnings in separate encounters. Expected: No premature enrage, phase-appropriate animations, no cancelled delayed damage, owned-effect cleanup and one matching defeat achievement. Record black/void-gap behaviour separately from solid-wall checks.
-
EnemyManager integration β Visit all dungeon themes and verify factory-created enemies and real assets. Kill split parents and verify that their two children remain tracked. Repeat Cerberus defeat orders and check for duplicate rewards/achievement notifications. Leave rooms while spawns or rewards are queued. Expected: Correct scaling, room clear only after tracked enemies die, one complete-boss report, and no stale room-owned spawns or duplicate rewards.
Related feature documentation: Enemies Β· Enemy AI and Navigation Β· Enemy Stat Display Β· Mini Boss 1: Cerberus Β· Snake Miniboss Remake Β· Miniboss 4: Sleipnir Β· Mini Boss 3: Chinese Dragon Β· Final Boss: Grandpa Β· Final Boss Stage 2 Remake and Stage 3 Improvements.