TankistOnline

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 10 Open GitHub ↗

A Cross-Platform Lightweight 2D Tank Multiplayer Game in Python 2/3

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# TankistOnline
A Cross-Platform Lightweight 2D Tank Multiplayer Game in Python 2/3.

![v0.2:Alpha Screenshot](https://github.com/servusDei2018/servusdei2018.github.io/blob/master/screenShots/tankist_screenshot.jpg?raw=true)

### Commitments:

**Tiny System Requirements** -- A Raspberry Pi can run a server and 4 clients, with room to spare. The RPi is a 1Ghz quad core processor with 1 GB of RAM.
**Tiny Size** -- v0.2:Alpha is < 152 KB (unzipped)
**Cross-Platform** -- Windows, Mac, Linux; anything that runs Python.

## UPDATES

### Public Server Operational!

**Come on over** and checkout our new public server at **tankistonline.skeltonkey.xyz**!

### Version 0.2 Alpha Released!

**Version 0.2 Alpha is now available!** If you experience any bugs or have any questions, please
feel free to open a new issue. V0.2:Alpha features:

```
New Features:

-A scrolling map
-Improved TKO Protocol security: packet verification
-A connection dialog to choose a server
```

```
Non-new features:

-Interactive multiplayer client-server gameplay, with nicknames for each player
-Shooting other tanks (and killing them)
-Driving across the map (with map boundaries to prevent people from driving infinitessimal distances)
-A colored life-bar
-The server automatically disconnects idle players
-**Client is Python 3 ONLY**
-**Server is Python 2.7+, Python 3.x, or PyPy**
```

Special thanks to all of our contributors and everyone who is helping with this project!

Please note that **we are looking for someone to host a public server, to which anyone can connect.** 
To host Tankist, you can either pay for a 24/7 VPS (which costs from $2-8/mo.) or you may just decide to
run Tankist on your own computer at a specified time each day/week/month -- and that information shall be
made available via this repository. If you have any questions about hosting Tankist, need help choosing or
setting up a VPS, or questions about sponsoring a Server, please open a new issue.

### Upcoming: Version 0.2 Alpha

Version 0.3 Alpha is planned to be released sometime in 2020 and shall feature:

```
-More maps, bigger maps, smaller maps
-More and improved code optimization
-Cleaner, more concise code
-A new and improved wiki
-A list of public hosts (when they're available)
```

And things that __may__ make an appearance in *future* releases:

```
-Different TURRETS that do different amounts of damages from different ranges
-Tank skins to customize the look and feel
```

### Changelog:

The project was last updated on `December 1, 2019` with many additions to both the client and the server.

```
Changelog:

-Server improved
-Client improved
```

## RUNNING

**The Client is Python 3 _only_, whereas the server can be run with Python 2.7+, Python 3.x, or PyPy**

### Running the client

If you don't have it, install pyglet: `pip3 install pyglet`
To run the client, **Python 3 must be used:** `python3 TankistOnline_Client.py`

Before you'll be able to play, you'll have to run the server (see below).

Once the client is running, you'll be asked to enter a nickname, then you'll connect
and be able to move around (arrow keys) and shoot (spacebar). If you want a landmark
by which to mark your movements, connect with another client. You may need to move
around a bit before your tanks are able to see each other.

### Running the server

For ease of deployment on varied systems, the server can be run with `python2.7+`, `python3.x`, and `PyPy`. The speed
difference between the interpreters is not significant, but will affect CPU usage and RAM (around 6-10%).

PyPy (fastest): `pypy TankistOnline_Server.py`
Python3.x: `python3 TankistOnline_Server.py`
Python2.7+ (slowest): `python TankistOnline_Server.py`

### Playing the game

**The client screen centers on the player's tank,** so it won't look like your tank is moving. If someone else joins the server, you'll be able to use him as a landmark.

## DEPENDENCIES

To keep to our lightweight commitment, dependencies for the client are minimal, and the server *has no dependencies* beyond the standard library.

### Client side dependencies:

- **Pyglet** (`pip install pyglet`, *or* `pip3 install pyglet`)

### Server side dependencies:

- **None**

## TO-DO:

### Server-Side:
Pending

### Client-Side:
- [ ] Add a **small** library for cross-platform sound, and use it.

### Misc:
- [ ] Optimization [it's always welcome, however, keep in mind our Cross-Platform mindset].
- [ ] Maintain the Wiki to reflect the contents of the `doc` folder. {`WIKI`}

**Maps** (in the form of jpg files) are welcome. When designing maps, please make sure that the image's filesize is under `32kb`. That means having low resolution (the client can automatically scale images to make them appear bigger). We do not plan to bloat the project with maps, so the map folder is planned to be capped at 64kb -- enough space for around 20 maps.

## CONTRIBUTING

Feel free to fork the project, and push contributions to the *beta* branch, unless otherwise directed by a Help Wanted topic in Issues.

## LICENSE

This project is released under the GPLv3.0.

It permits the **Commercial and Private Use and Modification, Distribution, and Patent Priviledges.** However, the Conditions are that you must **disclose the source code**, use the **same license**, **include both the license and copyright notice**, and **state changes**.

*Disclaimer: **This summary of the License is not the license itself**.*

TankistOnline

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README