Thumbnail image for project.

Inspiration

Bit-Bandits was inspired by classic heist movies and tactical puzzle games where infiltrating high-security vaults demands precision, patience, and timing. We wanted to capture that high-stakes tension across every layer of a break-in-from dodging security perimeters to cracking the safe mechanics-delivering a seamless, multi-stage digital heist built entirely with an interactive desktop interface.

What it does

Bit-Bandits is an interactive, three-stage heist simulator developed using JavaFX and FXML. Players assume the role of an infiltrator who must overcome three sequential security challenges to pull off a successful security breach.

The heist begins with the Vault Wheel, an intricate safe dial mechanic where players must search for the combination sequence through visual alignment cues, tension changes, and acoustic feedback to crack the outer door. Once the safe door gives way, players encounter the Lockpicking stage, an internal alignment puzzle requiring them to coordinate tension and pick angle to elevate three separate tumbler pins into their shear line. Finally, players face the Laser Grid minigame, a high-stakes avoidance and timing challenge guarding the central vault chamber where they must guide their avatar past oscillating tripwires and moving surveillance beams without triggering alarms to secure the gold.

How we built it

The project relies on a Model-View-Controller architecture implemented via JavaFX and FXML layouts. User interfaces were structured declaratively with FXML and styled with custom CSS themes to deliver a dark, high-security terminal atmosphere. Game mechanics, continuous collision checks for dynamic laser vectors, and safe dial physics operate through JavaFX \texttt{AnimationTimer} loops and timeline-based coordinate interpolation. Visual and audio feedback loops were wired directly to controller bindings to ensure responsiveness without external microcontroller hardware. The entire project is organized as a modular application with standard dependency management for rapid building and multi-platform desktop execution.

Challenges we ran into

Balancing three distinct gameplay paradigms presented the primary design hurdle, compounded by a major architectural pivot midway through development. We originally architected the interaction model around an external Arduino microcontroller paired with physical joystick inputs, intending to give safe manipulation a tactile hardware feel. Transitioning away from embedded hardware to standard keyboard and desktop event dispatchers required redesigning the core input pipeline, re-mapping continuous analog feedback curves onto discrete keypresses and mouse sweeps without sacrificing tactile weight. Concurrently, shifting smoothly from rotational dial searches to mechanical pin manipulation and real-time laser avoidance required strict separation of state variables and dedicated controller lifecycles. Managing stage transitions without leaking running thread timers or disrupting background audio assets demanded careful scene orchestration. Additionally, calibrating fair hitboxes on oscillating laser sweeps and finding the right forgiveness margins for safe dial detents required extensive iteration to keep challenges rewarding rather than frustrating.

Accomplishments that we're proud of

We are most proud of successfully delivering a cohesive, multi-stage game loop that runs smoothly from the initial vault crack to escaping the laser grid with the gold, all within a unified JavaFX desktop application. Successfully pivoting our entire control scheme from an external Arduino hardware setup to responsive keyboard and mouse controls under strict hackathon deadlines proved our team's adaptability and technical resilience. Rather than compromising the player's immersion during that transition, we translated continuous analog mechanics—like dial resistance and tumbler alignment—into intuitive desktop inputs complemented by dynamic audio and visual feedback. Engineering three mechanically distinct challenges while keeping the visual identity, scene lifecycles, and narrative pacing seamless across every stage stands as our strongest achievement.

What we learned

Bit-Bandits proved to be an invaluable masterclass in system architecture, rapid refactoring, and game feel under intense time constraints. Shifting our input paradigm away from serial-driven microcontrollers to desktop event handling taught us how to decouple core gameplay logic cleanly from the underlying input layer. We deepened our mastery of the JavaFX application lifecycle, particularly managing complex multi-stage FXML state, coordinating AnimationTimer loops, and preventing thread leaks during dynamic scene transitions. Beyond the technical mechanics of collision detection and input mapping, we gained critical insight into calibrating tactile player feedback purely through audiovisual cues when physical hardware is removed. Most importantly, the sprint reinforced the value of agile decision-making, showing us how to recognize architectural bottlenecks early, adjust project scope decisively, and maintain clean modular code in a high-pressure collaborative environment.

What's next for Bit-Bandits

Our primary focus for Bit-Bandits moving forward is expanding the prototype into a fully fleshed-out, replayable heist platform.

To increase replay value, we plan to implement procedural generation across all three stages. Randomizing safe combination lengths, tumbler spring heights, and laser oscillation patterns on every run will ensure no two break-ins feel identical. We also want to introduce an overarching heist timer paired with a dynamic alarm detection meter, where errors in earlier stages like slipping on a lock tumbler directly shrink the time window allowed to dodge lasers in the gold room.

Additionally, we aim to reintroduce hardware peripherals as an optional enthusiast mode. Building an abstracted input layer will allow players to toggle seamlessly between native keyboard controls and custom microcontrollers or dual analog joysticks for maximum physical immersion. Introducing selectable security contracts with escalating difficulty tiers, local high-score leaderboards tracking breach times, and branching escape routes will complete the transition from a hackathon showcase into a polished indie puzzle title.