跳到正文
GitHub·· 9 天前AI 评分38

SlopForge:把资产需求变成经人工审核的 3D 游戏资产工作流

gysahlgreene/SlopForge

AI 导读

SlopForge 打通 ComfyUI 生成、Blender 处理、人工审核与 Unity 交付,将资产需求转为经审核的 3D 游戏资产,支持本地或远程 GPU 推理,资产、审批记录与来源信息保留在本地项目中。

正文

Turn an asset brief into a reviewed 3D game asset.

SlopForge connects ComfyUI generation, Blender processing, human review, and Unity delivery. Run inference locally or on a remote GPU; keep your assets, approval decisions, and provenance in your own local project.

Get started · Documentation · Examples · Roadmap

Buy Me A Coffee

See it working

Reviewed humanoid Prop delivery
Basalt Warden performing the body-deformation test Generated power relay imported into Unity
Basalt Warden — body deformation approved; valid Unity Humanoid and evaluated diagnostic animation. Evidence → Power relay — surfacing, prop generation, and material preparation evidence. Evidence →

These are measured examples. Generation is stochastic: candidates must pass checks and human review, or the pipeline reports failure. A successful export alone does not make an asset game-ready.

The workflow

flowchart LR
    Brief[Brief + style] --> Concept[Concept candidates]
    Concept --> Review[Human selection]
    Review --> Mesh[3D generation + checks]
    Mesh --> Materials[Material review]
    Materials --> Unity[Unity delivery]
    Mesh --> Rig[Character rigging]
    Rig --> Motion[Deformation review]
    Motion --> Playback[Animation + Unity validation]

Loading

  • Generate: props, collectibles, architecture, and humanoid character candidates using configurable ComfyUI workflows.
  • Prepare: inspect geometry, preserve sources, process meshes and PBR maps, and render review views in Blender.
  • Review: compare candidates, approve explicitly, and retain failed attempts and processing evidence.
  • Coordinate: resume recipes, reuse style/reference libraries, and select quality tiers with bounded candidate budgets.
  • Deliver: export models/materials and prepare character animation tooling for Unity.

Quick start

Requires Python 3.10–3.14, Blender, a compatible ComfyUI service, and an existing Unity project. Model weights and custom nodes are installed separately.

git clone https://github.com/gysahlgreene/SlopForge.git
cd SlopForge
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
slopforge init ~/UnityProjects/MyGame
slopforge --project ~/UnityProjects/MyGame doctor

Installation covers dependencies. ComfyUI configuration covers local/remote inference and model/workflow compatibility.

Generate a prop

slopforge --project ~/UnityProjects/MyGame generate prop stone_lantern \
  "Weathered stone lantern for a fantasy ruin" \
  --image-prompt "Squat carved stone lantern, broad square cap, open sides, warm glass core; complete three-quarter view, isolated on a plain neutral background."
slopforge --project ~/UnityProjects/MyGame candidates stone_lantern
slopforge --project ~/UnityProjects/MyGame approve stone_lantern 1
slopforge --project ~/UnityProjects/MyGame candidates stone_lantern
slopforge --project ~/UnityProjects/MyGame approve-texture stone_lantern 1

Inspect the concept, mesh views, materials, and validation report before each approval. For characters, continue through readiness and rigging, then animation validation.

What is qualified today?

Area Current evidence
Generation, candidate tracking, recipes, provenance Implemented; offline tests and selected live GPU runs. Visual quality depends on the model and brief.
Mesh/material preparation and Unity delivery Demonstrated on selected props; geometry and material defects still require review.
Humanoid rigging One generated Basalt candidate has approved body deformation and valid Unity Humanoid evaluation. Providers remain experimental.
Third-party motion retargeting Plumbing and fixture evidence exist; production idle/walk/attack qualification remains open.
Safe Unity replacement/reimport Stable GUIDs and replacement validation remain open.

Full finger animation is not available on the reviewed Basalt rig. Reference-input plumbing exists, but the bundled concept graph is text-only. SlopForge does not assemble game scenes or ship sprites; it is an asset workflow for local-first review and delivery.

Find your way around

Directory Purpose
slopforge/ CLI, asset lifecycle, recipes, providers, and Unity integration
blender/ · processing/ Background mesh, rigging, and image helpers
workflows/ · templates/ ComfyUI graphs, requirement declarations, and project defaults
tests/ Offline checks and opt-in Blender, Unity, and GPU integrations
docs/ Guides, current audit, research, and compact benchmark evidence

Contributing · Security and publishing · MIT license · Third-party notices

来源:GitHub · github.com