By Mikop22
Generate, compile, sprite, and live-inject custom Terraria weapons from Claude Code.
Diagnose whether Tforge is ready to generate and inject Terraria weapons.
Install Tforge's local Python and Pixelsmith dependencies for Claude Code.
Generate Terraria mod weapons end-to-end via Architect/Coder/Reviewer/Judge subagents and the Tforge MCP tools. Use when the user asks for a weapon by description (e.g. "make a void pistol"), wants to inject something into their tModLoader install, or asks to iterate on a previously-generated weapon.
This directory is the **active** Python stack for The Forge. The default integration is **`mcp_server.py`** (MCP tools); the old file-driven orchestrator lives only under **`../archive/agents/`**.
Here is a master markdown reference guide you can save and keep open while you are drawing sprites and coding in tModLoader. It covers the standard conventions for getting your artwork to behave properly in the Terraria engine.
Here is your master markdown reference guide for drawing **weapon and item sprites** in Terraria.
Admin access level
Server config contains admin-level keywords
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.
This plugin requires configuration values that are prompted when the plugin is enabled. Sensitive values are stored in your system keychain.
fal_keyfal.ai API key used by Pixelsmith to generate Terraria item and projectile sprites.
${user_config.fal_key}No model invocation
Executes directly as bash, bypassing the AI model
No model invocation
Executes directly as bash, bypassing the AI model
Runs pre-commands
Contains inline bash commands via ! syntax
Runs pre-commands
Contains inline bash commands via ! syntax
"magic staff that shoots nyan cat for 0 mana"
https://github.com/user-attachments/assets/b6fb6588-1519-402b-8b05-2df8b91a65f8
Prerequisites:
/plugin command available3.12+Inside Claude Code:
/plugin marketplace add Mikop22/the-forge
/plugin install tforge@tforge
the plugin will then prompt you for a FAL.ai API key. You need this key to access the diffusion model which generates sprites and animation frames.
Run setup and diagnostics:
/tforge:setup
/tforge:doctor
/tforge:setup installs local Python and Node dependencies, downloads Pixelsmith weights, and copies ForgeConnector into your tModLoader ModSources directory when it can find it.
In tModLoader, build and enable ForgeConnector, enter a world, then run:
/tforge:forge <describe item here>
For local development without installing from the marketplace:
git clone https://github.com/Mikop22/the-forge.git
cd the-forge
claude --plugin-dir .
Architecture, MCP tools, supported item types, environment overrides, project layout, and troubleshooting live in TECHNICAL.md.
npx claudepluginhub mikop22/tforge --plugin tforgeStandalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.
Comprehensive UI/UX design plugin for mobile (iOS, Android, React Native) and web applications with design systems, accessibility, and modern patterns
Multi-model consensus engine integrating OpenAI Codex CLI, Gemini CLI, and Claude CLI for collaborative code review and problem-solving.
Write feature specs, plan roadmaps, and synthesize user research faster. Keep stakeholders updated and stay ahead of the competitive landscape.
Memory compression system for Claude Code - persist context across sessions