BetterPerlerBeads

# BetterPerlerBeads

BetterPerlerBeads is a client-side rendering optimization mod for BrainLayers bead artwork. It also supports 3D artwork from PerlerBeadsCube when that mod is installed.

Large or layered bead creations can require many faces to be drawn every frame. BetterPerlerBeads caches artwork data and changes how artwork items are rendered to reduce that work. For example, a detailed creation can retain its full appearance when held, while its inventory icon uses a simpler, static front view.

## Features

- **Held artwork:** 2D bead artwork keeps its full pixel detail. For 3D artwork, choose between textured full detail, several face-limited performance modes, a custom face limit, or Cube's original renderer.
- **Inventory icons:** 2D and 3D artwork can appear as static front-facing icons instead of repeatedly rendering a rotating 3D model.
- **Dropped 3D artwork:** When many 3D layers are present in nearby dropped items, the mod can display cached, camera-facing 2D views to reduce rendering load.
- **Item frames:** Artwork in frames has its own quality setting, separate from held items. You can prioritize full detail for a displayed creation or choose a lower-cost mode for a room with many frames.
- **Configurable behavior:** Adjust quality modes, icon resolution, dropped-item thresholds, and cache limits in the client configuration.

The bead table retains BrainLayers' original rendering. This mod changes client visuals and rendering performance; it does not change artwork data, crafting, or server-side behavior.

## Requirements

- Minecraft 1.21.1 with NeoForge
- BrainLayers 1.3.13 or newer (required)
- PerlerBeadsCube (optional, for 3D artwork support)