JamInit

JamInit is a command-line tool for creating standardized project structures for game jams.
It aims to reduce setup time and promote consistency across multiple game jam projects.

Features

• Initializes new game jam projects with predefined folder structures.
• Supports multiple engines (Pygame, Godot, Unity).
• Generates template files including README, LICENSE, and .gitignore.
• Optionally initializes a Git repository.
• Configurable templates for custom workflows.

Installation

JamInit requires Python 3.12 or higher.

pip install jaminit

Usage

Create a new game jam project:

jaminit new "Mini Jam 183" --engine pygame --license MIT --git

Example output:

mini_jam_183_dreams/
├── src/
│   ├── main.py
│    ├── settings.py
│   └── player.py
├── assets/
│   ├── sprites/
│   ├── sounds/
│   ├── music/
│   └── fonts/
├── README.md
├── LICENSE
├── .gitignore
└── requirements.txt

Command help:

jaminit --help

Roadmap

Version	Milestone	Description
✔️ v0.1.0	Core functionality	Implement base CLI using argparse. Add support for initializing Pygame projects with predefined folder structure and template files. Include auto-generated README, LICENSE, and .gitignore.
🚧 v0.2.0	Multi-engine support	Add rich integration. Add templates for Godot, PICO-8 and Unity projects. Introduce a shared configuration file defining default directory layout and file templates per engine.
v0.x.0	Git and license automation	Add optional --git flag to automatically run git init and create a .gitignore. Include --license option for MIT, GPL, CC-BY, and Unlicensed. Generate an automatic license file from a library.
v0.x.0	Template customization	Allow users to define and store custom templates under ~/.jaminit/templates/. Add jaminit template create and jaminit template list commands.
v0.x.0	Cross-platform polish	Add full Windows/macOS/Linux support testing, path normalization, and graceful error handling for filesystem issues.
v0.x.0	Interactive mode	Add optional interactive wizard (jaminit new without args) that prompts the user for engine, theme, and license step-by-step.
v1.0.0	Stable release	Comprehensive documentation, unit tests, and CI integration (GitHub Actions). Command autocompletion for Bash, Zsh, and PowerShell.

Contributing

Contributions are welcome. Open an issue before submitting major changes. Use conventional commit messages where possible.

License

Licensed under the MIT License.
See LICENSE for details.