Руководство по устранению неполадок

Это руководство предоставляет решения распространённых проблем и вопросов, возникающих при использовании mGBA. Если вы столкнулись с проблемой, не описанной здесь, пожалуйста, проверьте раздел FAQ или сообщите о проблеме на GitHub.

Распространённые проблемы и решения

Игра не загружается или ROM не загружается

Проблема:

Файл ROM игры не загружается или mGBA не распознаёт файл.

Решения:

  1. Убедитесь, что файл ROM является валидным ROM Game Boy Advance (формат .gba)
  2. Проверьте, не повреждён ли файл - попробуйте перезагрузить, если возможно
  3. Если ROM находится в ZIP архиве, сначала извлеките его
  4. Убедитесь, что файл ROM не повреждён или неполный
  5. Попробуйте загрузить другой ROM, чтобы проверить, работает ли mGBA
  6. Проверьте права доступа к файлу (убедитесь, что mGBA может читать файл)

Низкий FPS или проблемы производительности

Проблема:

Игра работает медленно или кадры пропускаются.

Решения:

  1. Включите аппаратное ускорение (OpenGL, Vulkan, Direct3D 11 или Metal)
  2. Уменьшите масштабирование разрешения (попробуйте 1x или 2x вместо большего масштабирования)
  3. Включите автоматический пропуск кадров
  4. Закройте другие ресурсоёмкие приложения
  5. Обновите графические драйверы до последней версии
  6. Проверьте, соответствует ли ваше оборудование минимальным требованиям
  7. Попробуйте разные бэкенды рендеринга (программный, если аппаратный не работает)

Заикание или треск аудио

Проблема:

Аудио заикается, трещит или пропускается во время игры.

Решения:

  1. Увеличьте размер аудио буфера в Настройки → Аудио
  2. Уменьшите частоту дискретизации (попробуйте 32 кГц, если 44.1 кГц вызывает проблемы)
  3. Отключите пропуск кадров, если включен
  4. Закройте другие аудио приложения
  5. Проверьте, обновлены ли аудио драйверы
  6. Попробуйте разные аудио бэкенды
  7. Уменьшите использование CPU другими приложениями

Файлы сохранений не работают

Проблема:

Сохранения игр не сохраняются или файлы сохранений не создаются.

Решения:

  1. Убедитесь, что mGBA имеет права на запись в своей директории
  2. Запустите mGBA с правами администратора, если необходимо (Windows)
  3. Проверьте, что имена ROM и файла сохранения точно совпадают
  4. Проверьте, что директория сохранений не только для чтения
  5. Проверьте доступное место на диске (недостаток места может препятствовать сохранению)
  6. Проверьте, что определение типа сохранения корректно (EEPROM, Flash, SRAM)
  7. Вручную установите тип сохранения, если автоматическое определение не работает

Графические глюки или визуальные артефакты

Проблема:

Графика повреждена, глючит или отображается неправильно.

Решения:

  1. Переключайтесь между разными бэкендами рендеринга (OpenGL, Vulkan, Direct3D, Metal)
  2. Отключите VSync, если он вызывает проблемы
  3. Обновите графические драйверы до последней версии
  4. Попробуйте программный рендеринг, если аппаратное ускорение вызывает проблемы
  5. Отключите пользовательские шейдеры или фильтры
  6. Сбросьте настройки видео на значения по умолчанию
  7. Проверьте, есть ли у конкретной игры известные проблемы совместимости

Геймпад или контроллер не работает

Проблема:

Геймпад или контроллер не определяется или элементы управления не работают.

Решения:

  1. Подключите геймпад перед запуском mGBA
  2. Перейдите в Настройки → Ввод → Геймпад для настройки
  3. Нажмите каждую кнопку для переназначения элементов управления
  4. Перезапустите mGBA с подключённым контроллером
  5. Проверьте, распознаётся ли геймпад вашей операционной системой
  6. Попробуйте разные USB порты (для USB контроллеров)
  7. Обновите драйверы геймпада
  8. Протестируйте геймпад с другими приложениями, чтобы убедиться, что он работает

Эмуляция кабеля связи не работает

Проблема:

Мультиплеер или эмуляция кабеля связи не подключается.

Решения:

  1. Включите эмуляцию кабеля связи в Инструменты → Кабель связи перед загрузкой игр
  2. Убедитесь, что в обоих экземплярах загружена одна и та же игра
  3. Проверьте настройки файрвола, если используете сетевой режим
  4. Проверьте, что оба экземпляра находятся в одной сети (режим локальной сети)
  5. Проверьте конфигурацию IP адреса для сетевых подключений
  6. Попробуйте перезапустить оба экземпляра mGBA
  7. Убедитесь, что игра поддерживает мультиплеер через кабель связи

Читы не работают

Проблема:

Читы не действуют или вызывают сбои.

Решения:

  1. Проверьте, что формат читов соответствует версии игры
  2. Проверьте, что читы для правильной игры и региона
  3. Убедитесь, что читы включены (установите флажок)
  4. Попробуйте загрузить читы перед запуском игры
  5. Проверьте формат читов (GameShark, Action Replay, CodeBreaker)
  6. Некоторые читы могут требовать определённых состояний игры для работы

mGBA падает или зависает

Проблема:

mGBA падает, зависает или перестаёт отвечать.

Решения:

  1. Обновитесь до последней версии mGBA
  2. Обновите графические драйверы
  3. Проверьте системные логи на наличие сообщений об ошибках
  4. Отключите пользовательские шейдеры или фильтры
  5. Сбросьте конфигурацию на значения по умолчанию
  6. Проверьте доступную память (недостаток RAM может вызывать сбои)
  7. Проверьте, что файл ROM не повреждён
  8. Сообщите о сбое с деталями ошибки на 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: