pygomas 0.3.0

A Python 'capture the flag' Game Oriented Multiagent System.

pygomas

A python capture the flag Game Oriented Multiagent System.

• Free software: GNU General Public License v3

• Documentation: https://pygomas.readthedocs.io. (to be done)

Features

• BDI agents to play a capture the flag game.

• Based on the SPADE Multi-Agent System platform (https://spade-mas.readthedocs.io.)

• Support for different game viewers (pygame, Unity, ncurses…)

Usage

To run a pygomas game manager:

$ pygomas manager --num-players 10 --match-time 120

The prepare a JSON file with your agent configuration:

{
    "host": "127.0.0.1",
    "manager": "cmanager",
    "service": "cservice",
    "axis": [
        {
            "rank": "BDISoldier",
            "name": "soldier_axis1",
            "password": "secret",
            "amount": 5
        }
    ],
    "allied": [
        {
            "rank": "BDISoldier",
            "name": "soldier_allied1",
            "password": "secret",
            "amount": 5
        }
    ]
}

For more complex configuration files run:

$ pygomas help run

Then run your agents file:

$ pygomas run --game game.json

To view the game play in real time run:

$ pygomas render

To dump the game play to a file to be replayed in the future run:

$ pygomas dump --log my_log_file.log

To replay a game play run:

$ pygomas replay --game my_log_file.log

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

0.3.0 (2020-02-10)

• Migrated msg format to msgpack.

• Black sttyle applied to code.

• Major refactoring of code in renders.

0.2.3 (2019-07-10)

• Upgrade default ASLs.

• Agent name in JSON file is no longer required.

0.2.2 (2019-07-10)

• Change all coordinate actions and beliefs to tuple of coordinates.

• Update spade-bdi.

0.2.1 (2019-07-08)

• Change the .create_control_points from action to function.

• Change all coordinate actions and beliefs to tuple of coordinates.

0.2.0 (2019-07-05)

• Added game replay support.

• Added action to register generic services.

• Added turn action for the troop agents.

• Added a new map (map_08)

• Minor bug fixes.

0.1.0 (2019-06-13)

• First release on PyPI.