Metadata-Version: 2.4
Name: ggx
Version: 0.8.2
Summary: API for GoodGame Empire
Author-email: mst4ck <mst4ck@mailfence.com>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: websockets>=15.0.1
Requires-Dist: loguru>=0.7.3
Requires-Dist: aiohttp==3.12.13
Dynamic: license-file

# GGX
The most advanced API library for interacting with GoodGame Empire.


## Description

The most advanced API client library for GoodGame Empire (GGE), enabling automated
connection, gameplay actions, and system scripting. Built for Python 3.12+,
ggx is currently in alpha stage—ideal for early adopters exploring automation
within GoodGame Empire.



## Install

```bash
pip install ggx
```


## Example

```
from ggx import GGXS
import asyncio


class Example(GGXS):

    def __init__(self, url, server_header, username, password):
        super().__init__(url, server_header, username, password)
        ## var example
        self.example = None


    ## add your jobs here!
    async def run_jobs(self):
        ## get castles detailes
        await self.get_detailed_castles()

async def main():
    app = Example("wss://ep-live-ro1-game.goodgamestudios.com/", "EmpireEx_15", "My username", "my password")
    await app.connect()
     
asyncio.run(main())
```


## Warning

 - This project is still under development and can cause errors or bugs!
 - Just for education purpose only!
 - I'm not responsible for any action which will be taken by GGE Studios against your account!
 
