Green Instance Renderer – BRG Renderer & Culling System for Unity

[mrgreendotone-dev]

A lightweight, code-driven GPU instance renderer built on Unity's Batch Renderer Group (BRG).

Green Instance Renderer makes high-performance mesh instancing accessible in just three function calls — no inspector setup, no complex configuration. Register your meshes, upload your transforms, and let the GPU handle the rest.

---

How It Works

• Call Generate to make an uploader, this will return the uploader ID

• Call Register with the uploader ID, the max amount of objects to render, the mesh you wish the uploader to use and if it should be Lit or Unlit, it needs 3 mesh for LODs

• Call Upload with the ID and the positions you wish to render

That's it. Instances are rendered immediately, with LOD, shadows, and culling handled automatically.

---

Features

• Up to 3 LOD meshes per registration
• Multi-submesh support — each submesh has independent visual controls
• Lit and Unlit shader variants included
• Custom shaders with per-submesh visual customization: saturation, contrast, brightness, normal map, wind influence, subsurface, rim light, shadow color, etc
• Built on Unity's Batch Renderer Group (BRG) for maximum GPU instancing efficiency
• Jobs-based parallel culling for both camera and shadow pass
• Burst-compiled culling jobs via injected scheduler interface
• LOD-aware shadow culling with configurable shadow distance and radius
• Frame-skip support for culling jobs to reduce CPU overhead
• Runtime position and state updates — move, show, or hide instances at any time
• Per-submesh visual controls independent of each other
• Shadow casting and receiving controls per registration

---

Itchio Link

---

Test Scenes
https://play.unity.com/en/games/93426df5-29be-4866-ba28-f12866b539ed/instance-re...

https://play.unity.com/en/games/91ddf759-cc33-4bc9-9327-475aaa9c45f1/v134-brg-te...

[mrgreendotone-dev]

Installation

• Import the package to unity

Known limitations & Requirements

• Unity 6.5 or newer
• Universal Render Pipeline (URP)
• Packages Mathematics, Burst, Collections
• HDRP and Built-in Render Pipeline are not supported, to enable the use on other pipelines, the shaders need to be updated
• Requires GPU instancing support
• Uses Burst jobs for culling
• Uses GraphicsBuffer for instance data
• On Project Settings>Graphics>Shader Stripping>Batch Render Group Variants, set Keep All
• Some browser don't support BRG
• Parallel jobs depend on browser support for multithreading

Supported Platforms

• Windows
• macOS
• Linux
• Android
• iOS
• Consoles
• WebGPU (experimental)

Usage

• Maximum instance count is defined when registering an uploader
• GPU memory is allocated upfront based on the selected capacity
• Visible instance count determines rendering cost
• CPU culling cost scales primarily with registered instances
• Each instance takes 112 bytes

Known Issues

• WebGL (BatchRendererGroup is not supported)
• Additional rendering passes may be triggered by:
  - Scene View
  - Inspector previews
  - Object selection
  - Gizmos
  - Editor tools

As a result, you may occasionally observe on the editor at runtime:
- Temporary blinking
- Objects appearing or disappearing while editing
- Brief visual inconsistencies while selecting or modifying objects
These effects are Editor-only and do not affect standalone builds.

[mrgreendotone-dev]

Main Functions

// Create the uploader
PropUploaderID myUploader = AssetGreenRenderer.Instance.Generate( );

// Register mesh for 3 level of details (LOD)
AssetGreenRenderer.Instance.Register ( myUploader, lod0Mesh, isLOD0Lit, lod1Mesh, isLOD1Lit lod2Mesh, isLOD2Lit, limit );

// Set transform data to render instances
AssetGreenRenderer.Instance.Upload ( myUploader, positionsList, rotationsList, scalesList );

// Destroy the Uploader and clean the memory
AssetGreenRenderer.Instance.Unregister ( myUploader );

Generate will make an empty uploader and set a culling job.
Register will prepare the renderer to use, materials will be created then meshes, materials and the batch will be registered on the BRG.
Upload will convert the Transform data into Packed matrix to set the data to the BRG and the Graphic Buffer.
Unregister will destroy the GameObject containing the uploader thus making the OnDestroy run the uploader's clean up function.

lodXMesh type mesh, meshes will be changed based on the distance from the camera to the instance.
isLODXLit type bool, set it to true if you want to use a Lit material for that LOD.
limit type int, set the max amount of instances that can be spawned for that uploader, limit can't be changed after registering.
positionsList, rotationsList, scalesList type List float3

[mrgreendotone-dev]

Update Functions

---

• State

// Change the visibility state of the instance with the same index to the state passed
AssetGreenRenderer.Instance.Update_State ( myUploader, int index, bool state );

// Change the visibility state of all instances to the state passed
AssetGreenRenderer.Instance.Update_StateAll ( myUploader, bool state );

// From the start, change the visibility state of as many instances to the state passed
AssetGreenRenderer.Instance.Update_StateSource ( myUploader, int[] _source );
AssetGreenRenderer.Instance.Update_StateSource ( myUploader, bool[] _source );

• Transform

// Update the transform of the instance with the same index as the one passed
AssetGreenRenderer.Instance.Update_Transform ( myUploader, int index, float3 position, float3 rotation, float3 scale );

// Update the transform of as many instances as the length of the position list
AssetGreenRenderer.Instance.Update_Transform ( myUploader, List<float3> allPositions, List<float3> allRotations, List<float3> allScales );
AssetGreenRenderer.Instance.Update_Transform ( myUploader, float3[] allPositions, float3[] allRotations, float3[] allScales );
// Rotation and scale are optional, default values are used if they are not found

// Update the transform of as many instances as the length of the smallest array
AssetGreenRenderer.Instance.Update_TransformRaw ( myUploader, NativeArray<float3> positions, NativeArray<PackedMatrix> objectToWorld, NativeArray<PackedMatrix> worldToObject );
// The positions array will be used on the culling as the instance position while the matrix will be passed to the graphic buffer to update the render position

---

Getter Functions

// Get a list of all instances positions

// Returns a list of type List<float3>
AssetGreenRenderer.Instance.GrabPositions_List ( myUploader );

// Returns a list of type float3[]
AssetGreenRenderer.Instance.GrabPositions_Array ( myUploader );

// Returns a list of type NativeArray<float3>
AssetGreenRenderer.Instance.GrabPositions_NativeArray ( myUploader );

[mrgreendotone-dev]

Settings Functions

---

• Defaults Settings
  Default values are used if none are passed

// Set default rotation and scale values
AssetGreenRenderer.Instance.Defaults_Transform ( myUploader, float3 rotation, float3 scale );

// Set a default color, if randomize is enabled, a random color will be set
AssetGreenRenderer.Instance.Defaults_Color ( myUploader, Color color, bool randomize );

// Set a default rim color, if randomize is enabled, a random color will be set
AssetGreenRenderer.Instance.Defaults_Rim ( myUploader, Color color, bool randomize );

// Set a default phase value that will be used as timing on the wind effect, if randomize is enabled all objects will have a different visual timing
AssetGreenRenderer.Instance.Defaults_Phase ( myUploader, float value, bool randomize );

---

• Culling Settings

// Set values for the camera culling
AssetGreenRenderer.Instance.Culling_Options ( myUploader, float frustumPlaneRadius, float lod0Distance, float lod1Distance, float cullDistance, int frameSkip );
// Camera and light culling results will be reused for an amount of frames by the value passed to frameSkip

// Set values for the light culling, not needed if shadows are disabled or unlit materials are used
AssetGreenRenderer.Instance.Culling_Shadow ( myUploader, float frustumShadowRadius, float shadowDistance );
// while frustumShadowRadius takes the light frustum, shadowDistance will render shadows from objects on a distance from the camera

// Commands are what is passed on the culling to dictate what to render and what not to
AssetGreenRenderer.Instance.Culling_Commands ( myUploader, int lodLevel, bool shadowCasting, float shadowReceive, bool shadowStaticCaster );
// lodLevel: what LOD(0 to 2) to affect, use a different value to set on all LODs
// shadowCasting: true to make the instance cast shadow which will make the light culling to be called, false to not render shadows
// shadowReceive: a value for the shadow attenuation
// shadowStaticCaster: tells unity if the object's shadow is static, no movement, no mesh deformation

---

• Material Settings

// Add an albedo texture
AssetGreenRenderer.Instance.Material_Albedo ( myUploader, Texture2D albedo, int lod, int submesh );

// Add a normal texture and a strength value
AssetGreenRenderer.Instance.Material_Normal ( myUploader, float value, Texture2D normal, int lod, int submesh );

// Set mask value
AssetGreenRenderer.Instance.Material_Mask ( myUploader, float value, Texture2D mask, int lod, int submesh );

// Set a color to add to the surface and a strength value
AssetGreenRenderer.Instance.Material_Subsurface ( myUploader, float value, Color subsurface, int lod, int submesh );

// Select the color of the shadow to receive
AssetGreenRenderer.Instance.Material_Shadow ( myUploader, Color shadow, int lod, int submesh );

• Visual Settings

// Alpha clipping
AssetGreenRenderer.Instance.Material_AlphaClipping ( myUploader, float value, int lod, int submesh );

// Wind influence
AssetGreenRenderer.Instance.Material_Wind ( myUploader, float value, int lod, int submesh );

// Rim strength
AssetGreenRenderer.Instance.Material_Rim ( myUploader, float value, int lod, int submesh );

// Brightness
AssetGreenRenderer.Instance.Material_Brightness ( myUploader, float value, int lod, int submesh );

// Contrast
AssetGreenRenderer.Instance.Material_Contrast ( myUploader, float value, int lod, int submesh );

// Saturation
AssetGreenRenderer.Instance.Material_Saturation ( myUploader, float value, int lod, int submesh );

// Dither
AssetGreenRenderer.Instance.Material_Dither ( myUploader, float value, int lod, int submesh );

lod: which LOD to affect(0 to 2), different values will add the settings to all LODs
submesh: set which submesh to affect, if a mesh with multiple submesh is used

[mrgreendotone-dev]

Reserved