Bee Specimens 0.3.0 Development Summary

Overview

Version 0.3.0 makes Bee Specimens extensible by other Forestry CE bee add-on mods.

The main goal is to let mods such as Dimensional Apiculture provide normal item-ID based Bee Specimens for their own custom bee species.

Main Changes

• Added a Bee Specimen provider API for external mods.
• External mods can now declare a Forestry CE species ID and a Bee Specimens item path.
• Bee Specimens loads external definitions and uses them through the same item registration, Specimen Table conversion, and Creative Tab display flow as the built-in Forestry CE specimens.
• Added duplicate detection for species IDs and item paths.
• Clarified that external mods are responsible for translation keys and item models for their own external specimens.
• Added a provider implementation guide and Dimensional Apiculture handoff document.
• Updated mods.toml metadata to expand from the canonical values in gradle.properties.
• Added specifications, a design memo, and ticket ledgers to keep development decisions traceable.

For Mod Developers

External mods implement BeeSpecimenProvider and declare it with META-INF/services/com.suumani.beespecimens.api.BeeSpecimenProvider.

External specimen item IDs become beespecimens:<item path>. Translation keys use item.beespecimens.<item path>, and item models should be provided by the external mod at assets/beespecimens/models/item/<item path>.json.

See:

• docs/spec/40_external_specimen_extensions.md
• docs/development/external_specimen_provider.md
• docs/development/dimensional_apiculture_handoff.md

Compatibility

If no external provider is present, Bee Specimens continues to register only the built-in Forestry CE specimens.

Bee Specimens does not have a hard dependency on Dimensional Apiculture.

Verification

• compileJava passed
• gradlew.bat clean build passed
• Confirmed that Forestry / Patchouli jars are not present in reachable Git history