{"id":22017864,"url":"https://github.com/tereshenkovav/trixie16bit","last_synced_at":"2026-03-19T21:32:07.750Z","repository":{"id":172249006,"uuid":"649050998","full_name":"tereshenkovav/Trixie16bit","owner":"tereshenkovav","description":"16-bit game \"Trixie and diamonds\" for MS-DOS, developed on QuickBasic 4.5 and NASM.","archived":false,"fork":false,"pushed_at":"2025-02-20T14:41:50.000Z","size":6313,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-20T15:37:45.862Z","etag":null,"topics":["16-bit","2d-game","action-game","game","indie-game","nasm","quickbasic","retrogaming","singleplayer-game"],"latest_commit_sha":null,"homepage":"https://tav-developer.itch.io","language":"QuickBASIC","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tereshenkovav.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-03T16:06:38.000Z","updated_at":"2025-02-20T14:41:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"772d92c6-c49d-4124-8978-1029c7547c47","html_url":"https://github.com/tereshenkovav/Trixie16bit","commit_stats":null,"previous_names":["tereshenkovav/trixie16bit"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tereshenkovav%2FTrixie16bit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tereshenkovav%2FTrixie16bit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tereshenkovav%2FTrixie16bit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tereshenkovav%2FTrixie16bit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tereshenkovav","download_url":"https://codeload.github.com/tereshenkovav/Trixie16bit/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245080882,"owners_count":20557740,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["16-bit","2d-game","action-game","game","indie-game","nasm","quickbasic","retrogaming","singleplayer-game"],"created_at":"2024-11-30T05:08:27.014Z","updated_at":"2026-01-04T15:58:51.719Z","avatar_url":"https://github.com/tereshenkovav.png","language":"QuickBASIC","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 16-битная игра \"Трикси и алмазы\" для MS-DOS, на основе QuickBasic 4.5 и NASM\r\n\r\n[![YooMoney donation](https://img.shields.io/badge/Donation-Yoo.money-blue.svg)](https://yoomoney.ru/to/41001497003495)\r\n[![Boosty](https://img.shields.io/badge/Boosty-donate-orange.svg)](https://boosty.to/ponygames)\r\n[![Website](https://img.shields.io/badge/Website-tav--developer.itch.io-29a662.svg)](https://tav-developer.itch.io)\r\n[![License](https://img.shields.io/badge/License-MIT0-darkgray.svg)](#)\r\n[![Tag](https://img.shields.io/github/v/tag/tereshenkovav/Trixie16bit?color=00c2e8)](#)\r\n[![Downloads](https://img.shields.io/github/downloads/tereshenkovav/Trixie16bit/total?color=c87bff)](#)\r\n\r\n## О проекте\r\n\r\nИгра реализована как 16-битное приложение для реального режима MS-DOS, запуск\r\nв эмуляторах также поддерживается.\\\r\nЗадача игры - собрать на экране заданное количество алмазов, избегая контакта\r\nс монстрами. Трикси может ходить, телепортироваться между платформами, использовать\r\nфайербол и щит. Эти действия расходуют ману.\\\r\nНа высоком уровне сложности мана восстанавливается медленнее.\r\n\r\n![Trixie16bit](screen1.png) ![Trixie16bit](screen2.png)\r\n\r\n## Состав репозитория\r\n\r\n* `bin` - каталог контента игры (графика, звуки, тексты), также содержит исполняемые файлы\r\n* `graphics` - иконки игры для дистрибутива и AppImage\r\n* `setup` - скрипты создания архива для DOS, дистрибутивов/архивов для Windows, AppImage для Linux и архивов/DMG для MacOS\r\n* `source` - исходный код игры для QuickBasic 4.5\r\n\r\n## Инструменты сборки\r\n\r\nДля сборки проекта нужен установленный QuickBasic 4.5 и ассемблер [NASM](https://nasm.us/) (ассемблер - только при сборке библиотеки из исходников, если брать из релизов, то в нём нет необходимости).\r\nТакже потребуется графическая библиотека [QbGraTools](https://github.com/tereshenkovav/QbGraTools), v1.1.0\r\n\r\nСоздание дистрибутива для Windows выполняется с помощью программы\r\n[NSIS](https://nsis.sourceforge.io)\r\n\r\nСоздание архива для Windows выполняется с помощью скриптовой утилиты построения архивов\r\n[SmartZipBuilder](https://github.com/tereshenkovav/SmartZipBuilder)\r\n\r\nДля создания AppImage под Linux необходим инструмент сборки AppImageKit -\r\n[appimagetool-x86_64.AppImage](https://github.com/AppImage/AppImageKit/releases)\r\n\r\n## Сборка, запуск игры и создание дистрибутивов\r\n\r\n### Сборка\r\n\r\nДля сборки можно использовать виртуальную машину с DOS/FreeDOS или же DOSBox, подключив в нём каталог, в котором доступны QuickBasic, файлы библиотеки и файлы проекта.\r\nВ каталог QuickBasic надо скопировать Файлы графической библиотеки QbGraTools -\r\n```\r\ngratools.qlb\r\ngratools.lib\r\ngratools.bi\r\n```\r\nТеперь можно компилировать сам проект игры. Для этого надо скопировать файлы из каталога `source`\r\nв каталог QuickBasic и запустить скрипт `build.bat`.\r\nПри правильной сборке, в каталоге появятся файлы `GAME.EXE` и `GAME_FPU.EXE`.\r\nПервый файл предназначен для компьютеров без математического сопроцессора 8087,\r\nвторой может запускаться на любом x86-совместимом компьютере, где есть установленный сопроцессор.\r\nДля запуска в DOSBox можно использовать любой из полученных файлов.\r\n\r\nЕсли необходимо открыть проект игры в QuickBasic IDE, то сначала надо скопировать\r\nкаталог `bin\\data` в каталог установленного QuickBasic, после чего запустить\r\nIDE командой, которая подгрузит графическую библиотеку.\r\n\r\n```\r\nqb.exe /l gratools.qlb trixie.bas\r\n```\r\n\r\nСкопированный каталог `data` позволит запускать игру в режиме отладки прямо из IDE.\r\n\r\n### Запуск\r\n\r\nДля запуска игры нужно скопировать полученные файлы `GAME.EXE` или `GAME_FPU.EXE`\r\nв каталог `bin`, поcле чего запустить исполнимый файл.\r\nВ файле `data\\options` можно включить опции показа FPS в игре или вывода отладочной информации,\r\nраскомментировав соответствующие строки.\r\n\r\n### Создание дистрибутивов\r\n\r\n**ВАЖНО**: при создании дистрибутивов, информация о версии, ветке и коммите берется\r\nиз репозитория git, поэтому все описанные ниже команды будут работать корректно\r\nтолько при вызове из каталога-репозитория git и при наличии установленного git.\r\n\r\nПеред началом создания дистрибутивов нужно обязательно скопировать\r\nбинарные файлы `GAME.EXE` и `GAME_FPU.EXE` в каталог `bin`. Для создания дистрибутивов не требуется DOS или DOSBox, они создаются в Windows и Linux.\r\n\r\nСоздание архива для DOS или для DOSBox выполняется автоматически при\r\nзапуске файла `build.bat` из каталога `setup/dos`.\r\n\r\nСоздание архива и дистрибутива для Windows выполняется автоматически при\r\nзапуске файла `build.bat` из каталога `setup/windows`\r\n(может потребоваться указать путь к компилятору NSIS). И архив, и дистрибутив\r\nвключают в себя эмулятор DOSBox. Его файлы уже находятся в каталоге `setup/windows`,\r\nдополнительно устанавливать не нужно.\r\n\r\nСоздание AppImage под Linux выполняется автоматически при\r\nзапуске файла `build64.sh`, из каталога `setup/linux` если\r\nустановлен AppImageKit и исполнимый файл DOSBox находится по пути `/usr/bin/dosbox`.\r\n\r\nСоздание архива приложения и образа DMG под MacOS выполняется автоматически при\r\nзапуске файла `make_app.sh`, из каталога `setup/mac`.\r\nНеобходимые файлы DOSBox уже находятся в каталоге проекта.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftereshenkovav%2Ftrixie16bit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftereshenkovav%2Ftrixie16bit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftereshenkovav%2Ftrixie16bit/lists"}