YUCP DevTools

Development tools for YUCP package creators and avatar variant management.

Features

Package Exporter

Core Export Features

• Profile-Based Export System - Save and reuse export configurations with customizable metadata
• Bundled Profiles - Create composite packages by bundling multiple export profiles together
• Bulk Export Operations - Export multiple profiles simultaneously with batch processing
• Export Inspector - Preview all assets before exporting with tree view and filtering
• Profile Organization - Organize profiles with folders and tags (preset + custom tags)
• Profile Statistics - Track export count and last export timestamp per profile

Version Management

• Auto-Increment Version - Automatically bump version numbers after export
• Version Increment Strategies - Choose major, minor, or patch increment
• Custom Version Rules - Create custom versioning patterns (semver, date-based, build numbers, etc.)
• @bump Directives - Scan code files for @bump directives and auto-increment versions in-place
• Version Directive Scanner - Project-wide scanning for version directives

Assembly Obfuscation

• ConfuserEx Integration - Automatic ConfuserEx installation and integration
• Preset System - Built-in presets: Minimal, Normal, Aggressive
• Advanced Settings - Fine-grained control over individual protections:
  • Control flow obfuscation with intensity control
  • Reference proxy with configurable depth
  • Constants encryption
  • Resource protection
  • Invalid metadata injection
• IL2CPP Compatibility - IL2CPP-specific optimizations
• Reflection Preservation - Options to preserve names for reflection-dependent code
• Debug Symbol Stripping - Remove debug symbols from obfuscated assemblies

Derived FBX Export

• HDiff Binary Patching - Export FBX variants as small binary patches using HDiff algorithm
• Single Base Mode - Create derived FBX from a single base FBX with binary diff
• Kitbash Mode - Multi-source FBX assembly from recipe-based synthetic bases (requires YUCP_KITBASH_ENABLED)
• Per-Triangle Mapping - Track triangle sources for complex kitbash operations
• Reference Preservation - Maintain prefab compatibility with original FBX GUIDs
• Automatic Patch Application - Patches applied automatically on package import via YUCPPatchImporter

Kitbash System (Advanced)

• Synthetic Base Builder - Build synthetic FBX files from kitbash recipes
• Ownership Mapping - Paint and manage triangle ownership for multi-source meshes
• Ownership Paint Tool - Scene view tool for painting mesh ownership
• Recipe System - Define kitbash recipes with multiple source parts
• Cache System - Intelligent caching of synthetic bases based on recipe hashes
• Requires Unity FBX Exporter - Uses Unity's FBX Exporter package for export

Package Signing

• Certificate Management - Import and manage signing certificates
• Manifest Generation - Automatic manifest creation with package metadata
• Server-Based Signing - Secure server-side signature generation
• Signature Embedding - Automatically embed signatures in exported packages
• Certificate Chain Support - Full certificate chain validation
• Gumroad/Jinxxy Integration - Product ID linking for distribution platforms

Dependency Management

• Automatic Dependency Scanner - Auto-detect VPM and Unity package dependencies
• Dependency Export Modes - Configure how dependencies are handled (include, exclude, reference)
• Package.json Generation - Automatic generation of package.json with dependencies
• VPM Dependency Resolution - Full VPM dependency tree scanning

Ignore & Filtering System

• .yucpignore Files - Gitignore-style exclusion patterns
• Permanent Ignore Folders - Profile-level folder exclusions (persistent across scans)
• File Pattern Filters - Wildcard-based file exclusion (e.g., *.tmp, *.log)
• Folder Name Filters - Exclude folders by name (e.g., .git, Temp)

Media Management

• Custom Package Icons - Inject custom icons into .unitypackage files
• Package Banners - Display custom banners in the exporter window
• Favicon Support - Automatic favicon generation for web assets
• Animated GIF Support - GIF preview and management

Bulk Operations

• Bulk Profile Editor - Edit multiple profiles simultaneously:
  • Set version across all selected profiles
  • Add/remove folders in bulk
  • Configure dependencies in bulk
  • Apply obfuscation settings to multiple profiles
  • Batch version increment strategies

Keyboard Shortcuts

• Export Shortcuts: Ctrl/Cmd+E (export selected), Ctrl/Cmd+Shift+E (export all), Ctrl/Cmd+Enter (quick export)
• Profile Management: F2 or Enter (rename), Ctrl/Cmd+D (duplicate), Delete/Backspace (delete)
• Navigation: Arrow keys, Home/End, PageUp/PageDown for profile navigation
• Search: Ctrl/Cmd+F (focus search)
• Utilities: F5 (refresh), Ctrl/Cmd+Alt+P (select in project), Ctrl/Cmd+Alt+E (show in explorer)
• Standard: Ctrl/Cmd+Z (undo), Ctrl/Cmd+Y or Ctrl/Cmd+Shift+Z (redo)

Templates & Utilities

• Export Profile Templates - Pre-configured templates for quick setup
• Direct VPM Installer - Install VPM dependencies directly from packages
• AutoFinalize System - Automatic editor refresh after compilation
• Backup System - Automatic prefab backup before patch application
• Installation Health Tools - Validate, repair, and clean installation artifacts

Avatar Tools (Avatar Uploader)

Avatar Management

• Avatar Collections - Organize avatars into profiles/collections
• Avatar Asset System - Comprehensive avatar metadata management
• Hero Section - Visual hero slides with configurable avatars
• Performance Metrics - Automatic tracking of polygon counts, materials, performance ratings
• Platform Support - Separate PC and Quest platform configurations

Build & Upload System

• Build Workflows - Three workflow modes:
  • BuildOnly - Build avatar without uploading
  • TestOnly - Test build validation
  • Publish - Build and upload to VRChat
• Batch Operations - Build/upload multiple avatars simultaneously
• Build Queue - Sequential build processing with progress tracking
• Upload Queue - Queue multiple uploads for automated processing
• Blueprint ID Management - Separate or shared blueprint IDs for PC/Quest
• Control Panel Integration - Direct integration with VRChat SDK Control Panel

Avatar Capture System

• Dedicated Capture Window - Full-featured avatar thumbnail capture tool
• Capture Modes - Headshot, FullBody, or Custom camera positioning
• Resolution Presets - VRChat standard resolutions and custom sizes
• Background Options:
  • Transparent backgrounds
  • Solid color backgrounds
  • Gradient backgrounds
  • Custom texture backgrounds
• Lighting Controls - Full lighting setup for optimal capture
• Camera Controls - Position, rotation, FOV, and distance controls
• Post-Processing - Image processing options for final output

Validation & Quality

• Pre-Build Validation - Check avatars for issues before building
• Performance Warnings - Automatic detection of performance issues
• Blueprint ID Validation - Ensure blueprint IDs are properly configured
• Icon Validation - Require avatar icons before first upload

Avatar Metadata

• Categories & Tags - Organize avatars with categories and custom tags
• Release Status - Manage avatar visibility (Private, Public, etc.)
• Version Tracking - Track avatar versions
• Styles - Avatar style tagging system
• Descriptions - Rich text descriptions

Settings & Preferences

• Auto-Upload After Build - Automatically upload after successful build
• Build Notifications - Configurable build status notifications
• Upload Notifications - Upload completion notifications
• Parallel Builds - Optional parallel build processing
• Build Caching - Cache builds for faster iterations
• Gallery Integration - Optional avatar gallery client integration

Model Revision Manager (Beta)

Variant Management

• ModelRevisionBase - Central configuration for managing avatar variants
• ModelRevisionVariant Component - Component-based variant tracking
• Variant Registration - Register and manage multiple variants from a single base
• Variant Status Tracking - Track sync status (Synced, HasOverrides, HasConflicts, OutOfSync)

Transfer Systems

• Blendshape Transfer - Automatically transfer blendshapes between model revisions
• Bone Mapping - Intelligent bone path resolution across variants
• Component Transfers - Transfer components between variants with path resolution
• Animation Remapping - Optional animation curve remapping between variants
• Avatar Descriptor Sync - Synchronize Avatar Descriptor settings

Override System

• Per-Variant Overrides - Material, mesh, and component overrides per variant
• Manual Overrides - Mark components as manual overrides
• Variant-Specific Mappings - Override base mappings per variant
• Transfer Direction Control - Configure send/receive transfer settings per variant

Build-Time Processing

• VRCFury Integration - Automatic build-time processing with VRCFury actions
• Bone Path Resolution - Automatic bone path resolution during build
• Conflict Detection - Detection and logging of transfer conflicts
• Transfer History - Maintain transfer reports and history

Visual Tools

• Model Revision Wizard - Visual wizard for setup and configuration
• Tree View Inspector - Visual tree view of all variants and configurations
• Validation System - Validate variant configurations before processing

Texture Array Builder

Source Modes

• Folder Input - Automatically discover textures from a folder
• Manual List - Manually add textures to the array
• Animated GIF - Extract frames from animated GIF files
• Video Clip - Extract frames from Unity VideoClip assets with frame stepping

Processing Options

• Resolution Controls - Set target width/height with aspect ratio preservation
• Texture Formats - Support for multiple formats:
  • DXT1 (BC1) - 4bpp RGB, desktop, no alpha
  • DXT5 (BC3) - 8bpp RGBA, desktop
  • BC7 - 8bpp RGBA, high quality desktop
  • ETC2 RGBA8 - 4bpp RGBA, modern mobile
  • ASTC 6x6 - ~3.6bpp RGBA, high-end mobile
  • PVRTC RGBA4 - 4bpp RGBA, iOS
  • RGBA32 - 32bpp, uncompressed fallback
• Mipmap Generation - Optional mipmap generation
• Color Space - Linear or sRGB color space options
• Alpha Detection - Automatic alpha channel detection and format selection

Preview System

• Texture Preview - Preview all textures before building
• Array Preview - Visual preview of the final texture array

Other Utilities

Installation Tools

• Validate Install - Check YUCP installation health
• Repair Install - Automatically repair installation issues
• Clean Import Artifacts - Remove temporary installer files and artifacts
• Fix Self-Referencing Dependencies - Repair circular dependency issues

Development Tools

• Derived FBX Debug Window - Debug window for derived FBX operations
• Ownership Map Window - Visual tool for managing kitbash ownership maps
• Kitbash Setup Wizard - Guided setup for kitbash workflows
• Patch Cleanup - Tools for cleaning up patch-related files

Installation

Via VCC (Recommended)

1. Add this VPM repository to your VRChat Creator Companion:

   https://dev.vpm.yucp.club/index.json
   

2. Open your project in VCC

3. Click "Manage Project"

4. Find "YUCP DevTools" and click "+" to install

5. YUCP Components will be installed automatically as a dependency

Manual Installation

1. Download the latest .unitypackage from Releases
2. Import into your Unity project
3. Install YUCP Components as a dependency

Requirements

• Unity 2022.3 or later
• YUCP Components >= 0.2.9 (automatically installed via VPM)
• VRChat SDK3 Avatars (automatically installed via VPM)
• VRCFury

Optional Dependencies

• Unity FBX Exporter - Required for Kitbash synthetic base generation (install via Package Manager: com.unity.formats.fbx)
• ConfuserEx - Automatically downloaded when obfuscation is first used

🔧 Usage

Package Exporter

Quick Start

1. Open from menu: Tools > YUCP > Package Exporter
2. Create an Export Profile: Assets > Create > YUCP > Export Profile
3. Configure folders to export
4. Click "Export Package" to build your .unitypackage

Creating Export Profiles

• Via Asset Menu: Assets > Create > YUCP > Export Profile
• Via Exporter Window: Click "New Profile" in the sidebar
• In Current Folder: Assets > Create > YUCP > Export Profile Here

Advanced Features

• Bundled Profiles: Add other export profiles to bundle their assets together
• Custom Version Rules: Create custom versioning with Assets > Create > YUCP > Custom Version Rule
• @bump Directives: Add // @bump rule_name comments in code files for automatic version bumping
• Derived FBX: Mark FBX files as derived in Model Importer to export as patches
• Package Signing: Configure certificates in Tools > YUCP > Others > Development > Package Signing Settings

Keyboard Shortcuts

• Ctrl/Cmd+E - Export selected profiles
• Ctrl/Cmd+Shift+E - Export all profiles
• Ctrl/Cmd+Enter - Quick export current profile
• F2 or Enter - Rename profile
• Ctrl/Cmd+D - Duplicate profile
• Delete/Backspace - Delete profile
• Ctrl/Cmd+F - Focus search
• F5 - Refresh profiles

Avatar Tools

Quick Start

1. Open from menu: Tools > YUCP > Avatar Tools
2. Create a new Avatar Collection (profile)
3. Add avatars to the collection
4. Configure avatar settings (blueprint IDs, metadata, etc.)
5. Build or upload using the toolbar buttons

Avatar Capture

1. Select an avatar in the Avatar Tools window
2. Click "Capture" or use the capture window button
3. Adjust camera, lighting, and background settings
4. Choose capture mode (Headshot/FullBody/Custom)
5. Capture and save thumbnail

Batch Operations

• Select multiple avatars (Ctrl/Cmd+Click)
• Use "Build All Selected" or "Upload All Selected" from the Build/Upload menus

Model Revision Manager

Quick Start

1. Create a ModelRevisionBase: Assets > Create > YUCP > Model Revision Base
2. Assign the base prefab
3. Add ModelRevisionVariant component to avatar variant prefabs
4. Configure blendshape and component mappings in the base
5. Open manager: Tools > YUCP > Others > Development > Model Revision Manager
6. Build your avatar - transfers process automatically at build time

Wizard

The Model Revision Wizard provides a guided setup process for configuring variants.

Texture Array Builder

Quick Start

1. Open from menu: Tools > YUCP > Others > Development > Texture Array Builder
2. Choose source mode (Folder, Manual List, GIF, or Video)
3. Configure processing settings (resolution, format, mipmaps)
4. Preview textures
5. Build the texture array

Documentation

For detailed documentation:

• Package Exporter Guide: See /Editor/PackageExporter/Templates/README_Template.md
• Custom Version Rules: See /Editor/PackageExporter/CUSTOM_VERSION_RULES.md
• Version Rule Examples: See /Editor/PackageExporter/Examples/README.md
• Model Revision Manager: See component tooltips and inline help
• YUCP Components: https://github.com/Yeusepe/YUCP-Components

Support

• GitHub Issues: GitHub Issues
• Main Package: YUCP Components
• VPM Listing: https://dev.vpm.yucp.club

License

MIT License - See LICENSE.md

---

Made with ❤️ by YUCP Club