BlackBox Skinner - Professional Weight Painting Tool

Live Demo GitHub User Manual Interactive Lab

A professional web-based tool for painting vertex weights on 3D skeletal meshes. Part of the BlackBox creative suite.

Features

Painting Tools

Add, subtract, smooth, and replace brushes
Adjustable size and strength
Real-time heat map visualization
Bone influence display

Smart Features

Automatic weight normalization
Validation & auto-fix tools
Mirror weights L to R
Pose testing mode

File Support

Import/Export GLB & GLTF
Save weight data as JSON
Preserve existing animations
Batch processing ready

Educational

Built-in tutorials
Interactive playgrounds
Tooltips & hints
Visual problem indicators

Quick Start

Standalone Mode

Visit https://p0qp0q.com/skinner
Load your GLB model
Start painting!

Local Development

# Clone the repository
git clone https://github.com/increasinglyHuman/BlackBoxWeightPainter.git
cd BlackBoxWeightPainter

# Start a local server (Python)
python3 -m http.server 8080

# Or use any static server
npx serve .

# Visit http://localhost:8080

Documentation

User Manual

Complete guide to using BlackBox Skinner, from basic concepts to advanced techniques.

Read Manual

The Puppet Master's Apprentice

Interactive educational lab for learning weight painting through storytelling and hands-on experiments.

Start Lab

Architecture

BlackBox Weight Painter is designed as a modular, client-side application:

Zero Backend

All processing happens in your browser - no server required.

Privacy First

Your 3D models never leave your machine.

Integration Ready

Can run standalone or embed in BlackBox Studio.

Shared Components

Uses BlackBox shared UI/UX components.

Learning Weight Painting

New to weight painting?

Check out our educational resources designed to make learning intuitive and fun:

User Manual - Complete beginner's guide
Interactive Playgrounds - Learn by experimenting
Video Tutorials - Coming soon!

Technology Stack

Three.js - 3D graphics engine
Vanilla JavaScript - No framework dependencies
WebGL - Hardware-accelerated rendering
ES6 Modules - Modern JavaScript architecture

Performance

60 FPS for meshes under 50k vertices
30+ FPS for meshes up to 100k vertices
GPU acceleration planned for v2.0

Roadmap

v1.0 (Current Release)

Core painting tools (Add/Subtract/Smooth/Replace)
Real-time heat map visualization
Spatial indexing for performance
Pose testing mode
Weight validation & auto-fix
GLB import/export
Signature BlackBox cube animation
Collapsible panel UI

v1.5 (In Development)

Advanced smooth brush algorithm
Mirror painting implementation
Weight transfer between meshes
Undo/redo system
Keyboard shortcuts (Alt+A/S/D/R)
Animation preview support

v2.0 (Future)

GPU-accelerated painting
Support for 100k+ vertex meshes
Full BlackBox Studio integration
Cloud save/load via poqpoq gateway
Collaborative painting sessions
AI-assisted weight suggestions

Integration with BlackBox Studio

Weight Painter is designed to work seamlessly with BlackBox Studio:

Shared file formats
Consistent UI/UX
Unified hotkey system
Common component library

Ready to Start Painting?

Make the invisible art of weight painting visible to everyone

Launch BlackBox Skinner

Part of the BlackBox Creative Suite

Built with love by the BlackBox Team