🎮 EMULICIOUS: ТОЧНЫЙ ИНСТРУМЕНТ ДЛЯ ТОЧНЫХ ЭМУЛЯЦИЙ

​

ВСТУПЛЕНИЕ: КОГДА ТОЧНОСТЬ СТАНОВИТСЯ ИСКУССТВОМ​

ЧТО ТАКОЕ EMULICIOUS И ЗАЧЕМ ОН НУЖЕН?​

ПОДДЕРЖИВАЕМЫЕ ПЛАТФОРМЫ​

КЛЮЧЕВЫЕ ВОЗМОЖНОСТИ (ЧТО ОН ДАЁТ ПОЛЬЗОВАТЕЛЮ)​

1. Точность превыше всего — эмуляция максимально приближена к поведению реального железа, что критично для разработчиков и ромхакеров .
2. Богатейший набор инструментов — отладчик, профайлер, трассировщик, анализатор покрытия кода, редактор памяти, просмотрщики тайлов, спрайтов, палитр и карт .
3. Remote Debugging — возможность подключаться к эмулятору из VS Code и отлаживать код на уровне исходников .
4. Автоматическое обновление — эмулятор сам следит за актуальностью версии .
5. IPS Patching — поддержка патчей для ROM-файлов .
6. Реверсивный шаг (Reverse Stepping) — можно отмотать выполнение назад, как в DeZog .
7. Тесты точности — эмулятор проходит множество тестов из сообщества gbdev, подтверждая свою надёжность .

ИСТОРИЧЕСКИЙ КОНТЕКСТ: ПОЧЕМУ ТОЧНОСТЬ ВАЖНА?​

УСТАНОВКА И НАСТРОЙКА​

Шаг 1: Установка самого эмулятора​

1. Перейдите на emulicious.net .
2. В разделе загрузок выберите версию под вашу ОС.
3. Для Windows доступна версия со встроенной Java — скачайте её, если у вас нет Java .
4. Распакуйте архив в удобную папку (например, C:\Emulicious).

flatpak install flathub net.emulicious.Emulicious

Шаг 2: Установка расширения для VS Code​

1. Запустите Visual Studio Code.
2. Нажмите Ctrl+Shift+X (или иконку квадратиков слева), чтобы открыть вкладку Extensions.
3. В поиске введите "Emulicious Debugger".
4. Найдите расширение от автора emulicious (или Calindro) и нажмите Install .

Шаг 3: Настройка путей в VS Code​

1. Откройте настройки VS Code (File -> Preferences -> Settings или Ctrl+,).
2. Найдите раздел Emulicious Debugger.
3. В поле "Emulicious Path" укажите полный путь к исполняемому файлу эмулятора, включая имя файла:
   
   • Windows: C:\Emulicious\Emulicious.exe
   • Linux: /home/username/Emulicious/Emulicious (или путь к flatpak)
   • macOS: /Applications/Emulicious.app/Contents/MacOS/Emulicious

Шаг 4: Включение удалённой отладки в эмуляторе​

1. Запустите Emulicious.
2. В меню выберите Tools -> Remote Debugging.
3. Убедитесь, что пункт Enabled отмечен галочкой .

СТРУКТУРА ПРОЕКТА И НАСТРОЙКА LAUNCH.JSON​

Базовая конфигурация для отладки​

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "emulicious-debugger",
            "request": "launch",
            "name": "Emulicious Debug",
            "program": "${workspaceFolder}/build/rom.gb",
            "emulicious": {
                "rom": "${workspaceFolder}/build/rom.gb",
                "symbolMap": "${workspaceFolder}/build/rom.sym",
                "stopOnEntry": true,
                "remotePort": 58876
            }
        }
    ]
}

Ключевые параметры​

Пример проекта GBDK Starter Template​

GBDK-Starter-Template/
├── .vscode/
│   ├── c_cpp_properties.json    # Пути к include GBDK
│   └── launch.json               # Конфигурация для Emulicious
├── build/                         # Выходная папка
├── tools/                          # Вспомогательные скрипты
├── build.bat                       # Скрипт сборки
├── main.c                           # Главный файл программы
└── README.md

1. Склонируйте репозиторий.
2. В c_cpp_properties.json укажите правильный путь к папке include вашего GBDK.
3. В Emulicious включите Tools -> Remote Debugging -> Enabled.
4. Нажмите F5 в VS Code — проект скомпилируется и запустится в Emulicious с привязанным отладчиком.

РАБОЧИЙ ПРОЦЕСС (ДЕНЬ ОПЛАТЫ)​

Шаг 1: Пишем код​

#include <gb/gb.h>
#include <stdio.h>

void main(void) {
    printf("Hello, Game Boy!");
    
    while(1) {
        // Ждём нажатия кнопки
        waitpad(J_START);
        
        // Меняем фон при старте
        BGP_REG = 0xE4;
    }
}

Шаг 2: Собираем проект​

Шаг 3: Запускаем отладку​

1. VS Code запускает задачу сборки (если настроено).
2. Запускается Emulicious и загружает наш ROM.
3. Эмулятор подключается к отладчику через указанный порт.
4. Выполнение останавливается на первой инструкции (если stopOnEntry: true).

Шаг 4: Отлаживаем​

• Точки останова — ставим прямо в C-коде, кликнув слева от номера строки.
• Пошаговое выполнение — F10 (Step Over), F11 (Step Into), Shift+F11 (Step Out).
• Просмотр переменных — видим значения локальных и глобальных переменных.
• Просмотр регистров — все регистры Z80 (или LR35902) в реальном времени.
• Просмотр памяти — можно смотреть любые области адресного пространства.

Шаг 5: Анализируем производительность​

ПРОДВИНУТЫЕ ВОЗМОЖНОСТИ ОТЛАДЧИКА​

Что умеет встроенный отладчик Emulicious​

Условные точки останова​

• Остановиться, когда регистр A равен 10 и выполняется запись в память по адресу 0xFF44.
• Остановиться, когда счётчик команд достигает определённой метки, но только если флаг Z сброшен.

Реверсивная отладка (Reverse Stepping)​

Загрузка исходных файлов​

СРАВНЕНИЕ: EMULICIOUS VS АЛЬТЕРНАТИВЫ​

ПЛЮСЫ И МИНУСЫ​

Плюсы (Почему это must-have для ретро-разработчика)​

• Универсальность: один эмулятор для нескольких популярных платформ .
• Промышленная точность: можно доверять результатам тестирования .
• Интеграция с VS Code: официальное расширение-отладчик .
• Набор инструментов: отладчик, профайлер, трассировщик, просмотрщики графики — всё в одном флаконе .
• Реверсивная отладка: отматывайте выполнение назад .
• Условные брейкпоинты: мощный синтаксис выражений .
• Бесплатный: никаких платежей, донаты приветствуются .
• Активная разработка: последняя версия от 31.08.2024 .
• Кроссплатформенность: Windows, Linux, macOS через Java .

Минусы (О чём нужно знать)​

• Требует Java: хотя для Windows есть версия со встроенной Java, для других ОС может понадобиться отдельная установка JRE .
• Нет фильтров графики: по отзывам, отсутствие графических фильтров может огорчать казуальных игроков .
• Звук не идеален: по некоторым отзывам, звук остаётся "perfectible" (может быть улучшен) .
• Закрытый исходный код: в отличие от многих эмуляторов, Emulicious не является open-source .
• Не для всех платформ: нет поддержки NES, SNES, Mega Drive — только перечисленные выше .
• Некоторые инструменты не для всех платформ: например, французский обзор отмечает, что часть продвинутых инструментов работает только для Master System/Game Gear .

СОВЕТЫ БЫВАЛОГО (КАК ВЫЖАТЬ МАКСИМУМ)​

1. Используйте шаблоны проектов. Репозиторий GBDK-Starter-Template от RednibCoding уже содержит настроенный .vscode/launch.json и скрипты сборки — с него легко начать .
2. Генерируйте symbol map. Убедитесь, что ваш компилятор (GBDK, SDCC и т.д.) создаёт файл с символами (обычно .sym, .map, .lst). Без него отладчик будет показывать только адреса, а не имена переменных и функций .
3. Изучите встроенный отладчик. Не ограничивайтесь VS Code — откройте Tools в самом Emulicious. Там есть визуализаторы спрайтов и тайлов, которые бесценны для разработки графических игр .
4. Используйте профайлер. Если игра тормозит, запустите профайлер и посмотрите, какая функция съедает больше всего тактов. Оптимизируйте именно её .
5. Проверяйте точность. Если сомневаетесь в поведении эмулятора, сверьтесь с тестами на GBEmulatorShootout . Emulicious обычно показывает отличные результаты.
6. Включите реверсивную отладку. Это спасает, когда вы прошли шагом дальше, чем нужно. Не перезапускайте программу — просто отмотайте назад .
7. Для MSX есть альтернативы. Корейская документация упоминает, что для MSX можно использовать openMSX Debugger или MAME с gdbstub . Но Emulicious проще в настройке.

РЕСУРСЫ И ССЫЛКИ​

• Официальный сайт: emulicious.net
• Flathub: net.emulicious.Emulicious
• VS Code Extension: Emulicious Debugger на Visual Studio Marketplace
• GitHub репозиторий расширения: Calindro/emulicious-debugger
• GBDK Starter Template: RednibCoding/GBDK-Starter-Template-for-VS-Code
• GBEmulatorShootout: daid.github.io/GBEmulatorShootout/ — сравнение точности эмуляторов Game Boy
• Emulation General Wiki: Emulicious

ЗАКЛЮЧЕНИЕ: ЭМУЛЯТОР, КОТОРЫЙ ПОНИМАЕТ ВАШ КОД​