Common Issues

Solutions to the most common issues when using Mafkers.

Game Not Detected

Problem: Mafkers says “Engine not detected” when selecting game folder.

Solutions:

1. Make sure you selected the correct folder (not a subfolder)
2. Check if your game’s engine is supported: Engine Support Matrix
3. Some games use custom engines that Mafkers doesn’t support yet
4. Report on Discord with the game name and engine info

Game Crashes After Mod

Problem: Game crashes or shows errors after applying Mafkers translation.

Solutions:

1. Rollback immediately: Open Mafkers → History → click “Rollback”
2. This restores your game to its original state
3. Report the crash on Discord with:
   • Game name and version
   • Engine (if known)
   • Error message (if any)
4. Try translating to a different target language slot (Smart Language Mapping)

Translation Quality Is Poor

Problem: Translation reads like machine translation, stiff or unnatural.

Solutions:

1. Upgrade to Pro: Pro tier uses Claude Sonnet 4.5 for quality polish (vs DeepSeek V3 in Free)
2. Use Custom Glossary: Add character/item names to glossary for consistency
3. Manual Edit: After translation, you can manually edit individual strings in the app
4. Report specific issues: Share examples on Discord for improvement

Mod Breaks After Game Update

Problem: Game updated and the translation mod no longer works.

Solutions:

1. Open Mafkers → History
2. Click “Re-patch” on the affected project
3. Mafkers will re-translate only the changed strings (Smart Re-patching)
4. This saves 80-95% of the cost compared to full re-translation

“Anti-Cheat Detected” Warning

Problem: Mafkers shows a warning about anti-cheat when selecting a game.

This is a safety feature. The game uses kernel-level anti-cheat (Vanguard, EasyAntiCheat, BattlEye) that can ban your account for file modification.

Solutions:

1. Do not proceed if the game has anti-cheat - your account could be banned
2. Mafkers is designed for single-player/offline games only
3. If you’re sure the game is single-player (no multiplayer component), you can proceed at your own risk

App Won’t Start

Problem: Mafkers desktop app won’t launch.

Solutions:

Windows

1. Check if antivirus blocked the app - add exception
2. Run as Administrator
3. Reinstall Mafkers
4. Check Event Viewer for error details

macOS

1. Right-click → Open (bypass Gatekeeper for first launch)
2. Check System Preferences → Security & Privacy → allow Mafkers

Linux

1. Check if AppImage has execute permission: chmod +x Mafkers-*.AppImage
2. Install FUSE if needed: sudo apt install libfuse2
3. Run from terminal to see error: ./Mafkers-*.AppImage

Login Issues

Problem: Can’t sign in to Mafkers.

Solutions:

1. Check internet connection
2. Try different sign-in method (Google, Discord, GitHub, email)
3. Clear browser cookies for mafkers.com
4. Disable VPN/proxy temporarily
5. Contact support@mafkers.com

Performance Issues

Problem: Mafkers is slow or uses too much memory.

Solutions:

1. Close other heavy applications
2. Mafkers uses ~50MB RAM idle, ~500MB during modding - this is normal
3. Large AAA games with 500K+ strings may take 1-3 hours
4. Ensure you have at least 4GB RAM

Contact Support

If none of the above solutions work:

1. Discord (fastest): discord.gg/mafkers
2. Email: support@mafkers.com (response within 24 hours)
3. Bug Report: Use in-app feedback form (Settings → Report Bug)