Руководство по устранению неполадок
Это руководство предоставляет решения распространённых проблем и вопросов, возникающих при использовании mGBA. Если вы столкнулись с проблемой, не описанной здесь, пожалуйста, проверьте раздел FAQ или сообщите о проблеме на GitHub.
Распространённые проблемы и решения
Игра не загружается или ROM не загружается
Проблема:
Файл ROM игры не загружается или mGBA не распознаёт файл.
Решения:
- Убедитесь, что файл ROM является валидным ROM Game Boy Advance (формат .gba)
- Проверьте, не повреждён ли файл - попробуйте перезагрузить, если возможно
- Если ROM находится в ZIP архиве, сначала извлеките его
- Убедитесь, что файл ROM не повреждён или неполный
- Попробуйте загрузить другой ROM, чтобы проверить, работает ли mGBA
- Проверьте права доступа к файлу (убедитесь, что mGBA может читать файл)
Низкий FPS или проблемы производительности
Проблема:
Игра работает медленно или кадры пропускаются.
Решения:
- Включите аппаратное ускорение (OpenGL, Vulkan, Direct3D 11 или Metal)
- Уменьшите масштабирование разрешения (попробуйте 1x или 2x вместо большего масштабирования)
- Включите автоматический пропуск кадров
- Закройте другие ресурсоёмкие приложения
- Обновите графические драйверы до последней версии
- Проверьте, соответствует ли ваше оборудование минимальным требованиям
- Попробуйте разные бэкенды рендеринга (программный, если аппаратный не работает)
Заикание или треск аудио
Проблема:
Аудио заикается, трещит или пропускается во время игры.
Решения:
- Увеличьте размер аудио буфера в Настройки → Аудио
- Уменьшите частоту дискретизации (попробуйте 32 кГц, если 44.1 кГц вызывает проблемы)
- Отключите пропуск кадров, если включен
- Закройте другие аудио приложения
- Проверьте, обновлены ли аудио драйверы
- Попробуйте разные аудио бэкенды
- Уменьшите использование CPU другими приложениями
Файлы сохранений не работают
Проблема:
Сохранения игр не сохраняются или файлы сохранений не создаются.
Решения:
- Убедитесь, что mGBA имеет права на запись в своей директории
- Запустите mGBA с правами администратора, если необходимо (Windows)
- Проверьте, что имена ROM и файла сохранения точно совпадают
- Проверьте, что директория сохранений не только для чтения
- Проверьте доступное место на диске (недостаток места может препятствовать сохранению)
- Проверьте, что определение типа сохранения корректно (EEPROM, Flash, SRAM)
- Вручную установите тип сохранения, если автоматическое определение не работает
Графические глюки или визуальные артефакты
Проблема:
Графика повреждена, глючит или отображается неправильно.
Решения:
- Переключайтесь между разными бэкендами рендеринга (OpenGL, Vulkan, Direct3D, Metal)
- Отключите VSync, если он вызывает проблемы
- Обновите графические драйверы до последней версии
- Попробуйте программный рендеринг, если аппаратное ускорение вызывает проблемы
- Отключите пользовательские шейдеры или фильтры
- Сбросьте настройки видео на значения по умолчанию
- Проверьте, есть ли у конкретной игры известные проблемы совместимости
Геймпад или контроллер не работает
Проблема:
Геймпад или контроллер не определяется или элементы управления не работают.
Решения:
- Подключите геймпад перед запуском mGBA
- Перейдите в Настройки → Ввод → Геймпад для настройки
- Нажмите каждую кнопку для переназначения элементов управления
- Перезапустите mGBA с подключённым контроллером
- Проверьте, распознаётся ли геймпад вашей операционной системой
- Попробуйте разные USB порты (для USB контроллеров)
- Обновите драйверы геймпада
- Протестируйте геймпад с другими приложениями, чтобы убедиться, что он работает
Эмуляция кабеля связи не работает
Проблема:
Мультиплеер или эмуляция кабеля связи не подключается.
Решения:
- Включите эмуляцию кабеля связи в Инструменты → Кабель связи перед загрузкой игр
- Убедитесь, что в обоих экземплярах загружена одна и та же игра
- Проверьте настройки файрвола, если используете сетевой режим
- Проверьте, что оба экземпляра находятся в одной сети (режим локальной сети)
- Проверьте конфигурацию IP адреса для сетевых подключений
- Попробуйте перезапустить оба экземпляра mGBA
- Убедитесь, что игра поддерживает мультиплеер через кабель связи
Читы не работают
Проблема:
Читы не действуют или вызывают сбои.
Решения:
- Проверьте, что формат читов соответствует версии игры
- Проверьте, что читы для правильной игры и региона
- Убедитесь, что читы включены (установите флажок)
- Попробуйте загрузить читы перед запуском игры
- Проверьте формат читов (GameShark, Action Replay, CodeBreaker)
- Некоторые читы могут требовать определённых состояний игры для работы
mGBA падает или зависает
Проблема:
mGBA падает, зависает или перестаёт отвечать.
Решения:
- Обновитесь до последней версии mGBA
- Обновите графические драйверы
- Проверьте системные логи на наличие сообщений об ошибках
- Отключите пользовательские шейдеры или фильтры
- Сбросьте конфигурацию на значения по умолчанию
- Проверьте доступную память (недостаток RAM может вызывать сбои)
- Проверьте, что файл ROM не повреждён
- Сообщите о сбое с деталями ошибки на GitHub Issues
Платформо-специфичные проблемы
Windows
- Ошибка Visual C++ Runtime: Установите Visual C++ Redistributable
- Ошибки DirectX: Обновите библиотеки времени выполнения DirectX
- Ошибки прав доступа: Запустите от имени администратора или настройте права доступа к папке
- Блокировка антивирусом: Добавьте mGBA в белый список антивируса
macOS
- Ошибка "Приложение повреждено": Удалите атрибут карантина:
xattr -d com.apple.quarantine mGBA.app - Предупреждение Gatekeeper: Разрешите приложение в Системные настройки → Безопасность
- Ошибки Metal: Обновитесь до последней версии macOS
Linux
- Отсутствующие библиотеки: Установите необходимые зависимости (SDL2, Qt5 и т.д.)
- Ошибки прав доступа: Проверьте права доступа к файлам и владельца
- Проблемы с графикой: Обновите драйверы Mesa или проприетарные драйверы GPU
Получение помощи
Если вы не можете решить вашу проблему:
- Проверьте раздел FAQ на основном сайте
- Поищите существующие GitHub Issues на похожие проблемы
- Создайте новый GitHub Issue с:
- Подробным описанием проблемы
- Шагами для воспроизведения проблемы
- Характеристиками вашей системы (ОС, CPU, GPU)
- Версией mGBA
- Сообщениями об ошибках или логами, если доступны
Связанные статьи
Для получения дополнительной информации о конфигурации и использовании mGBA:
- Руководство для начинающих - Инструкции по установке и базовой настройке
- Руководство по настройке производительности - Решения проблем производительности и стратегии оптимизации
- Руководство по продвинутой конфигурации - Продвинутые настройки, которые могут помочь решить проблемы
- Справочник API конфигурации - Параметры конфигурации и управление настройками