OValue Exporter

  • OValue Exporter



    TOOL INFORMATION

    ----------------


    Tool Name: OValue Exporter


    Current Version: 3.3.4


    Author / Team: Galax (nicolagalassi)


    Website / Repository:

    Web app: https://ovalue.net

    Source code: https://github.com/nicolagalassi/ovalue


    Support / Contact: https://github.com/nicolagalassi/ovalue/issues


    License: MIT


    Download Link: https://greasyfork.org/scripts/574448-ovalue-exporter



    TOOL CLASSIFICATION

    -------------------


    Userscript (Tampermonkey / Violentmonkey / Greasemonkey)



    BROWSER / PLATFORM COMPATIBILITY

    ---------------------------------


    Supported Browsers / Platforms:

    - Google Chrome (with Tampermonkey)

    - Mozilla Firefox (with Tampermonkey or Greasemonkey)

    - Microsoft Edge (with Tampermonkey)

    - Safari (with Userscripts or similar extension)


    Minimum Version Requirements:

    - Any modern browser



    SUPPORTED OGAME LANGUAGES / COMMUNITIES

    ----------------------------------------


    Currently fully supported: Italian (it), English (en), German (de), French (fr)



    TOOL DESCRIPTION

    ----------------


    OValue Exporter is a userscript that collects empire production data from OGame

    and synchronizes it with the OValue web application (ovalue.net), a suite of

    calculators for mine production optimization, resource pack planning, and shop

    item management.


    The script reads data passively as the user navigates standard OGame pages —

    no automated page requests, no gameplay interaction. Collected data is stored

    locally in Tampermonkey's secure storage and transferred to OValue exclusively

    via the browser's localStorage API when the user visits ovalue.net. No data is

    ever sent to external servers.



    COMPLETE FEATURE LIST

    ---------------------


    Data Collection:

    [+] Mine level extraction per planet (Metal Mine, Crystal Mine, Deuterium Synthesizer)

    [+] Planet position and coordinates detection

    [+] Planet name extraction from sidebar and empire page

    [+] Lifeform type detection per planet (Humans, Rock'tal, Mechas, Kaelesh)

    [+] Lifeform-specific building levels (High Energy Smelting / Magma Forge)

    [+] Crawler count per planet

    [+] Per-planet active item detection (Bronze/Silver/Gold/Platinum metal amplifiers)

    [+] Custom resource amplifier percentage detection

    [+] Plasma technology level from Empire page

    [+] Economy speed from universe API endpoint

    [+] Universe name from universe API endpoint

    [+] Player class detection (Collector / General / Explorer)

    [+] Officer status tracking: active/inactive + remaining time with expiration

    (Commander, Admiral, Engineer, Geologist, Technocrat)

    [+] Lifeform bonus collection (Metal production bonus, Class bonus)

    [+] Global item detection with expiration times

    (Expedition Slots, Fleet Slots, etc.) — permanent items excluded

    [+] Multi-server support with separate data storage per server hostname


    Synchronization:

    [+] Automatic bridge synchronization: when user visits ovalue.net, collected

    data is transferred to the web app via localStorage and a custom DOM event

    [+] Manual export to clipboard (JSON format) for manual import into OValue

    [+] Data persistence across sessions using Tampermonkey GM_setValue/GM_getValue


    In-page Panel:

    [+] Non-intrusive floating panel added to OGame navigation

    [+] Step-by-step collection status for each required page

    (Overview, LifeForm Bonuses, Empire)

    [+] Visual indicators showing which data has been collected and what is missing

    [+] Officer status display with remaining time

    [+] Planet and lifeform summary

    [+] Active global items list

    [+] Cache reset functionality per universe

    [+] Panel visibility state persisted across page loads


    Internationalization:

    [+] Panel UI available in Italian, English, German, and French

    [+] Language auto-detected from OGame interface content

    [+] Language preference synchronized from OValue web app settings via bridge


    API USAGE

    ---------


    Yes, the script uses two OGame endpoints:


    Endpoint: /api/serverData.xml

    Purpose: Fetch universe name and economy speed

    Trigger: Once per page load on Overview, only if not already cached


    Endpoint: ?page=standalone&component=empire

    Purpose: Read mine levels, planets, crawler counts, active items

    Trigger: Only when user manually navigates to the Empire page


    Expected request frequency:

    - /api/serverData.xml: at most once per Overview page load, skipped if cached

    - Empire page: passive read only when user navigates there manually


    The script never initiates page navigations or automated requests.

    It only reads the DOM of pages the user visits during normal gameplay.



    UI MODIFICATIONS

    ----------------


    The script makes the following additions to the OGame interface:


    1. Navigation menu entry:

    A new "OValue" item is appended to the left sidebar navigation (#menuTable),

    styled to match the existing menu. Clicking it toggles the data panel.


    2. Floating data panel:

    A panel positioned to the left of the game sidebar, containing collection

    status, officer summary, planet list, and action buttons.

    The panel does not overlap or modify any existing OGame UI elements.


    No existing OGame interface elements are modified, hidden, or replaced.



    DATA HANDLING / PRIVACY

    ------------------------


    - Local storage only: all empire data is stored in Tampermonkey's sandboxed

    GM_setValue storage, accessible only to this script.


    - No external server communication: data transfer to OValue happens exclusively

    via localStorage and a browser DOM event when the user actively navigates

    to ovalue.net.


    - No analytics or telemetry: the script contains no tracking, logging, or

    analytics of any kind.


    - No user credentials collected: the script reads only game production data

    visible on standard OGame pages.


    - No data persistence beyond local storage: clearing Tampermonkey storage or

    using the in-panel "Reset" button permanently deletes all collected data.



    SOURCE AVAILABILITY

    -------------------


    Open Source — MIT License

    Full source: https://github.com/nicolagalas…Value_Exporter_v3.user.js



    CHANGELOG

    ---------


    Version 3.3.4

    Removed: permanent items are no longer exported or shown in the expiration tracker


    Version 3.3.3

    Added: automatic OGame display language detection from page content

    (officer tooltip keywords, navigation text)

    Added: detected language persisted via GM_setValue for consistency across pages


    Version 3.3.2

    Fixed: duration parsing now handles English short format (7w 3d 8h 46m 30s)

    Fixed: added support for w (weeks), d (days), j (French days), t (German days)



    COMPLIANCE DECLARATION

    -----------------------


    I confirm that this tool:


    - Does not automate gameplay

    - Does not provide forbidden functionality

    - Does not exceed permitted API usage

    (one passive read of /api/serverData.xml per Overview page visit)

    - Complies with all current OGame Origin tool guidelines

  • RiV-

    Approved the thread.