# `@combos-fun/plugin-renderer-render` — Agent notes

Per-`GameObject` visibility / alpha / zIndex / sortable-children control for the 2D pipeline. Without this plugin, every drawable is fully visible at alpha 1 and zIndex 0.

## When to read

Read whenever you need to hide / fade an object, change draw order, or turn on z-sorted children inside a container.

## Public API

```ts
import { Render, RenderSystem, type RenderParams } from '@combos-fun/plugin-renderer-render';
```

`componentName = 'Render'`, `systemName = 'Render'`.

| Field | Type | Default |
|-------|------|---------|
| `visible` | `boolean` | `true` |
| `alpha` | `number` | `1` |
| `zIndex` | `number` | `0` |
| `sortableChildren` | `boolean` | `false` |

## Required setup

`RendererSystem` (from `plugin-renderer`) must be added before `RenderSystem`.

## Common pitfalls

| Symptom | Fix |
|---------|-----|
| Wrong stacking order | Set `sortableChildren: true` on the parent's `Render` and `zIndex` on children |
| Object visible despite `visible: false` | Confirm `RenderSystem` is registered |
| Fade has no effect | Confirm `alpha` is between 0 and 1 |

## Minimal example

```ts
go.addComponent(new Render({ visible: true, alpha: 1, zIndex: 5 }));
```

## Verification

`pnpm --filter @combos-fun/plugin-renderer-render run build`.