'Level two' game to set up tools.

Toolchain Trail Capstone

The7Blueprints
Hope Fune, Anishka Sangvi, Kailyn Sanford, Meryl Chen, Anika Maranthe, Avantika Chittari, Laya Balaji

Level 2 / Environment Quest

Toolchain Trail is the second level of the OCS Onboarding Gamification project and builds upon the foundation established in Level 1, Identity Forge. Its purpose is to guide students through setting up and verifying a complete development environment for students using macOS, Windows/WSL, or Linux.

Team: Hope Fune, Anishka Sangvi, Kailyn Sanford, Meryl Chen, Anika Maranthe, Avantika Chittari, Laya Balaji

Planning Board GitHub Repository
6core stations

Project Stages

Stage 01

Development Environment Verification

View stage details

Improve the existing verifyTools.sh Bash script so it can determine whether a student's development environment is properly configured.

  • Find the repository automatically and verify required tools, files, and project configuration.
  • Give clear remediation steps and a passed, warning, or failed summary with the correct exit code.
  • Keep checks secure, platform-aware, and documented in the README.
Stage 02

Python Onboarding Agent

View stage details

Replace the Bash verification script with a cross-platform Python onboarding agent that produces structured JSON for every verification.

  • Verify development tools, GitHub access, repository setup, and project runtime across supported platforms.
  • Record structured results and connect them to each student's GitHub identity.
  • Track progress, retries, and regressions to gate levels and surface students who need help.

Toolchain Trail Stations

1 Terminal Town Gate Station 1
2 Compiler Canyon Forge Station 2
3 Editor Isle Tower Station 3
4 Git Village Hall Station 4
5 GitHub Gateway Arch Station 5
6 Build Bridge Station 6
★ Integration Summit Final gate
View station purposes

Terminal Town Gate

Shell fundamentals and package management

Compiler Canyon Forge

Java or Python runtime

Editor Isle Tower

VS Code/Cursor and WSL configuration

Git Village Hall

Git installation and configuration

GitHub Gateway Arch

GitHub authentication and repository connectivity

Build Bridge

Project build and runtime verification

Integration Summit (Gated)

Final end-to-end verification

Map Structure

Explore the map plan
  • The player begins at The Setup Grounds, located at the center of the map.
  • Six buildings surround the central area, each representing one development-environment station.
  • Integration Summit is a locked side path that becomes available only after all six stations are complete.
  • Each station has a unique building, floating nameplate, purpose icons, wooden sign, and completion feedback.
  • Integration Summit initially appears desaturated and locked.

Building States

Each station makes its progress visible as students move from setup to verified completion.

1
State 01

Locked

Desaturated with unlit torches and no glow.

2
State 02

Active

Full color with lighting and a glowing entrance.

3
State 03

Stuck

Active appearance with a subtle warning glow.

4
State 04

Complete

Full color with a steady glow and completion indicator.

NPC Feedback & Completion