How neutralplasma/magicbees works
MagicBees is a Minecraft server plugin for configurable, upgradeable beehives. Players interact with hives to harvest honey or comb and upgrade production; the plugin exposes controller APIs for hive operations, requirements, rewards, providers, and translations. Hive state is cached by chunk and persisted through a DAO, while menus and event listeners provide player-facing interaction. The README is only a title, so capability details come from the API and sampled source; unsampled command and integration wiring is shown only where plugin registration is evidenced.
Main entry points: BeeHiveControllerImpl.kt Hive operations · MagicBeesPlugin.kt Plugin lifecycle · BeeHiveMenu.kt Hive menu · BeeHiveController.kt Hive operations API
Components 18
Plugin entry
- Plugin lifecycle
plugin/src/main/kotlin/eu/virtusdevelops/magicbees/plugin/MagicBeesPlugin.kt - World listeners
plugin/src/main/kotlin/eu/virtusdevelops/magicbees/plugin/listeners - Plugin commands
plugin/src/main/kotlin/eu/virtusdevelops/magicbees/plugin/commands
Hive gameplay
- Hive operations API
api/src/main/kotlin/eu/virtusdevelops/magicbees/api/controllers/BeeHiveController.kt - Hive state model
api/src/main/kotlin/eu/virtusdevelops/magicbees/api/models/BeeHive.kt - Hive operations
core/src/main/kotlin/eu/virtusdevelops/magicbees/core/controllers/BeeHiveControllerImpl.kt
API services
- Requirement parsing
core/src/main/kotlin/eu/virtusdevelops/magicbees/core/requirements - Reward parsing
core/src/main/kotlin/eu/virtusdevelops/magicbees/core/rewards - Provider integrations
core/src/main/kotlin/eu/virtusdevelops/magicbees/core/providers - Translations service
api/src/main/kotlin/eu/virtusdevelops/magicbees/api/controllers/TranslationsController.kt
Hive persistence
- Storage setup
core/src/main/kotlin/eu/virtusdevelops/magicbees/core/controllers/StorageController.kt - Chunk hive cache
core/src/main/kotlin/eu/virtusdevelops/magicbees/core/controllers/BeeHiveStorageController.kt - Hive DAO
core/src/main/kotlin/eu/virtusdevelops/magicbees/core/storage/BeeHiveDao.kt - Hive database
core/src/main/kotlin/eu/virtusdevelops/magicbees/core/storage/mysql/BeeHiveMysql.kt
Player interaction
- GUI controller
gui/src/main/kotlin/eu/virtusdevelops/magicbees/gui/GuiController.kt - Hive menu
gui/src/main/kotlin/eu/virtusdevelops/magicbees/gui/guis/BeeHiveMenu.kt
Other components
- Player
- Minecraft server
Connections 22
- Plugin lifecycle → Storage setup: initializes
plugin/src/main/kotlin/eu/virtusdevelops/magicbees/plugin/MagicBeesPlugin.kt - Plugin lifecycle → GUI controller: initializes
plugin/src/main/kotlin/eu/virtusdevelops/magicbees/plugin/MagicBeesPlugin.kt - Plugin lifecycle → World listeners: registers
plugin/src/main/kotlin/eu/virtusdevelops/magicbees/plugin/MagicBeesPlugin.kt - Plugin lifecycle → Plugin commands: registers
plugin/src/main/kotlin/eu/virtusdevelops/magicbees/plugin/MagicBeesPlugin.kt - Player → World listeners: interacts
- Player → Plugin commands: invokes
- World listeners → Hive operations API: uses
plugin/src/main/kotlin/eu/virtusdevelops/magicbees/plugin/listeners/BlockInteractListener.kt - Plugin commands → Hive operations API: uses
plugin/src/main/kotlin/eu/virtusdevelops/magicbees/plugin/commands/GiveCommand.kt - Hive operations → Hive operations API: implements
core/src/main/kotlin/eu/virtusdevelops/magicbees/core/controllers/BeeHiveControllerImpl.kt - Hive operations → Hive state model: updates
core/src/main/kotlin/eu/virtusdevelops/magicbees/core/controllers/BeeHiveControllerImpl.kt - Hive operations → Chunk hive cache: delegates storage
core/src/main/kotlin/eu/virtusdevelops/magicbees/core/controllers/BeeHiveControllerImpl.kt - Hive operations → Requirement parsing: evaluates
- Hive operations → Reward parsing: applies
- Storage setup → Chunk hive cache: creates
core/src/main/kotlin/eu/virtusdevelops/magicbees/core/controllers/StorageController.kt - Storage setup → Hive DAO: initializes
core/src/main/kotlin/eu/virtusdevelops/magicbees/core/controllers/StorageController.kt - Chunk hive cache → Hive DAO: reads writes
core/src/main/kotlin/eu/virtusdevelops/magicbees/core/controllers/BeeHiveStorageController.kt - Hive DAO → Hive database: implemented by
- GUI controller → Hive menu: manages
- Hive menu → Hive operations API: requests hive data
gui/src/main/kotlin/eu/virtusdevelops/magicbees/gui/guis/BeeHiveMenu.kt - Hive menu → Translations service: requests text
gui/src/main/kotlin/eu/virtusdevelops/magicbees/gui/guis/BeeHiveMenu.kt - Player → Hive menu: uses
- Minecraft server → Plugin lifecycle: hosts