KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

fal-3D-Generator-Plugin-for-Cinema-4D

★ 15 Open GitHub ↗

Plugin/Script to use fal.ai with Cinema 4D

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# fal.ai 3D Generator Plugin for Cinema 4D

Generate 3D models from text or images using AI, directly inside Cinema 4D.

![Plugin Screenshot](https://raw.githubusercontent.com/lovisdotio/fal-3D-Generator-Plugin-for-Cinema-4D/main/screenshot.png)

This plugin integrates with [fal.ai](https://fal.ai) and the Hunyuan3D V3 model to create textured 3D assets from simple prompts or reference images.

## Features

- **Text-to-3D**: Describe what you want, get a 3D model
- **Image-to-3D**: Upload a photo or concept art, get a 3D model
- **Multi-view support**: Add back/left/right images for better reconstruction
- **Parallel generation**: Queue multiple generations at once
- **Automatic import**: Models appear directly in your scene
- **Isolated assets**: Each generation gets its own folder (no texture conflicts)

## Requirements

- Cinema 4D 2025 or later
- A fal.ai account and API key ([get one here](https://fal.ai))
- (Optional) Python with Pillow for texture splitting

## Installation

1. Download or clone this repository
2. Copy the `cinema4d-fal` folder to your plugins directory:
   - **Windows**: `C:\Program Files\Maxon Cinema 4D 2026\plugins\`
   - **macOS**: `~/Library/Preferences/Maxon/Maxon Cinema 4D 2026/plugins/`
3. Restart Cinema 4D
4. Open via **Extensions > fal.ai 3D Generator**

## Quick Start

1. Open the plugin from **Extensions > fal.ai 3D Generator**
2. Enter your fal.ai API key
3. Type a prompt (e.g., "a wooden treasure chest") or select an image
4. Click **Generate**
5. Wait 1-3 minutes for the model to appear in your scene

## Generation Options

| Option | Description |
|--------|-------------|
| Face Count | Mesh density (40K - 1.5M faces) |
| Type | Normal (textured), LowPoly, or Geometry (untextured) |
| Polygons | Triangles or Quadrilaterals |
| Enable PBR | Generate PBR material textures |

## Parallel Generation

You can launch multiple generations without waiting:

1. Start first generation
2. Change prompt/image, click Generate again
3. Each result imports automatically when ready
4. Status shows active count: "Generating... (3 active)"
5. Cancel stops all active generations

## Output Structure

Each generation creates an isolated folder to prevent texture conflicts:

```
Documents/fal_ai_generations/
  fal_gen1_1737421234/
    fal_gen1_1737421234.glb
    tex/
      baseColor.png
      normal.png
      metallicRoughness.png
  fal_gen2_1737421300/
    ...
```

## Texture Splitting

GLB files use combined metallic-roughness textures (glTF standard). To split them:

**Option 1: From C4D**
1. Click "Convert Textures" button
2. Select the combined texture file
3. Get separate metallic and roughness maps

**Option 2: Command line**
```bash
python split_texture.py path/to/metallicRoughness.png
```

Requires Pillow: `pip install Pillow`

## Troubleshooting

**Generation stuck on "Starting..."**
- Check your API key is valid
- Check your fal.ai account has credits

**Model not importing**
- Ensure Cinema 4D supports GLB (built-in since R20)
- Check the console for error messages

**Textures overwriting each other**
- This is fixed in the latest version (isolated folders)
- Each generation now has unique material/object names

**Timeout errors**
- Timeout is set to 2 hours
- Large/complex models take longer

## API Costs

This plugin uses [fal.ai's Hunyuan3D V3](https://fal.ai/models/fal-ai/hunyuan3d-v3). Check their pricing page for current costs.

## File Structure

```
cinema4d-fal/
  fal_ai_generator.pyp   # Main plugin
  fal_api.py             # API communication
  split_texture.py       # Texture utility
  res/
    c4d_symbols.h        # UI IDs
    dialogs/
      fal_dialog.res     # Dialog layout
    strings_en-US/
      c4d_strings.str    # UI strings
```

## License

MIT License - see LICENSE file.

## Credits

- [fal.ai](https://fal.ai) - AI generation API
- [Tencent Hunyuan3D](https://github.com/Tencent/Hunyuan3D-2) - 3D generation model
- [Maxon](https://www.maxon.net) - Cinema 4D

fal-3D-Generator-Plugin-for-Cinema-4D

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README