Local copies of external docs/wikis cited elsewhere in this project, saved so a citation doesn't
go dead if the live page changes or vanishes. Generated by
tools/hw_console/generate_docs.py from docs/references/index.yaml — do not hand-edit this
file, it will be overwritten. Add a new source by adding one entry to index.yaml and saving its
content under docs/references/raw/<slug>/content.md, then re-run the generator.
Generated: 2026-11-04.
| Source | Archived | Cited by | Note |
|---|---|---|---|
| CobraPin Pinball Controller Powered by OPP (official MPF doc) (local copy) | 2026-10-04 | docs/opp-hardware-reference.md | Full verbatim copy of the page source plus its 15 images (re-archived 2026-10-04; the 2026-09-13 copy was only a summary). Power input, switch inputs (3.3V), solenoid banks and HV_A/B/C fuses, NeoPixel chains (J10-J12/J14, NEO0 = 0-0-x, NEO1 = 1-0-x, 256 RGB each), the STM32 boards, and an example config. |
| CobraPin Pinball Controller - GitHub markdown source (local copy) | 2026-10-04 | docs/opp-hardware-reference.md | Same file as cobrapin-official-doc, which holds the verbatim copy; this entry only points there. |
| CobraPin - Pinball Makers wiki (local copy) | 2026-09-14 | docs/board-silkscreen-reference.md | Authority for silkscreen labeling on CobraPin corrected a wrong claim in this project's own doc: switch-input AND coil-output headers both print the MPF-compatible number directly - confirmed independently against this cabinet's own board photos. |
| Open Pinball Project (OPP) - pinballmakers.com wiki (local copy) | 2026-09-13 | docs/opp-hardware-reference.md, design/research/outside-perspective.md | Community OPP hardware wiki - wing boards, firmware flashing, chaining, wiring safety. |
| OPP Switches (MPF docs) (local copy) | 2026-09-13 | docs/opp-hardware-reference.md | Switch numbering scheme, worked example config. |
| OPP coils / drivers (MPF docs) (local copy) | 2026-09-13 | docs/opp-hardware-reference.md | Coil numbering, pulse time, hold power, pulse power, recycle factor. |
| OPP LEDs (MPF docs) (local copy) | 2026-09-13 | docs/opp-hardware-reference.md | Serial LED numbering/channel scheme (chain-card-index). |
| OPP Lights (MPF docs) (local copy) | 2026-09-13 | docs/opp-hardware-reference.md | Incandescent-wing bulb numbering (not the serial LED strips). |
| Connecting OPP to your computer (MPF docs) (local copy) | 2026-09-13 | docs/opp-hardware-reference.md | mpf hardware scan output format, Linux udev/ModemManager gotchas. |
| Configuring your machine for OPP (MPF docs) (local copy) | 2026-09-13 | docs/opp-hardware-reference.md | hardware:/opp: config sections, port naming across OS. |
| Troubleshooting OPP (MPF docs) (local copy) | 2026-09-13 | docs/opp-hardware-reference.md | Hardware scan, debug:true, poll_hz tuning. |
| Stern SPIKE(TM) System Repair - PinWiki (local copy) | 2026-09-13 | docs/stern-spike-trough-opto.md | Confirms this project's trough opto board (74HC165) is NOT the genuine SPIKE node-bus. |
| Controlling a custom homebrew machine with MPF (local copy) | 2026-09-13 | design/research/outside-perspective.md | Control-system/power/parts guidance for homebrew MPF machines. |
| Config Version 6 Migration Guide (local copy) | 2026-09-13 | design/research/outside-perspective.md | Confirms this project (config_version 6) is on the current MPF config format. |
| MPF mode: config reference (local copy) | 2026-09-13 | design/research/outside-perspective.md | Full mode: config option reference. |
| Skill Shot (MPF docs) (local copy) | 2026-09-13 | design/research/outside-perspective.md | Official rotate-lit-lane-via-flippers skillshot recipe - this project's skillshot idiom. |
| Tilt (MPF docs) (local copy) | 2026-09-13 | design/research/outside-perspective.md, TODO.md | Built-in tilt mode config - relevant once TODO.md's tilt-switch gap is closed. |
| Achievements (MPF docs) (local copy) | 2026-09-13 | design/research/outside-perspective.md | Achievement tracking concept, real-machine examples. |
| Achievement Groups (MPF docs) (local copy) | 2026-09-13 | design/research/outside-perspective.md | Grouping achievements, group-level actions (select/rotate/complete). |
| Multiballs (MPF docs) (local copy) | 2026-09-13 | design/research/outside-perspective.md, TODO.md | eject_timeouts note directly relevant to this project's multiball once wired/playtested. |
| How to design a game in MPF using Modes (local copy) | 2026-09-13 | design/research/outside-perspective.md, design/README.md | MPF's own top-level game-design guide - story/mode-selection/layering. |
| Layering Modes Example (MPF docs) (local copy) | 2026-09-13 | design/research/outside-perspective.md, design/README.md | Field/Mission/Wizard mode-layering pattern this project's design workflow already uses. |
| Writing Machine Tests (MPF docs) (local copy) | 2026-09-13 | design/research/outside-perspective.md | Testing philosophy behind this project's own tests/ suite. |
| Stern SPIKE System Manual (775-7640-00, Release 2) (local copy) | 2026-09-26 | docs/stern-spike-trough-opto.md | Confirms the trough opto board is a 'Node extension' read by a Playfield Node board's own onboard firmware, not the main Spike CPU directly - explains why the bit-level read protocol is undocumented anywhere public. |
| Hardware Design (5 REV 10) - Bus Pirate 5 docs (local copy) | 2026-09-26 | docs/stern-spike-trough-opto.md | Bus Pirate 5 I/O goes through 74LVC1T45 level shifters on a settable 1-5V supply, so it can drive a real 5V logic high - unlike the v3.6 used on the trough opto bench. |
| Caroline - Combine OverWiki (local copy) | 2026-10-06 | design/research/story-brainstorm/lore-and-meaning.md | Caroline uploaded to become GLaDOS, the deletion vs. 'Now little Caroline is in here too', McLain's view that she wasn't deleted, and the 'Greg' origin of the character. |
| Chell - Combine OverWiki (local copy) | 2026-10-06 | design/research/story-brainstorm/lore-and-meaning.md | Chell's backstory (Bring Your Daughter to Work Day, the science-fair potato, the Lab Rat file: 'abnormally stubborn', moved from #1498 to #1), silence by choice (Wolpaw). |
| Portal 2: Lab Rat - Combine OverWiki (local copy) | 2026-10-06 | design/research/story-brainstorm/lore-and-meaning.md | Plot of Valve's bridging comic: Rattmann, the talking Companion Cube, the Morality Core, Bring Your Cat to Work Day, Chell kept 'both alive and dead'. |
| Portal ARG - Combine OverWiki (local copy) | 2026-10-06 | design/research/story-brainstorm/lore-and-meaning.md | The 2010 ARG: 26 radios, Morse/SSTV images, the BBS (GLaDOS login, drattmann), 'Valuable Asset Retrieval' and the Party Escort Bot ending added to Portal. |
| Aperture Science - Combine OverWiki (local copy) | 2026-10-06 | design/research/story-brainstorm/lore-and-meaning.md | Aperture's timeline decade by decade (who was tested when), the ARG memos (three pillars; the 1976 'resource acquisitions' memo), the test-subject roster. |
| Perpetual Testing Initiative - Combine OverWiki (local copy) | 2026-10-06 | design/research/story-brainstorm/lore-and-meaning.md | PeTI DLC story: multiverse Apertures, alternate Caves, 'chariots chariots', Dark Cave and the money-verse. |
| Portal Stories: Mel - Combine OverWiki (local copy) | 2026-10-06 | design/research/story-brainstorm/lore-and-meaning.md | Fan mod plot: 1952 Olympian Mel, Virgil the core posing as Cave Johnson, the rogue security AI AEGIS - a template for a period-4 'new AI'. |
| The cake is a lie - Wikipedia (local copy) | 2026-10-06 | design/research/story-brainstorm/lore-and-meaning.md | The cake as a reward with no intent to deliver; the writers' 'which philosopher' meeting; Wolpaw/Faliszek's 'thematic anchor'; Wolpaw 'sick of the memes' (2010). |
| Chell's Digital Birth Certificate - PopMatters (Kris Ligman, 2011) (local copy) | 2026-10-06 | design/research/story-brainstorm/lore-and-meaning.md | The mother/daughter reading: Aperture as womb, GLaDOS/Caroline as mother, Cave Johnson and the cores as deconstructed father figures. |
| Portal 2: its writers reveal the game's original, unused ending - Film Stories (2023) (local copy) | 2026-10-06 | design/research/story-brainstorm/lore-and-meaning.md | Wolpaw (Edge #388): Portal 2 was to end in a stalemate only Chell's voice could break - she'd say 'Yes'; cut because her voice confused playtesters. |
| The role of meta-humor in Portal 2 and Sword & Sworcery EP - GamesBeat (2011) (local copy) | 2026-10-06 | design/research/story-brainstorm/lore-and-meaning.md | Portal as satire of game design: the cake as extrinsic reward, GLaDOS's 'solution euphoria', the action button as the silent player's only voice. Archived copy is a fetch-tool rendering; check the live page before quoting unquoted sentences. |
| Stern Pinball Opens The Vault With Fallout [Special Hands-On Preview] - Arcade Heroes (local copy) | 2026-10-06 | design/research/story-brainstorm/pinball-prior-art.md | Stern's Fallout (2026): character stats, vaults, the shop, V.A.T.S., 200,000 Bethesda assets. |
| Hands-on: Stern Pinball Enters the Wasteland with 'Fallout' - The Toy Book (local copy) | 2026-10-06 | design/research/story-brainstorm/pinball-prior-art.md | S.P.E.C.I.A.L. level 10 unlocks modes, Pemberton callouts, theft costs reputation. |
| Fallout (Pinball FX Wiki) (local copy) | 2026-10-06 | design/research/story-brainstorm/pinball-prior-art.md | Zen Studios' virtual Fallout table (Bethesda Pinball, 2016): stats as timers, quests as search-then-fight, factions as shot patterns. Raw wikitext fetched via the API. |
| Portal (Pinball FX Wiki) (local copy) | 2026-10-06 | design/research/story-brainstorm/pinball-prior-art.md | Zen's virtual Portal table (2015): turret factory wins pre-disable the wizard's turrets. |
| Portal (Extended Edition) Rulesheet - Tilt Forums (local copy) | 2026-10-06 | design/research/story-brainstorm/pinball-prior-art.md | Multimorphic's official Portal pinball (2025): the Hub, 7 chambers, items collected become wizard parts. |
| How Valve's Portal became a pinball game - GamesBeat (local copy) | 2026-10-06 | design/research/story-brainstorm/pinball-prior-art.md | Stellenberg interview: how Multimorphic worked with Valve on the Portal table. |
| Toy Story 4 Rulesheet - Tilt Forums (local copy) | 2026-10-06 | design/research/story-brainstorm/pinball-prior-art.md | Starting a scene qualifies the wizard mode; completing it multiplies the wizard. |
| Room for storytelling in pinball? - Pinside forum (local copy) | 2026-10-06 | design/research/story-brainstorm/pinball-prior-art.md | Players' views on how much story pinball can carry. |
| Relaxation Vault - Portal Wiki (local copy) | 2026-10-08 | design/art/README.md | Source of the two Relaxation Vault screenshots used on the attract mode's vault page. |
| File:Glados parking lot.jpg - Combine OverWiki (local copy) | 2026-11-04 | design/art/README.md | Source of E2's background: the surface, GLaDOS's remains on the parking lot. |
| widget_player: - Mission Pinball Framework documentation (local copy) | 2026-10-09 | docs/gmc-bugs.md | A widget without slide: goes on whichever slide is active - documented, so not a GMC bug (gmc-bugs.md #3). |
| mpf game (command-line utility) - Mission Pinball Framework documentation (local copy) | 2026-10-09 | docs/testing-strategy.md | The -pit platform integration test runner the playtests (stages 2 and 3) are built on; -X, -t, -b. |
| Testing your game - Mission Pinball Framework documentation (local copy) | 2026-10-09 | docs/testing-strategy.md | MPF's testing advice, including fuzz testing (stage 1's test_fuzz). |
| MPF Monitor - Mission Pinball Framework documentation (local copy) | 2026-10-09 | docs/testing-strategy.md | MPF Monitor 1.0.0: click switches on a playfield picture, LEDs live (stage 4). |
| Lucide icon: cassette-tape (ISC licence) (local copy) | 2026-10-10 | tools/art/tape_icon.py | Geometry for the cassette candidate of period 4's TAPE sign icon; ISC asks to keep the notice. |
| Balance in scoring - playing for fun vs score (Tilt Forums) (local copy) | 2026-10-16 | design/research/story-chain/scoring-benchmark.md | Summary with quotes. Players' definition of balanced scoring (the best-scoring path is the modes and wizard modes); mode-led examples (Tron, Addams Family, STTNG, Metallica); no percentages. |
| How to get ahead at pinball - Pavlov Pinball talks to Bowen Kerins (2014) (local copy) | 2026-10-16 | design/research/story-chain/scoring-benchmark.md | Summary. Several routes (Addams Family); risk/reward shots; dominant repeatable shots (Star Wars ramps, Earthshaker, Police Force); Star Wars as a good game for new players. |
| Home Assistant contributor docs - YAML style guide (local copy) | 2026-10-25 | docs/reviews/2026-10-25-3-config-documentation-standard.md | Summary with quotes. The most formal published YAML convention found: comments on their own line above what they explain, capitalised; true/false only; block style; long text in block scalars. |
| yamllint - Rules (local copy) | 2026-10-25 | docs/reviews/2026-10-25-3-config-documentation-standard.md | Summary. Machine-checkable comment rules (space after #, 2 spaces before an inline comment, comment indentation), line length, truthy, key duplicates. |
| Phalanx developer guide - Write the values.yaml file (helm-docs convention) (local copy) | 2026-10-25 | docs/reviews/2026-10-25-3-config-documentation-standard.md | Summary. A per-setting description comment directly above each key with a fixed marker (# --), a blank line between settings; tools can generate docs from such comments. |
| CobraPin NeoPixel chains (MPF docs) - excerpt (local copy) | 2026-10-31 | design/research/lighting/research-findings.md, design/LIGHTING.md | Excerpt for the lighting plan: 2 chains of 256 RGB per board, J10/J14 pixel power, JST VH. The full page is cobrapin-official-doc. |
| OPP incandescent wing, BS170 and pinball bulb specs - excerpts (local copy) | 2026-10-31 | design/research/lighting/research-findings.md, design/LIGHTING.md | Bundle of excerpts: the OPP wiki and MPF OPP lights page (8 outputs per wing), the BS170 datasheet (0.5 A), #44/#47/#89/#906 bulb currents (flippers.be, Marco Specialties). |
| MPF lights, light_player, shows and tokens (MPF docs, main branch) - excerpts (local copy) | 2026-10-31 | design/research/lighting/research-findings.md, design/LIGHTING.md | Bundle of excerpts from the MPF 0.80 docs: lights, light_player, show_player, show tokens, OPP LED numbering, LED basics. |
| Addressable LED parts and powering - excerpts (local copy) | 2026-10-31 | design/research/lighting/research-findings.md, design/LIGHTING.md | Bundle of excerpts: Adafruit's NeoPixel guide (power, 60 mA/pixel, injection), WS2812B facts, ring PCB sizes, LED filament and COB strips, edge-lit acrylic. |
| Pinball lighting practice: inserts, RGB, light language - excerpts (local copy) | 2026-10-31 | design/research/lighting/research-findings.md, design/LIGHTING.md | Bundle of excerpts: pinballmakers construction (inserts), RGB vs coloured inserts (Pinside, Comet), rulesheet light language (Iron Maiden, Star Wars), Multimorphic's Portal machine (theportalwiki, tiltforums). Pinside lines are search snippets. |
| Portal and Portal 2 colours and test elements - excerpts (local copy) | 2026-10-31 | design/research/lighting/research-findings.md, design/LIGHTING.md | Bundle of excerpts: the stock portal colours (SST mod source), indicator lights, cores, gels, grill, funnel, turrets (Combine OverWiki, Valve Developer Community search snippets). |
| Aperture Science Emergency Intelligence Incinerator - Combine OverWiki (local copy) | 2026-11-02 | design/research/art-candidates/2026-11-02-online-shots/sources.csv | Source page of screenshots picked as screen candidates (plans/game-screenshots.md step 6). |
| GLaDOS - Combine OverWiki (local copy) | 2026-11-02 | design/research/art-candidates/2026-11-02-online-shots/sources.csv | Source page of screenshots picked as screen candidates (plans/game-screenshots.md step 6). |
| Central AI Chamber - Combine OverWiki (local copy) | 2026-11-02 | design/research/art-candidates/2026-11-02-online-shots/sources.csv | Source page of screenshots picked as screen candidates (plans/game-screenshots.md step 6). |
| Cave Johnson - Combine OverWiki (local copy) | 2026-11-02 | design/research/art-candidates/2026-11-02-online-shots/sources.csv | Source page of screenshots picked as screen candidates (plans/game-screenshots.md step 6). |
| Aperture Science - Combine OverWiki (local copy) | 2026-11-02 | design/research/art-candidates/2026-11-02-online-shots/sources.csv | Source page of screenshots picked as screen candidates (plans/game-screenshots.md step 6). |
| Doug Rattmann - Combine OverWiki (local copy) | 2026-11-02 | design/research/art-candidates/2026-11-02-online-shots/sources.csv | Source page of screenshots picked as screen candidates (plans/game-screenshots.md step 6). |
| Aperture Science Weighted Storage Cube - Combine OverWiki (local copy) | 2026-11-02 | design/research/art-candidates/2026-11-02-online-shots/sources.csv | Source page of screenshots picked as screen candidates (plans/game-screenshots.md step 6). |
| Thermal Discouragement Beam - Combine OverWiki (local copy) | 2026-11-02 | design/research/art-candidates/2026-11-02-online-shots/sources.csv | Source page of screenshots picked as screen candidates (plans/game-screenshots.md step 6). |
| Repulsion Gel - Combine OverWiki (local copy) | 2026-11-02 | design/research/art-candidates/2026-11-02-online-shots/sources.csv | Source page of screenshots picked as screen candidates (plans/game-screenshots.md step 6). |
| Propulsion Gel - Combine OverWiki (local copy) | 2026-11-02 | design/research/art-candidates/2026-11-02-online-shots/sources.csv | Source page of screenshots picked as screen candidates (plans/game-screenshots.md step 6). |
| Aperture Science Handheld Portal Device - Combine OverWiki (local copy) | 2026-11-02 | design/research/art-candidates/2026-11-02-online-shots/sources.csv | Source page of screenshots picked as screen candidates (plans/game-screenshots.md step 6). |
| Wheatley - Combine OverWiki (local copy) | 2026-11-02 | design/research/art-candidates/2026-11-02-online-shots/sources.csv | Source page of screenshots picked as screen candidates (plans/game-screenshots.md step 6). |
| Aperture Science Aerial Faith Plate - Combine OverWiki (local copy) | 2026-11-02 | design/research/art-candidates/2026-11-02-online-shots/sources.csv | Source page of the activated Faith Plate screenshots picked as screen candidates. |
