A custom tropical-themed pinball machine built with the Mission Pinball Framework (MPF). Experience the ultimate island getaway with exciting gameplay featuring multiple flippers, drop targets, multiball modes, and immersive tiki-inspired visuals and sounds.
- 4 Flippers: Main left/right flippers plus upper left/right flippers
- Multiple Drop Target Banks: Top (5 targets), Left (3 targets), Right (3 targets)
- Orbit Shots: Sequence-based scoring system
- Mini Playfield: Secondary play area with 4 switches
- Ball Save System: 10-second protection with grace period
- Multiball Mode: High-scoring multiball gameplay
- Multiplayer Support: Up to 4 players, 3 balls per game
- FAST Pinball Platform: Modern pinball control system
- FP-I/O Boards: 1616, 3208, and 0024 configurations
- Comprehensive Switch Matrix: 40+ switches including trough, targets, bumpers
- LED System: Custom lighting with fade effects
- Audio System: Immersive sound effects and tropical music
- Custom Tiki Theme: Tropical island aesthetic
- Dynamic Display: 1280x390 resolution with Color DMD effects
- Custom Fonts: Tropika Island font family
- Sound Design: Tropical background music and voice callouts
- Light Shows: Synchronized LED animations for attract mode and gameplay
- Python 3.9+
- Mission Pinball Framework
- FAST Pinball hardware (or virtual mode for testing)
-
Clone the repository
git clone https://github.com/weijtmans/pinball.git cd pinball -
Install dependencies
pip install -r requirements.txt
-
Run the pinball machine
# Full hardware mode mpf both # Virtual testing mode (no hardware required) mpf both -X # Verbose logging for debugging mpf both -V
The main gameplay mode featuring:
- Progressive scoring system
- Ball save protection
- Shot combo scoring
- Background music and sound effects
Eye-catching display when idle:
- Rotating light shows
- Display animations
- Attracts players to start a game
High-energy gameplay with multiple balls
Special mode triggered by completing drop target banks
Triggered by completing orbit sequences
- FP-I/O-1616: 16 inputs, 16 outputs
- FP-I/O-3208: 32 inputs, 8 outputs
- FP-I/O-0024: Cabinet controls
- FP-EXP-0071: LED expansion board
- FP-EXP-2000: Neuron expansion board
- Ball Trough: 6-ball capacity with jam detection
- Flippers: Dual-coil flippers with EOS switches
- Slingshots: 3 slingshots for dynamic gameplay
- Bumpers: 3 pop bumpers
- Kickouts: Upper and middle ball kickout mechanisms
pinball/
├── config/ # Main configuration files
├── modes/ # Game mode definitions
│ ├── attract/ # Attract mode
│ ├── base/ # Base gameplay mode
│ ├── multiball/ # Multiball mode
│ └── orbit/ # Orbit mode
├── sounds/ # Audio files
│ ├── music/ # Background music
│ ├── sfx/ # Sound effects
│ └── voice/ # Voice callouts
├── fonts/ # Custom Tiki fonts
├── monitor/ # Monitoring configuration
└── rpi/ # Raspberry Pi scripts
# Start with media controller
mpf both
# Debug mode without media controller
mpf -t -b
# Virtual mode (ignore hardware)
mpf both -X
# Text-based monitoring
mpf monitorThe machine runs on a Raspberry Pi with automatic startup:
- Auto-login configured for seamless operation
- Startup script (
start_pinball.sh) handles environment setup - Pyenv environment management for Python dependencies
Edit the startup script to change MPF parameters:
nano /home/[user]/start_pinball.sh- Lights Implementation: Complete LED system integration
- Artwork Design: Custom backglass and playfield art
- High Score System: Persistent high score tracking
- Tilt Mechanism: Anti-cheating tilt detection
- Bonus Scoring: End-of-ball bonus calculations
- Service Mode: Maintenance and diagnostic tools
- Advanced Game Modes: Complex rule sets and objectives
- Magnet Integration: Under-playfield magnets for special effects
The machine features tropical-themed audio including:
- Background music: "Waikiki" theme
- Voice callouts: Custom recorded phrases
- Sound effects: Ocean waves and tropical ambience
Contributions are welcome! Please feel free to submit issues, fork the repository, and create pull requests for improvements.
- Follow MPF configuration standards
- Test changes in virtual mode first
- Document new features and modes
- Keep configuration files well-commented
This project is open source. Please respect the Mission Pinball Framework licensing terms.
For questions about:
- MPF Configuration: Check the MPF Documentation
- Hardware Issues: Consult FAST Pinball Support
- This Project: Open an issue in this repository
Built with ❤️ using Mission Pinball Framework
🏝️ Escape to your own tropical pinball paradise 🏝️