# meigoc/dbettermodel architecture

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

- Interactive diagram: https://gitdiagram.com/meigoc/dbettermodel
- Repository: https://github.com/meigoc/dbettermodel

## Overview

DBetterModel is a Denizen bridge for BetterModel, packaged as one plugin supporting BetterModel 1.15.x, 2.x, and 3.x. At startup it detects the installed version and loads a matching compatibility layer; scripts then use registered commands, objects, tags, and events to control models, animations, bones, and trackers. The version-neutral API isolates BetterModel-specific behavior, while ModelService coordinates core operations and event delivery. Some subsystem paths and capabilities come from the README and file tree; unsampled internal wiring is not asserted.

Main entry points: [`src/main/java/meigo/dbettermodel/DBetterModel.java`](https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/DBetterModel.java) (Plugin bootstrap), [`src/main/java/meigo/dbettermodel/services/ModelService.java`](https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/services/ModelService.java) (Model service), [`api/src/main/java/meigo/dbettermodel/compat/api`](https://github.com/meigoc/dbettermodel/tree/main/api/src/main/java/meigo/dbettermodel/compat/api) (Compat contracts), [`compat/v1/src/main/java/meigo/dbettermodel/compat/v1/V1Platform.java`](https://github.com/meigoc/dbettermodel/blob/main/compat/v1/src/main/java/meigo/dbettermodel/compat/v1/V1Platform.java) (BetterModel v1)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bootstrap["Plugin bootstrap"]
  node_bootstrapper["Plugin bootstrap<br/>[DBetterModel.java]"]
end

subgraph group_compat["Compatibility layers"]
  node_v1["BetterModel v1<br/>[V1Platform.java]"]
  node_v2["BetterModel v2<br/>[V2Platform.java]"]
  node_v3["BetterModel v3<br/>[V3Platform.java]"]
end

subgraph group_api["Neutral API"]
  node_api_contracts["Compat contracts"]
end

subgraph group_denizen["Denizen interface"]
  node_commands["Model commands"]
  node_bone_tags["Bone tags<br/>[BMBoneTag.java]"]
  node_entity_tags["Entity tags<br/>[BMEntityTag.java]"]
  node_model_tags["Model tags<br/>[BMModelTag.java]"]
  node_server_tags["Capability tags<br/>[BMServerTags.java]"]
  node_tag_extensions["Tag extensions"]
  node_script_events["Script events"]
  node_keyframe_bridge["Keyframe bridge"]
end

subgraph group_runtime["Model runtime"]
  node_model_service["Model service<br/>[ModelService.java]"]
  node_bone_controller["Bone controller"]
  node_bone_mechanisms["Bone mechanisms"]
end

node_script_user(("Denizen scripts"))
node_bettermodel["BetterModel plugin"]
node_denizen["Denizen"]

node_script_user -->|"runs scripts"| node_denizen
node_denizen -.->|"invokes commands"| node_commands
node_bootstrapper -->|"selects by version"| node_v1
node_bootstrapper -->|"selects by version"| node_v2
node_bootstrapper -->|"selects by version"| node_v3
node_bootstrapper -->|"loads platform"| node_api_contracts
node_v1 -->|"implements"| node_api_contracts
node_v2 -->|"implements"| node_api_contracts
node_v3 -->|"implements"| node_api_contracts
node_bootstrapper -->|"initializes"| node_model_service
node_model_service -->|"registers event sink"| node_api_contracts
node_v1 -->|"adapts API"| node_bettermodel
node_v2 -->|"adapts API"| node_bettermodel
node_v3 -->|"adapts API"| node_bettermodel
node_commands -.->|"requests operations"| node_model_service
node_bone_tags -->|"reads and updates"| node_model_service
node_model_service -->|"caches controllers"| node_bone_controller
node_bone_mechanisms -->|"handles adjustments"| node_bone_controller
node_bootstrapper -->|"registers events"| node_script_events
node_bootstrapper -->|"registers extensions"| node_tag_extensions
node_server_tags -->|"queries capabilities"| node_api_contracts
node_keyframe_bridge -.->|"emits signals"| node_script_events
node_model_tags -.->|"uses model operations"| node_model_service
node_entity_tags -.->|"uses model operations"| node_model_service

click node_bootstrapper "https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/DBetterModel.java"
click node_api_contracts "https://github.com/meigoc/dbettermodel/tree/main/api/src/main/java/meigo/dbettermodel/compat/api"
click node_v1 "https://github.com/meigoc/dbettermodel/blob/main/compat/v1/src/main/java/meigo/dbettermodel/compat/v1/V1Platform.java"
click node_v2 "https://github.com/meigoc/dbettermodel/blob/main/compat/v2/src/main/java/meigo/dbettermodel/compat/v2/V2Platform.java"
click node_v3 "https://github.com/meigoc/dbettermodel/blob/main/compat/v3/src/main/java/meigo/dbettermodel/compat/v3/V3Platform.java"
click node_model_service "https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/services/ModelService.java"
click node_bone_controller "https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/services/BoneController.java"
click node_bone_mechanisms "https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/services/BoneMechanismHandler.java"
click node_commands "https://github.com/meigoc/dbettermodel/tree/main/src/main/java/meigo/dbettermodel/denizen/commands"
click node_bone_tags "https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/denizen/objects/BMBoneTag.java"
click node_entity_tags "https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/denizen/objects/BMEntityTag.java"
click node_model_tags "https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/denizen/objects/BMModelTag.java"
click node_server_tags "https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/denizen/BMServerTags.java"
click node_tag_extensions "https://github.com/meigoc/dbettermodel/tree/main/src/main/java/meigo/dbettermodel/denizen/properties"
click node_script_events "https://github.com/meigoc/dbettermodel/tree/main/src/main/java/meigo/dbettermodel/denizen/events"
click node_keyframe_bridge "https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/denizen/KeyframeScriptBridge.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_bootstrapper toneBlue
class node_v1,node_v2,node_v3 toneAmber
class node_api_contracts toneMint
class node_commands,node_bone_tags,node_entity_tags,node_model_tags,node_server_tags,node_tag_extensions,node_script_events,node_keyframe_bridge toneRose
class node_model_service,node_bone_controller,node_bone_mechanisms,node_script_user,node_bettermodel,node_denizen toneIndigo
```

## Components

### Plugin bootstrap

- [Plugin bootstrap](https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/DBetterModel.java): `src/main/java/meigo/dbettermodel/DBetterModel.java`

### Compatibility layers

- [BetterModel v1](https://github.com/meigoc/dbettermodel/blob/main/compat/v1/src/main/java/meigo/dbettermodel/compat/v1/V1Platform.java): `compat/v1/src/main/java/meigo/dbettermodel/compat/v1/V1Platform.java`
- [BetterModel v2](https://github.com/meigoc/dbettermodel/blob/main/compat/v2/src/main/java/meigo/dbettermodel/compat/v2/V2Platform.java): `compat/v2/src/main/java/meigo/dbettermodel/compat/v2/V2Platform.java`
- [BetterModel v3](https://github.com/meigoc/dbettermodel/blob/main/compat/v3/src/main/java/meigo/dbettermodel/compat/v3/V3Platform.java): `compat/v3/src/main/java/meigo/dbettermodel/compat/v3/V3Platform.java`

### Neutral API

- [Compat contracts](https://github.com/meigoc/dbettermodel/tree/main/api/src/main/java/meigo/dbettermodel/compat/api): `api/src/main/java/meigo/dbettermodel/compat/api`

### Denizen interface

- [Model commands](https://github.com/meigoc/dbettermodel/tree/main/src/main/java/meigo/dbettermodel/denizen/commands): `src/main/java/meigo/dbettermodel/denizen/commands`
- [Bone tags](https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/denizen/objects/BMBoneTag.java): `src/main/java/meigo/dbettermodel/denizen/objects/BMBoneTag.java`
- [Entity tags](https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/denizen/objects/BMEntityTag.java): `src/main/java/meigo/dbettermodel/denizen/objects/BMEntityTag.java`
- [Model tags](https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/denizen/objects/BMModelTag.java): `src/main/java/meigo/dbettermodel/denizen/objects/BMModelTag.java`
- [Capability tags](https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/denizen/BMServerTags.java): `src/main/java/meigo/dbettermodel/denizen/BMServerTags.java`
- [Tag extensions](https://github.com/meigoc/dbettermodel/tree/main/src/main/java/meigo/dbettermodel/denizen/properties): `src/main/java/meigo/dbettermodel/denizen/properties`
- [Script events](https://github.com/meigoc/dbettermodel/tree/main/src/main/java/meigo/dbettermodel/denizen/events): `src/main/java/meigo/dbettermodel/denizen/events`
- [Keyframe bridge](https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/denizen/KeyframeScriptBridge.java): `src/main/java/meigo/dbettermodel/denizen/KeyframeScriptBridge.java`

### Model runtime

- [Model service](https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/services/ModelService.java): `src/main/java/meigo/dbettermodel/services/ModelService.java`
- [Bone controller](https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/services/BoneController.java): `src/main/java/meigo/dbettermodel/services/BoneController.java`
- [Bone mechanisms](https://github.com/meigoc/dbettermodel/blob/main/src/main/java/meigo/dbettermodel/services/BoneMechanismHandler.java): `src/main/java/meigo/dbettermodel/services/BoneMechanismHandler.java`

### Other components

- **Denizen scripts**
- **BetterModel plugin**
- **Denizen**

## Connections

- Denizen scripts → Denizen: runs scripts (evidence: `README.md`)
- Denizen → Model commands: invokes commands
- Plugin bootstrap → BetterModel v1: selects by version (evidence: `README.md`)
- Plugin bootstrap → BetterModel v2: selects by version (evidence: `README.md`)
- Plugin bootstrap → BetterModel v3: selects by version (evidence: `README.md`)
- Plugin bootstrap → Compat contracts: loads platform (evidence: `src/main/java/meigo/dbettermodel/DBetterModel.java`)
- BetterModel v1 → Compat contracts: implements (evidence: `compat/v1/src/main/java/meigo/dbettermodel/compat/v1/V1Platform.java`)
- BetterModel v2 → Compat contracts: implements (evidence: `compat/v2/src/main/java/meigo/dbettermodel/compat/v2/V2Platform.java`)
- BetterModel v3 → Compat contracts: implements (evidence: `compat/v3/src/main/java/meigo/dbettermodel/compat/v3/V3Platform.java`)
- Plugin bootstrap → Model service: initializes (evidence: `src/main/java/meigo/dbettermodel/DBetterModel.java`)
- Model service → Compat contracts: registers event sink (evidence: `src/main/java/meigo/dbettermodel/services/ModelService.java`)
- BetterModel v1 → BetterModel plugin: adapts API (evidence: `compat/v1/src/main/java/meigo/dbettermodel/compat/v1/V1Platform.java`)
- BetterModel v2 → BetterModel plugin: adapts API (evidence: `compat/v2/src/main/java/meigo/dbettermodel/compat/v2/V2Platform.java`)
- BetterModel v3 → BetterModel plugin: adapts API (evidence: `compat/v3/src/main/java/meigo/dbettermodel/compat/v3/V3Platform.java`)
- Model commands → Model service: requests operations (evidence: `src/main/java/meigo/dbettermodel/denizen/commands/BMStateCommand.java`)
- Bone tags → Model service: reads and updates (evidence: `src/main/java/meigo/dbettermodel/denizen/objects/BMBoneTag.java`)
- Model service → Bone controller: caches controllers (evidence: `src/main/java/meigo/dbettermodel/services/ModelService.java`)
- Bone mechanisms → Bone controller: handles adjustments (evidence: `src/main/java/meigo/dbettermodel/services/BoneMechanismHandler.java`)
- Plugin bootstrap → Script events: registers events (evidence: `src/main/java/meigo/dbettermodel/DBetterModel.java`)
- Plugin bootstrap → Tag extensions: registers extensions (evidence: `src/main/java/meigo/dbettermodel/DBetterModel.java`)
- Capability tags → Compat contracts: queries capabilities (evidence: `src/main/java/meigo/dbettermodel/denizen/BMServerTags.java`)
- Keyframe bridge → Script events: emits signals (evidence: `src/main/java/meigo/dbettermodel/denizen/events/BMAnimationSignalEvent.java`)
- Model tags → Model service: uses model operations (evidence: `src/main/java/meigo/dbettermodel/denizen/objects/BMModelTag.java`)
- Entity tags → Model service: uses model operations
