How meigoc/dbettermodel works
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: DBetterModel.java Plugin bootstrap · ModelService.java Model service · api Compat contracts · V1Platform.java BetterModel v1
Components 19
Plugin bootstrap
- Plugin bootstrap
src/main/java/meigo/dbettermodel/DBetterModel.java
Compatibility layers
- BetterModel v1
compat/v1/src/main/java/meigo/dbettermodel/compat/v1/V1Platform.java - BetterModel v2
compat/v2/src/main/java/meigo/dbettermodel/compat/v2/V2Platform.java - BetterModel v3
compat/v3/src/main/java/meigo/dbettermodel/compat/v3/V3Platform.java
Neutral API
- Compat contracts
api/src/main/java/meigo/dbettermodel/compat/api
Denizen interface
- Model commands
src/main/java/meigo/dbettermodel/denizen/commands - Bone tags
src/main/java/meigo/dbettermodel/denizen/objects/BMBoneTag.java - Entity tags
src/main/java/meigo/dbettermodel/denizen/objects/BMEntityTag.java - Model tags
src/main/java/meigo/dbettermodel/denizen/objects/BMModelTag.java - Capability tags
src/main/java/meigo/dbettermodel/denizen/BMServerTags.java - Tag extensions
src/main/java/meigo/dbettermodel/denizen/properties - Script events
src/main/java/meigo/dbettermodel/denizen/events - Keyframe bridge
src/main/java/meigo/dbettermodel/denizen/KeyframeScriptBridge.java
Model runtime
- Model service
src/main/java/meigo/dbettermodel/services/ModelService.java - Bone controller
src/main/java/meigo/dbettermodel/services/BoneController.java - Bone mechanisms
src/main/java/meigo/dbettermodel/services/BoneMechanismHandler.java
Other components
- Denizen scripts
- BetterModel plugin
- Denizen
Connections 24
- Denizen scripts → Denizen: runs scripts
README.md - Denizen → Model commands: invokes commands
- Plugin bootstrap → BetterModel v1: selects by version
README.md - Plugin bootstrap → BetterModel v2: selects by version
README.md - Plugin bootstrap → BetterModel v3: selects by version
README.md - Plugin bootstrap → Compat contracts: loads platform
src/main/java/meigo/dbettermodel/DBetterModel.java - BetterModel v1 → Compat contracts: implements
compat/v1/src/main/java/meigo/dbettermodel/compat/v1/V1Platform.java - BetterModel v2 → Compat contracts: implements
compat/v2/src/main/java/meigo/dbettermodel/compat/v2/V2Platform.java - BetterModel v3 → Compat contracts: implements
compat/v3/src/main/java/meigo/dbettermodel/compat/v3/V3Platform.java - Plugin bootstrap → Model service: initializes
src/main/java/meigo/dbettermodel/DBetterModel.java - Model service → Compat contracts: registers event sink
src/main/java/meigo/dbettermodel/services/ModelService.java - BetterModel v1 → BetterModel plugin: adapts API
compat/v1/src/main/java/meigo/dbettermodel/compat/v1/V1Platform.java - BetterModel v2 → BetterModel plugin: adapts API
compat/v2/src/main/java/meigo/dbettermodel/compat/v2/V2Platform.java - BetterModel v3 → BetterModel plugin: adapts API
compat/v3/src/main/java/meigo/dbettermodel/compat/v3/V3Platform.java - Model commands → Model service: requests operations
src/main/java/meigo/dbettermodel/denizen/commands/BMStateCommand.java - Bone tags → Model service: reads and updates
src/main/java/meigo/dbettermodel/denizen/objects/BMBoneTag.java - Model service → Bone controller: caches controllers
src/main/java/meigo/dbettermodel/services/ModelService.java - Bone mechanisms → Bone controller: handles adjustments
src/main/java/meigo/dbettermodel/services/BoneMechanismHandler.java - Plugin bootstrap → Script events: registers events
src/main/java/meigo/dbettermodel/DBetterModel.java - Plugin bootstrap → Tag extensions: registers extensions
src/main/java/meigo/dbettermodel/DBetterModel.java - Capability tags → Compat contracts: queries capabilities
src/main/java/meigo/dbettermodel/denizen/BMServerTags.java - Keyframe bridge → Script events: emits signals
src/main/java/meigo/dbettermodel/denizen/events/BMAnimationSignalEvent.java - Model tags → Model service: uses model operations
src/main/java/meigo/dbettermodel/denizen/objects/BMModelTag.java - Entity tags → Model service: uses model operations