Open Tank

What is this

Caution

I am not a specialized developer in NodeJS, for this reason, you may not like something in the code. If you want to improve the project or encounter any errors, write about it in issues but I'm not sure I can find the time to answer. If you are the owner of Tanki Online and you don't like that this project exists, contact me at issues and we will be able to solve this problem.

This is a client for the Tanki Online game written in NodeJS and wrapped in electron. The game does not have a native client for Linux (there is only one for Windows), for this reason I decided to create this client. The Windows client is created in a similar way, just a Chromium engine and an electron wrapper. In principle, there is almost no difference with the original client.

How to build

Install npm & nodeJS

• Manjaro/ArchLinux:

sudo pacman -S nodejs npm

• Debian/Ubuntu/Linux Mint:

sudo apt install nodejs npm

Clone git repository and navigate to the project folder:

git clone https://github.com/WolfAURman/opentank && cd opentank

Run the dependency installation:

npm install

Run build:

npm run build

Get the finished project in the directory:

dist/opentank-1.0.0.AppImage

Development

• Make changes to the source code.
• Run during development without compilation.

Example:

npm start

How to use

To launch the project, download from the releases section opentank-1.0.0.AppImage package (or if you used manual build, you will receive a ready-made package from dist/opentank-1.0.0.AppImage) and run it from the terminal:

./opentank-1.0.0.AppImage

For AMD graphics cards using the OpenSource driver, game runs perfectly and has a high FPS. For more information, visit wikipedia: Arch Linux Wiki - Chromium

Data storage

Almost all AppImage applications save data & config in your home folder. OpenTank is no exception. You can find the application data in ~/.config/opentank/

Creating shortcut

Create folder. After creation folder, place opentank-*.AppImage and the assets folder with the icon pack there ~/.opentank

mkdir -p ~/.opentank

Create file .desktop:

cat << EOF > ~/.local/share/applications/opentank.desktop
[Desktop Entry]
Type=Application
Exec=/home/$USER/.opentank/opentank-*.AppImage --ozone-platform-hint=auto
Icon=/home/$USER/.opentank/assets/icons/512x512.png
Terminal=false
Categories=Games;Game;
Keywords=tanki;opentank;OT;
Name=OpenTank
GenericName=OpenTank
EOF

Update shortcut database:

update-desktop-database ~/.local/share/applications

Troubleshooting

Below are solutions to common issues that may arise when working with this project.

Error: Fuse package is not installed

Description:

AppImages require FUSE to run. 
You might still be able to extract the contents of this AppImage 
if you run it with the --appimage-extract option

Solution:

• Install the fuse package.

Example:

• Manjaro/ArchLinux:

sudo pacman -S fuse

• Debian/Ubuntu/Linux Mint:

sudo apt install fuse

Error: The cursor goes beyond the edges of the window

Description:

When using mouse control in the game, the cursor goes beyond the edges of the window, leaving the application

Solution:

• Do not use this flag: --ozone-platform-hint=auto

Example:

cat << EOF > ~/.local/share/applications/opentank.desktop
[Desktop Entry]
Type=Application
Exec=/home/$USER/.opentank/opentank-*.AppImage
Icon=/home/$USER/.opentank/assets/icons/512x512.png
Terminal=false
Categories=Games;Game;
Keywords=tanki;opentank;OT;
Name=OpenTank
GenericName=OpenTank
EOF