Aegg Bomb

A game that lets you throw eggs at each other.

Build with stack build, run with stack exec aegg-bomb.

Connect As A Player

Connect as a player on TCP port 4242, using something like netcat. First you need to provide your player name, then you can interact with the game.

Using rlwrap makes this a little more pleasant.

$ rlwrap netcat localhost 4242

> Hi, what's your name?
< bob
> Welcome, bob!

You will receive frequent status reports that tell you what is going on around you.

> Current position (0.0,0.0)
> Health 1.0
> Can see players []
> Can see eggs []

You can issue a Move command to move your player.

< Move (1.0, 0.0)
> Current position (0.31666666666666665,0.0)
> Health 1.0
> Can see players []
> Can see eggs []
> Current position (0.8333333333333343,0.0)
...

Throw will throw an egg.

< Throw (10.0, 5.0)
> Current position (0.0,0.0)
> Health 1.0
> Can see players []
> Can see eggs [(1.8333333333333335,0.9166666666666667)]
> Current position (0.0,0.0)
> Health 1.0
> Can see players []
> Can see eggs [(7.0000000000000036,3.5000000000000018)]
...

This is still very much a work-in-progress and precisely all the details are subject to change.

Connect As A Renderer

The render output is sent over WebSockets. The server runs on port 2424. Each message sent to the client is a JSON object containing lists for each type of object in the scene.

There are currently four types of object: walls, players, eggs and explosions. Each object has pos and bounds properties. The pos contains the x and y coordinates of the object, the bounds contains the minimum and maximum coordinates of the axis-aligned bounding box around the object, relative to pos.

{
  "pos": [32.5, -46.7],
  "bounds": [[-0.5, -0.5], [0.5, 0.5]]
}

Some objects contain further properties which can be used to make the rendered output more interesting.

A full message looks something like the following (once nice formatting has been applied):

{
  "walls": [
    { "pos": [0.0, 0.0], "bounds": [[-11, -11], [-10, 10]] },
    { "pos": [0.0, 0.0], "bounds": [[-11, 10], [10, 11]] },
    { "pos": [0.0, 0.0], "bounds": [[10, -10], [11, 11]] },
    { "pos": [0.0, 0.0], "bounds": [[-10, -11], [11, -10]] },
    { "pos": [0.0, 0.0], "bounds": [[-6, -6], [-5, 6]] }
  ],
  "players": [
    {
      "name": "Alice",
      "pos": [9.5, 3.7999],
      "bounds": [[-0.5, -0.5], [0.5, 0.5]]
    }
  ],
  "eggs": [
    {
      "pos": [6.7499, 4.8999],
      "bounds": [[-0.25, -0.25], [0.25, 0.25]],
      "height": 8.6625
    }
  ],
  "explosions": [
    {
      "pos": [-3.7500, 9.0999],
      "box": [[-0.5918, -0.5918], [0.5918, 0.5918]]
    }
  ]
}

wscat is a useful tool for debugging this.

derkyjadex/aegg-bomb

Aegg Bomb

Connect As A Player

Connect As A Renderer

License