Skip to content
Gary Brown edited this page Nov 30, 2025 · 1 revision

Frequently Asked Questions

Common questions and troubleshooting for the Pinball Accuracy Memory Trainer.

Table of Contents


General Questions

What is this app for?

The Pinball Accuracy Memory Trainer helps competitive pinball players memorize flipper shot positions. By repeatedly recalling percentage values for different shots, you build muscle memory that translates to faster, more accurate decision-making during actual gameplay.

Who made this?

This project was created by Gary Brown, a competitive pinball player. The entire codebase was written using AI "vibe coding" — every line of code, build scripts, GitHub workflows, and documentation was generated by AI with human guidance and review.

Is it free?

Yes, completely free and open source under the MIT license. No ads, no subscriptions, no data collection.

Do I need to install anything?

No! The app runs entirely in your web browser. Just visit the live demo and start training.

Does it work offline?

Yes. Once you've loaded the app, it works offline. For guaranteed offline access, download the standalone HTML file which has everything embedded.

What browsers are supported?

Any modern browser with ES6+ support:

  • ✅ Chrome / Chromium
  • ✅ Firefox
  • ✅ Edge
  • ✅ Safari
  • ✅ Brave
  • ❌ Internet Explorer (not supported)

Using the App

What do the percentages mean?

Each percentage represents a position on the flipper:

  • 5-15% — Tip of the flipper
  • 50% — Middle of the flipper
  • 85-95% — Near the base/post
  • 0 (NP) — Not Possible from this flipper

Lower percentages = earlier timing / tip shots. Higher percentages = later timing / base shots.

Why must left flipper values be increasing?

This reflects how shots are spatially arranged on a pinball playfield. Shots on the left side of the table (hit with the left flipper tip) have low percentages. Shots toward the center/right (hit with the left flipper base) have higher percentages.

The same logic applies in reverse for the right flipper (decreasing values).

What does "NP" mean?

"Not Possible" — the shot cannot reasonably be made from that flipper. For example, a far-left orbit might be NP from the right flipper.

How do I delete a shot?

Click the trash icon (🗑) at the end of the shot row in the setup table.

How do I reorder shots?

Drag and drop! Click and hold on a shot row, then drag it to the desired position. A visual indicator shows where it will be inserted.

Can I save my custom configuration?

Yes! Click the export icon (⬆) to download your configuration as a JSON file. You can reload it later or share it with others.

How do I load a preset table?

  1. Click "+ Add Shot(s)"
  2. Select a table from the preset dropdown
  3. Click to load — shots and percentages are pre-configured

Training & Practice

What's the best way to practice?

  1. Start with tables you know — Validate your baseline understanding
  2. Keep sessions short — 10-15 minutes daily beats occasional long sessions
  3. Use Random mode — Prevents bias toward favorite shots
  4. Gradually increase drift — Master low drift before adding challenge
  5. Do final recall tests — Measure true retention periodically

What is drift?

Drift simulates real-world variability. The hidden "truth" values you're recalling gradually shift during practice, preventing rote memorization and training adaptive recall.

In real pinball, your timing varies, flipper rubber changes, and conditions fluctuate — drift prepares you for this.

What do the drift settings mean?

Setting Description
Initial Random Steps How different hidden values are from your base percentages at session start (0-4 steps × 5%)
Drift Every N How often values shift (every N attempts)
Drift Magnitude Maximum shift per drift event (in 5% steps)

What do the feedback colors mean?

Color Meaning Error
🟢 Bright green Perfect 0%
🟢 Dark green Slight error 5%
🟡 Yellow Fairly off 10%
🔴 Red Very off 15%+

How is the score calculated?

  • Perfect (0% error): +10 points
  • Slight (5% error): +5 points
  • Fairly (10% error): +2 points
  • Very (15%+ error): +0 points
  • Adjustment bonus: Extra points for correcting in the right direction

Should I use Manual or Random mode?

  • Manual: Good for focused practice on specific weak shots
  • Random: Better for realistic training — you don't choose shots during a real game

We recommend Random mode for most practice, with occasional Manual sessions to target problem areas.

How long should a session be?

Quality over quantity. 10-15 focused minutes is more effective than an hour of distracted practice. End with a Final Recall test to measure retention.


Technical Issues

My data disappeared!

Data is stored in your browser's localStorage. It can be lost if you:

  • Clear browser data/cookies
  • Use private/incognito mode
  • Switch browsers
  • Use a different device

Solution: Export your configurations regularly as JSON backups.

The app won't load

Try these steps:

  1. Refresh the page (Ctrl+F5 for hard refresh)
  2. Try a different browser
  3. Disable browser extensions (ad blockers can sometimes interfere)
  4. Check your internet connection (for the online version)
  5. Try the standalone versiondownload here

The playfield looks wrong or cut off

  • Resize your browser window — The app is optimized for desktop/tablet
  • Try fullscreen mode — Click the expand icon
  • Zoom out — Use Ctrl+Minus or browser zoom controls

Percentages won't save / keep resetting

The app enforces ordering constraints:

  • Left flipper must be strictly increasing
  • Right flipper must be strictly decreasing

If your values violate these rules, they'll be auto-corrected. Reorder your shots or adjust values to comply.

I can't enter a specific percentage

Values must be:

  • Multiples of 5 (5, 10, 15... 95)
  • 0 for "Not Possible"
  • Within the allowed range for that position (ordering constraints)

How do I reset everything?

To completely reset:

  1. Open Developer Tools (F12)
  2. Go to ApplicationLocal Storage
  3. Delete all entries starting with pinball_
  4. Refresh the page

Data & Privacy

Is my data sent anywhere?

No. The app is 100% client-side. No data is ever transmitted to any server. There are no analytics, tracking, or network requests.

Where is my data stored?

In your browser's localStorage, on your device only. Keys include:

  • pinball_rows_v1 — Shot configurations
  • pinball_driftEvery_v1 — Drift frequency setting
  • pinball_driftMag_v1 — Drift magnitude setting
  • Various UI state keys

Can I backup my data?

Yes! Use the export function to save your configuration as a JSON file. Store it wherever you keep important files.

Can I sync across devices?

Not automatically (there's no server). But you can:

  1. Export your configuration on Device A
  2. Transfer the JSON file (email, cloud drive, etc.)
  3. Import on Device B

Contributing

How can I contribute?

Many ways!

  • ⭐ Star the repo — Helps others discover it
  • 🎰 Add presets — Submit configurations for pinball tables
  • 🐛 Report bugs — Help improve quality
  • 💡 Suggest features — Share ideas in Discussions
  • 📝 Improve docs — Fix typos, add clarity
  • 🔧 Contribute code — Bug fixes and features welcome

See the Contributing Guide for details.

How do I add a preset for my favorite table?

See the Preset Contribution Guide for step-by-step instructions.

I found a bug — how do I report it?

Open a bug report with:

  • Steps to reproduce
  • Expected vs actual behavior
  • Browser and OS information
  • Screenshots if helpful

I have an idea for a feature

Open a feature request or start a Discussion.


Still Have Questions?


Didn't find your answer? Edit this page to add it!

Clone this wiki locally