Cucumber Mod Wiki

Cucumber Mod (also known as Cucumber Library) is a foundational technical mod designed to provide shared code, logic, and resources for a wide suite of popular modifications. Developed by BlakeBr0, it is a mandatory requirement for running mods such as Mystical Agriculture, Iron Jetpacks, Pickle Tweaks, and Extended Crafting.

Beyond its role as a backend library, Cucumber adds several high-utility features for players and modpack developers, specifically focused on data visibility and item identification. It streamlines the development process for BlakeBr0's ecosystem, ensuring that updates to core mechanics (like energy handling or GUI frameworks) are applied consistently across all dependent mods.

Cucumber Mod enhances the standard Minecraft interface by injecting additional data into item and block tooltips. These features are invaluable for players working with complex modpacks or developers debugging recipe tags.

Tag Tooltips

When enabled, this feature adds a list of all Tags (Registry Names) associated with a block or item directly into its tooltip. This allows players to see exactly which categories an item belongs to (e.g., #forge:ingots/iron or #minecraft:planks), making it much easier to determine if an item will work in a specific modded recipe.

• Activation: Requires Vanilla "Advanced Tooltips" to be active (toggled via F3 + H).
• Visuals: Tags appear at the bottom of the tooltip in a distinct color.

Data Component & NBT Tooltips

In version 1.20.1 and beyond, Cucumber provides a detailed view of an item's NBT data (or Data Components). This is particularly useful for identifying the specific properties of modded items, such as the energy stored in a jetpack, the growth stage of a seed, or the internal ID of a custom tool.

• Status: This feature is disabled by default to prevent tooltip clutter.
• Usage: Once enabled in the configuration, players can hover over an item while holding a specific modifier key (usually Shift or Ctrl) to expand the data view.

As a library mod, Cucumber does not introduce traditional gameplay mechanics like survival progression or combat. Instead, its mechanics revolve around Information Display and Mod Interoperability.

Dependency Role

Cucumber acts as the "brain" for several major gameplay systems used in other mods:

• Crop Logic: Handles the custom growth and harvesting mechanics for Mystical Agriculture.
• Energy Framework: Provides the standard Forge Energy (FE) implementation for Iron Jetpacks.
• Recipe Handlers: Manages the complex multi-tier crafting grids found in Extended Crafting.

Cucumber Mod offers a client-side configuration file that allows players to customize how information is displayed. This file is typically located in the /config folder of your Minecraft directory as cucumber-client.toml.

Configuration Options

To enable NBT tooltips, locate the cucumber-client.toml file, change showNBTTooltips to true, and restart the game or use a config-reloading mod.

Because Cucumber is a library, its presence is most felt through the mods that require it. The following is a list of major mods that utilize Cucumber's framework:

• Mystical Agriculture: Resource crops and farming utility.
• Iron Jetpacks: Fully customizable, energy-based flight.
• Pickle Tweaks: Various vanilla+ tools, paxels, and balancing tweaks.
• Extended Crafting: High-tier crafting tables and automation.
• More Buckets: Adds buckets made from various materials (Copper, Quartz, etc.).
• Mystical Agradditions: Tier 6 crops and endgame content for Mystical Agriculture.