https://github.com/airvzxf/manaplus-game-sniparinject
Mana Plus - Game: Intercept and read the network packets to find information about the game, but it could be useful for any network sniffer.
https://github.com/airvzxf/manaplus-game-sniparinject
game-hack game-hacking
Last synced: 15 days ago
JSON representation
Mana Plus - Game: Intercept and read the network packets to find information about the game, but it could be useful for any network sniffer.
- Host: GitHub
- URL: https://github.com/airvzxf/manaplus-game-sniparinject
- Owner: airvzxf
- License: gpl-3.0
- Created: 2021-06-17T10:38:47.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2024-07-16T08:04:43.000Z (almost 2 years ago)
- Last Synced: 2025-01-27T05:59:13.682Z (over 1 year ago)
- Topics: game-hack, game-hacking
- Language: Shell
- Homepage:
- Size: 38.1 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: docs/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Mana Plus - Game
Intercept and read the network packets to find information about the game, but
it could be useful for any network sniffer. This project is work in progress.
Reefer to the [To-Do's][todo] list to check what is done and what is coming.
## Run it
### Locally
For more information go to the [sniparinject page in PyPi][sniparinject-pypi].
```bash
python3 -m pip install sniparinject
git clone https://github.com/airvzxf/manaplus-game-sniparinject.git
cd manaplus-game-sniparinject || exit 123
cd src || exit 123
# Make modification to the source code files: main.py and settings.yml.
# Run your changes.
sudo python3 main.py
```
### As a developer
The only special Python's packages that you need is `sniparinject`. The
suggested version of `Python` is `>= 3.10`. Follow the commands to set up and
install this package.
```bash
git clone https://github.com/airvzxf/manaplus-game-sniparinject.git
cd manaplus-game-sniparinject || exit 123
./src/script/setup-dev.bash
```
After this setup, it could be easy to activate the vEnv and start to work.
```bash
# Inside of the GitHub cloned directory.
cd src || exit 123
source ./venv/bin/activate
# Make modification to the source code files (main.py and settings.yml).
# Run your changes.
sudo python3 main.py
# Finally deactivate the vEnv.
deactivate
```
## Usage
The settings, needs to set the network interface which could get by the
command `ip addr` or `ls -1 /sys/class/net`. The next two are the host IP and
its port, in our case we will use the game IP and port. You could use this
command `lsof -i` to show all the process which has connection to the network,
check the column `NAME` to review the connection
`manaplus 5563 wolf ... MSIGT73EVR7RF:55238->52.174.196.146:5122
(ESTABLISHED)`. Also, another command is
`sudo netstat -nap | grep -i NAME_OF_GAME_PROCESS`.
`./src/settings.yml`
```yaml
Network:
interface: enp4s0
Server:
host: 52.174.196.146
port: 5122
```
Execute the application:
```bash
# Go to the source code directory.
cd src
# Execute with root permissions the main script.
sudo python3 main.py
```
### Example
[![asciicast][ascii-mana-image]][ascii-mana-link]
## Settings
Looking for add, modify or remove parse rules. It does not need to modify any
file in the source code. It has the `./src/settings.yml` file which is able to
add, modify or remove any rule, please reefer to the file in this project to
understand in deep.
The settings file is little complex, the better documentation is in the
`sniparinject` [official read me file][sniparinject-github].
Enjoy!
[todo]: ./TODO.md
[sniparinject-pypi]: https://pypi.org/project/sniparinject/
[ascii-mana-image]: https://asciinema.org/a/R0mxcmrpWHzX96NDJyc7kyTDB.svg
[ascii-mana-link]: https://asciinema.org/a/R0mxcmrpWHzX96NDJyc7kyTDB
[sniparinject-github]: https://github.com/airvzxf/sniparinject/blob/main/README.md#settings