Differences between revisions 1 and 22 (spanning 21 versions)
Revision 1 as of 2006-08-29 22:01:53
Size: 875
Editor: EddyPetrisor
Comment: initial page for DataLoader
Revision 22 as of 2015-11-01 19:43:34
Size: 3935
Comment: add link to http://thefloppydisk.com/
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
''This page is incomplete, please add the relevant information which you see fit.'' ## page was renamed from Games/Development/DataLoader
Line 3: Line 3:
= Goals = ~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: English - [[fr/Games/GameDataPackager|Français]] -~
----
Line 5: Line 6:
The [wiki:Self:Games/Development/DataLoader DataLoader] project has as goals the following:
 * provide a way to make the package management aware of non-official packages so the game can depend on them
  * non-free data files (e.g.: quake3 data-files)
  * local data files (e.g.: Ooilte OXP packages)
 * create some meta-packages for the unofficial packages which, if uninstalled will remove all the files installed unofficially
Various games are divided into two logical parts: engine
and data. Often the engine and data are licenced in
different ways, such that only one half can be distributed
in Debian.
Line 11: Line 11:
The non-official packages could be created from tarballs fetched from:
 * http servers
 * ftp servers
 * local filesystem
 * CD-s
There have been some successful projects to replace the non-free part
(mostly the game data):
 * [[https://packages.debian.org/sid/freedoom|FreeDoom]] that can replace Doom 1 & 2; with this you can even play fan-made levels designed for the original game, like the [[http://doomwiki.org/wiki/Compet-n|Compet-n]] levels that can be automatically downloaded/packaged/installed by {{{game-data-packager}}}
 * The [[https://packages.debian.org/sid/openttd-opengfx|OpenTTD]] project comes with an optional graphics set that can replace the original Transport Tycoon Deluxe game. Users owning the original game may prefer to use the original graphics and this is supported by {{{game-data-packager}}}.
 * [[Games/LGeneral|LGeneral]] has it's own wiki page that explains how it can also use Panzer General assets.
 
----
Line 17: Line 19:
{{{game-data-packager}}} is a tool which builds .deb files for game
data which cannot be distributed in Debian (such as
commercial game data).
Line 18: Line 23:
= Examples/Prior work = {{{game-data-packager}}} aims to support all games of any kind: FPS, adventure games, text games, strategy games,... in all available languages.
Line 20: Line 25:
 * make-wad-package script from the doom-package in [http://debian.halfcoded.net/source/ Jon Dowland's apt repo]
 * [http://packages.debian.org/java-package java-package]
Using this tool has several advantages over managing game-assets by hand:
 * it does a lot of things automatically:
  * it create an individual meny entry (.desktop file) for ScummVM games, Doom WADS
  * it provide user language autodetection at package and/or runtime
  * it will find data in your [[Steam]] folder (both native or under Wine; or even on some mounted NTFS/VFAT device)
 * each needed file is verified with a checksum to ensure it will work
 * G-D-P will store the data where the game engine expect those, in accordance with this engine's maintainer (e.g.: some specific directory under /usr/share/games)
 * G-D-P will know which Debian-provided extractor to use to unpack .exe dos/windows (self-)extracting archives (e.g.: innoextract, 7z, lha, rar, ace, arj, unshield, cabextract ...)
 * some commercial website now provide some .deb's files too, but those:
  * may include some outdated version of the free game engine, games packaged with G-D-P will always use the latest version of the engine

  * doesn't try to follow Debian quality standards

  * are allways i386/amd64 packages while packages built by G-D-P are 'all' packages that can also be used on ARM devices for example.

 * The game you've bought on Steam is now available to all users of this computer; not only the one running the Steam client. You can let your child play games without cheating the 13 years rule or worrying about the online-chat feature.

Here is a [[http://pkg-games.alioth.debian.org/game-data/|list of all games]] supported by the version in git. To see which games are supported by the version currently installed on your computer, simply type {{{game-data-packager}}} at the shell.

If you want to help on improving this this tool, please have look a the [[Games/GameDataPackager/Development|worklist]] .

== External links ==

 * [[http://bugs.debian.org/game-data-packager|BTS]]: G-D-P on the Bug Tracker System
 * [[https://tracker.debian.org/pkg/game-data-packager|PTS]]: G-D-P on the Package Tracker System
 * [[http://pkg-games.alioth.debian.org/game-data/|list of all supported games]]
 * [[https://steamcommunity.com/groups/debian_gdp#curation|list of games sold by Steam]]
 * [[https://www.gog.com/mix/games_supported_by_debians_gamedatapackager|list of games sold at GOG.com]]
 * [[http://thefloppydisk.com/collection.php|http://thefloppydisk.com]]: a nice website with pictures of original media & CD count

Translation(s): English - Français


Various games are divided into two logical parts: engine and data. Often the engine and data are licenced in different ways, such that only one half can be distributed in Debian.

There have been some successful projects to replace the non-free part (mostly the game data):

  • FreeDoom that can replace Doom 1 & 2; with this you can even play fan-made levels designed for the original game, like the Compet-n levels that can be automatically downloaded/packaged/installed by game-data-packager

  • The OpenTTD project comes with an optional graphics set that can replace the original Transport Tycoon Deluxe game. Users owning the original game may prefer to use the original graphics and this is supported by game-data-packager.

  • LGeneral has it's own wiki page that explains how it can also use Panzer General assets.


game-data-packager is a tool which builds .deb files for game data which cannot be distributed in Debian (such as commercial game data).

game-data-packager aims to support all games of any kind: FPS, adventure games, text games, strategy games,... in all available languages.

Using this tool has several advantages over managing game-assets by hand:

  • it does a lot of things automatically:
    • it create an individual meny entry (.desktop file) for ScummVM games, Doom WADS
    • it provide user language autodetection at package and/or runtime
    • it will find data in your Steam folder (both native or under Wine; or even on some mounted NTFS/VFAT device)

  • each needed file is verified with a checksum to ensure it will work
  • G-D-P will store the data where the game engine expect those, in accordance with this engine's maintainer (e.g.: some specific directory under /usr/share/games)
  • G-D-P will know which Debian-provided extractor to use to unpack .exe dos/windows (self-)extracting archives (e.g.: innoextract, 7z, lha, rar, ace, arj, unshield, cabextract ...)
  • some commercial website now provide some .deb's files too, but those:
    • may include some outdated version of the free game engine, games packaged with G-D-P will always use the latest version of the engine
    • doesn't try to follow Debian quality standards
    • are allways i386/amd64 packages while packages built by G-D-P are 'all' packages that can also be used on ARM devices for example.
  • The game you've bought on Steam is now available to all users of this computer; not only the one running the Steam client. You can let your child play games without cheating the 13 years rule or worrying about the online-chat feature.

Here is a list of all games supported by the version in git. To see which games are supported by the version currently installed on your computer, simply type game-data-packager at the shell.

If you want to help on improving this this tool, please have look a the worklist .