#openttdcoop archive

Designdocument for Autodownload

Eine aktuelle Version des Dokuments findet sich im development repository: http://trac.openttdcoop.org/wiki/giraffe

Diese Version ist hier nur aus historischen Gründen ;)


Autodownload is an envisioned feature of OpenTTD which allows a client to connect to a database (which is topic of this site) and query for the grfs stored in it. When selected for playing the newest version of that grf is downloaded. By comparison of the MD5 sums the appropriate version can be downloaded when connecting to a multiplayer server or loading a savegame. GRFs uploaded to this server must be free to be distributed. This is acknowledged explicitly upon upload by the authors who are the only ones who may upload grfs.

Grfs may be queried by two methods automatically: - unique ID (for single player: update local grf files) - MD5 sum (for multiplayer purposes)


Database desgin

Features of each GRF:

  • GRFs sequential version number (set by author upon upload: major + minor version)
  • GRF file
  • GRF category as grf crawler / #openttdcoop grfpack: other / landscape / infrastructure / industries / town_buildings / stations / vehicles / last
  • author(s) list
  • supplied readme
  • obsolete yes/no
  • owner(s): <authors identified by name>
  • GRF name (automatically extracted from the file)
  • unique grf ID (automatically extracted from file) - 4 bytes
  • date of upload / publication date (automatically)
  • MD5 sum (automatically extracted from file)


Authors can

  • Create a new grf entry (a new unique grf ID)
  • update an existing grf entry:
    • upload new grf file (pre-requisite: same unique ID)
    • change the name of the grf
    • change the category of the grf
    • update a new readme
    • mark the entry obsolet:
      • won't show anymore in list of available grf, if queried by unique ID
      • points to grf which superseeds this (if applicable)


Features available to Admins / moderators (to be decided who does what)

  • Create / modify / delete accounts
  • modify database entries
  • change ownership of grfs
  • change terms of upload / license conditions.


User records:

  • Name (unique)
  • E-Mail address
  • admin / member / moderator
  • password


Client Interface:

  • Query grf by MD5 (any version of any grf for MP games)
  • Query "update local grfs": Query by unique ID


Webinterface: shows only non-obsolete grfs, newest versions

  • Browsing of repository:
    • Browse grfs by category
    • Browse grfs by submission date (change log)
    • Browse grfs by author
  • Search the database:
    • Search by name
    • Search by unique ID
    • Search by MD5 sum