🇬🇧 English

Smart Dispensers

Smart Dispensers elevates vanilla Minecraft dispensers into an intuitive, modular micro-automation and farming engine without requiring complex technical machinery or external energy systems.

The mod registers no new items, blocks, or entities — it operates entirely through vanilla blocks, items, dispenser behaviors, and data components. It is 100% server-side: players can connect to your server without installing any client-side mods!

✨ Features

• Automated Agriculture: Plant crops, seeds, saplings, mushrooms, nether wart, cocoa beans, and sweet berries on appropriate soil.
• Smart Harvesting with Hoes: Harvests mature crops, drops yields, auto-replants at age 0, and spends 1 hoe durability without wasting uses on immature plants.
• Block Tool Processing: Strip logs, scrape copper oxidation/wax with axes, flatten dirt paths, extinguish campfires with shovels, and till farmland with hoes.
• Fluids & Bottles: Fill empty glass bottles from water sources; turn dirt into mud with water bottles.
• Animal Care: Milk cows and goats with buckets, collect stew from mooshrooms with bowls, and trigger breeding mode with food.
• Runtime Configuration: Live /dispenser gamerule commands apply and save config changes instantly with Brigadier autocompletion.
• Cross-Platform Support: Native builds for Fabric, Forge, and NeoForge across Minecraft 1.19.2, 1.21.1, 1.21.4, 1.21.8, and 1.21.11.

🌱 Agriculture & Seed Planting

Dispensers recognize all vanilla crops and plant them automatically on valid soil in front:

Immature crops or incompatible surfaces will not consume seeds in vain.

🌾 Smart Harvesting with Hoes (Auto-Replant)

Placing any wooden, stone, iron, golden, diamond, or netherite hoe into a dispenser facing a mature crop enables Smart Harvesting:

1. Maturity Check: The dispenser validates that the crop (wheat, carrots, potatoes, nether wart, or cocoa) has reached its final growth stage (MAX_AGE).
2. Yield Drop: Mature crops are harvested and their full harvest drops into the world (or into collection hoppers).
3. Auto-Replant: The crop is immediately replanted at growth stage 0 without requiring manual seed insertion.
4. Durability: Consumes exactly 1 durability from the hoe.
5. No Waste: If the plant is not yet fully grown, the hoe action does not fire, preserving durability.

🪓 Tool Processing: Axes, Shovels, and Hoes

Transform blocks in the world with standard survival tools:

• Axes:
  • Strip bark from wood and logs (log → stripped_log).
  • Scrape wax from waxed copper blocks.
  • Scrape oxidation weathering stages off copper blocks.
  • Consumes 1 durability per operation.
• Shovels:
  • Flatten grass, dirt, and coarse dirt into dirt paths (dirt_path).
  • Safely extinguish burning campfires and soul campfires.
  • Consumes 1 durability per operation.
• Hoes:
  • Till dirt, grass, and dirt paths into farmland (farmland).
  • Clean rooted dirt into regular dirt, dropping hanging roots.
  • Consumes 1 durability per operation.

🧪 Fluids, Bottles, Mud & Animal Husbandry

• Water Bottling: Dispensing an empty glass bottle facing a water source block fills the bottle into a Water Bottle (addressing a long-standing vanilla limitation).
• Mud Creation: Dispensing a water bottle facing a Dirt block converts it into Mud and returns an empty glass bottle to the dispenser (or drops it if full).
• Milking Cows & Goats: Dispensing an empty bucket facing a cow or goat fills the bucket with milk (Milk Bucket). Vanilla water and lava bucket logic is 100% preserved.
• Mooshroom Milking: Dispensing a wooden bowl facing a Mooshroom yields mushroom stew (Mushroom Stew).
• Animal Breeding: Dispensing appropriate breeding food (wheat for cows/sheep, carrots for pigs/rabbits, seeds for chickens) facing breedable animals triggers their love mode (setInLove).

⚙️ Configuration

Config file: config/dispensermechanics.json (created automatically upon first run):

{
  "enablePlanting": true,
  "enableHarvesting": true,
  "enableToolAxe": true,
  "enableToolShovel": true,
  "enableToolHoe": true,
  "enableWaterBottling": true,
  "enableMudCreation": true,
  "enableMilking": true,
  "enableBreeding": true
}

Every parameter can be toggled independently at runtime.

⌨️ In-Game Commands

Requires permission level 2 (OP) or game master permissions:

/dispenser help
/dispenser reload
/dispenser gamerule <parameter>
/dispenser gamerule <parameter> <value>

Examples:

/dispenser gamerule enableHarvesting true
/dispenser gamerule enableWaterBottling false
/dispenser reload

Changes made through /dispenser gamerule are applied immediately in memory and written to disk without needing a server restart.

🧩 Compatibility & Technical Notes

• Server-Side Only: Install on dedicated servers or singleplayer worlds. Clients do not need the mod installed.
• Vanilla Compatibility: Does not alter vanilla dispenser loot tables or break vanilla redstone circuits.
• Available Loaders: Fabric (requires Fabric API), Forge, and NeoForge across Minecraft 1.19.2, 1.21.1, 1.21.4, 1.21.8, and 1.21.11.

🇷🇺 Русский

Smart Dispensers

Smart Dispensers превращает обычный ванильный раздатчик Minecraft в полноценный инструмент микро-автоматизации и фермерства без необходимости строить громоздкие технические механизмы или использовать стороннюю энергию.

Мод не регистрирует новых предметов, блоков или сущностей — вся работа ведётся через ванильные предметы, раздатчики и Data Components. Мод полностью серверный: игроки могут заходить на сервер без установки клиентского мода!

✨ Основные возможности

• Автоматическая посадка культур: посев семян, саженцев, моркови, картофеля, грибов, адского нароста, какао-бобов и ягод на подходящую почву.
• Умный сбор урожая мотыгой (Auto-Replant): сбор только созревших растений, выброс добычи, автоматическая пересадка (возраст 0) и расход ровно 1 прочности мотыги.
• Обработка блоков инструментами: обтёсывание бревен и очистка меди топором, создание тропинок и тушение костров лопатой, вспашка грядок мотыгой.
• Жидкости и бутылочки: наполнение пустых стеклянных бутылочек водой из источника, превращение земли в грязь с помощью бутылочки с водой.
• Уход за животными: доение коров и коз ведрами, сбор тушеных грибов с грибных коров мисками, перевод животных в режим размножения едой.
• Мгновенная настройка на лету: изменение параметров через команды /dispenser gamerule с автодополнением Brigadier и сохранением на диск.
• Кросс-платформенность: поддержка Fabric, Forge и NeoForge для версий Minecraft 1.19.2, 1.21.1, 1.21.4, 1.21.8 и 1.21.11.

🌱 Сельское хозяйство и посадка культур

Раздатчик определяет правильную почву перед собой и сажает семена или плоды:

Если блок почвы не подходит или перед раздатчиком уже растет культура — семена не тратятся впустую.

🌾 Умный сбор урожая мотыгой (Auto-Replant)

Если поместить в раздатчик любую мотыгу (деревянную, каменную, железную, золотую, алмазную или незеритовую) перед созревшим растением:

1. Проверка спелости: раздатчик определяет, достигла ли культура (пшеница, морковь, картофель, нарост, какао) максимальной стадии роста (MAX_AGE).
2. Сбор урожая: созревшая культура дропает семена и плоды в мир (или в загрузочную воронку под грядкой).
3. Авто-пересадка: на этом же блоке моментально высаживается новое растение стадии 0 (тратить дополнительные семена не требуется).
4. Прочность: мотыга расходует ровно 1 единицу прочности.
5. Безопасность: если растение еще не созрело, мотыга не срабатывает и не расходует прочность.

🪓 Обработка блоков: топоры, лопаты, мотыги

Позволяет автоматизировать строительные и терраформирующие операции:

• Топоры:
  • Обтёсывают древесину и бревна (log → stripped_log).
  • Соскабливают воск с вощёных медных блоков.
  • Снимают стадии окисления (патину) с медных блоков.
  • Расходуют 1 ед. прочности за действие.
• Лопаты:
  • Превращают траву, землю и каменистую землю в тропинки (dirt_path).
  • Безопасно тушат горящие костры и костры душ.
  • Расходуют 1 ед. прочности за действие.
• Мотыги:
  • Вспахивают землю, дерн и тропинки в грядки (farmland).
  • Очищают укоренившуюся землю, выбивая свисающие корни.
  • Расходуют 1 ед. прочности за действие.

🧪 Жидкости, бутылочки, грязь и животноводство

• Наполнение бутылочек: пустая стеклянная бутылочка, выброшенная перед блоком-источником воды, превращается в Бутылочку с водой (Water Bottle).
• Создание грязи: бутылочка с водой, примененная на блок Земли (Dirt), превращает её в Грязь (Mud) и возвращает пустую бутылочку в инвентарь раздатчика.
• Доение коров и коз: пустое ведро при срабатывании на корову или козу наполняется молоком (Milk Bucket). Ванильная механика ведер с водой и лавой не нарушена.
• Сбор супа с грибных коров: миска при срабатывании на мушрума наполняется тушеными грибами (Mushroom Stew).
• Размножение животных: раздатчик с подходящим кормом (пшеница для коров и овец, морковь для свиней, семена для кур) переводит стоящих перед ним животных в режим любви (setInLove).

⚙️ Конфигурация

Файл конфигурации: config/dispensermechanics.json (создается автоматически при первом запуске):

{
  "enablePlanting": true,
  "enableHarvesting": true,
  "enableToolAxe": true,
  "enableToolShovel": true,
  "enableToolHoe": true,
  "enableWaterBottling": true,
  "enableMudCreation": true,
  "enableMilking": true,
  "enableBreeding": true
}

Каждую механику можно включить или выключить отдельно.

⌨️ Команды в игре

Требуется уровень прав оператора (OP 2) или права гейм-мастера:

/dispenser help
/dispenser reload
/dispenser gamerule <параметр>
/dispenser gamerule <параметр> <значение>

Примеры:

/dispenser gamerule enableHarvesting true
/dispenser gamerule enableWaterBottling false
/dispenser reload

Команды /dispenser gamerule мгновенно изменяют логику на сервере и перезаписывают JSON-файл без перезагрузки сервера.

🧩 Совместимость и технические примечания

• Только для сервера: устанавливается на сервер или в одиночный мир. Клиентам мод не требуется.
• Ванильная совместимость: не ломает стандартные ванильные схемы из редстоуна и таблицы лута раздатчиков.
• Поддерживаемые загрузчики: Fabric (требуется Fabric API), Forge и NeoForge для Minecraft 1.19.2, 1.21.1, 1.21.4, 1.21.8 и 1.21.11.