Leer en español/Read in spanish
RogueTech is a RPG roguelike game for browsers, with online competitive functionality between players via online leaderboards.
- Roguelike gameplay (Random levels, permadeath).
- Animations, sound effects, background music, wide variety of enemies and items.
- Can create accounts for submitting scores and competing with other users.
- Follow friend and other users to find their scores easily.
- Highly dynamic interface, will look good on desktop as well as on mobile.
- Can be easily downloaded and installed as an app.
| Landing page | Game |
|---|---|
 |
 |
| Scores page | Responsive game UI |
 |
 |
The program requires the following dependencies to be installed and configured in the system:
- Python 3.10 or newer.
- MariaDB or MySQL database.
- Node.js 18 or newer.
The database structure first has to be imported to the DBMS, which can be done using the tools provided by it or additional tools such as phpMyAdmin. The first step is to create the database to be used, the default database name is "gamedb"; if you choose another name for the database, you will need to specify it in the configuration (explained in the following sections). After creating the database, you need to import the schema.sql file into it.
Start a terminal or cmd window running in the application's directory and run the following commands to install the dependencies required by the application:
python -m pip install -r requirements.txt
npm install
The game's code is divided into multiple JavaScript files in the src directory, which are later compiled along with other libraries into a single complete file that can be loaded by the browser as main-compiled.js. To compile the game source code run:
npm run build
At startup, the program will search settings for how to connect to the database in the directory where it is executing. It will search for a .env file that will contain the database name, as well as other information regarding the database. If the .env file doesn't exist, the server will use the default values as seen below. The .env file contents can be:
export DB_NAME=gamedb
export DB_USER=root
export DB_PASS=
export DB_HOST=localhost
Where DB_NAME is the database name, DB_USER is the username used to connect to the database, DB_PASS is the database user's password, and DB_HOST is the address to connect to the database, usually being localhost.
Additionally to the database options, the optional ENABLE_DEVMENU can be configured to enable or disable the developer settings available in the pause menu inside the game. A value of 1 (the default) activates the menu, and a value of 0 disables it.
export ENABLE_DEVMENU=1
Initially, the system will have no users, so you should create an initial administrator user. For security reasons, the creation of admin users is completely separated from the one offered in the web interface, which will only register regular users. To create a new admin user, execute the follwing command:
python make-admin.py
It will ask for the username, password and security pin for the new administrator; once the information is provided, the script will try to create the administrator and indicate the success of the operation or any errors that may happen.
Once the dependencies have been installed and the environment configured, the application can start correctly. To run it, start a terminal or cmd window in the application's directory, and run the following command:
python -m flask run
Once it starts, you will be able to open http://localhost:5000/ to begin using the application.
To compile or modify the game's code (in the src directory), it is required to recompile the the code to create a bundled file including all dependencies. To recompile use the command:
npm run build
Or for the continuous compilation mode, recompiling the game every time a change is saved, use:
npm run watch