Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gjum/gagar
Standalone graphical agar.io Python client/bot using GTK and agarnet
https://github.com/gjum/gagar
agar bot cairo game gtk pypi
Last synced: about 2 months ago
JSON representation
Standalone graphical agar.io Python client/bot using GTK and agarnet
- Host: GitHub
- URL: https://github.com/gjum/gagar
- Owner: Gjum
- License: gpl-3.0
- Created: 2015-05-16T00:14:56.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2016-05-07T14:30:12.000Z (over 8 years ago)
- Last Synced: 2024-10-14T19:25:59.244Z (2 months ago)
- Topics: agar, bot, cairo, game, gtk, pypi
- Language: Python
- Homepage:
- Size: 349 KB
- Stars: 21
- Watchers: 4
- Forks: 11
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# OUTDATED
Due to heavy changes in the web client and protocol, this project does not work anymore.
gagar
=====
[](https://pypi.python.org/pypi/gagar/)
[](https://pypi.python.org/pypi/gagar/)
[](https://gitter.im/Gjum/gagar?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
Standalone graphical [agar.io](http://agar.io/) Python client using GTK and [`agarnet`](https://github.com/Gjum/agarnet)
Features
--------
- mass graph
- minimap
- skins
- show eatability/hostility level of other cells
- force fields for eatable/hostile cells
- show/hide anything via key bindings
- extend with your own plugins (more stats, server chooser, bot, ...)
###Roadmap
- command-line arguments (nick, gamemode, facebook token)
- better virus interaction
- zoom
- make it work with Ogar
- documentation (for now, look at [the `agarnet` docs](https://github.com/Gjum/agarnet/tree/v0.2.1/doc))
- config file
Installation
------------
First of all, install the GTK dependencies.
Under Arch Linux, run
pacman -S python-gobject python-cairo pygtk
Other distros should have similar packages.
Someone told me it even works on Mac using MacPorts.
If you get it to work, please comment on [this issue](https://github.com/Gjum/gagar/issues/8), so I can add instructions for your system.
The client itself can be installed from [PyPI](https://pypi.python.org/pypi?name=gagar&:action=display) with
pip install gagar
or, if you want to get the source code,
git clone [email protected]:Gjum/gagar.git
cd gagar/
python3 setup.py install
Run the GUI with
gagar -h
Controls
--------
| Key | Action |
|:----------|:----------------------|
| `S` | spectate |
| `Q` | toggle spectate mode |
| `R`/`RETURN` | respawn |
| `Mouse` | movement direction |
| `W` | shoot small cell |
| `Space` | split |
| `K` | explode (disabled on official servers) |
| `C` | reconnect to any server |
| `I` | show/hide helpful cell info |
| `N` | show/hide names |
| `K` | show/hide skins |
| `M` | show/hide movement lines |
| `G` | show/hide grid |
| `B` | show/hide world border |
| `F1` | show/hide overlays |
| `F2` | change background color |
| `F3` | show/hide FPS meter |
| `ESC` | quit |
About
-----
This is a hobby project of me, on which I work in my free time.
Pull requests are more than welcome, but you should open an issue first, so we can talk about it.
I reverse-engineered the protocol implementation by looking at the (barely) obfuscated Javascript code on the agar.io website.
Although it would be much easier now to write a client, because [there is a wiki](http://agar.gcommer.com/) describing the whole protocol and most game mechanics.
If you have any game-related questions, feel free to ask in the [#agariomods IRC channel on the Rizon network](http://irc.lc/rizon/agariomods/CodeBlob@@@).
For questions about this client specifically, [open an issue](https://github.com/Gjum/gagar/issues/new) or write me an email: [[email protected]](mailto:[email protected])
Disclaimer
----------
This project isn't affiliated with [agar.io](http://agar.io/) in any way. When playing with this client, you do not get advertisements, which may be nice for you, but does not pay for the servers needed to run the game.
---
Licensed under GPLv3.