Troubleshooting

Troubleshooting

Solutions to common problems.

Editor Won't Start

Problem: Python error on launch

Solutions:

• Check Python version (3.13.7+)
• Install requirements: pip install -r requirements.txt
• Verify tutankhm.zip is in same folder

ROMs Won't Load

Problem: "Error loading ROMs" message

Solutions:

• Verify zip file is named tutankhm.zip
• Check zip contains all ROM files
• Try "Open ROMs From Folder" instead
• Ensure ROM files aren't corrupted

Changes Not Saving

Problem: Edits disappear after closing

Solutions:

• Use File → Save ROMs before exiting
• Check disk space (need ~50KB free)
• Verify folder isn't read-only

MAME Won't Load Modified ROMs

Problem: MAME rejects edited ROMs

Solutions:

• Extract original zip to tutankhm folder
• Save edited ROMs to same folder, overwriting the original extracted ROMs
• Run: mame -window tutankhm -rompath .

Map Editor Issues

Problem: Can't place tiles/objects

Solutions:

• Structure editing - Only works in Difficulty 1
• Items - Must have correct empty box type
• Teleporters - Both points must be same column
• Spawns - Must be on empty path tile (0x26)

Game Crashes

Problem: MAME crashes during gameplay

Solutions:

• Spawn rate too high - Keep at 5-8 range

Colors Look Different

Can't Undo Changes

Problem: Want to revert edits

Solutions:

• Editor currently has no undo!
• Always keep backups
• Reload from original zip
• Save incremental versions (v1, v2, v3...)

Editor Runs Slowly

Problem: Laggy UI or slow rendering

Solutions:

• Close other editors - one at a time works best
• Reduce zoom level in map editor
• Restart editor to clear memory
• Check system resources

Still Having Issues?

• Check README.md for setup instructions
• Verify Python packages installed correctly

Preventing Problems

• Save often - No auto-save
• Test frequently - Verify changes in MAME
• Keep backups - Date your saves
• One change at a time - Easier to debug
• Read the wiki - Most answers are here!