Advanced Realistic Shadow System for lilToon with Modular Avatar AAO integration. Features real-time PCSS, volumetric shadows, subsurface scattering, and performance optimization. Now with enhanced VCC compatibility and semantic versioning support.
- Real-time PCSS: Percentage-Closer Soft Shadows with dynamic quality adjustment
- Volumetric Shadows: Advanced volumetric shadow effects with density and step controls
- Subsurface Scattering: Realistic subsurface scattering with strength and color controls
- Real-time Reflection: Dynamic reflection system with strength and roughness controls
- Distance-based Quality: Automatic quality adjustment based on distance
- Performance Optimization: LOD, frame rate, memory, and GPU optimization
- Reflection-based Integration: Safe dependency management without direct dependencies
- Real-time Parameter Control: Dynamic parameter changes through ModularAvatar
- Automatic Menu Generation: Automatic ModularAvatar menu setup
- Blend Shape Control: Dynamic blend shape control for avatar customization
- Dynamic Light Control: Real-time light intensity adjustment
- Environmental Light Control: Dynamic environmental light adjustment
- Volumetric Lighting: Advanced volumetric lighting effects
- Real-time Reflection: Dynamic reflection control
- Quality-based Control: Dynamic adjustment based on quality level
- Time-based Control: Dynamic changes based on time progression
- Distance-based Control: Dynamic adjustment based on distance
- Performance Optimization: Automatic performance adjustment
- Dynamic LOD: Distance-based LOD control
- Frame Rate Optimization: Dynamic frame rate adjustment
- Memory Optimization: Automatic memory usage optimization
- GPU Optimization: Dynamic GPU usage optimization
- 18 Categorized Settings: Organized settings in 18 categories
- Auto-upgrade Functionality: Automatic conversion of existing lilToon materials
- Quick Actions: Quality presets and bulk feature control
- Modular Avatar Integration: Dedicated setup functionality
- Automatic Checkpoint Saving: 5-minute interval automatic saves
- Emergency Save Functionality: Ctrl+C and abnormal termination protection
- Backup Rotation System: Maximum 10 automatic backups
- Session Management: Unique ID for complete session tracking
- Signal Handler Support: SIGINT, SIGTERM, SIGBREAK handling
- Recovery System: Automatic restoration from previous session
- Data Integrity: JSON+Pickle composite saving
- VCC Compatibility: Full VRChat Creator Companion support
- Semantic Versioning: Semantic Versioning 2.0.0 compliance
- Version Management: Automated version bumping and tracking
- Package Repository: Enhanced VPM repository structure
- Dependency Management: Improved dependency resolution
- Unity 2019.4 or later
- Universal Render Pipeline (URP) 7.0.0 or later
- Core Render Pipeline 7.0.0 or later
- lilToon: Compatible with lilToon shaders
- Modular Avatar AAO: Optional integration (reflection-based, no direct dependency)
- VRChat Creator Companion: For VCC package management
- VRChat SDK: 3.5.0 or later
- Modular Avatar: 1.12.5 or later
- Open VRChat Creator Companion
- Go to "Worlds" or "Avatars" project
- Click "Add Package"
- Search for "lilToon PCSS Extension"
- Click "Install"
- Open Unity Package Manager
- Click the "+" button
- Select "Add package from git URL"
- Enter:
https://github.com/liltoon-pcss-extension/com.liltoon.pcss-extension.git
git submodule add https://github.com/liltoon-pcss-extension/com.liltoon.pcss-extension.git- Download the latest release
- Extract to your Unity project's
Packagesfolder - Restart Unity
- Select your avatar's root GameObject
- Go to
Tools/lilToon PCSS Extension/Advanced Integration/Setup Advanced Integration - All systems will be automatically set up
- Create lilToon Modular Avatar: Modular Avatar integration only
- Setup Advanced Lighting System: Advanced lighting only
- Create Dynamic Material System: Dynamic materials only
- Setup Advanced Shader System: Advanced shaders only
- Create Performance Optimizer: Performance optimization only
- Select a material
- Change shader to "lilToon/Advanced Modular Avatar Integration"
- Configure detailed settings in the custom editor GUI
- Apply presets using quick actions
# マイナーバージョンをインクリメント（新機能追加）
python scripts/version_manager.py bump-minor
# パッチバージョンをインクリメント（バグ修正）
python scripts/version_manager.py bump-patch
# メジャーバージョンをインクリメント（破壊的変更）
python scripts/version_manager.py bump-major
# 特定のバージョンを設定
python scripts/version_manager.py set-version --version 2.1.0| Feature | This Implementation | Competitor A | Competitor B |
|---|---|---|---|
| lilToon Integration | ✅ Complete | ❌ None | |
| Modular Avatar Integration | ✅ Complete | ❌ None | |
| Advanced Lighting | ✅ Implemented | ❌ None | |
| Dynamic Materials | ✅ Implemented | ❌ None | ❌ None |
| Advanced Shaders | ✅ Implemented | ❌ None | ❌ None |
| Performance Optimization | ✅ Implemented | ❌ None | |
| Custom Editor GUI | ✅ Implemented | ❌ None |
| Metric | This Implementation | Competitor A | Competitor B |
|---|---|---|---|
| Memory Usage | Low | Medium | High |
| GPU Usage | Optimized | Basic | Unoptimized |
| Frame Rate | Stable | Unstable | Unstable |
| Load Time | Fast | Medium | Slow |
- Ultra Realistic: Maximum quality with all features enabled
- Photorealistic: High quality with balanced features
- Cinematic: Medium quality optimized for cinematic effects
- Anime Enhanced: Optimized for anime-style rendering
- Performance: Maximum performance with minimal quality loss
The custom editor GUI provides 18 categories of settings:
- Basic Settings
- Modular Avatar Integration
- Advanced Lighting System
- Dynamic Material System
- Advanced Shader System
- Performance Optimization
- Shadow Settings
- PCSS Settings
- Volumetric Settings
- Reflection Settings
- Subsurface Scattering
- Quality Settings
- VRC Light Volumes
- Anime Settings
- Cinematic Settings
- Rendering Settings
- Stencil Settings
- Ensure lilToon is properly installed
- Check Unity version compatibility
- Verify URP is installed and configured
- Modular Avatar AAO is optional (reflection-based integration)
- Check for any ModularAvatar version conflicts
- Ensure proper avatar setup
- Use performance presets for better frame rates
- Enable performance optimization features
- Adjust quality settings based on your hardware
- GitHub Issues: Report bugs and request features
- Documentation: Wiki and guides
- Email Support: [email protected]
Due to the complete rewrite in version 2.0.0, migration requires:
- Backup your project before upgrading
- Remove old package completely
- Install new package version 2.0.0
- Run auto-upgrade using the new menu items
- Review and adjust settings in the new advanced GUI
- Test thoroughly with your existing avatars
- Complete API rewrite
- New shader names and properties
- Different menu structure
- New dependency requirements
- Changed Unity version compatibility
- Additional quality presets
- More detailed benchmark features
- User setting save/restore functionality
- Enhanced real-time reflection
- More advanced volumetric shadow features
- Custom shader feature additions
- Integration with other shaders (Poiyomi, Unity Standard)
- Cloud-based setting synchronization
- AI-driven automatic optimization
We welcome contributions! Please see our Contributing Guidelines for details.
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.
- lilToon Team: For the excellent base shader system
- Modular Avatar Team: For the powerful avatar customization system
- Unity Technologies: For the amazing game engine
- VRChat Community: For inspiration and feedback
- GitHub: liltoon-pcss-extension
- Email: [email protected]
- Discord: Join our community
Version: 2.0.0
Last Updated: 2025-01-28
Unity Compatibility: 2019.4+
License: MIT