Heirloom | Custom Crops, Cooking & Diets v2.5

Heirloom 2.5 — Wiki, QoL & Stability Update

A smoother public wiki, cleaner startup, safer workstation recovery, better recipe discovery, improved Cafe visuals, and a long list of quality fixes for players and server owners.​

---

Highlights

• New Heirloom Wiki: The public documentation has been rebuilt into a proper browsable wiki with player guides, server-owner docs, customization pages, addon docs, station pages, recipe indexes, galleries, and reference pages. Start with the new Mixing Bowl page here: Heirloom Wiki - Mixing Bowl.
• Smooth wiki browsing: The wiki now uses instant navigation, search suggestions, highlighted search results, and sidebar scroll restoration, so clicking through station and recipe pages feels much less jumpy.
• Station recipe pages with real detail: Station pages now explain how each workstation is built, what it is for, common recipe chains, likely mistakes, and linked recipe tables with ingredient icons.
• Recipe search command: Added recipe search with autocomplete so players can quickly find recipes by name, station, addon, output, or ingredient.
• Workstation restart recovery: Items placed on cutting boards, ovens, mixing bowls, and other workstations now carry recovery metadata and can be restored safely after restarts, crashes, plugin disables, updates, or chunk reloads.
• Cleaner Cafe presentation: Barista Machine ingredient displays now sit on a cleaner direction-aware shelf layout instead of scattered offsets, and the Barista Machine is now built as an iron trapdoor over quartz stairs.
• Professional startup banners: Heirloom and addons now use one standardized banner renderer. Box rows are aligned, borders stay consistent, and long quotes wrap across multiple rows cleanly.
• Less startup spam: Startup logging is quieter and focuses on useful summaries instead of repeated locale, manager, and addon details.

Player-Facing Fixes

• Blue eggs and brown eggs are no longer treated as vegan ingredients. Dietary labels now correctly recognize them as egg ingredients.
• WATER_BOTTLE ingredients now show as real water bottles in recipe GUIs instead of falling back to a paper placeholder.
• Water bottles now use their own special ingredient path, so water-bottle recipes behave correctly instead of being confused with generic potions.
• Oven and Barista Machine recipe-browser icons were updated to more recognizable materials: smoker for Oven and quartz stairs for Barista Machine.
• Custom food particles are now driven by per-item particle_block data where available, making bite and place effects match the actual food better.
• Removed the confusing flatbread/taco-shell duplicate path so the recipe browser is cleaner and less redundant.
• Prepared foods no longer receive hidden hardcoded regeneration or bonus saturation. Food now follows configured values unless explicit effects or food properties are defined.

Server Owner & Creator Improvements

• Better docs for real configuration work: The wiki now covers installation, permissions, diagnostics, updating, custom foods, custom recipes, custom crops, seed acquisition, advancements, visual integrations, Nexo, ItemsAdder, JSON fields, commands, and config files.
• Recipe chain navigation: The wiki recipe pages link outputs and ingredients together, making it much easier to inspect parent recipes and explain Heirloom systems to players.
• Unified visual providers: Nexo and ItemsAdder support now share the same visual-item path, making custom models easier to support consistently.
• Safer cleanup behavior: The cleanup command now handles station display items safely and drops recovered ingredients instead of silently deleting them.
• Configurable food visuals: Server owners can tune food particle blocks through JSON instead of relying on one hardcoded fallback for everything.
• Quieter diagnostics: Translation and content loading logs now report compact summaries, while detailed checks remain available through commands such as /hl debug test and language tools.

Content & Stability Fixes

• Restored crops-distillery.json with all five grape crop definitions.
• Added real ONION item and ALLIUM crop content, keeping existing seed/world acquisition references valid.
• Cleaned bundled recipe validation warnings: FLOUR now uses BAG_OF_FLOUR, incomplete SAUCE content was retired, and ungated core LOBSTER_THERMIDOR content was removed because lobster belongs to Tides.
• Added and updated language fallback keys across bundled locales.
• Updated the in-game UI style with the newer Heirloom color scheme and cleaner presentation.
• Updated tests for the intentional Cafe barista display layout.
• Added resource regression tests for crop JSON, recipe references, distillery grapes, retired content, locale key completeness, water-bottle display, station recovery, station icons, food balance, and startup cleanup.

Server Owner Notes

• Re-check custom food balance if you previously worked around hidden prepared-meal bonuses.
• Add regeneration, saturation, or other potion effects explicitly through JSON effects or food_property.
• If a world has old orphaned workstation displays, use /hl cleanup [radius] after updating.
• Startup logs should now be shorter, easier to scan, and more professional while keeping the banner boxes.
• Use the new wiki link in listings, guides, and support messages: https://kernel-person.github.io/heirloom-docs/

Heirloom 2.0 — The Ultimate Culinary & Agriculture Update

A massive overhaul introducing seamless third-party claim protections, custom textures with Nexo, advanced item mechanics, in-game debugging diagnostics, and dozens of community-requested features and bug fixes.​

Major Highlights & Compatibility

3D Custom Textures & Nexo Integration
Heirloom 2.0 now features native soft integration with Nexo for custom 3D models and textures.

• Zero-Configuration Auto-Mapping: Automatically looks for a Nexo item matching heirloom_<item_id> (lowercase). For example, the Heirloom item TOMATO will automatically map to Nexo item heirloom_tomato.
• Explicit Custom Mapping: Set a custom Nexo ID via "nexo_id": "namespace:custom_item" in custom_items.json to override auto-mapping.
• Dynamic Visual Shifts (SET_NEXO_ITEM): Recipes can dynamically swap to specific Nexo models (e.g., a variant visual) while preserving all Heirloom attributes (food values, quality, chef tracking).
• API Support: Programmatic registration via .nexoId("your_nexo_item") in ItemDefinitionBuilder for addon developers.
• Startup Verification: Startup logs verify registration status: ✓ Nexo items loaded - 42 matched, 15 using defaults.

Deep Region Protection & WorldGuard Hook
Security and claim safety have been entirely rewritten to support clean server operations.

• Universal Claim Protection: Fires standard Bukkit BlockPlaceEvent and BlockBreakEvent checks during planting/harvesting, offering instant, out-of-the-box compatibility with Towny, GriefPrevention, Lands, and more.
• WorldGuard Hook: Prevents unauthorized interaction with cooking stations (Flags.INTERACT) and planting/harvesting (Flags.BUILD) within protected regions.
• Station Protection: Fully protects all 5 cooking stations from griefing/unauthorized access in foreign claims.

Generic Reusable Container System

• Dynamic Returns (consume_return): Configure any custom item in custom_items.json to return another item when eaten or used in a recipe. For example:
  
  JSON:

  "CANNED_TOMATOES" -> returns "TIN_CAN" when consumed

EcoEnchants & Custom Replanting Compatibility

• Auto-Replant: Supported natively per-crop via replant_after_harvest in crop configuration files (e.g., crops.json).
• EcoEnchants Integration: Full support for ecoenchants:replant and ecoenchants:replenish (forcing replant) as well as ecoenchants:prospector (for bonus fortune drops).
• Late-Load Safety: Safe runtime resolution handles plugins that load after Heirloom.

Advanced New Features

Custom Food Eating Effects
Food items can now grant customizable status effects when consumed. Add them directly inside your item definitions:

JSON:

{
  "id": "GOLDEN_PANCAKE",
  "name": "Golden Pancake",
  "edible": true,
  "food_value": 8,
  "saturation": 6.0,
  "effects": [
    { "type": "REGENERATION", "duration": 200, "amplifier": 1, "probability": 1.0 },
    { "type": "ABSORPTION", "duration": 2400, "amplifier": 0, "probability": 1.0 },
    { "type": "POISON", "duration": 100, "amplifier": 0, "probability": 0.1 }
  ]
}

Seed Packages & World Discovery

• Seed Packets: Added customizable seed packages that players can find throughout the world to discover new crops.

Social Bonus & Chef Tracking

• Cook Tracking: Food now tracks who cooked it in its lore.
• Social Dining: Eating food cooked by other players/friends grants a beneficial social status bonus!

Expanded Language Support
Heirloom 2.0 now supports 26 different languages out of the box (with fully customizable files):
English, Spanish, Russian, German, French, Portuguese, Polish, Turkish, Chinese, Indonesian, Italian, Vietnamese, Dutch, Korean, Czech, Thai, Hungarian, Arabic, Japanese, Ukrainian, Swedish, Danish, Romanian, Slovak, Hebrew, Lithuanian.



Diagnostics & Admin Tools

Real-Time Diagnostic Suite
Ensure your server is configured correctly with /hl debug test (aliases: /hl debug runtests, /hl debug testall). It runs live, in-game assertions on:

• CustomItemManager registry totals.
• Recipe matching accuracy (e.g., validating cooked rice recipes).
• CropManager registration integrity.
• WorldGuard hook state.
• EcoEnchants compatibility.
• Event bypass verification.

Admin Cheat GUI

• Access a convenient admin panel via /hl cheat to easily spawn custom items and test recipes on the fly.

Bug Fixes & Refinements

• Water Bucket Cooking: Fixed cooking interaction where right-clicking boiling pots with a water bucket placed water in the world. Water buckets are now correctly consumed as recipe ingredients.
• Tomato Harvesting Entity Reset: Solved a bug where tomato crops disappeared entirely when harvested; tomatoes now correctly revert back to their unripe green stage.
• Garden Replanting Loop Fix: Solved a regression where claim checks caused the plugin's own replanting events to get cancelled. Introduced a thread-safe checkingPermissions ThreadLocal bypass.
• Minced Meat Recipe: Fixed incorrect recipe definitions for minced meat.
• Addon Content Filtering: Custom items and recipes from uninstalled addons (e.g., Distillery, Pasture) are dynamically filtered out of /hl cheat and the Cookbook to prevent interface clutter.
• Tab Complete & Autocomplete: Added command autocomplete entries for /hl debug test, /hl debug runtests, and /hl debug testall. Overrode both tabComplete Bukkit signatures to guarantee autocomplete works seamlessly across all modern Spigot, Paper, and Purpur platforms.
• CheatGUI & Runtime Class Loading: Fixed a dynamic class-loading NoClassDefFoundError when calling /hl items (the cheat GUI) by ensuring correct Proguard obfuscation rules, verifying deployments with the server stopped, and adding a CheatGUI runtime loading verification test to /hl debug test.

Community & Addons

• Distillery Addon Gift: To celebrate our first addon launch, anyone who purchased the base plugin prior to this update gets the Distillery Addon for free! Thank you all for the incredible support!
• New Plugin Spotlight — Shutterbug : Take high-fidelity photos in-game using a custom-built raytracer inside Minecraft! Save them to albums, frame them, hang them on walls, or take in-game selfies. Very customizable and completely unique. Check it out on BuiltByBit.
• Discord Server Merge: We might soon start consolidating our support channels into a single unified community Discord for faster support, cleaner communication, and centralized feedback.

Happy Holidays! This update brings seasonal cheer, placeable feasts, and a smarter recipe system.​

Seasonal Specialties​

Celebrate the holidays with new festive treats!

• Limited-Time Recipes: Discover special holiday recipes like Holiday Ham, Gingerbread, and Eggnog.
• Seasonal Availability: These items are only craftable during the holiday season.
• Server Owners: You can customize exactly when these holidays start and end in the recipe configuration files!

Improved Dining & Feasts​

The way you interact with food has been reimagined. You can now Place certain foods down as a physical block!

• Share the Love: Placed food works like a Cake—right click to grab a slice!
• Feast Buffs: Sharing a meal is better with friends. When new guests join a feast, it grants Regeneration buffs to everyone already eating.
• Food Properties: Distinct foods now give special effects:
  • Spicy: Feel the heat! (Visual fire effects)
  • Energizing: Get a burst of Speed and Haste.
  • Glowing: Shine bright in the dark!

Quality Matters​

We've refined the food quality system to be clearer and more rewarding.

• 6-Tier Quality: From Poor (⚀) to Perfect (⚅).
• Visual Indicators: Quality is now clearly shown with dice icons in the item name.
• Better Bonuses: Higher quality food grants significantly better saturation. Watch out for Poor quality food—it might leave you feeling a bit queasy!

"What can I cook with this?"​

Ever found an ingredient and wondered what it's used for?

• New Lookup Tool: Right-click an ingredient in the menu to view all recipes that use it.
• Tides Integration: If you have Heirloom Tides, check which fish love your bait directly from the menu!

Native Advancements​

Heirloom now has its own advancement tab in the vanilla advancement screen (press L). Earn achievements for trying new foods, reaching quality milestones, harvesting crops, and more.

• Fully customizable via advancements.json.

Cooking Mastery​

The more you cook a recipe, the better you get. Level up from Novice to Master and unlock up to +30% quality bonus on that dish. Reward your dedicated chefs!

Admin Control: Crop Permissions​

You can now restrict crop planting to specific players or ranks directly in the crop config.

• Granular Control: Assign different permissions to different crops (e.g., require job.farmer for Wheat but rank.vip for Truffles).
• Configurable: Just add the "permission": "your.node.here" line to any crop in your crops.json.

Quality of Life & Fixes​

• Reduced Console Noise: We've cleaned up the logging to be much less spammy during startup and saving.
• Fixed a few bugs

making plugins is hard haha