grepo-remote/README.md

Grepolis Remote Control (GRC)

A sophisticated remote management dashboard and automation relay for Grepolis. GRC allows you to monitor your towns and issue building/recruitment commands from a centralized web interface, bypassing the need to have the game tab active at all times.

🚀 Key Features

• Real-time Town Monitoring: Track resources (Wood, Stone, Iron, Silver), Population, God, Points, and World placement across all your towns.
• Remote Commands: Issue "Build" and "Recruit" orders directly from the dashboard.
• Infinite External Queue: Commands are stored in a local database and executed by the script as soon as in-game slots or resources become available.
• Smart UI Indicators:
  • Resource Validation: Live checks against town resources; warns you if you can't afford a command.
  • Dependency Tracking: Automatically detects missing building prerequisites or required research.
  • Building Costs & Times: Displays exact requirements and duration for the next upgrade level.
• Modular Architecture: Cleanly separated frontend (JS/CSS) and backend (Python/Flask) for easy maintenance.
• Greek Localization: Fully localized unit and building names.

🏗 System Architecture

The project consists of three main parts:

1. Tampermonkey Script (GrepolisRemoteControl.user.js):
   • The "Worker" that runs inside your Grepolis browser tab.
   • Scrapes game state (ITowns, GameData) and pushes it to the relay server.
   • Polls the relay for pending commands and executes them using in-game AJAX calls.
2. Relay Server (Python/Flask):
   • app.py: Entry point and CORS configuration.
   • db.py: SQLite database management for storing town states and command history.
   • routes/: API endpoints for state synchronization and dashboard data.
3. Dashboard (HTML/JS/CSS):
   • templates/dashboard.html: The main interface structure.
   • /static/js/: Modular logic split into State, API, and UI Components (TownViewer, CommandForm, CommandLog).

🛠 Setup & Installation

1. Backend Setup

Ensure you have Python 3.x installed.

pip install -r requirements.txt
python app.py

By default, the server runs on http://localhost:5050 (or your configured domain).

2. Userscript Setup

1. Open Tampermonkey in your browser.
2. Create a new script and paste the contents of GrepolisRemoteControl.user.js.
3. Update the BASE_URL constant (line 17) to point to your relay server.
4. Save and refresh your Grepolis tab.

🕹 How to Use

1. Check Connectivity: Open the Dashboard. Look for the "● Server" and "● Script" indicators in the top right. Both should be green.
2. Select a Town: Click a town from the left sidebar to view detailed resources, buildings, and current build queue.
3. Issue a Command:
   • Select Build or Recruit from the dropdown.
   • Choose the target (Building or Unit).
   • If resources are lacking, the system will ask for confirmation to add it to the wait-list.
   • If dependencies are missing, a red warning will prevent submission.
4. Monitor the Log: View the status of your commands (Pending, Executing, Done, or Failed) in the bottom log panel.

⚠️ Disclaimer

This is an automation tool. Using scripts like this may violate the game's Terms of Service. Use responsibly and at your own risk.

---

Created with ❤️ for Grepolis players. . .