From 0732306619c2e9770c8b85d8e78efb4f0f7d94c9 Mon Sep 17 00:00:00 2001 From: Mat Manna <91392083+matmanna@users.noreply.github.com> Date: Tue, 7 Oct 2025 21:00:42 -0400 Subject: [PATCH 1/3] :memo: Add ATTRIBUTION.md --- ATTRIBUTION.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 ATTRIBUTION.md diff --git a/ATTRIBUTION.md b/ATTRIBUTION.md new file mode 100644 index 0000000..d5055ad --- /dev/null +++ b/ATTRIBUTION.md @@ -0,0 +1,17 @@ +# Attribution + +## Sound Attribution: + +* “Player [1-4]” and “Winner!” by Kenney.nl +* “Success Fanfare Trumpets” by freesound_community from Pixabay +* “success 1” by freesound_community from Pixabay +* “Buzzer 5” by floraphonic from Pixabay +* “TV Show Intro Music” by TheoJT from Pixabay +* “Screaming Hawk” by PsychoBird on SoundBible + +## Tools/Software Used: + +* Affinity Designer for Visual Design (Vinyl Vectors, T-Shirts, Project/Team Logos, Card Icons) +* Audacity for sound editing/modifications +* PLCNext Engineer for programming/simulation/testing +* Excalidraw for diagramming, flowcharting -- 2.51.2 From 191d4f1ba2b81541de266966061bc09114b930e5 Mon Sep 17 00:00:00 2001 From: Mat Manna <91392083+matmanna@users.noreply.github.com> Date: Wed, 8 Oct 2025 08:14:29 -0400 Subject: [PATCH 2/3] :memo: Create README.md w/ project overview Added initial project description and note about README status. --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..377e2d5 --- /dev/null +++ b/README.md @@ -0,0 +1,6 @@ +# Operation: Falcon Nation + +🦅 "Operation: Falcon Nation" is a complete re-imagining of a classic board game through the magnification of scale, sensory experience, and of course, automation. Featuring a 6-ft, life-size board, dramatically upscaled themed pieces, and technology-enhanced automation of game mechanics, the project was built to serve philanthropic causes and events. + +> [!NOTE] +> This README is a work-in-progress -- 2.51.2 From 09df0e393b20afe8765830f6914a8f318badad8e Mon Sep 17 00:00:00 2001 From: Mat Manna <91392083+matmanna@users.noreply.github.com> Date: Wed, 8 Oct 2025 13:39:55 -0400 Subject: [PATCH 3/3] :memo: Enhance README with features and docs Expanded README with detailed features and documentation sections. --- README.md | 33 ++++++++++++++++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 377e2d5..a78f6eb 100644 --- a/README.md +++ b/README.md @@ -2,5 +2,36 @@ 🦅 "Operation: Falcon Nation" is a complete re-imagining of a classic board game through the magnification of scale, sensory experience, and of course, automation. Featuring a 6-ft, life-size board, dramatically upscaled themed pieces, and technology-enhanced automation of game mechanics, the project was built to serve philanthropic causes and events. -> [!NOTE] +> [!IMPORTANT] > This README is a work-in-progress + +## 🌟 Features + +* Automatic piece-removal detection +* Circuit-based tong penalty loop +* Score-keeping and dynamic leaderboards +* Haptic-feedback-enabled modified kitchen tongs +* Multicolor board-and-cavity game state lights +* 11 custom-themed game pieces & cavities +* Two touchscreen web panel displays +* Two (repurposed car) speakers & immersive audio +* Plug-and-outlet power for project & tongs + +## 📺 Demo Video + +## 📘 Documentation + +### 📚 Manual + +A full manual containing operation (pun-intended) and gameplay instructions for the project can be found [here](/MANUAL.md). + +### 🔖 Monorepo Layout + +This monorepo includes all of the components of the project one would need to reproduce, update, or extend the original version contained within. The specific documentation most relevant to this objective are: + +* `/src` - The PLCNext Engineer project codebase +* `WIRING.md` - The electrical wiring configuration +* `/3d` - The 3d-print-ready piece and cavity files +* `/build` - The wood, glass, tong, and vinyl construction +* `/assets` - Files related to art, SFX, music, and branding +* `EXPENSES.md` - A budgeted list of components (& sources!) -- 2.51.2