mirror of
https://github.com/Donchitos/Claude-Code-Game-Studios.git
synced 2026-10-16 01:37:05 +00:00
Release 1.1.2 — the default path works end to end
Fix release for 1.1.1: the minimal path end to end, engine commands that run on Godot, Unity and Unreal, hook warnings you can see, and verdicts that say when they could not check. Details in CHANGELOG.md; upgrade steps in UPGRADING.md (v1.1.1 → v1.1.2). Fixes #67 Fixes #131 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WuJn2FdynEybfL5KC697nJ
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
7ed2c3e9c4
commit
b21fa0f7f2
@@ -1,23 +1,25 @@
|
||||
# Setup Requirements
|
||||
|
||||
This template requires a few tools to be installed for full functionality.
|
||||
All hooks fail gracefully if tools are missing — nothing will break, but
|
||||
you'll lose validation features.
|
||||
Hooks carry on without an optional tool and lose only the check it powers. The
|
||||
required ones are required: without Python 3 every setting falls back to its
|
||||
default and a commit that stages data JSON is blocked, and without Bash no hook
|
||||
runs at all.
|
||||
|
||||
## Required
|
||||
|
||||
| Tool | Purpose | Install |
|
||||
| ---- | ---- | ---- |
|
||||
| **Git** | Version control, branch management | [git-scm.com](https://git-scm.com/) |
|
||||
| **Claude Code** | AI agent CLI | `npm install -g @anthropic-ai/claude-code` |
|
||||
| **Claude Code** | AI agent CLI | Native installer: `curl -fsSL https://claude.ai/install.sh \| bash` (macOS, Linux, WSL) or `irm https://claude.ai/install.ps1 \| iex` (Windows PowerShell). npm also works: `npm install -g @anthropic-ai/claude-code` (Node.js 22+). See [code.claude.com/docs/en/setup](https://code.claude.com/docs/en/setup) |
|
||||
| **Python 3** | Reads `project.yaml` for every skill and hook | [python.org](https://www.python.org/). Without it every setting silently falls back to its default, and a commit that stages data JSON is blocked because it cannot be validated |
|
||||
| **Bash** | Runs every hook | Built into macOS and Linux. On Windows, install [Git for Windows](https://git-scm.com/downloads/win) — Claude Code runs without it, but no CCGS hook does |
|
||||
|
||||
## Recommended
|
||||
|
||||
| Tool | Used By | Purpose | Install |
|
||||
| ---- | ---- | ---- | ---- |
|
||||
| **jq** | Hooks (7 of 12) | JSON parsing in commit/push/asset/agent hooks | See below |
|
||||
| **Python 3** | Hooks (2 of 12) | JSON validation for data files | [python.org](https://www.python.org/) |
|
||||
| **Bash** | All hooks | Shell script execution | Included with Git for Windows |
|
||||
| **jq** | Hooks (8 of 12) | JSON parsing in commit/push/asset/agent hooks | See below |
|
||||
|
||||
### Installing jq
|
||||
|
||||
@@ -45,7 +47,9 @@ sudo pacman -S jq # Arch
|
||||
### Windows
|
||||
- Git for Windows includes **Git Bash**, which provides the `bash` command
|
||||
used by all hooks in `settings.json`
|
||||
- Ensure Git Bash is on your PATH (default if installed via the Git installer)
|
||||
- If Claude Code can't find Git Bash, set `CLAUDE_CODE_GIT_BASH_PATH` to its
|
||||
`bash.exe` in the `env` block of your settings (for example
|
||||
`C:\\Program Files\\Git\\bin\\bash.exe` in JSON)
|
||||
- Hooks use `bash .claude/hooks/[name].sh` — this works on Windows because
|
||||
Claude Code invokes commands through a shell that can find `bash.exe`
|
||||
|
||||
@@ -61,16 +65,16 @@ Run these commands to check prerequisites:
|
||||
git --version # Should show git version
|
||||
bash --version # Should show bash version
|
||||
jq --version # Should show jq version (optional)
|
||||
python3 --version # Should show python version (optional)
|
||||
python --version # Required: Python 3 (python3 or py also work)
|
||||
```
|
||||
|
||||
## What Happens Without Optional Tools
|
||||
|
||||
| Missing Tool | Effect |
|
||||
| ---- | ---- |
|
||||
| **jq** | Commit validation, push protection, asset validation, and agent audit hooks silently skip their checks. Commits and pushes still work. |
|
||||
| **Python 3** | JSON data file validation in commit and asset hooks is skipped. Invalid JSON can be committed without warning. |
|
||||
| **Both** | All hooks still execute without error (exit 0) but provide no validation. You're flying without safety nets. |
|
||||
| **jq** | Nothing is lost: every hook falls back to `grep` to read its JSON input. jq is only more robust with unusual input. |
|
||||
| **Python 3** | Not optional (see Required). Every setting falls back to its default, because `project.yaml` is read through Python; the asset hook skips JSON validation and says so; a commit that stages data JSON is blocked. |
|
||||
| **Both** | As without Python. |
|
||||
|
||||
## Optional Performance Settings
|
||||
|
||||
@@ -103,6 +107,11 @@ agents would write files you never approved.
|
||||
If you genuinely want it off, override it in `.claude/settings.local.json`,
|
||||
which takes precedence. Understand what you are turning off first.
|
||||
|
||||
**The VS Code extension does not read it.** The extension never reads a
|
||||
project's `.claude/settings.json` for the permission mode a conversation starts
|
||||
in. To get the same behaviour there, set `claudeCode.initialPermissionMode` to
|
||||
`default` in your VS Code user settings.
|
||||
|
||||
## Recommended IDE
|
||||
|
||||
Claude Code works with any editor, but the template is optimized for:
|
||||
|
||||
Reference in New Issue
Block a user