Dead Ascend

A hand-drawn, open source, point'n'click-like 2D adventure game written in Qt/QML and Javascript.

"A horde of Zombies chased you to the old radio tower. Your only chance is to ascend up through the tower - solving a host of puzzles on your way to your rescue."

Quick start

DIY Building

update_ut_readme You can build the game from command line or with Qt Creator. QtCreator usually comes bundled with Qt. It can be downloaded and installed in various ways so please refer to Qt homepage and documentation on howto get Qt Creator.

If you do have clickable installed, you can start QtCreator by running clickable ide qtcreator in the apps main folder.

Once you have a fully working Qt/Qt Creator setup - you are ready to checkout and build "Dead Ascend".

1. Get codebase from GitHub

   cd /path/to/projects
   git clone https://github.com/mateosalta/DeadAscend.git
   git checkout ut
   

2. Build

   Command line

• Run clickable for your arch in the main project folder

  clickable
  clickable --arch=arm64
  clickable --arch=amd64
  

update_ut_readme You can now run ./App/DeadAscend - or if you used BIN_DIR: /usr/bin/DeadAscend

Translation

The app uses QtLinguist translations. You can edit them in the source code, but it is recommended to use [QtCreator](https://www.qt.io/product/development-tools) for your convenience. If you are using QtCreator, configure lupdate and lrelease with the argument set to "App/translations/*.ts".

**Note: Run all following commands from project root.**

### Extract additional strings from scenes.json to a temporary qml-file

- terminal: `python3 ./sbin/translation.py ./App/assets/scenes/scenes.json`

### Translation flow

a. to extract strings from qml files to ts-files (developers)
- terminal: lupdate App/App.pro -ts App/translations/*.ts
- QtCreator
    - configure Linguist: Tools -> Options -> Environment -> Linguist -> lupdate, set Arguments to 'App/App.pro -ts App/translations/*.ts'
    - run lupdate: Tools->External->Linguist->update translations(lupdate)
b. to update ts-files
- terminal: linguist App/translations/DeadAscend_*.ts
- QtLinguist: done automatically, according to [manual](https://doc.qt.io/qt-5/linguist-manager.html)

c. translate strings
- in editor: use an editor of your choice to translate strings in the source code, add the translated string between the tags `<translation>add translation here</translation>`
- QtCreator: right click on translation file, select "open with->QtLinguist", translate using QtLinguist

d. to update/create qm-files from updated/new ts-files (developers)
- terminal: lrelease App/translations/*.ts
- QtCreator
    - configure Linguist: Tools -> Options -> Environment -> Linguist -> lrelease, set Arguments to 'App/translations/*.ts'
    - run lrelease: Tools->External->Linguist->update translations(lrelease)

### (optional) get language flags to add to the app for new translations
https://github.com/hjnilsson/country-flags

Bugs and issues

If you encounter anything odd with the game feel free to report an issue.

If you're having trouble with QtFirebase please open an issue on the QtFirebase project issue page.

Other game projects

non - The First Warp

clickable will error on 'manifest.json not found'

• Copy the binary file from the build folder to /App/platforms/ubuntutouch/DeadAscend

• Run clickable for your arch within /App/platforms/ubuntutouch

• qtfirebase is 'stub' implementation only on 'other platforms' so it is left unconfigured and will not show ads