{"id":29032479,"url":"https://github.com/adzcoder/atomicfisher","last_synced_at":"2025-06-26T11:02:12.088Z","repository":{"id":298504702,"uuid":"1000192411","full_name":"AdzCoder/AtomicFisher","owner":"AdzCoder","description":"A fun educational fishing game designed for KS3 science students to learn about chemical elements and the periodic table.","archived":false,"fork":false,"pushed_at":"2025-06-13T15:49:35.000Z","size":3118,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-26T11:01:53.530Z","etag":null,"topics":["app-designer","chemistry-game","educational-game","element-identification","game-based-learning","interactive-learning","key-stage-3","matlab","periodic-table","stem-education","universityofwarwick"],"latest_commit_sha":null,"homepage":"https://www.youtube.com/watch?v=VTREubCIVF4","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AdzCoder.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-11T12:03:28.000Z","updated_at":"2025-06-13T15:49:38.000Z","dependencies_parsed_at":"2025-06-11T13:25:12.201Z","dependency_job_id":"6d2e9166-1adc-4fa8-937f-d6c149504806","html_url":"https://github.com/AdzCoder/AtomicFisher","commit_stats":null,"previous_names":["adzcoder/atomicfisher"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AdzCoder/AtomicFisher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdzCoder%2FAtomicFisher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdzCoder%2FAtomicFisher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdzCoder%2FAtomicFisher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdzCoder%2FAtomicFisher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AdzCoder","download_url":"https://codeload.github.com/AdzCoder/AtomicFisher/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdzCoder%2FAtomicFisher/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262053537,"owners_count":23251214,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["app-designer","chemistry-game","educational-game","element-identification","game-based-learning","interactive-learning","key-stage-3","matlab","periodic-table","stem-education","universityofwarwick"],"created_at":"2025-06-26T11:00:39.468Z","updated_at":"2025-06-26T11:02:12.073Z","avatar_url":"https://github.com/AdzCoder.png","language":null,"readme":"# 🎣 AtomicFisher\n\n![MATLAB Version](https://img.shields.io/badge/MATLAB-R2024b+-blue?style=flat-square) ![Educational](https://img.shields.io/badge/Educational-KS3%20Science-green?style=flat-square) ![License](https://img.shields.io/badge/License-Educational%20Use-orange?style=flat-square) ![Version](https://img.shields.io/badge/Version-2.0-red?style=flat-square)\n\nA fun educational fishing game 🎮 designed for KS3 science students to learn about chemical elements and the periodic table 🧪⚛️\n\n## 🎥 Demo \u0026 Presentation\n\n[![AtomicFisher Game Demo](title.gif)](https://www.youtube.com/watch?v=VTREubCIVF4)\n\n🎬 **Watch the full game presentation and demo** on YouTube! This video showcases Atomicfisher's gameplay, educational features, and development journey.\n\n## 📖 About\n\nAtomicFisher is an interactive MATLAB App Designer game where players control a fishing hook 🪝 to catch fish 🐟 carrying non-metal elements. The game helps students distinguish between metals and non-metals in a fun, engaging way! 🎯\n\n## ✨ Features\n\n- **🎓 Educational Gameplay**: Learn to identify non-metal elements (H, He, C, O)\n- **🎮 Interactive Controls**: Use arrow keys to move the fishing hook and spacebar to catch fish\n- **🏆 Scoring System**: Earn points for correct catches, lose points for mistakes\n- **⭐ Star Rating**: Achieve up to 3 stars based on your performance\n- **⏰ Timer Challenge**: Complete the level within the time limit\n\n## 💻 Requirements\n\n- MATLAB 2024b (may not work on previous versions) 🔧\n- MATLAB App Designer 🛠️\n\n## 🚀 Installation \u0026 Running\n\n1. 📥 Download or clone this repository\n2. 📁 Ensure all files are in the same directory, maintaining the folder structure\n3. 🔧 Open MATLAB 2024b\n4. 📂 Navigate to the project folder\n5. 🖱️ Double-click `AtomicFisher.mlapp` to open in App Designer\n6. ▶️ Click the \"Run\" button in App Designer, or\n7. ⌨️ Type `AtomicFisher` in the MATLAB command window\n\n## 🎯 How to Play\n\n1. **🎯 Objective**: Catch only the fish carrying non-metal elements\n2. **🎮 Controls**:\n   - ⬅️➡️⬆️⬇️ Arrow keys: Move the fishing hook\n   - 🚀 Spacebar: Release/catch the hooked fish\n   - 🖱️ Click background: Pause the game\n3. **🏆 Scoring**:\n   - ➕100 points for each correct catch ✅\n   - ➖50 points for catching wrong elements ❌\n4. **🎯 Elements to catch**: H (Hydrogen), He (Helium), C (Carbon), O (Oxygen) ✅\n5. **⚠️ Elements to avoid**: Na (Sodium), Fe (Iron), K (Potassium) ❌\n\n## ⚙️ Game Mechanics\n\n- 🐟 Fish spawn randomly with different elements\n- 🪝 Hook must touch the fish to catch it\n- 🚤 Bring caught fish back to the boat (hook above boat level) to score\n- 🏃‍♂️ Game speed increases as you progress\n- ⏱️ 60 seconds time limit per level\n\n## ⭐ Star System\n\n- ⭐ 1 Star: 175+ points\n- ⭐⭐ 2 Stars: 325+ points  \n- ⭐⭐⭐ 3 Stars: 475+ points\n\n## 📁 File Structure\n\n```\nAtomicFisher/\n├── 🎮 AtomicFisher.mlapp     # Main game application\n└── 🖼️ Images/                # Game assets\n    ├── 🌅 Backgrounds/       # Background images\n    ├── ⚛️ Elements/          # Chemical element icons\n    ├── 🐟 Fish/              # Fish sprites and animations\n    ├── 🚤 Player/            # Boat, hook, and rope graphics\n    └── ▶️ play.gif           # UI elements\n```\n\n## 🎓 Educational Value\n\nThis game is designed for KS3 (Key Stage 3) science curriculum and helps students:\n- 🔍 Identify non-metal elements\n- 📚 Learn chemical symbols\n- 🧠 Understand the difference between metals and non-metals\n- ⚡ Develop quick recognition of periodic table elements\n\n## 📈 Version History\n\n- **🆕 Version 2**: Current release with improved gameplay and MATLAB 2024b compatibility\n- **📝 Version 1**: Initial release\n\n## 👨‍💻 Author\n\n**Adil Wahab Bhatti**\n- 🏫 University of Warwick, School of Engineering  \n- 📚 [ES2D7: Systems and Software Engineering Principles (23/24)](https://courses.warwick.ac.uk/modules/2023/ES2D7-15)\n\n## 🔧 Troubleshooting\n\n- **❌ Game won't start**: Ensure you're using MATLAB 2024b or compatible version\n- **🖼️ Images not loading**: Check that the Images folder is in the same directory as the .mlapp file\n- **⚠️ Performance issues**: Close other MATLAB applications and ensure sufficient system resources\n\n## 🤝 Contributing\n\nThis is an educational project. If you'd like to suggest improvements or report bugs, please open an issue on GitHub! 💡\n\n## 📜 Licence\n\nMIT Licence — see the [LICENCE](LICENSE) file for details. ⚖️\n\n---\n\n*❓ For questions or issues related to this educational project, please refer to the original coursework documentation or contact the development team through appropriate academic channels.*\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadzcoder%2Fatomicfisher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadzcoder%2Fatomicfisher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadzcoder%2Fatomicfisher/lists"}