How gbeic/bbs-plusplus works
BBS++ is a Fabric client-side extension for BBSFS, adding editing, animation, disguise, playback, rendering, and compatibility features. The principal workflow is to edit a film or disguise in BBS’s UI, configure added form/keyframe data, then render or play it through BBS with the extension’s runtime hooks. README capabilities also include structure tools, AAA particles, item sprays, video billboards, shader curves, and numerous editor fixes. The tree and excerpts establish some registration and mixin behavior; unsampled subsystem links are shown only where the README documents the capability, not as inferred call chains.
Main entry points: BBSPlusPlusModClient.java Client initialization · forms Form editors · BaseFilmControllerMixin.java Film render hooks · AAAParticleFormRenderer.java AAA particle renderer
Components 24
Mod Core
- Client initialization
src/main/java/gbeic/bbsplusplus/client/BBSPlusPlusModClient.java - Addon settings
src/main/java/gbeic/bbsplusplus/BBSAddonsSettings.java - Mod entry
src/main/java/gbeic/bbsplusplus/BBSPlusPlusMod.java
Editing
- Film editor extensions
src/main/java/gbeic/bbsplusplus/mixin/UIFilmControllerGameModeMixin.java - Pose editing
src/main/java/gbeic/bbsplusplus/client/ui/pose - Keyframe extensions
src/main/java/gbeic/bbsplusplus/keyframes/BBSPlusPlusKeyframeFactories.java - Form editors
src/main/java/gbeic/bbsplusplus/client/ui/forms/editors/forms - Film library UI
src/main/java/gbeic/bbsplusplus/client/ui/film
Forms And Rendering
- AAA particle form
src/main/java/gbeic/bbsplusplus/forms/AAAParticleForm.java - AAA particle renderer
src/main/java/gbeic/bbsplusplus/client/renderer/AAAParticleFormRenderer.java - Item spray form
src/main/java/gbeic/bbsplusplus/forms/ItemSprayForm.java - Item spray runtime
src/main/java/gbeic/bbsplusplus/client/renderer/ItemSprayGlobalSystem.java - Structure disguise
src/main/java/gbeic/bbsplusplus/structure/StructureSaver.java - Video billboard form
src/main/java/gbeic/bbsplusplus/forms/VideoBillboardForm.java - Video billboard renderer
src/main/java/gbeic/bbsplusplus/client/renderer/VideoBillboardFormRenderer.java - Particle trigger network
src/main/java/gbeic/bbsplusplus/network/BBSPlusPlusNetwork.java
Playback
- Film render hooks
src/main/java/gbeic/bbsplusplus/mixin/BaseFilmControllerMixin.java - Video timeline state
src/main/java/gbeic/bbsplusplus/client/renderer/VideoTimelineState.java - Equipment transforms
src/main/java/gbeic/bbsplusplus/keyframes/EquipmentTransformRuntime.java - Shader curve support
src/main/java/gbeic/bbsplusplus/mixin/shadercurves/IrisRenderingPipelineMixin.java
Integrations
- Optional mod compatibility
src/main/java/gbeic/bbsplusplus/compat - Texture loading fixes
src/main/java/gbeic/bbsplusplus/mixin/TextureManagerMixin.java - VFX selection compatibility
src/main/java/gbeic/bbsplusplus/mixin/vfx/BbsVfxClientMixin.java
Other components
- BBS user
Connections 24
- BBS user → Client initialization: uses extension
- Client initialization → Mod entry: initializes
- Client initialization → Addon settings: registers features
- BBS user → Film editor extensions: edits films
- BBS user → Pose editing: edits poses
- BBS user → Keyframe extensions: edits tracks
- BBS user → Form editors: configures forms
- BBS user → Film library UI: browses films
- Form editors → AAA particle form: configures
- AAA particle form → AAA particle renderer: renders as
- Form editors → Item spray form: configures
- Item spray form → Item spray runtime: drives runtime
- Form editors → Structure disguise: configures
- Form editors → Video billboard form: configures
- Video billboard form → Video billboard renderer: renders as
- Client initialization → AAA particle renderer: registers renderer
- Client initialization → Video billboard renderer: registers renderer
- Film render hooks → Video timeline state: sets render context
- Film render hooks → Equipment transforms: applies transforms
- BBS user → Film render hooks: plays films
- Shader curve support → Optional mod compatibility: integrates with Iris
- Texture loading fixes → Optional mod compatibility: patches texture loading
- VFX selection compatibility → Optional mod compatibility: patches VFX behavior
- Particle trigger network → AAA particle renderer: signals particle trigger