Gunwood

Gunwood is a Minecraft performance and visibility utility mod designed for large mechanical areas, complex decorative builds, and Create factories.

It adds a “transparent paint” system: players can paint blocks with the sprayer to hide them from normal view and make them skip as much client-side rendering as possible. When wearing Gunwood Goggles, the hidden blocks become visible again.

Gunwood does not delete blocks, and it is not just a transparent texture replacement. Its goal is to reduce unnecessary rendering work by skipping the rendering of painted blocks whenever possible.

Features

• Paint blocks with the sprayer to hide them
• Remove transparent paint with the scraper
• Wear Gunwood Goggles to see hidden blocks again
• Use the selection tool to paint or scrape large areas
• Let painted blocks allow light to pass through
• Configurable durability, selection limits, overlay range, and compatibility options
• Shift-expanded item tooltips
• Curios support for wearing goggles in a head accessory slot

FPS Improvement Through Render Skipping

Gunwood is built around a simple idea: if a player does not need to see a complex block, the client should avoid rendering it whenever possible.

Instead of only making blocks visually transparent, Gunwood attempts to skip their rendering path. This can reduce client-side rendering pressure in areas with many complex blocks.

This is especially useful for:

• Large Create factories
• Shafts, cogwheels, water wheels, and windmill structures
• Complex decorative builds
• Hidden machinery
• Internal machine structures that only need to be inspected occasionally

Actual FPS gains depend on your hardware, shaders, resource packs, mod list, and world layout. Gunwood does not guarantee a fixed FPS boost in every scenario, but it is designed to reduce unnecessary rendering work.

Native Create Compatibility

Gunwood includes dedicated compatibility for Create, including support for:

• Create blocks and casings
• Shafts, cogwheels, water wheels, and kinetic parts
• Flywheel-based dynamic rendering
• Contraptions such as windmill bearing and mechanical bearing structures

This makes Gunwood especially useful for optimizing the visual load of large Create industrial areas.

Sodium and Shader Compatibility

Gunwood includes compatibility for Sodium’s chunk rendering pipeline, allowing painted blocks to stay hidden even when Sodium replaces Minecraft’s vanilla chunk renderer.

Gunwood also tries to behave correctly in shader environments, reducing cases where hidden blocks continue to appear in special render passes.

FTB Ultimine Compatibility

Gunwood supports FTB Ultimine / chain-style interactions:

• Chain painting with the sprayer
• Chain scraping with the scraper
• Area operations with the selection tool

This makes it much easier to manage large painted regions without editing blocks one by one.

Items

Sprayer

Paints blocks with transparent paint.
Without a selection, it paints single blocks or FTB chain targets. With a Gunwood selection, it paints the selected area.

Scraper

Removes transparent paint.
When held, it shows nearby painted blocks and the current selection. Supports single-block scraping, area scraping, and FTB chain scraping.

Gunwood Goggles

Allows the player to see painted hidden blocks again.
If Curios is installed, the goggles can also be worn in a Curios head accessory slot.

Selection Tool

Creates and adjusts Gunwood selections.
It provides a Create Super Glue-like selection experience, including visible outlines, mouse-wheel resizing, and quick selection clearing.

Configuration

Gunwood provides readable configuration files with bilingual comments. Players and server owners can configure:

• Sprayer and scraper durability
• Durability cost per successful use
• Maximum selection volume
• Batch operation limits
• Light transparency behavior
• Sodium / Create / Contraption compatibility toggles
• Overlay render range
• Outline colors
• Advanced Shift tooltips

Compatibility

Supported environment:

• Minecraft 1.21.1
• NeoForge

Optional compatibility:

• Sodium
• Create
• Flywheel
• FTB Ultimine
• Curios API
• Common shader setups

Sodium, Create, FTB Ultimine, and Curios are optional. Gunwood can run without them.

Notes

• Gunwood does not remove blocks.
• Painted blocks can be seen again by wearing Gunwood Goggles.
• Performance improvements vary depending on the scene.
• For large modpacks or shader-heavy setups, testing in a backup world is recommended.

Credits / Acknowledgements

Gunwood's selection tool interaction design is inspired by Create's Super Glue tool.

Some compatibility and interaction logic was implemented with reference to the Create mod source code.

Create is developed by The Create Team / The Creators of Create. Create's code is licensed under the MIT License, while its assets are All Rights Reserved. This project does not include or redistribute Create's assets.

Gunwood was developed by the author with assistance from AI tools for code suggestions, debugging support, documentation drafting, and implementation planning.

The final implementation, testing, balancing, integration decisions, and release preparation were completed and reviewed by the author.

Gunwood's selection tool interaction is inspired by Create's Super Glue tool, and its Create/Flywheel compatibility was implemented with reference to Create/Flywheel source structure.