> ## Documentation Index
> Fetch the complete documentation index at: https://dadd.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# InstancedGeomRenderer

> Batch repeated compatible MuJoCo geoms into Three.js InstancedMesh objects

`<InstancedGeomRenderer />` is an opt-in renderer for particle, granular, or repeated-geom scenes. It groups compatible MuJoCo geoms by type, size, mesh, and material, then updates instance matrices from `data.geom_xpos` and `data.geom_xmat`.

```tsx theme={null}
import { InstancedGeomRenderer } from "mujoco-react";

function Particles() {
  return <InstancedGeomRenderer geomGroup={2} />;
}
```

## Props

| Prop            | Type                | Description                                     |
| --------------- | ------------------- | ----------------------------------------------- |
| `geomGroup`     | `number`            | Only instance geoms from this MuJoCo geom group |
| `filter`        | `(geom) => boolean` | Select geoms by name, type, body, or size       |
| `material`      | `THREE.Material`    | Override material for every batch               |
| `visible`       | `boolean`           | Hide or show instanced batches                  |
| `castShadow`    | `boolean`           | Enable shadows                                  |
| `receiveShadow` | `boolean`           | Receive shadows                                 |

Use the default `<SceneRenderer />` for ordinary robot models. Use `<InstancedGeomRenderer />` when many repeated geoms dominate rendering cost.