Medieval Cookery User Guide

What is Medieval Cookery?

Medieval Cookery is a Spigot plugin that adds craftable medieval-themed food items to Minecraft. Each food is a custom player-head item with its own texture, crafted at the standard crafting table from a shaped recipe defined in recipes.yml.

Installation

The plugin runs on Spigot (or a fork such as Paper) 1.18.1 or newer. An older server refuses to load it with an "unsupported API version" message. The versions every release is tested on are listed under Supported Minecraft Versions in the README.

1. Download the latest Medieval-Cookery-<version>.jar from the Releases page.
2. Place the JAR in your server's plugins/ folder.
3. Restart the server.

On the first startup a default recipes.yml is written to plugins/MedievalCookery/. Edit that file to change or add recipes, then restart the server for the changes to take effect. See CONFIG.md for the full field reference.

Craftable Foods

All recipes use the standard 3×3 crafting table. In the patterns below, each row is one row of the grid and a . marks a slot that must be left empty. The . is a reading aid only — inside recipes.yml an empty slot is written as a space.

Eating a Food

Hold the food in your main hand and right-click. The foods are player heads, which vanilla Minecraft does not treat as edible, so the plugin handles the right-click itself: instead of placing the head as a block, it starts a meal.

• Eating takes 32 ticks — about 1.6 seconds — the same as a vanilla food, with the eating sound playing throughout.
• One food is then taken from your hand, a Saturation effect is applied for the number of ticks the recipe's hungerDecrease sets, and a message confirms the meal.
• If the recipe sets an afterEatItem, that item is added to your inventory. Beet Salad and Bowl of Rice return the Bowl used to craft them.
• Moving the food out of your main hand before the meal finishes cancels it. No food is consumed and no effect is applied in that case.
• Right-clicking again while already eating does nothing; one meal has to finish before the next begins.
• Right-clicking a block that has its own use — a chest, a door, a crafting table — opens that block instead of starting a meal, exactly as carrying a vanilla food does. Sneak while you right-click to eat in front of one.

Known Limitations

A food eaten from the off-hand is not recognised — only the main hand starts a meal.

A food crafted before foods were tagged with their recipe is recognised by its display name together with its skin. Such a food renamed in an anvil can no longer be eaten, and one whose recipe has no textureBase64 cannot be eaten at all, since it cannot be told apart from an ordinary player head given the same name. Foods crafted since then are recognised by their tag, so they can be renamed freely, and a player head renamed after a recipe is not a food.

Support

Open a GitHub issue to report bugs or request features.