zachlatta / sshtron Goto Github PK

$ ssh sshtron.zachlatta.com

License: MIT License

Go 72.23% HTML 17.53% CSS 8.17% Shell 0.44% Dockerfile 1.62%

sshtron's Introduction

SSHTron is a multiplayer lightcycle game that runs through SSH. Just run the command below and you'll be playing in seconds:

$ ssh sshtron.zachlatta.com

Controls: WASD or vim keybindings to move (do not use your arrow keys). Escape or Ctrl+C to exit.

Code quality disclaimer: SSHTron was built in ~20 hours at BrickHack 2. Here be dragons.

Want to choose color yourself?

There are total 7 colors to choose from: Red, Green, Yellow, Blue, Magenta, Cyan and White

$ ssh [email protected]

If the color you picked is already taken in all open games, you'll randomly be assigned a color.

Running Your Own Copy

Clone the project and cd into its directory. These instructions assume that you have your GOPATH setup correctly.

# Create an RSA public/private keypair in the current directory for the server
# to use. Don't give it a passphrase.
$ ssh-keygen -t rsa -f id_rsa

# Download dependencies and compile the project
$ go get && go build

# Run it! You can set PORT to customize the HTTP port it serves on and SSH_PORT
# to customize the SSH port it serves on.
$ ./sshtron

Running under a Docker container

Clone the project and cd into its directory.

# Build the SSHTron Docker image
$ docker build -t sshtron .

# Spin up the container with always-restart policy
$ docker run -t -d -p 2022:2022 --restart always --name sshtron sshtron

For Raspberry Pi, use the following to build the Docker image:

$ docker build -t sshtron --build-arg BASE_IMAGE=resin/raspberry-pi-golang:latest .

CVE-2016-0777

CVE-2016-0777 revealed two SSH client vulnerabilities that can be exploited by a malicious SSH server. While SSHTron does not exploit these vulnerabilities, you should still patch your client before you play. SSHTron is open source, but the server could always be running a modified version of SSHTron that does exploit the vulnerabilities described in CVE-2016-0777.

If you haven't yet patched your SSH client, you can follow these instructions to do so now.

License

SSHTron is licensed under the MIT License. See the full license text in LICENSE.

sshtron's People

Contributors

Stargazers

Watchers

Forkers

bpd1069 ligadous dungquoctrinh gnagel kazuakiebe 3p3r jaredfolkins azanebrain thomasbabuj glavkos intfrr yangwao shravankumara kiranreddythikkam alexfalcucci-archive techscientist ruthenium scharsey camtosh cdfpaz marcioalmada dgem issacpeng alphilippo dragonfax muracz anonquebec ib23 johann-weiss zachdzimmerman roadmaster vice95 xsank0r xsankor jwdeitch pankaj0001 umayr alyyousuf7 vinkdong alanmaciel srcbase tsoliangwu0130 usm4n froonix cpuspellcaster leewarnock vermuz e11it drdelaney jaymoulin forging2012 bcspragu mbjorge gfriloux linecode slremy briskgopesh fhowington hhy5277 wangheapp hellojustxn rblaine95 nohac sillyhatxu thor-isme himmatong justforkin joncv plaidshirtakos blrsn eazybright acganesh raulcesar rosera dontbanmeplz austinorth midgithub krizzo korman lxngoddess5321 ptrsc swipswaps rmccrystal wangyixian indl-coding 521hellogithub ruuucker aryzach mr-banana1080 donlinglok1 harmakhis971 greatfanzy rohinibarla ofdteam hamadmh paperbluster wholetthedog-out testwill qwquan orvilleelephant123

sshtron's Issues

Need to change base image for RPI

apicht/rpi-golang:latest cannot be used for the RPI base image because it is a pre-1.10 go version and therefore does not have math/bits extension. A base such as resin/raspberry-pi-golang:latest will work.

Add Dvorak keyboard support

Seems no one is playing this game. I have to play with myself. cry out loud.

Nice project!

I wrote pretty much the same project about a year ago - feel free to grab some ideas from it:

https://github.com/jpillora/ssh-tron

You might see some performance benefits from sending screen deltas to each player? This reduces updates from WxH bytes to 2-8 bytes per tick

ssh does not get connected

$ ssh sshtron.zachlatta.com

returns

Unable to negotiate with 149.28.243.27 port 22: no matching host key type found. Their offer: ssh-rsa

Flickering display

There is something weird with my terminal, but this is unplayable for me as between every frame there is a completely empty screen.

I am not sure how you are rendering a new screen, but it seems like you are clearing the screen and the redrawing. If that can be rendered to a buffer which would then be pushed or render directly without clearing, I think that would help some people.

Server player count is slightly off (-1)

./sshtron
Listening on port :2022 for SSH and port :3043 for HTTP...
Player joined. Current stats: 0 users, 0 games  <-- Should be 1 user, 0 games
Player joined. Current stats: 1 users, 1 games  <-- Should be 2 users, 1 game
EOF
EOF

Rainbow Trails

feature idea: your trail is a rainbow of colors of people that you have defeated, so instead of outputting a single color as you move along, it outputs a pattern of your win streak, and then resets when you die

Disable turning on Point

It is possible to turn on point e.g. if you press a-s (while moving upwards).

Please disable turning more then one direction in one step.

Can not connect

When I run
ssh sshtron.zachlatta.com
I get an error
Unable to negotiate with 149.28.243.27 port 22: no matching host key type found. Their offer: ssh-rsa
Can you please explain what is wrong?

Should recommend ssh -a -x for connecting

To avoid SSH agent and X11 forwarding, that a malicious server could exploit.

Feature request: Spectator mode

I would like to livestream games in progress.

Still working?

Hitting the server is just causing my terminal to hang. Seems to enter into an ssh session but then nothing after that.

Tried on

OSX 10.10.5 with zsh
Ubuntu 14.04 with bash

Other people seem to be having problems too.

Client settings

The manual should note the needed client settings to get the correct experience (for example, a plain ANSI terminal emulation will not suffice).

Provide some assurance you're not exploiting unpatched ssh clients

http://arstechnica.com/security/2016/01/bug-that-can-leak-crypto-keys-just-fixed-in-widely-used-openssh/

EU server?

170 ms make it a bit hard to play..
A EU server could be nice.

Wish: Provide `systemd` service file for people to use.

Right now when sshtron is run by systemd, the colors don't work. See:

http://unix.stackexchange.com/questions/352937/ansi-colors-when-using-systemd-service

From what I can tell, sshtron uses a color library, which in turn uses library to check is there's a terminal connected to decide whether to use colors or not, which boils down to this line:

https://github.com/mattn/go-isatty/blob/master/isatty_linux.go#L14

The logic using TTY detection to decide if a server should output color seems flawed if that's what' going on. The server might be not connected to a TTY even if the clients are.

systemd does have some options to connect a service to a TTY documented in man systemd.exec, but usually services aren't connected to TTYs, their clients are.

In any event, providing a working systemd .service file would be of interest to people who want to manage sshtron as a standard system service.