Skip to content

Texture Browser — browse and assign textures from local folders#909

Open
nklbdev wants to merge 1 commit into
JannisX11:masterfrom
nklbdev:texture-browser
Open

Texture Browser — browse and assign textures from local folders#909
nklbdev wants to merge 1 commit into
JannisX11:masterfrom
nklbdev:texture-browser

Conversation

@nklbdev
Copy link
Copy Markdown

@nklbdev nklbdev commented May 19, 2026

Texture Browser

A panel plugin that lets you browse textures from any local folder and
assign them to selected faces with a single click — no need to manually
import each texture first.

Features

  • 📁 Folder picker — select any folder on disk; textures are listed
    as thumbnails in a responsive grid
  • 🔍 Smart filter — type a substring (e.g. brick) and it
    automatically matches red_brick.png, brick_wall.tga, etc.
    Full glob patterns (*.png, wall_*) are also supported.
    By default, if a string does not contain any glob special characters
    (simple pattern), it is treated as enclosed in asterisks (*).
  • ✅ One-click assign — click a thumbnail to instantly apply the
    texture to all selected faces across all selected meshes
  • 🔖 Used filter — native toolbar toggle to show only textures
    currently in use, so you can spot what's already assigned
  • 🧹 Orphan cleanup — optional setting to automatically remove
    textures that become unreferenced after reassignment
  • 📐 Configurable thumbnail size — 10%–200% in Settings, updates
    the grid live
  • 📂 Configurable scan depth — control how many subfolder levels
    to scan (1–10)
  • ↩️ Undo-safe — full undo/redo support including restoration of
    cleaned-up orphan textures

Technical notes

  • Uses Blockbench 5.0 native Toolbar + BarTextInput + Action +
    Toggle widgets for all controls
  • Minimal Vue — only the texture grid and status messages use a
    template; everything else is Blockbench-native API
  • Native APIs accessed via requireNativeModule() with proper
    permission prompts
  • Panel attaches to the Textures sidebar tab in Edit mode
  • Desktop-only (variant: "desktop")

Preview

Texture list filtering:

2026-05-20.01-36-34.mov

Texture applying and undo:

2026-05-20.01-31-19.mov

A similar material panel in the TrenchBroom editor:

2026-05-20.01-52-13.mov

Example from real project:

screenshot_2026-05-19_00:07:22

@nklbdev nklbdev force-pushed the texture-browser branch 2 times, most recently from 2d84be1 to 7dcf3cf Compare May 19, 2026 21:52
@nklbdev nklbdev force-pushed the texture-browser branch from 7dcf3cf to 6dc1a5d Compare May 22, 2026 22:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant