# gbeic/bbs-plusplus architecture

> Architecture diagram of the GitHub repository gbeic/bbs-plusplus, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gbeic/bbs-plusplus
- Repository: https://github.com/gbeic/bbs-plusplus

## Overview

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: [`src/main/java/gbeic/bbsplusplus/client/BBSPlusPlusModClient.java`](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/client/BBSPlusPlusModClient.java) (Client initialization), [`src/main/java/gbeic/bbsplusplus/client/ui/forms/editors/forms`](https://github.com/gbeic/bbs-plusplus/tree/main/src/main/java/gbeic/bbsplusplus/client/ui/forms/editors/forms) (Form editors), [`src/main/java/gbeic/bbsplusplus/mixin/BaseFilmControllerMixin.java`](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/mixin/BaseFilmControllerMixin.java) (Film render hooks), [`src/main/java/gbeic/bbsplusplus/client/renderer/AAAParticleFormRenderer.java`](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/client/renderer/AAAParticleFormRenderer.java) (AAA particle renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Mod Core"]
  node_client["Client initialization"]
  node_settings["Addon settings"]
  node_mod["Mod entry"]
end

subgraph group_editing["Editing"]
  node_filmui["Film editor extensions"]
  node_pose["Pose editing"]
  node_keyframes["Keyframe extensions"]
  node_formui["Form editors"]
  node_film_library["Film library UI"]
end

subgraph group_forms["Forms And Rendering"]
  node_aaa_form["AAA particle form"]
  node_aaa_renderer["AAA particle renderer"]
  node_spray_form["Item spray form<br/>[ItemSprayForm.java]"]
  node_spray_system["Item spray runtime"]
  node_structure["Structure disguise"]
  node_video_form["Video billboard form"]
  node_video_renderer["Video billboard renderer"]
  node_network["Particle trigger network"]
end

subgraph group_playback["Playback"]
  node_film_hooks["Film render hooks"]
  node_video_timeline["Video timeline state"]
  node_equipment["Equipment transforms"]
  node_shader["Shader curve support"]
end

subgraph group_compat["Integrations"]
  node_compat["Optional mod compatibility"]
  node_texture_fix["Texture loading fixes"]
  node_vfx_fix["VFX selection compatibility"]
end

node_user(("BBS user"))

node_user -->|"uses extension"| node_client
node_client -->|"initializes"| node_mod
node_client -->|"registers features"| node_settings
node_user -->|"edits films"| node_filmui
node_user -->|"edits poses"| node_pose
node_user -->|"edits tracks"| node_keyframes
node_user -->|"configures forms"| node_formui
node_user -->|"browses films"| node_film_library
node_formui -->|"configures"| node_aaa_form
node_aaa_form -->|"renders as"| node_aaa_renderer
node_formui -->|"configures"| node_spray_form
node_spray_form -->|"drives runtime"| node_spray_system
node_formui -->|"configures"| node_structure
node_formui -->|"configures"| node_video_form
node_video_form -->|"renders as"| node_video_renderer
node_client -->|"registers renderer"| node_aaa_renderer
node_client -->|"registers renderer"| node_video_renderer
node_film_hooks -->|"sets render context"| node_video_timeline
node_film_hooks -->|"applies transforms"| node_equipment
node_user -->|"plays films"| node_film_hooks
node_shader -.->|"integrates with Iris"| node_compat
node_texture_fix -.->|"patches texture loading"| node_compat
node_vfx_fix -.->|"patches VFX behavior"| node_compat
node_network -->|"signals particle trigger"| node_aaa_renderer

click node_client "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/client/BBSPlusPlusModClient.java"
click node_settings "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/BBSAddonsSettings.java"
click node_mod "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/BBSPlusPlusMod.java"
click node_filmui "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/mixin/UIFilmControllerGameModeMixin.java"
click node_pose "https://github.com/gbeic/bbs-plusplus/tree/main/src/main/java/gbeic/bbsplusplus/client/ui/pose"
click node_keyframes "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/keyframes/BBSPlusPlusKeyframeFactories.java"
click node_formui "https://github.com/gbeic/bbs-plusplus/tree/main/src/main/java/gbeic/bbsplusplus/client/ui/forms/editors/forms"
click node_film_library "https://github.com/gbeic/bbs-plusplus/tree/main/src/main/java/gbeic/bbsplusplus/client/ui/film"
click node_aaa_form "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/forms/AAAParticleForm.java"
click node_aaa_renderer "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/client/renderer/AAAParticleFormRenderer.java"
click node_spray_form "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/forms/ItemSprayForm.java"
click node_spray_system "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/client/renderer/ItemSprayGlobalSystem.java"
click node_structure "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/structure/StructureSaver.java"
click node_video_form "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/forms/VideoBillboardForm.java"
click node_video_renderer "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/client/renderer/VideoBillboardFormRenderer.java"
click node_film_hooks "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/mixin/BaseFilmControllerMixin.java"
click node_video_timeline "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/client/renderer/VideoTimelineState.java"
click node_equipment "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/keyframes/EquipmentTransformRuntime.java"
click node_shader "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/mixin/shadercurves/IrisRenderingPipelineMixin.java"
click node_network "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/network/BBSPlusPlusNetwork.java"
click node_compat "https://github.com/gbeic/bbs-plusplus/tree/main/src/main/java/gbeic/bbsplusplus/compat"
click node_texture_fix "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/mixin/TextureManagerMixin.java"
click node_vfx_fix "https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/mixin/vfx/BbsVfxClientMixin.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_client,node_settings,node_mod,node_user toneBlue
class node_filmui,node_pose,node_keyframes,node_formui,node_film_library toneAmber
class node_aaa_form,node_aaa_renderer,node_spray_form,node_spray_system,node_structure,node_video_form,node_video_renderer,node_network toneMint
class node_film_hooks,node_video_timeline,node_equipment,node_shader toneRose
class node_compat,node_texture_fix,node_vfx_fix toneIndigo
```

## Components

### Mod Core

- [Client initialization](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/client/BBSPlusPlusModClient.java): `src/main/java/gbeic/bbsplusplus/client/BBSPlusPlusModClient.java`
- [Addon settings](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/BBSAddonsSettings.java): `src/main/java/gbeic/bbsplusplus/BBSAddonsSettings.java`
- [Mod entry](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/BBSPlusPlusMod.java): `src/main/java/gbeic/bbsplusplus/BBSPlusPlusMod.java`

### Editing

- [Film editor extensions](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/mixin/UIFilmControllerGameModeMixin.java): `src/main/java/gbeic/bbsplusplus/mixin/UIFilmControllerGameModeMixin.java`
- [Pose editing](https://github.com/gbeic/bbs-plusplus/tree/main/src/main/java/gbeic/bbsplusplus/client/ui/pose): `src/main/java/gbeic/bbsplusplus/client/ui/pose`
- [Keyframe extensions](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/keyframes/BBSPlusPlusKeyframeFactories.java): `src/main/java/gbeic/bbsplusplus/keyframes/BBSPlusPlusKeyframeFactories.java`
- [Form editors](https://github.com/gbeic/bbs-plusplus/tree/main/src/main/java/gbeic/bbsplusplus/client/ui/forms/editors/forms): `src/main/java/gbeic/bbsplusplus/client/ui/forms/editors/forms`
- [Film library UI](https://github.com/gbeic/bbs-plusplus/tree/main/src/main/java/gbeic/bbsplusplus/client/ui/film): `src/main/java/gbeic/bbsplusplus/client/ui/film`

### Forms And Rendering

- [AAA particle form](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/forms/AAAParticleForm.java): `src/main/java/gbeic/bbsplusplus/forms/AAAParticleForm.java`
- [AAA particle renderer](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/client/renderer/AAAParticleFormRenderer.java): `src/main/java/gbeic/bbsplusplus/client/renderer/AAAParticleFormRenderer.java`
- [Item spray form](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/forms/ItemSprayForm.java): `src/main/java/gbeic/bbsplusplus/forms/ItemSprayForm.java`
- [Item spray runtime](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/client/renderer/ItemSprayGlobalSystem.java): `src/main/java/gbeic/bbsplusplus/client/renderer/ItemSprayGlobalSystem.java`
- [Structure disguise](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/structure/StructureSaver.java): `src/main/java/gbeic/bbsplusplus/structure/StructureSaver.java`
- [Video billboard form](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/forms/VideoBillboardForm.java): `src/main/java/gbeic/bbsplusplus/forms/VideoBillboardForm.java`
- [Video billboard renderer](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/client/renderer/VideoBillboardFormRenderer.java): `src/main/java/gbeic/bbsplusplus/client/renderer/VideoBillboardFormRenderer.java`
- [Particle trigger network](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/network/BBSPlusPlusNetwork.java): `src/main/java/gbeic/bbsplusplus/network/BBSPlusPlusNetwork.java`

### Playback

- [Film render hooks](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/mixin/BaseFilmControllerMixin.java): `src/main/java/gbeic/bbsplusplus/mixin/BaseFilmControllerMixin.java`
- [Video timeline state](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/client/renderer/VideoTimelineState.java): `src/main/java/gbeic/bbsplusplus/client/renderer/VideoTimelineState.java`
- [Equipment transforms](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/keyframes/EquipmentTransformRuntime.java): `src/main/java/gbeic/bbsplusplus/keyframes/EquipmentTransformRuntime.java`
- [Shader curve support](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/mixin/shadercurves/IrisRenderingPipelineMixin.java): `src/main/java/gbeic/bbsplusplus/mixin/shadercurves/IrisRenderingPipelineMixin.java`

### Integrations

- [Optional mod compatibility](https://github.com/gbeic/bbs-plusplus/tree/main/src/main/java/gbeic/bbsplusplus/compat): `src/main/java/gbeic/bbsplusplus/compat`
- [Texture loading fixes](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/mixin/TextureManagerMixin.java): `src/main/java/gbeic/bbsplusplus/mixin/TextureManagerMixin.java`
- [VFX selection compatibility](https://github.com/gbeic/bbs-plusplus/blob/main/src/main/java/gbeic/bbsplusplus/mixin/vfx/BbsVfxClientMixin.java): `src/main/java/gbeic/bbsplusplus/mixin/vfx/BbsVfxClientMixin.java`

### Other components

- **BBS user**

## Connections

- 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
