Skip to content

Feature: Gamified Minecraft Lists Module (Survival Story Mode, FLIP Animations & 17-Op Sandbox) - #23

Open
abhijeetjanbandhu123 wants to merge 6 commits into
vicharanashala:mainfrom
abhijeetjanbandhu123:main
Open

Feature: Gamified Minecraft Lists Module (Survival Story Mode, FLIP Animations & 17-Op Sandbox)#23
abhijeetjanbandhu123 wants to merge 6 commits into
vicharanashala:mainfrom
abhijeetjanbandhu123:main

Conversation

@abhijeetjanbandhu123

@abhijeetjanbandhu123 abhijeetjanbandhu123 commented Jul 27, 2026

Copy link
Copy Markdown

✨ Add Minecraft Lists Learning Module

Summary

Introduces a fully gamified Minecraft Lists module to PyBe, teaching Python list operations through an interactive Minecraft-themed experience. This is a frontend-only feature addition — no backend changes.

What's New

  • 🎮 Survival Mode — a guided 9-step story teaching [], append(), len(), insert(), pop(), and sort(), accepting both plain English ("add wood") and Python syntax input.
  • 🛠️ Creative Sandbox — a free-play mode covering all 17 standard list operations with a simulated REPL history log and Big-O complexity badges.
  • 🎬 FLIP Animation Engine (Stage.jsx) — smooth, native React-based reordering animations (no external animation library needed).
  • 🧭 New route /minecraft-list linked from the main dashboard sidebar via a "PLAY MINECRAFT LISTS" button.

Changes

  • Added react-router-dom for client-side routing.
  • Wrapped the app in BrowserRouter / Routes to support the new route alongside the existing dashboard.
  • Added try/catch/finally error handling to refresh() in main.jsx so a down backend no longer leaves the UI stuck loading.
  • Added JSDoc comments across all exported functions/components in main.jsx.
  • Namespaced global dashboard CSS classes under .app-shell to prevent style leakage into the new module.
  • Added Vite config (allowedHosts: true) for dev server support.

Files Added

  • client/src/pages/MinecraftList/MinecraftList.jsx
  • client/src/pages/MinecraftList/components/SurvivalMode.jsx
  • client/src/pages/MinecraftList/components/CreativeSandbox.jsx
  • client/src/pages/MinecraftList/components/Stage.jsx
  • client/src/pages/MinecraftList/MinecraftList.css
  • client/src/pages/MinecraftList/README.md
  • client/public/minecraft-list/hero_backpack.jpg

Backend Impact

✅ None — server/** is untouched.

Testing

  • Verified / dashboard loads and functions as before
  • Verified /minecraft-list route loads correctly
  • Tested Survival Mode step progression (English + Python inputs)
  • Tested all 17 Creative Sandbox operations
  • Verified FLIP animations render smoothly
  • Confirmed no console errors on backend downtime (error handling)

Notes

  • No breaking changes to existing API or database schema.
  • Documentation (Product.md, case-study.md, change.md) updated to reflect this release.
    Product.md
    Changelog.md
    Case_Study.md

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant