start-blured

Start the Blured Engine (OpenCode AI server + Godot editor)

5 stars

Best use case

start-blured is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Start the Blured Engine (OpenCode AI server + Godot editor)

Teams using start-blured should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/start-blured/SKILL.md --create-dirs "https://raw.githubusercontent.com/bluredengine/blured/main/.claude/skills/start-blured/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/start-blured/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How start-blured Compares

Feature / Agentstart-bluredStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Start the Blured Engine (OpenCode AI server + Godot editor)

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Start Blured Engine

This skill starts the complete Blured Engine environment using `start_blured.sh`.

## Instructions

Simply run the startup script:

```bash
bash .claude/skills/start-blured/scripts/start_blured.sh
```

To open the **Project Manager** instead (for creating/selecting a project):

```bash
bash .claude/skills/start-blured/scripts/start_blured.sh -new
```

When the user passes `-new` as an argument to `/start-blured`, pass it through to the script.

This script will:
1. Load configuration from `.env` (project path, AI port)
2. Kill any existing Godot process
3. Check/start the OpenCode AI server
4. Launch the Godot editor with the configured project (or the Project Manager if `-new`)

## Configuration

The workspace is configured via `.env` (gitignored, per-machine):

```env
BLURED_PROJECT_PATH=G:\GodotProjects\rogue-card
BLURED_AI_PORT=13700
```

To change the project, edit the `.env` file.

## Troubleshooting

- If AI server fails to start, check if the port is already in use
- If build fails with "access denied", kill Godot first
- If AI Assistant shows "Disconnected", click the "Connect" button
- To change the project, edit `g:/blured-engine/.env`

Related Skills

package-blured

5
from bluredengine/blured

Package the Blured Engine into a distributable directory

build-blured

5
from bluredengine/blured

Build the Blured Engine (OpenCode + Godot)

worldbuilding

5
from bluredengine/blured

Build the game world's foundation before generating concept art. Use when starting a new game project, when user says "build world", "worldbuilding", "world design", or before art direction. Guides the user through 3 questions to establish the world's unique identity.

ui-production

5
from bluredengine/blured

Create polished player-facing UI from whitebox to final assets. 5-step workflow from UI mockup to deployed game UI. Do NOT use for whitebox/prototype UI.

ui-layout-replicate

5
from bluredengine/blured

Replicate a UI layout from a cornerstone reference image into a pixel-perfect .tscn scene. Use when user says "replicate UI layout", "build layout from reference", "1:1 UI copy", or has a cornerstone UI image to turn into a scene.

polish

5
from bluredengine/blured

Systematic polish pass — add juice, screen effects, audio, transitions, UI animations, and game feel improvements. Use when user says "polish", "add juice", "make it feel better", "add effects", or similar.

analyze-screenshot

5
from bluredengine/blured

Analyze game screenshots for visual design issues, UI problems, and art consistency. Automatically triggers when a screenshot is attached.

add-level

5
from bluredengine/blured

Guided level design — create a new level with purpose, environment, layout, enemies, and auto-generated assets. Use when user says "add a level", "new level", "create a stage", or similar.

tech-debt

5
from bluredengine/blured

Clean up tech debt - remove obsolete files, temporary files, unused code, dead imports, and other cruft. Use when user wants to clean up the codebase, remove unused code, or reduce tech debt.

git-pushing

5
from bluredengine/blured

Stage, commit, and push git changes with conventional commit messages. Use when user wants to commit and push changes, mentions pushing to remote, or asks to save and push their work. Also activates when user says "push changes", "commit and push", "push this", "push to github", or similar git workflow requests.

git-dev-merge

5
from bluredengine/blured

Merge feature branches back to their base branches across the main repo and submodules. Use when user says "merge feature", "finish feature", "merge back", or invokes /git-dev-merge.

git-dev-feature

5
from bluredengine/blured

Start a new feature development workflow by creating an issue and feature branches across the main repo and submodules.