How m3-org/characterstudio works
Character Studio is a browser-based 3D avatar creator and asset workflow tool. Users enter the studio, load or choose avatar assets, customize traits and animation, then export avatars or use batch, optimization, wallet, and minting features. The React app selects views while shared scene state initializes and exposes the character manager; it is the internal layer connecting editor interactions to avatar operations. Relationships for unsampled pages and capabilities are included only where documented; some implementation details and integrations could not be verified from the excerpts.
Main entry points: App.jsx Application views · Appearance.jsx Appearance editor · download-utils.js Avatar export · characterManager.js Character manager
Components 26
Studio app
- Application views
src/App.jsx - View state
src/context/ViewContext.jsx - Language state
src/context/LanguageContext.jsx - Audio controls
src/context/AudioContext.jsx - Sound effects
src/context/SoundContext.jsx
Avatar editing
- Appearance editor
src/pages/Appearance.jsx - Asset drop
src/components/FileDropComponent.jsx - Trait attributes
src/components/JsonAttributes.jsx - Editor controls
src/components/BottomDisplayMenu.jsx
3D runtime
- Scene state
src/context/SceneContext.jsx - Character manager
src/library/characterManager.js - Animation manager
src/library/animationManager.js - Manifest data
src/library/CharacterManifestData.js - Model loading
src/library/load-utils.js
Export and batch
- Avatar export
src/library/download-utils.js - VRM exporter
src/library/VRMExporter.js - Mesh merging
src/library/merge-geometry.js - Batch export
src/pages/BatchDownload.jsx - Manifest batch
src/pages/BatchManifest.jsx - Merge options
src/components/MergeOptions.jsx - Avatar optimizer
src/pages/Optimizer.jsx
Wallet and minting
- Mint workflow
src/library/mint-utils.js - Contract interface
src/components/Contract.jsx - Wallet workflow
src/pages/Wallet.jsx
Other components
- Studio user
- Blockchain service
Connections 30
- Studio user → Application views: uses
README.md - Application views → View state: selects views
src/App.jsx - Application views → Appearance editor: renders
src/App.jsx - Application views → Batch export: renders
src/App.jsx - Application views → Manifest batch: renders
src/App.jsx - Appearance editor → Asset drop: renders
src/pages/Appearance.jsx - Appearance editor → Trait attributes: renders
src/pages/Appearance.jsx - Appearance editor → Editor controls: renders
src/pages/Appearance.jsx - Appearance editor → Scene state: reads state
src/pages/Appearance.jsx - Appearance editor → Animation manager: loads animation
src/pages/Appearance.jsx - Scene state → Character manager: initializes
src/context/SceneContext.jsx - Scene state → Manifest data: provides data
- Character manager → Animation manager: owns manager
src/library/characterManager.js - Character manager → Model loading: loads model data
src/library/characterManager.js - Character manager → Avatar export: exports avatar
src/library/characterManager.js - Avatar export → VRM exporter: uses exporter
src/library/download-utils.js - Avatar export → Mesh merging: merges meshes
src/library/download-utils.js - Studio user → Avatar optimizer: optimizes avatar
README.md - Avatar optimizer → Mesh merging: merges meshes
- Batch export → Avatar export: exports assets
src/pages/BatchDownload.jsx - Manifest batch → Manifest data: uses metadata
- Studio user → Mint workflow: mints avatar
- Mint workflow → Avatar export: prepares export
src/library/mint-utils.js - Mint workflow → Contract interface: calls contract
src/library/mint-utils.js - Contract interface → Blockchain service: interacts with
- Studio user → Wallet workflow: manages assets
- Application views → Wallet workflow: renders
src/App.jsx - Studio user → Language state: changes language
- Studio user → Audio controls: controls music
- Studio user → Sound effects: hears effects