The Tigra-128 project is an implementation of the graphics API functions of TIC-80 fantasy console. The project is a plugin for Unity that allows you to experiment with TIC-80 graphics using the full power of C# and Unity!
Tigra-128 will allow you to plunge into the atmosphere of minimalism of fantasy consoles. Small screen resolution, border, a palette of 16 colors, all code in a single file and a simple TIC-80 API functions is what creates limitations and emphasizes the spirit of retro-gaming consoles. A professional development environment Unity and powerful object-oriented language C# is the tools for easy and rapid creating, debugging, and publishing your creative ideas under a variety of execution platforms. The project also includes some scripts for integrating free and open source code editor Microsoft Visual Code: snippets for autocompletion TIC-80 API functions, Unity integration script, settings of ignored resources files.
It is enough to have one GameObject with a custom script inherited from Tic80 class in scene in order to work. Tic80Config script and graphical representation will be added automatically.
The project includes source code of some demos for TIC-80, rewritten in C#. The project is open source and freely redistributable. TIC-80 logo and brand (c) Copyright 2017 Nesbox https://tic.computer/
You can select the font and colours in the editor in Tic80Config script.
It also allows you to set the display of debug information (currently it can only be displayed if the script is not used the text output using print function).
Settings can be changed in the editor and in runtime.
Only one custom script inherited from Tic80 class can be active at a time. If the scene will has other active Tic80 scripts they will be turned off.
When you activate a custom script during runtime the remaining scripts will be turned off automatically.
No need to create a camera - the representation will be added at the start of the game.
-
Create a new scene: File -> New Scene. Add to the scene a new GameObject: GameObject -> Create Empty. Then add this object to our game script or drag it (if it is already exist), or using the Add Component button in the Inspector tab when gameObject is selected. In addition to our script the
Tic80Configscript will be automatically added to the gameObject. -
Create our script - descendant class of
Tic80-class. In addition to creating class manually, you can use the class creation template. For this the script99-Tic80 Script-NewTic80Script.csmust already be in the specified folder (see "Placement and editing template scripts."). Further, in the Project tab, select the folder where we want to place the script (but NOT in the Editor folder), click the right mouse button and from the context menu, select Create -> Tic80 Script. It will create a new script, which should be given a name.
- Fill our script with game logic and launch the game!
To create scripts according to the template you want, copy the file 99-Tic80 Script-NewTic80Script.cs from the folder Assets/Scripts/Editor/ScriptTemplates to the script templates folder.
To display the source folder and target folder, you can use the command from the context menu Show in explorer Tic80 Script Templates or selecting it from the Assets > Show in explorer Tic80 Script Templates.
- Windows
C:\Program Files\Unity\Editor\Data\Resources\ScriptTemplates - Mac
/Applications/Unity.app/Contents/Resources/ScriptTemplates - Linux
/opt/Unity/Editor/Data/Resources/ScriptTemplates
In order to use autocompletion of code (snippets) of TIC-80 API functions do the following:
- Open the file csharp.json with the desired language. The following languages are available: EN, RU, FR. They are here:
Assets/Plugins/VSCodeSnippets. - Open in Visual Studio Code: File->Preferences->User Snippets, locate the C# language, copy and paste the contents of the corresponding json.
What are a tweetcarts and tweetjams? Tweetcart is a post in Tweeter, which contains self-sufficient script, which usually draws funny graphics on the screen. The script size is limited to the number of characters in a single tweet, i.e. 280 characters. A tweetjam is a competition or contest for the most interesting tweetcarts devoted to any topic. In order to use the power of C# language and Unity libraries and to fit in such a small code size - we've added an abbreviations in code. You can easily create a blank billet of tweetcart or create a tweetcarts with auto-substitution code from another tweetcart. The context menu command: Create > Tic80 New TweetCart and Create > Tic80 Paste TweetCart.
- the Tigra project is now named Tigra-128
- added abbreviations for tweetcarts
- added templates for creating tweetcarts
- added 6 demonstration tweetcarts
- performance improvement: SetPixels replaced with SetPixels32
The following graphical TIC-80 API functions are implemented:
- pix
- line
- circ
- circb
- rect
- rectb
- tri
- trib [missing in API]
- cls
- border [API equivalent: poke(#03FF8, color)]
Other implemented API functions:
- TIC
- init
- btn
- btnp
- mouse
- trace
- time
- exit
Partially implemented:
- print - prints the text once per tick
I want to thank for the contribution and for the motivation:
Проект "Tigra-128" - это реализация графических функций API виртуальной игровой консоли TIC-80. Проект представляет из себя плагин для Unity, позволяющий экспериментировать с графикой TIC-80 используя всю мощь C# и среды Unity!
"Tigra-128" позволит вам окунуться в атмосферу минималистичности фантазийных консолей. Малое разрешение экрана, бордюр, палитра из 16 цветов, весь код в единственном файле и простые функции API TIC-80 - это то, что создаёт ограничения и подчеркивает дух игровых ретро-консолей. Профессиональная среда разработки игр Unity и мощный ООП язык C# - это инструменты для удобного и быстрого создания, отладки и публикации ваших креативных идей под множество платформ исполнения. В проект также влючены скрипты для интеграции бесплатного и открытого редактора кода Microsoft Visual Code: сниппеты для автодополнения функций API TIC-80, скрипт интеграции в Unity, настройки игнорируемых файлов ресурсов.
Для того чтобы всё заработало достаточно иметь на сцене один GameObject с пользовательским скриптом, унаследованным от класса Tic80. Скрипт Tic80Config и отображение будут добавлены автоматически.
В проект включены исходные коды демок для TIC-80, переписанные на C#. Проект является открытым и свободно распространяемым. Логотип и марка TIC-80 (c) Copyright 2017 Nesbox https://tic.computer/
Шрифт и цветовую палитру можно выбирать в редакторе - в скрипте Tic80Config.
Также в нем можно установить отображение отладочной информации (сейчас она может выводиться только если в скрипте не использован вывод текста через функцию print).
Настройки можно менять как в редакторе, так и во время исполнения игры.
Пользовательский скрипт, унаследованный от класса Tic80, может быть активен только один. Если на сцене будут активны другие скрипты Tic80 - они будут выключены.
При активации пользовательского скрипта во время исполнения - остальные скрипты будут выключены автоматически.
Создавать камеру не нужно, отображение само добавляется при старте игры.
-
Создаём новую сцену: File -> New Scene. Добавляем на сцену новый GameObject: GameObject -> Create Empty. Далее добавляем на этот объект наш игровой скрипт - либо перетягиванием (если он уже есть), либо нажав кнопку Add Component во вкладке Inspector при выделенном gameObject-е. Кроме нашего скрипта, на gameObject будет автоматически добавлен скрипт
Tic80Config. -
Создаём наш скрипт - класс-потомок класса
Tic80. Кроме создания класса вручную, можно использовать создание класса по шаблону. Для этого скрипт99-Tic80 Script-NewTic80Script.csуже должен находиться в указанной папке (см. пункт "Размещение и правка шаблона скриптов."). Далее, во вкладке Project выбираем папку куда мы хотим поместить скрипт (но НЕ папку Editor), жмем правую кнопку мыши и в контекстном меню выбираем Create -> Tic80 Script. Будет создан новый скрипт, которому нужно дать имя.
- Наполняем "логикой" наш скрипт и запускаем игру, готово!
Для того чтобы создавать скрипты по шаблону, нужно скопировать файл 99-Tic80 Script-NewTic80Script.cs из папки Assets/Scripts/Editor/ScriptTemplates в папку шаблонов скриптов.
Чтобы отобразить папку-источник и целевую папку, можно воспользоваться командой из контекстного меню Show in explorer Tic80 Script Templates либо выбрав её из Assets > Show in explorer Tic80 Script Templates.
- Windows
C:\Program Files\Unity\Editor\Data\Resources\ScriptTemplates - Mac
/Applications/Unity.app/Contents/Resources/ScriptTemplates - Linux
/opt/Unity/Editor/Data/Resources/ScriptTemplates
Для того чтобы использовать автодополнение кода(сниппеты) функций API TIC-80 проделайте следующее:
- Откройте файл csharp.json с нужным языком локализации, доступны EN, RU, FR. Они находятся здесь:
Assets/Plugins/VSCodeSnippets. - В Visual Studio Code откройте: File->Preferences->User Snippets, найдите язык C#, скопируйте и вставьте содержимое соответствующего json-а.
Что такое твит-карты и твит-джемы?
Твит-картом называют пост в tweeter, который содержит сомодостаточный скрипт, который как правило рисует забавную графику на экране.
Размер скрипта ограничен количеством символов в одном твите, т.е. 280 символов.
Твит-джем - это некое соревнование или конкурс, на самый интересный твит-карт посвященный какой либо теме.
Для того, чтобы задействовать мощь языка C#, а также библиотек Unity и уместиться в такой маленький размер кода - мы добавили сокращения.
Можно легко создавать пустую заготовку твит-карта или создать твит-карт с авто-подстановкой кода из твит-карта.
Команды из контекстного меню: Create > Tic80 New TweetCart и Create > Tic80 Paste TweetCart.
- проект Tigra теперь носит имя Tigra-128
- добавлены сокращения для твит-картов
- добавлены шаблоны создания твит-картов
- добавлены 6 демонстрационных твит-картов
- увеличение производительности: замена SetPixels на SetPixels32
Реализованы следующие графические функции API TIC-80:
- pix
- line
- circ
- circb
- rect
- rectb
- tri
- trib [нет в API]
- cls
- border [эквивалент в API: poke(#03FF8, color)]
Реализованы прочие функции API:
- TIC
- init
- btn
- btnp
- mouse
- trace
- time
- exit
Частично реализованы:
- print - выводит текст один раз за тик
Хочу поблагодарить за вклад и мотивацию: