gg

A set of command line tools and Go packages to work with Thimbleweed Park data files.

The project name "gg" was chosen, because the names of some of these formats start with those two letters, e.g. "ggpack" or "GGDictionary". They were conceived by Grumpy Gamer (Ron Gilbert). This project is not related to him or Terrible Toybox, Inc.

Command line tools

• ggpack A tool to inspect, unpack or create "ggpack" files.
• ggdict A tool to convert back and forth between the GGDictionary format and JSON.
• retext A tool to replace ID placeholders like @12345 in files with texts from a text table file in TSV format.
• nutfmt A tool to indent Squirrel script files.
• yack A tool to run Yack dialogs.
• ggsavegame A tool to convert savegame files to JSON format and back.

Installation

Either download binaries for your operating system from the latest release or build from source with Go:

go install github.com/fzipp/gg/cmd/ggpack@latest
go install github.com/fzipp/gg/cmd/ggdict@latest
go install github.com/fzipp/gg/cmd/retext@latest
go install github.com/fzipp/gg/cmd/nutfmt@latest
go install github.com/fzipp/gg/cmd/yack@latest
go install github.com/fzipp/gg/cmd/ggsavegame@latest

Go packages

• ggpack Read and write ggpack files.
• ggdict Read and write the GGDictionary format.
• texts Replace text ID placeholders with texts.
• yack Read and run Yack dialogs.
• wimpy Read and write Wimpy room files.
• savegame Read and write savegame files.

Related, but independent packages:

• texturepacker Read sprite sheet information from TexturePacker's JSON (Hash) export format.
• bmfont Load and render bitmap fonts in the format of AngelCode's bitmap font generator.

Related Work

Projects by other people with similar objectives:

• NGGPack .NET based tool for reading and writing ggpack archives.
• ggdump Python based tool for listing and extracting files from ggpack archives.
• r2-ggpack Radare2 plugins to manipulate ggpack archives.
• engge Experimental game engine for Thimbleweed Park by the same author as NGGPack.
• Thimbleweed Park Explorer An explorer/viewer/dumper tool for Thimbleweed Park
• ggpack Command line tool for inspecting ggpack files, written in Go.

License

This project is free and open source software licensed under the BSD 3-Clause License.