Tool Information
Tool Name: TopExpéRaidMine (TERM)
Current Version: 1.1.0
Author / Team: Loryan (solo developer)
Website / Repository: https://topexpraid-ter-production.up.railway.app/
Support / Contact: Via the Contact / Feedback tab directly in the tool
License: Closed Source — source available to reviewers upon request
Download Link: N/A (hosted web application)
Tool Classification
✅ Web Tool
Browser / Platform Compatibility
Supported Browsers / Platforms: All modern browsers (Chrome, Firefox, Edge, Safari) — desktop and mobile Minimum Version Requirements: ES2020 compatible browser
Supported OGame Languages / Communities
Currently focused on the French community (fr), with multi-community support in progress. The combat report converter already handles community-based ship ID mapping (fr, en, de, etc.) to always display ship names in the user's language. All tool interfaces are available in French, with this submission provided in English for review purposes.
Tool Description
TopExpéRaidMine (TERM) is a community statistics and analysis platform for OGame players. It allows players to track, compare and visualise their expedition, raid and mining performance across universes, with community leaderboards, personal account synthesis, lifeform technology rankings, and a combat report converter.
Complete Feature List
✅ Top Expé — Community leaderboard for expeditions (USM, resources, antimatter, ships found). Filterable by universe, economic speed, period and metric. Normalised to ×10 for fair cross-universe comparison.
✅ Top Raid — Community leaderboard for raids (loot, losses, debris recovered, net USM). Debris correctly integrated into profitability calculation.
✅ Top Mine — Community leaderboard for daily production (USM snapshot from OGame Tracker export).
✅ Top Tech — Community leaderboard for research technology levels and invested points, by category (Fundamental, Propulsion, Advanced, Combat).
✅ Top FDV (Lifeforms) — Community leaderboard for Lifeform technology levels, invested points and real bonus percentages (Metal, Crystal, Deuterium, Expedition Resources, Ships, Explorer Boost), by functional category (Prod, Expé, Fret, Speed Research, Research, Buildings, Ships, Other).
✅ Records — Community records on all metrics across Top Expé, Top Raid, Top Mine, Top Tech and Top FDV sections.
✅ Account Synthesis — Personal account graphs: production progression, net ships found, metal/crystal/deuterium breakdown, building and research levels, lifeform technology levels.
✅ Points Synthesis — Detailed points breakdown per category (mines, buildings, research, lifeform technologies) with USM calculation.
✅ Combat Report Converter — Loads a combat report via OGame API key (using community proxy ogapi.faw-kes.de), displays full formatted report (fleets before/after, result, loot, debris, attacker/defender summary with profitability), generates BBCode for forum posting, and creates a shareable public link accessible without an account.
✅ OGLight Merger — Client-side tool to merge multiple OGLight JSON exports (pinned players union, player database merge, statistics merge). Zero server-side storage.
✅ Admin navigation visibility panel — Administrators can show/hide any section or sub-tab for non-admin users.
✅ Universe management — Administrators can ignore specific universes from all leaderboards.
✅ Account creation, login, public/private snapshot visibility — Each user controls whether their data appears in community rankings
❌ No gameplay automation ❌ No UI injection into OGame ❌ No automatic data collection from OGame
API Usage
Yes — one external API is used:
Endpoint: https://ogapi.faw-kes.de/v1/report/<full_cr_string>/1
Usage: Combat report converter only (admin-restricted feature, triggered manually by user action)
Expected request frequency: On-demand only, maximum a few requests per hour per user
No private API key is used — the community proxy is used as recommended.
The tool also uses OGame's public XML API (localization.xml) for ship name localisation per community, cached for 24 hours server-side.
UI Modifications
This is a standalone web application — it does not inject into or modify the OGame game interface in any way.
Screenshots / Demo
Live demo: https://topexpraid-ter-production.up.railway.app/ (Account creation required to access leaderboards and personal features)
Installation Instructions
No installation required. Access via browser at: https://topexpraid-ter-production.up.railway.app/
- Create an account
- Import your OGLight or OGame Infinity export for expeditions and raids
- Import your OGame Tracker export for mining leaderboard and account synthesis
- Your data is added to community leaderboards
Data Handling / Privacy
- User accounts are stored server-side (pseudonym, hashed password)
- OGame Tracker exports are stored server-side compressed (gzip), linked to the user account, and used solely for leaderboard and synthesis calculation
- OGLight exports used in the merger tool are never sent to the server — all processing is client-side only
- No analytics, no telemetry, no third-party tracking
- No advertising
- Users can set their snapshots to Private at any time, removing them from community leaderboards while keeping personal synthesis
- Users can delete their snapshots at any time
Source Availability
Closed Source — unminified source code available to reviewers upon request.
Changelog
Version 1.1.0
- Added: Top Tech section (research leaderboard + points synthesis)
- Added: Top FDV section (lifeform technology leaderboard + real bonus percentages)
- Added: Top Tech and Top FDV records
- Added: Combat Report Converter (via ogapi.faw-kes.de proxy, BBCode export, public shareable link, customisable skins per user)
- Added: OGLight Merger tool (client-side, no server storage)
- Added: Admin navigation visibility panel (show/hide sections per user role)
- Added: Universe ignore feature in admin
- Changed: Records reorganised — lifeform buildings and tech moved from Top Mine to Top FDV records
Version 1.0.0
- Initial release: Top Expé, Top Raid, Top Mine, Records, Account Synthesis
Compliance Declaration
I confirm that this tool:
- ✅ Does not automate gameplay
- ✅ Does not provide forbidden functionality
- ✅ Does not exceed permitted API usage
- ✅ Complies with all current OGame Origin tool guidelines
- ✅ Uses only the community proxy (ogapi.faw-kes.de) for API access, as recommended
Current limitation and API key request:
The combat report converter currently uses the community proxy (ogapi.faw-kes.de) as recommended. However, the JSON response provided by this proxy does not include per-round fleet composition data (i.e. the state of each fleet after each combat round). As a result, it is currently impossible to determine:
- The exact number of ships destroyed per player during the battle
- The surviving fleet of each participant after combat
- Whether a defender was fully destroyed or still has ships remaining
This information is present in the full combat report response available via a private API key, which includes detailed round-by-round data. Without it, the converter can display the initial fleets, loot, debris and summary statistics, but cannot render a complete "after battle" fleet breakdown as tools like OGotcha or OGameDB do.
For this reason, I am also submitting this as an API key request, in accordance with the procedure described at: API Access Applications – Required Procedure (Updated)
Working demo using the community proxy: https://topexpraid-ter-production.up.railway.app/ (admin account required to access the combat report converter because still in development)
Loryan (Lor)
