Skip to content

[NEW GAME] Bullet Math #111

Description

@aleenaharoldpeter

🔍 Is this game already proposed?

  • I have searched both "open" and "closed" issues and this is not a duplicate.

🎮 Game Summary

Bullet Math is a timed cognitive game designed to sharpen working memory, attention, and logical reasoning through mental arithmetic drills.

Players are presented with arithmetic equations (e.g., 7 + 3 = ?) and must type the correct answer. The game offers three difficulty levels, each introducing progressively more complex operations:

  • Amateur (Easy): Simple addition, subtraction, multiplication (1–9), and division with small numbers and clean quotients.
  • Normal (Medium): Two-digit addition/subtraction, multiplication tables (6–14), and division problems with exact answers.
  • Veteran (Hard): Large multi-digit addition/subtraction, multi-digit multiplication, division with larger quotients, and challenging combinations (e.g., splitting numbers into tens + ones for harder multiplication).

The game runs on a 2-minute countdown. Correct answers award points based on difficulty (Amateur = 1, Normal = 2, Veteran = 3). Incorrect answers do not subtract points, but players must solve the current equation before moving on. Wrong inputs are highlighted in red to provide immediate feedback.

Players can also track live stats: ⭐ Score, ⏳ Time Remaining, and 📊 Attempted Problems.


📖 How to Play

  1. Choose a difficulty level: Amateur, Normal, or Veteran.
  2. Solve the arithmetic problem displayed.
  3. Type your answer and press Enter.
    • ✅ Correct → score points and move to the next equation.
    • ❌ Wrong → input turns red; retry until correct.
  4. Continue solving for 2 minutes.
  5. Aim for the highest ⭐ score possible.

⚙️ Algorithm Explanation

  • Equation Generator: Creates random arithmetic equations depending on difficulty.
  • Clean Division: Ensures division problems always result in whole numbers.
  • Hard Mode (Veteran): Includes multi-digit multiplication, large sums/differences, and structured challenges (e.g., breaking numbers into tens and ones).
  • Scoring System: Awards 1–3 points depending on difficulty and tracks total attempts.

🧠 Brain Development Impact

Bullet Math strengthens:

  • Working Memory: Players must hold and manipulate numbers in mind while solving.
  • Attention & Concentration: Timed gameplay requires sustained focus and accuracy.
  • Logical & Numerical Reasoning: Complex problems in Veteran mode build flexible problem-solving skills.

These activities stimulate the prefrontal cortex (executive functions, decision-making) and the hippocampus (memory formation), improving recall and long-term arithmetic fluency.

📚 Scientific Backing (required)

Working Memory ↔ Arithmetic (review).
Raghubar, K. P., Barnes, M. A., & Hecht, S. A. (2010). Working memory and mathematics: A review of developmental, individual difference, and cognitive approaches. Learning and Individual Differences, 20(2), 110–122. https://doi.org/10.1016/j.lindif.2009.10.005
Why it fits: Shows strong links between working memory and arithmetic problem-solving — exactly the skill Bullet Math targets.

Mental Arithmetic ➜ Parietal/Attention Networks (fMRI).
Grabner, R. H., Ansari, D., Reishofer, G., et al. (2007). Individual differences in mathematical competence predict parietal brain activation during mental calculation. Journal of Neuroscience, 27(49), 12653–12659. https://pubmed.ncbi.nlm.nih.gov/18079292/
Why it fits: Mental calculation recruits parietal and attention systems; activation scales with math competence — aligns with your timed equations.

Working Memory Training & Plasticity (review).
Klingberg, T. (2010). Training and plasticity of working memory. Trends in Cognitive Sciences, 14(7), 317–324. https://pubmed.ncbi.nlm.nih.gov/20630350/
Why it fits: Summarizes evidence that adaptive practice can improve WM and attentional control — the core of Bullet Math’s design.

Meta-analysis: Mental Arithmetic Consistently Activates Fronto-Parietal Network (fMRI).
Arsalidou, M., & Taylor, M. J. (2011). Is 2+2=4? Meta-analyses of brain areas needed for numbers and calculations. NeuroImage, 54(3), 2382–2393. https://pubmed.ncbi.nlm.nih.gov/20946958/
Why it fits: Across many tasks, arithmetic engages the exact control/attention circuitry your game exercises.

Single-Digit Mental Arithmetic Predicts Later Math Skills (fMRI).
Price, G. R., Mazzocco, M. M. M., & Ansari, D. (2013). Why mental arithmetic counts: brain activation during single-digit arithmetic predicts high school math scores. Journal of Neuroscience, 33(1), 156–163. https://pubmed.ncbi.nlm.nih.gov/23283330/
Why it fits: Shows that quick mental arithmetic (like Bullet Math rounds) taps neural processes that track real-world math proficiency.

📄 Have You Read CONTRIBUTING.md?

  • I have read and understood the CONTRIBUTING.md and agree to follow the project’s game standards.

👨‍💻 Would you like to work on this game yourself?

Yes

🛠️ Implementation Plan (if you're building it)

Plan to implement Bullet Math with the following stack:

  • Framework: Next.js (React) with TypeScript
  • Styling: CSS Modules (page.module.css) using Flexbox for layout and wrapping
  • State Management: React hooks (useState, useEffect, useCallback) to handle game logic, scoring, and timer
  • Equation Generation:
    • generateEquation() builds random problems depending on difficulty (amateur, normal, veteran)
    • Division problems use makeDivisible() to ensure clean quotients (no decimals)
    • Veteran mode sometimes generates larger multi-digit problems or distributive-style multiplication challenges
  • Scoring System:
    • Amateur = 1 point
    • Normal = 2 points
    • Veteran = 3 points
    • Stats tracked: ⏳ Time Left (120s), ⭐ Score, and 📊 Attempts
  • Feedback & Input:
    • Player types answers directly into an input box
    • Press Enter to submit
    • If wrong, the answer box highlights red (.wrong style) and players must retry until correct
    • Only correct answers advance the game to the next equation
  • Responsiveness:
    • Layout built with Flexbox and wrapping so it adapts across desktop and mobile browsers
    • Tested to run correctly in both desktop and mobile views (≥360px screens)

Quality Assurance

  • Timer stops after 120 seconds and ends the game
  • Equations regenerate correctly after each solved problem
  • Wrong input handling verified (red highlight, no advancement)
  • Scoring increments as expected per difficulty level
  • Basic responsiveness validated through browser dev tools on different screen sizes

Metadata

Metadata

Labels

status: awaiting triageWaiting for maintainers to verify (please do not start work on this yet)

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions