https://github.com/nzeemin/uknc-desolate

🕹️ Desolate game ported from TI-83 Plus to UKNC
https://github.com/nzeemin/uknc-desolate

16bit 8bit assembly game macro11 ms0511 pdp11 porting porting-game retro retrocomputing uknc

Last synced: 5 days ago
JSON representation

🕹️ Desolate game ported from TI-83 Plus to UKNC

• Host: GitHub
• URL: https://github.com/nzeemin/uknc-desolate
• Owner: nzeemin
• License: mit
• Created: 2020-12-12T00:25:32.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2021-03-15T10:20:38.000Z (almost 4 years ago)
• Last Synced: 2024-11-15T01:35:38.220Z (2 months ago)
• Topics: 16bit, 8bit, assembly, game, macro11, ms0511, pdp11, porting, porting-game, retro, retrocomputing, uknc
• Language: C#
• Homepage:
• Size: 496 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# uknc-desolate

Ported **Desolate** game from TI-83 Plus calculator to soviet computer [UKNC](https://en.wikipedia.org/wiki/UKNC) (УКНЦ).

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Thanks a lot to tr1p1ea for the original game!

Thanks to [zx-pk.ru forum](https://zx-pk.ru/forum.php) members for all the help and support!

The main challenge was to convert ~4K lines of Z80 assembly code to PDP-11 MACRO assembler, in other words, to convert all the code to very different processor. Plus the usual stuff like difference in video and input.

So the work took like 18 days to convert the code and fix all the bugs found.

![](screenshot/port-story1.png)

![](screenshot/port-room1.png)

Controls to use in the game:

 - Arrows - movement

 - Space - look/shoot

 - I - Inventory

 - Q - switch look/shoot mode

 - P - return to menu

 - Other keys (usually I prefer Tab) - close all pop-ups

Play the game online using UKNCBTL WASM emulator: https://nzeemin.github.io/ukncbtl-wasm/index.html?state=https://nzeemin.github.io/ukncbtl/desolate.uknc&run=1

## The original game

Written by Patrick Prendergast (tr1p1ea) for TI-83/TI-84 calculators.

![](screenshot/original-room1.png)

Links:

 - [Desolate game description and files](https://www.ticalc.org/archives/files/fileinfo/348/34879.html)

 - [Wabbit emulator site](http://wabbitemu.org/) and [GitHub](https://github.com/sputt/wabbitemu)

To run the game on Wabbitemu emulator:

 1. Run Wabbitemu, select ROM file

 2. File Open `DesData.8xp`

 3. MEM, select Archive; PRGM, select DesData; ENTER

 4. File Open `Desolate.8xp`

 5. File Open `MIRAGEOS.8xk`

 6. APPS select MirageOS

 7. Select Main > Desolate

## Tools used to develop the port

 - [RT-11 simulator](http://emulator.pdp-11.org.ru/RT-11/distr/) written by Dmitry Patronov, to run RT-11 commands `MACRO` and `LINK` directly from the Windows command line

 - [UKNCBTL utilities](https://github.com/nzeemin/ukncbtl-utils): `rt11dsk` to work with disk images, `sav2cartridge` to prepare UKNC ROM cartridge

 - [pclink11](https://github.com/nzeemin/pclink11): to link object modules just like `LINK` command do, but mostly to test `pclink11`

 - VSCode as the primary code editor

 - Visual Studio and C# to write some code converting binary data (tiles, sprites, strings, tables), see the code in SpriteRotate folder

Emulators of the machine, to test the result:

 - [UKNCBTL](https://github.com/nzeemin/ukncbtl)

 - [EmuStudio](https://zx-pk.ru/threads/18027-emulyator-uknts-emustudio.html)

## Links

 - [Discussion on zx-pk.ru (in Russian)](https://zx-pk.ru/threads/32566-portirovanie-desolate-s-ti-83-plus-na-uknts.html)

 - [Desolate port on ZX Spectrum](https://github.com/nzeemin/spectrum-desolate)

 - [Desolate port on Vector06c](https://github.com/nzeemin/vector06c-desolate)