Skip to content

Latest commit

 

History

History
146 lines (114 loc) · 8.11 KB

README.md

File metadata and controls

146 lines (114 loc) · 8.11 KB

DrawLess

Latest release Build Minecraft 26.2 Fabric Java 25

DrawLess

Less rendering work for busy multiplayer scenes.

DrawLess is a client-side optimization mod for Minecraft 26.2 / Fabric for the scenes that make servers heavy on the client: hundreds of Item Displays and ModelEngine models, crowds of players in armor with items in hand, and dense particles. It started with Item Displays and now covers players and particles as well.

The approach is the same everywhere: geometry that does not change stays on the GPU, and work that would repeat every frame is reused, while movement, animation and lighting stay live. Anything a path does not support falls back to vanilla rendering, and every optimization has its own switch.

Download on Modrinth · Benchmark results

What it offers

Item Displays and models

  • Live geometry: supported Item Display models, including ModelEngine models built from them, keep their meshes on the GPU and draw together; each frame sends only poses, lighting and tint.
  • Parts of these models outside the camera view are skipped for the frame; their ticks and animation keep running.
  • A model cache reuses prepared model layers and refreshes them within a CPU budget.

Players

  • Armor stays on the GPU: armor layers, trims and enchantment glint are drawn in a few calls instead of being rebuilt every frame.
  • Items held and worn on the head stay on the GPU too, including enchantment glint, and share their meshes with Item Displays. Glowing and translucent items keep vanilla rendering.
  • Player bodies with skins that have no semi-transparent pixels stay on the GPU and are drawn in one call; other skins keep vanilla rendering.

Particles

  • Particle light reuse and a fast path for collisions with empty space; particle count and movement are unchanged.

Drawing

  • Batching of compatible draws, with OFF, LIMITED and EXPANDED modes.
  • Optional text/name-tag buffer reuse (OFF by default).

A searchable settings menu with English and Russian translations lists every optimization separately.

Getting started

Install Fabric Loader 0.19.3+, Fabric API 0.161.0+26.2 and Java 25, then place the DrawLess JAR in your Minecraft instance's mods folder. Nothing needs to be installed on the server. Sodium is optional.

Press F8 in-game to open settings. Rebind it under Options → Controls → Key Binds → DrawLess.

Settings are grouped into Rendering, Players, Particles and Advanced. Search works across all categories; hover a setting for more information. Drag numbers to adjust them, hold Shift for finer control, or use the keyboard. Changes save automatically; resetting settings requires confirmation. Existing configurations are preserved when updating.

Compatibility

DrawLess works standalone or with Sodium; Sodium 0.9.2 is the tested version. With ImmediatelyFast, overlapping text and batching optimizations are disabled in DrawLess. With Iris (1.11.4 tested), DrawLess optimizations stay active while shaders are off. While a shader pack is active, feature batching, GPU armor, GPU items on players and GPU player bodies are paused and Live geometry uses ordinary rendering; they resume when shaders are turned off. GPU player bodies are also disabled with mods that change player models or skins (3D Skin Layers, Entity Model Features, Entity Texture Features, Figura, CPM). Unavailable controls explain why they cannot be changed. With Particle Core or AsyncParticles, DrawLess disables its overlapping particle caches. Iris and recognized dynamic-light integrations limit light reuse to the current rendering pass.

EXPANDED batching is enabled by default and can alter overlapping layers. If text backgrounds or other layers look incorrect, select LIMITED or OFF under Rendering → Feature batching. Particle caches can be disabled independently under Particles. They default to ON for new settings; existing saved choices are preserved. GPU armor, GPU items on players and GPU player bodies can be disabled under Players; they default to ON unless saved as OFF. Text reuse defaults to OFF. Keep Live geometry selected for normal play.

Measured performance

Benchmark 04: +54.58% mean paired FPS change on a server spawn with players, DrawLess 1.4.0

A busy server spawn with other players in view measured +54.58% mean paired FPS change (122.06 → 188.61 FPS) with 1.4.0, Sodium and default settings. The scene renders 12–17 player models with their bodies, armor and held items next to about 420 Item Displays. Two more series in the same session measured +61.18% and +68.02%. Tested on a Ryzen 5 5600H / RTX 3060 Laptop GPU.

I cross-checked it the same evening with PresentMon, a frame-time tool outside DrawLess: switching DrawLess off and on gave +38% and +41% in a somewhat lighter scene, with p95/p99 frame times about 20% shorter.

This scene had more players in view than the 1.3.0 benchmark, so the percentages are not a version-to-version comparison. It is a scene-specific result from one session. See the full report for all phases, the population adjustment, raw measurements, conditions and limitations.

Attributions

  • RK_01 / RaphiMC and ImmediatelyFast contributors — ImmediatelyFast, specifically the text and name-tag fast lookup approach in v1.16.5 for Minecraft 26.2. This informed DrawLess's own pass-scoped buffer reuse implementation, including active-buffer validation and shared handling for text and name tags. The IF glyph-renderer mixin classes are not incorporated. ImmediatelyFast's source remains under its LGPL-3.0-or-later terms.
  • RK_01 / RaphiMC and ImmediatelyFast contributors — the enhanced batching and scissor-state comparison approach informed DrawLess's own prepared-material comparison and optional promotion of ordered groups to reorderable batches. LIMITED retains vanilla order permissions; EXPANDED evaluates the broader reordering approach using the existing group list. IF's scissor and group mixin implementations are not incorporated.
  • LlamaLad7 and MixinExtras contributors — MixinExtras, whose composable injection APIs are used by DrawLess's operation and method wrappers.
  • fzzyhmstrs and Particle Core contributors — Particle Core's position and tick-light reuse approaches provided inspiration for DrawLess's particle position, light reuse and collision work.

License

The code is under the MIT license. The mod icon and the banner are simplified recolors of a Minecraft texture, which belongs to Mojang, and are not covered by that license.