Animal Pen

[0.2.0] - The Interactivity update

Added

• Tool-Based Interactions

  • Bucket on cows/goats: Collect milk (with 5-second cooldown)
  • Bucket on chickens: Collect all stored eggs from passive generation
  • Glass bottle on bees: Collect honey (requires 3+ bees, with cooldown)
  • Bowl on mooshrooms: Collect mushroom stew (with cooldown)
  • Shears on sheep: Harvest 1-3 wool of the sheep's color (with cooldown)
  • Shears on bees: Collect 1-2 honeycomb (requires 3+ bees, with cooldown)
  • Brush on armadillos: Collect armadillo scutes (with cooldown)
  • Dye items on sheep: Change sheep color permanently

• Passive Resource Generation

  • Chickens automatically lay eggs every 5 minutes (per chicken)
  • Bees produce honey bottles every 10 minutes (3 bees = 1 bottle, max 4 per cycle)
  • Resources stored internally up to 16 items per type
  • Sneak + empty hand on pen to collect all passive resources
  • Visual feedback and sounds when resources are generated

• Enhanced Bee Rendering

  • Bees now render with a decorative beehive on the north fence post
  • Beehive displays honey level (0-5) based on stored honey bottles
  • Bee entity hovers in front of beehive with gentle animation
  • Beehive faces toward the pen interior

• Improved Visual Feedback

  • Health bar displays current and max health for damaged animals
  • Health bar color changes based on health percentage (green/yellow/red)
  • Count text now has semi-transparent background for better visibility
  • Damage particles and hurt animations synced between client and server

• Utility Systems

  • AnimalSoundUtils: Centralized entity sound mapping for hurt/death sounds
  • EntityDataUtils: Standardized NBT data handling for captured animals
  • EntityRenderUtils: Entity scaling and rendering helper methods
  • EntityTypeUtils: Safe entity type validation and registry lookups
  • ItemStackUtils: Item collection management (merging, counting, removing)
  • StoredAnimal: Dedicated data structure for animal storage with health tracking

Changed

• Refactored entity data storage to use proper NBT component system
• Improved entity render caching to reduce performance overhead
• Tool interactions now properly damage tools (except in creative mode)
• Breeding cooldown now tracked per-pen instead of globally
• Resource generation timers persist through world reload
• Loot generation now uses proper LootParams and damage sources

Fixed

• Entity rendering no longer creates duplicate entities every frame
• Proper UUID handling when releasing captured animals
• Health properly resets when animal dies and next animal takes its place
• Cached render entities are cleared when entity type changes
• Tool durability properly consumed in survival mode