GB-ADB - Goldberg Achievement Database

THIS REPOS IS JUST A "DEMO" VERSION! THE FULL REPO WILL BE TOO LARGE(32GB+) TO HOST IT ON GITHUB, SO WHEN I DID FINISHED THE WHOLE THING, THE WHOLE DATABASE WILL BE AVAILABLE FOR SEPARATE DOWNLOADING! UNTIL THEN THIS IS A DEMO WITH MORE THAN 15k GAMES IN DATABASE!!

A comprehensive, automated database of Steam achievements formatted specifically for the Goldberg Emulator (GBE2 fork). This project aims to bridge the gap for titles missing achievement schemas in the Goldberg V2 format.

🔗 Access the Live Database here: https://0p3n50urc3-f0r3v3r.github.io/GB-ADB/

---

🚀 Features

• Massive Library: Currently indexing Thousands of games - UPDATING ON DAYILY BASIS with a target of covering the entire Steam catalog.
• Plug & Play: Achievement schemas are provided in the exact folder structure required by the emulator.
• Multi-Search: Advanced search bar supporting Steam AppID or Game Name. Capable to search more titles at once.
• Automated Updates: Data is continuously scraped and verified using a custom Python-based mining tool.
• Detailed Stats: Tracks total game count and database status in real-time.

---

📂 Data Structure

Each download provides the necessary files for the Goldberg Emulator:

• achievements.json: Full achievement list with localized strings.
• stats.json: Internal game statistics tracking.
• achievement_images/: Local repository of all icons (colorful and grayscale).
• steam_appid.txt & force_language.txt: Pre-configured settings files.

---

🛠️ Usage / Installation

THIS IS JUST A SAMPLE! EVERY GAME USES DIFFERENT FOLDER STRUCTURE! YOU NEED TO BE CREATIVE! XD

To add achievements to your game using the Goldberg Emulator (GBE2), follow these steps:

1. Locate your game folder: Find the directory where the game's executable (.exe) is located.
2. Download the schema: Search for your game in the GADB Web Interface and download the provided folder.(If Any)
3. Copy the files: * Navigate to the folder where steam_api64.dll (or steam_api.dll) is found.
   • Create a folder named steam_settings if it doesn't exist.
   • Place the achievements.json, stats.json, and the achievement_images folder inside the steam_settings directory.
   • EDIT force_language.txt to "English" -> Without quotes! Or just simply remove force_language.txt!!
4. Final Structure: Your game folder should look like this:

   YourGame/
   ├── Game.exe
   ├── steam_api64.dll
   └── steam_settings/
       ├── achievements.json
       ├── stats.json
       ├── steam_appid.txt
       └── achievement_images/
           ├── ACH_01.jpg
           └── ...
   
   

---

⚠️ Compatibility

Important

This project is designed STRICTLY for the Goldberg Emulator V2 (GBE2 fork). These files will NOT work with older versions of the Goldberg emulator due to the structural changes in how achievements are handled.

Important

SOME ACHIEVEMENTS ARE IN OTHER LANGUAGE! THOSE WILL BE CHANGED IN THE FUTURE!

---

🛠️ Technical Background

The database is generated by a custom Python scraper that:

1. Iterates through Steam AppIDs.
2. Fetches game metadata and achievement schemas via Steam API.
3. Sanitizes and formats data into the Goldberg-specific JSON structure.
4. Downloads and optimizes achievement icons locally.
5. THE DATABASE NOT COMPLETE YET! CONTINOUSLY BEING UPDATED! IF YOU CANNOT NOT FIND A GAME, IT JUST MOST PROBABLY NOT IN THE DATABASE YET!
6. THERE IS NO GUARANTEE THAT ANY OF THE ACHIEVEMEWNTS WILL WORK CORRECTLY!! THIS IS JUST A CONVERTED DATABASE! BUT IT DOES WORKS FOR AT LEAST AROUND 80-90%.
7. ACHIEVEMENTS ON OTHER LANGUAGES WILL BE CORRECTED IN THE FUTURE. (IT'S ABOUT 2% OF THE GAMES ARE CONCERNED ONLY.)
8. "Unknown games" will be scraped and fixed, once the whole database had been scraped. Until then, rely on appid!

---

⚖️ Disclaimer

This database is provided "as-is" for the community. Achievements are sourced from public APIs; their functionality depends entirely on the emulator's implementation and the specific game's engine.

Created for the community. 2026 GB-ADB Project.