{"id":31183786,"url":"https://github.com/jonathanxdr/tkkg","last_synced_at":"2025-09-19T18:18:11.023Z","repository":{"id":305901335,"uuid":"833280377","full_name":"JonathanXDR/TKKG","owner":"JonathanXDR","description":"A complete guide for playing classic TKKG adventure games on modern macOS.","archived":false,"fork":false,"pushed_at":"2025-07-22T15:12:18.000Z","size":62077,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-09T01:24:26.569Z","etag":null,"topics":["adventure","classic","games","guide","macos","tkkg","utm","vintage"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JonathanXDR.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2024-07-24T17:59:34.000Z","updated_at":"2025-07-22T15:12:22.000Z","dependencies_parsed_at":"2025-07-22T16:36:05.538Z","dependency_job_id":null,"html_url":"https://github.com/JonathanXDR/TKKG","commit_stats":null,"previous_names":["jonathanxdr/tkkg"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/JonathanXDR/TKKG","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonathanXDR%2FTKKG","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonathanXDR%2FTKKG/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonathanXDR%2FTKKG/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonathanXDR%2FTKKG/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JonathanXDR","download_url":"https://codeload.github.com/JonathanXDR/TKKG/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonathanXDR%2FTKKG/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275982090,"owners_count":25564143,"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","status":"online","status_checked_at":"2025-09-19T02:00:09.700Z","response_time":108,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["adventure","classic","games","guide","macos","tkkg","utm","vintage"],"created_at":"2025-09-19T18:18:09.393Z","updated_at":"2025-09-19T18:18:10.852Z","avatar_url":"https://github.com/JonathanXDR.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TKKG Games - Complete Setup and Access Guide\n\nThis comprehensive guide covers how to play the classic TKKG adventure games and access their data files. The TKKG series consists of 14 main games plus an additional Identikit tool, originally released for classic Mac systems. There are also two additional games that were released for Windows, but this guide focuses on the Mac versions.\n\n\u003e [!IMPORTANT]  \n\u003e This guide is specifically written for **macOS** as the host system. The tools used (UTM, The Unarchiver) and setup procedures are macOS-specific. Users on Windows or Linux will need to find alternative tools and may need to adapt the instructions accordingly.\n\n## Table of Contents\n\n- [Table of Contents](#table-of-contents)\n- [Playing the Games](#playing-the-games)\n- [Game Documentation and Manuals](#game-documentation-and-manuals)\n- [System Requirements](#system-requirements)\n- [Troubleshooting](#troubleshooting)\n- [Accessing Game Data (For Developers)](#accessing-game-data-for-developers)\n\n## Playing the Games\n\n### Step 1: Download the Games\n\nThe TKKG games were originally distributed on CD-ROM for classic Macintosh systems in the 1990s and early 2000s. These games are now preserved as disc images on the Macintosh Repository, a digital preservation archive for vintage Mac software.\n\n\u003e [!NOTE]  \n\u003e You'll need a free account on Macintosh Repository to download files larger than 100 MB. Each TKKG game exceeds this size limit, so account creation is mandatory.\n\n**Complete Game List:**\n\n- [TKKG 1: Jennifer is Missing](https://www.macintoshrepository.org/5387-tkkg-1-jennifer-is-missing)\n- [TKKG 2: Deadly Chocolate](https://www.macintoshrepository.org/4794-tkkg-2-deadly-chocolate)\n- [TKKG 3: The Mystery of the Mayan Treasure](https://www.macintoshrepository.org/3393-tkkg-3-the-mystery-of-the-mayan-treasure)\n- [TKKG 4: The Secret of Dragon Claw Manor](https://www.macintoshrepository.org/6174-tkkg-4-the-secret-of-dragon-claw-manor)\n- [TKKG 5: TKKG Betrayed](https://www.macintoshrepository.org/4717-tkkg-5-tkkg-betrayed)\n- [TKKG 6: The Forged Fifties](https://www.macintoshrepository.org/3430-tkkg-6-the-forged-fifties)\n- [TKKG 7: Fire!](https://www.macintoshrepository.org/4043-tkkg-7-fire-)\n- [TKKG 8: The Captain's Legacy](https://www.macintoshrepository.org/6187-tkkg-8-the-captain-s-legacy)\n- [TKKG 9: Voodoo Magic](https://www.macintoshrepository.org/5744-tkkg-9-voodoo-magic)\n- [TKKG 10: Panik im Internat](https://www.macintoshrepository.org/2997-tkkg-10-panik-im-internat)\n- [TKKG 11: Film ab!](https://www.macintoshrepository.org/3133-tkkg-11-film-ab-)\n- [TKKG 12: Alarm in der Geisterbahn](https://www.macintoshrepository.org/3884-tkkg-12-alarm-in-der-geisterbahn)\n- [TKKG 13: Zelle 13](https://www.macintoshrepository.org/5302-tkkg-13-zelle-13)\n- [TKKG 14: Gefährliche Ferien](https://www.macintoshrepository.org/3506-tkkg-14-gefahrliche-ferien)\n- [TKKG Identikit](https://www.macintoshrepository.org/4209-tkkg-identikit)\n\n\u003e [!TIP]\n\u003e Start with TKKG 1 if you're new to the series. The games follow a chronological storyline featuring the four main characters: Tim, Karl, Klösschen, and Gaby.\n\n### Step 2: Extract the Game Files\n\nThe games are downloaded as `.sit` files (StuffIt archives), which was a popular compression format for classic Mac files. Modern systems can't open these natively, so we need specialized software.\n\n1. Download [The Unarchiver](https://theunarchiver.com/) - a free Mac application that can handle various vintage archive formats including StuffIt\n2. Install The Unarchiver on your system\n3. Use The Unarchiver to extract the downloaded `.sit` files\n4. After extraction, you should have game files with `.cdr` (CD-ROM image) or `.iso` (International Organization for Standardization disc image) extensions\n\n\u003e [!NOTE]  \n\u003e The extracted files are disc images - exact digital copies of the original game CDs. These contain all the game data, audio, and program files as they existed on the original media.\n\n### Step 3: Set Up the Emulation Environment\n\nSince these games were designed for classic Macintosh systems running Mac OS 8 or 9 in the late 1990s and early 2000s, they cannot run on modern macOS versions due to fundamental architectural changes. That means we need to emulate the original environment by using a virtual machine. A Virtual Machine (VM) is a software simulation of a physical computer and allows us to run a complete operating system within our current OS. So we'll be essentially running a virtual classic Mac computer inside your modern Mac.\n\n#### Download UTM\n\n[UTM](https://mac.getutm.app/) is a powerful virtualization app for macOS that can emulate different computer architectures, including the PowerPC processors that classic Macs used.\n\n1. Download UTM from the official website\n2. Install UTM on your system (requires macOS 11.0 or later)\n\n#### Download macOS 9.2.2 VM\n\nRather than installing Mac OS 9 from scratch (which would require original installation media and complex setup), we use a pre-configured virtual machine.\n\n1. Download the macOS 9.2.2 UTM file from [Archive.org](https://archive.org/download/mac-os-ppc-utm-vms)\n2. Extract the downloaded zip file\n3. Open the extracted VM file with UTM\n\n\u003e [!NOTE]  \n\u003e This VM comes pre-installed with Mac OS 9.2.2, which was one of the last and most stable versions of classic Mac OS. It provides the best compatibility with late-era classic Mac games like TKKG.\n\n### Step 4: Configure the Virtual Machine\n\nNow we need to make the TKKG game accessible to our virtual classic Mac. In emulation, we simulate hardware components including CD-ROM drives. By \"mounting\" a game disc image as a virtual drive, the emulated Mac OS thinks a physical game CD has been inserted.\n\n1. **Open UTM** and locate your macOS 9.2.2 VM\n2. **Right-click the VM** and select \"Edit\"\n3. **Add a new drive:**\n   - Click the \"+\" button to add hardware\n   - Select \"Drive\"\n   - **Interface**: Choose \"IDE\" (the standard interface for CD-ROM drives in that era)\n   - **Type**: Set to \"Disk Image\"\n   - Click \"Browse\" and select one of your extracted TKKG game files (`.cdr` or `.iso`)\n4. **Save the VM configuration**\n\n\u003e [!TIP]\n\u003e You can change which game disc is \"inserted\" by editing the VM configuration and selecting a different game file. This simulates swapping CDs in a physical drive.\n\n### Step 5: Start Playing\n\n1. **Start the VM** in UTM\n2. **Wait for macOS 9.2.2 to boot** - This may take a minute or two as it emulates vintage hardware\n3. **Look for the game drive** that should appear as an icon on the Mac OS 9 desktop\n4. **Double-click the game icon** to launch it\n\n\u003e [!NOTE]  \n\u003e The games will run at their original speed and resolution. You may notice the interface looks dated - this is authentic to the original 1990s-2000s Mac gaming experience.\n\n## Game Documentation and Manuals\n\nFor your convenience, all documentation from each TKKG game has been extracted from the original game files and is available in this repository. This includes README files and all printable materials in both their original format and as converted PDFs.\n\n\u003e [!TIP]\n\u003e These files were originally only accessible by mounting the game disc images and extracting them manually. By providing them here, players can access important game information without needing to perform the technical extraction process described in the developer section.\n\n### What's Included\n\n**README Files** - Text files (typically named `LIESMICH.TXT` or similar) containing:\n\n- Installation instructions for the original versions\n- Technical requirements and display settings recommendations\n- Gameplay hints and walkthrough tips\n- Contact information for technical support (historical reference)\n\n**Printable Materials** - Available in two formats:\n\n- **Original PCT files** - The native Macintosh picture format as stored on the game CDs\n- **Converted PDF files** - Modern, easily viewable versions of the same content\n\nThe printable materials may include reference cards, hint guides, decoder wheels, maps, or other supplementary materials designed to be printed and used while playing.\n\n### File Organization\n\nLook for files organized by game number in the repository inside the `contents/` directory:\n\n- `TKKG1/` - Documentation for \"Jennifer is Missing\"\n- `TKKG2/` - Documentation for \"Deadly Chocolate\"\n- And so on through TKKG14 and the Identikit tool\n\nCheck these folders for the specific documentation corresponding to each game you're playing.\n\n## System Requirements\n\n**Host System Requirements:**\n\n- **macOS 10.15 or later** (for UTM compatibility)\n- **Apple Silicon or Intel processor** with virtualization support\n- **At least 4 GB RAM** (2 GB for your system + 256 MB for the VM)\n- **Several GB of free disk space** (each game is 100+ MB, plus VM overhead)\n\n**Virtual Machine Specifications:**\n\n- **PowerPC emulation** (handled automatically by UTM)\n- **256 MB RAM allocated to VM** (sufficient for Mac OS 9 and games)\n- **IDE CD-ROM drive emulation** for game disc access\n\n## Troubleshooting\n\n### \"IDE unit 0 is in use\" Error\n\nThis error occurs when UTM detects a conflict in the virtual hardware configuration, typically when drive interfaces aren't properly updated after configuration changes.\n\n**Solution:**\n\n1. **Go to VM settings** in UTM\n2. **Check each configured drive** (including the system drive and your game drive)\n3. **Look for \"Update Interface\" buttons** on each drive configuration\n4. **Click \"Update Interface\"** wherever this button appears\n5. **Save configuration and try starting the VM again**\n\n\u003e [!TIP]\n\u003e This error often appears after adding or changing virtual drives. The \"Update Interface\" button refreshes the virtual hardware configuration to resolve conflicts.\n\n### Game Drive Not Appearing\n\n**Possible causes and solutions:**\n\n- **Incorrect file format:** Ensure the game file has a `.cdr` or `.iso` extension\n- **Interface misconfiguration:** Verify the drive is configured as IDE interface\n- **VM restart needed:** Try restarting the virtual machine\n- **Corrupted extraction:** Re-extract the game from the original `.sit` file\n- **File path issues:** Make sure the game file path doesn't contain special characters\n\n### Performance Issues\n\nIf games run slowly or audio stutters:\n\n- **Allocate more RAM** to the VM (try 512 MB instead of 256 MB)\n- **Close unnecessary applications** on your host Mac\n- **Check Activity Monitor** for high CPU usage from other processes\n\n---\n\n## Accessing Game Data (For Developers)\n\nThis section is intended for developers, researchers, or enthusiasts interested in examining the original game files, extracting assets, or understanding the game's internal structure. By mounting the disc images on a modern system, you can access all the original game data without needing to run the actual games.\n\n\u003e [!WARNING]  \n\u003e The following procedures involve mounting disc images and require administrative privileges. Ensure you understand the commands before executing them.\n\n### Mounting Game Images\n\nThe TKKG games are distributed as disc images (`.cdr` or `.iso` files) that contain the complete game data as it appeared on the original CDs. To access this data on modern systems, they need to be mounted to a virtual drive.\n\nFirst, create a directory, where the game data will be mounted.\n\n```bash\nmkdir -p ~/TKKG1\n```\n\nNext, use the `hdiutil` command to attach the disc image and mount it. This command will create a virtual drive that you can access like any other disk on your system. In this example, we'll mount the first TKKG game located at `~/Downloads/TKKG1.cdr`.\n\n\u003e [!TIP]  \n\u003e Replace the path in the example with the actual path to your extracted game files. The file extension might be `.iso` instead of `.cdr` depending on the game you picked.\n\n```bash\n# Attach the disc image\nDEVICE=$(hdiutil attach ~/Downloads/TKKG1.cdr -nomount -imagekey diskimage-class=CRawDiskImage | head -1 | awk '{print $1}')\n\n# Mount using the assigned device\nsudo mount -t cd9660 $DEVICE ~/TKKG1\n```\n\n\u003e [!NOTE]  \n\u003e The `head -1` command ensures we only get the first device name (the main disk), not the individual partitions that might also be listed.\n\n#### Unmounting After Use\n\nWhen you're finished accessing the game data, properly unmount the images:\n\n```bash\nsudo umount ~/TKKG1\nhdiutil detach $DEVICE\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonathanxdr%2Ftkkg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonathanxdr%2Ftkkg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonathanxdr%2Ftkkg/lists"}