Skip to content

README.md

Latest commit

 

History

History
92 lines (66 loc) · 4.61 KB

README.md

File metadata and controls

92 lines (66 loc) · 4.61 KB
Raw

OpenFrontIO-TroopTiming

OpenFrontIO-TroopTiming Logo

English · Türkçe

⚠️ Disclaimer: This script may or may not violate OpenFront.io's Terms of Service. This script is for educational purposes and does not automate any actions — it only visualizes existing game data. The author is not responsible for any issues, damages, or consequences arising from the use of this script (including account bans). Use at your own risk.

✅ Official Developer Clarification

The developer of OpenFront.io, Evan (u/OpenFrontOfficial), reviewed this script and confirmed it is allowed under his policy:

"Our policy on extensions: they're allowed only if they provide or enhance information. They cannot take actions on behalf of the player. So this one is fine."

  • Source: Reddit comment thread
  • This script fully complies with the policy: it only visualizes existing game data and takes no actions on the player's behalf.

📸 Official Response Screenshot

OpenFront.io developer Evan confirms this script is allowed

A userscript that adds a real-time troop timing overlay to OpenFront.io. Requires a userscript extension such as Tampermonkey, Greasemonkey, or Violentmonkey. ✨

🚀 Features

  • 🎯 Troop Timing Overlay — Real-time troop bar overlay with color-coded strategy indicator
  • 📊 Gradient bar showing troop percentage (0%–100%)
  • ✨ Animated marker with smooth transitions
  • 🎨 Color-coded strategy icons (star/checkmark/clock) based on troop ratio
  • 🏷️ Troop badge override with matching colors
  • 🔄 Falls back to DOM scraping if the game API is unavailable

📸 Screenshots

Troop Timing Overlay - Low Troops    Troop Timing Overlay - High Troops

🛠️ Installation

  1. Install a userscript extension in your browser:
  1. Install the script:

📥 Install Script · 📥 Install from GreasyFork · 📥 Install from OpenUserJS

Or copy the contents of OpenFrontIO-TroopTiming.user.js into a new userscript.

  1. Navigate to openfront.io or nightly.openfront.dev — the overlay will appear automatically on game pages 🎮

📁 Repository Structure

OpenFrontIO-TroopTiming/
├── README.md # This file (English) 🇬🇧
├── README.tr.md # Turkish version 🇹🇷
├── AGENTS.md # AI agent knowledge base 🤖
├── .gitignore
├── OpenFrontIO-TroopTiming.user.js # Userscript (Tampermonkey/Greasemonkey)
├── assets/ # Project logos and screenshots 🖼️
│   ├── TroopTimingBackground.svg
│   ├── TroopTimingNoBackground.svg
│   ├── TroopTiming1.png
│   ├── TroopTiming2.png
│   └── DeveloperAnswered.png
└── colors/ # Material Design 3 color schemes 🎨

💻 Development

The script is a single self-contained JavaScript file. No build step required. ⚡

To modify:

  1. Edit OpenFrontIO-TroopTiming.user.js
  2. In Tampermonkey, click the script icon → Edit
  3. Or reinstall from the file

📜 License

Source code is licensed under MIT. ⚖️