Inline API attributes for certain messages

  • Currently, if tools like OGame Infinity or my OGame Tracker want to extract data from messages like expedition results, result of lifeform discovery missions, or desbris field harvest reports, they need to have a complete list of messages for each supported language and message.

    This requires a lot of effort for the developer(s) and the community every time new messages are added. Even after few years, there are still several expedition messages missing in Infinity or the Tracker, and still a lot of messages for the relatively new lifeform discovery messages are not known to tools.


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


    To allow for easier and language/localization independent tool development I propose the following API for messages:

    I propose inline HTML attributes similar to the attributes for the buildings, ships, etc. which already provide information like technology ID, progress, passed and total building time, or the current level/amount.

    These new attributes for the messages should include information like the date, type of the result, size of the result (if available/applicable), as well as the specific findings.

    If possible, it would also be great to include the unscaled finding values for resources or ships found on expeditions,such that the unscaled values don't include factors like the resource-dependend scaling, the scaling depending on the best player's score, the Pathfinder, the player class, economy speed of the server, and the several bonuses from lifeform researches.


    What could this API look like?

    I will now give several examples for what this API could look like for several message types.

    The individual used factors are:

    - Pathfinder used (x2)

    - Discoverer player class (x1.5)

    - Economy speed (x8)

    - 0.2% lifeform research bonus to resource, fleet, and dark matter findings (x1.002)

    - best player >= 100 million points


    The new attributes should both a available in both the message overview as well as the detailed message view (dialog).


    1. Expeditions:

    a) Small resource finding:

    b) Huge fleet finding:

    c) Medium dark matter finding


    2. Lifeform Discovery Missions

    a) Exploration ship was lost


    b) Lifeform found

    c) Small finding of artifacts


    3. Debris field harvest report