By liafonx
Develop Balatro mods with Steamodded, Lovely, and SMODS. Includes game source navigation, mobile compat, debugging, and sub-agent delegation.
Increment version and update changelogs
Health audit — check if project config, scripts, hooks, rules, file placement, and gitignore are up-to-date
Evaluate whether to compact context based on current workflow phase
Verify fix by extracting and analyzing Lovely logs after code changes
Draft a PR message for fork contributions
Reviews code changes for correctness, edge cases, and quality. Use after writing code or before merging — catches bugs, logic errors, and mod-specific pitfalls. Only reports issues with confidence ≥ 80. <example> Context: Code was just written or modified user: 'Review the changes I just made' assistant: 'I will invoke the code-reviewer agent to analyze your changes.' <commentary>Triggers on review requests after code changes.</commentary> </example>
Executes implementation plans from the main agent. Use when the main agent has a concrete plan and needs Sonnet to write the code — multi-file edits, new modules, refactoring. <example> Context: Main agent has approved implementation plan user: 'Implement the approved plan' assistant: 'I will invoke the code-writer agent to execute the plan.' <commentary>Triggers after plan approval when code needs to be written.</commentary> </example>
Inspects Lovely runtime state — logs, dump metadata, and mod compatibility. Use when the user wants to check the latest log, analyze patch conflicts, or understand what mods changed in the game. Produces a structured diagnostic report for the main agent. <example> Context: User wants runtime diagnostics user: 'Check the latest log and game dump' assistant: 'I will invoke the debug-inspector agent to inspect runtime state.' <commentary>Triggers on log inspection, dump analysis, or mod compatibility checks.</commentary> </example>
Researches Balatro game source code to find function implementations, data structures, and injection points. Use when needing to understand how something works in the game, find where to inject code, or locate specific game mechanics. <example> Context: Main agent needs to understand game mechanics user: 'Find how G.GAME.blind works in the game source' assistant: 'I will invoke the game-source-researcher agent to find this in the game source.' <commentary>Triggers when game source research is needed.</commentary> </example>
Researches Lovely patch patterns and injection techniques. Use when needing to find how to patch game functions, understand Lovely syntax, or find examples of specific patch types. <example> Context: Main agent needs lovely patch syntax user: 'Find lovely patch examples for card evaluation' assistant: 'I will invoke the lovely-patch-researcher agent to find relevant patch patterns.' <commentary>Triggers when Lovely patch research is needed.</commentary> </example>
Modifies files
Hook triggers on file write and edit operations
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Claude Code plugin for Balatro mod development with Steamodded, Lovely, and SMODS.
A plugin that teaches Claude how to develop Balatro mods using:
# Add the marketplace (one-time)
/plugin marketplace add liafonx/Open-Balatro
# Install the plugin
/plugin install balatro-mod-dev@open-balatro
Or via CLI:
claude plugin install balatro-mod-dev@open-balatro
claude --plugin-dir ./balatro-mod-dev
| Component | Count | Purpose |
|---|---|---|
| Skills | 1 | balatro-mod-dev — game knowledge, patterns, references |
| Agents | 11 | Research, debug inspection, code writing, review (Sonnet + Opus + Haiku) |
| Commands | 16 | /familiar, /init, /sync-mod, /debug, /refactor, etc. |
| Hooks | 9 | Session init, file protection, task model enforcement, session memory |
| Script templates | 4 | Sync to mods, create release, fix sprites |
| Project templates | 10+ | INIT.md, AGENT.md, mod.config.json, Lua rules |
The main agent (Sonnet) orchestrates all work. Sub-agents handle research, code writing, and specialized reasoning via the Task tool.
Main Agent (Sonnet) → Sonnet sub-agents (research, code writing)
→ Opus sub-agents (code review, synthesis, planning)
→ Haiku sub-agents (scripts)
↑ ↓
└──────── recap ─────┘
Source paths are configured per-mod in mod.config.json:
"source_paths": {
"game_desktop": "~/path/to/Balatro_src/desktop",
"steamodded": "~/path/to/smods/src",
"mods": "~/path/to/Balatro/Mods"
}
Open-Balatro/
├── .claude-plugin/
│ └── marketplace.json # Marketplace catalog (enables plugin discovery)
├── balatro-mod-dev/ # THE PLUGIN (distributable)
│ ├── .claude-plugin/
│ │ └── plugin.json # Manifest (name, version, description)
│ ├── skills/balatro-mod-dev/ # Skill knowledge (patterns, references)
│ ├── agents/ # 11 sub-agent templates
│ ├── commands/ # 16 command templates
│ ├── hooks/ # 9 hooks + JS scripts
│ ├── scripts/ # Utility scripts (sync, release, fix-sprites)
│ └── templates/ # Project setup templates
│ └── rules/ # Scaffolded to .claude/rules/ by /init
├── docs/ # NOT part of plugin (longform guides, reference)
├── .claude/rules/ # THIS repo's rules
└── README.md
See AGENT.md for plugin architecture and development guidelines.
MIT
npx claudepluginhub liafonx/open-balatro --plugin balatro-mod-devBuild s&box games by talking to Claude. Bundles the Claude Bridge MCP server, a screenshot-driven game-dev workflow skill, and an optional sbox-game-dev specialist agent. The s&box editor addon must be installed separately (see README).
Game development with Unity, Godot, and Minecraft Bukkit plugin development
Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 44-tool MCP bridge to the local desktop app.
Comprehensive game development learning system with 7 specialized agents, 21 in-depth skills, 4 slash commands, and automation hooks. Master game design, programming, graphics, audio, networking, tools, and publishing across Unity, Unreal Engine, and Godot.
Playgama Bridge SDK integration helper for Defold games
The game studio for the agent internet. Build, monetize, and ship browser games with one command. Phaser 2D, Three.js 3D, Play.fun monetization. Works with 40+ AI coding agents.