{"id":18425765,"url":"https://github.com/faforever/unitdb","last_synced_at":"2025-10-19T02:43:46.358Z","repository":{"id":30069173,"uuid":"117902959","full_name":"FAForever/UnitDB","owner":"FAForever","description":null,"archived":false,"fork":false,"pushed_at":"2024-08-11T07:35:12.000Z","size":59588,"stargazers_count":1,"open_issues_count":2,"forks_count":6,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-11T14:05:31.159Z","etag":null,"topics":["database","game-files","units","webpage"],"latest_commit_sha":null,"homepage":"https://unitdb.faforever.com","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FAForever.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-01-17T22:58:22.000Z","updated_at":"2024-08-11T07:32:46.000Z","dependencies_parsed_at":"2024-08-10T14:01:52.828Z","dependency_job_id":"d4ff2c60-b2e0-49d2-b817-10eb0d80ac4c","html_url":"https://github.com/FAForever/UnitDB","commit_stats":null,"previous_names":[],"tags_count":37,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FAForever%2FUnitDB","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FAForever%2FUnitDB/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FAForever%2FUnitDB/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FAForever%2FUnitDB/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FAForever","download_url":"https://codeload.github.com/FAForever/UnitDB/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223286474,"owners_count":17120000,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","game-files","units","webpage"],"created_at":"2024-11-06T05:05:29.716Z","updated_at":"2025-10-19T02:43:41.316Z","avatar_url":"https://github.com/FAForever.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SCFA/FAF Unit List\r\nThis project aims to create a webpage that can load dynamically Supreme Commander's unit list and display them all with their own stats.\r\nAt the moment (17/01/2018), two other databases exist :\r\n- The \"official\" one, which is very old and outdated.\r\n- [Spooky's database](https://github.com/spooky/unitdb), up to date, but I personally don't like the layout of it. \r\nSo I've made my own !\r\n\r\n### Prerequisites\r\n\r\nWhat things you need to run the webpage :\r\n\r\n####    Serverside :\r\n```\r\nApache2 [but nginx works probably too)\r\nPHP 5.6 or 7\r\n```\r\nIf you have a LAMP server, it's more than enough.\r\n\r\nFor up-to-date unit data you will have to provide your own data (game files .scd or .nx2). More info in the \"Installing\" part of this readme.\r\n\r\n####     Clientside :\r\n\r\nAny browser capable of rendering HTML5 and executing basic javascript.\r\nTested with Vivaldi, Firefox and with Chrome.\r\n\r\nFirefox kind of lags a bit due to the huge amount of elements on the page : disabling previews in the settings can help reducing lag on some browser.\r\n\r\n### Installing\r\n\r\nFirst download all the files and put them in your server's folder. \r\nWith a LAMP server it'll be something like :\r\n```\r\n/var/www/html\r\n```\r\nYou can put them pretty much wherever you want, as most of the code uses relative paths.\r\n\r\nOnce you've done that, you can edit the `config/datafiles.json` file to link the database to the game files. By default, the game is linked to .3599 files in the `data/gamedata` folder. You can add more files in the list, and they will be loaded in the order specified. Two things to note here :\r\n* Keep in mind that uncompressing data and analyzing it will be done in PHP, therefore these operations must not take more than *120 seconds* combined : else it will break and exit before writing any change. \r\n* You should always keep the .3599 file to be loaded somewhere (in first) as it is very complete, and if the data you load after it lacks unit, the unitDB will fall back to 3599 files. If you don't mount these files before anything else, stuff will probably be missing. \r\n\r\n`config/locfiles.json` works the same way, but for localization files (.scd).\r\n\r\nOnce you're done editing and tweaking stuff, run `update.php` in your browser (or `update.php?debug=1) and everything should be fine.\r\n\r\n## Authors\r\n\r\n* [rackover@racknet.noip.me](https://github.com/Rackover)\r\n\r\nThanks to :\r\n* biass \u0026 to amelieUntitle  for their design tips, even if I didn't follow much (sorry!)\r\n* AchievedJaguar8, \r\n  JaggedAppliance, \r\n  PhilipJFry, \r\n  dm, \r\n  speed2, \r\n  JJ, \r\n  Exotic-retard, \r\n  Petric, \r\n  MrShiny1,\r\n  Apofenas,\r\n  and Zook for general help and feedback\r\n\r\n## License\r\n\r\nThis project is licensed under the Beerware license. See the [LICENSE](LICENSE) file for more details.\r\n\r\n## Acknowledgments\r\n\r\n* All the code for this one db has been made from scratch using nothing more than my bare hands : no code have been taken neither from  [Spooky's DB](https://github.com/spooky/unitdb), nor from the *official* unitDB.\r\n* All the sprites and logos and fonts used in this project either come directly from the game files, or are vanilla Windows fonts (except for the FA Forever logo, used as a favicon).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaforever%2Funitdb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffaforever%2Funitdb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaforever%2Funitdb/lists"}