# JiuWu's Kitchen - Immersive Culinary Art 🍳
> 📖 [View Full Wiki Documentation](https://gitlab.com/jiuwu02/jiuwus_kitchen_wiki/-/wikis/home) | 💬 [Join Discord Community](https://discord.gg/rpD2zAQk) | 👥 [QQ Group](https://qm.qq.com/q/GqGrzHp0wU)
**Breathe Soul and Lively Atmosphere into Your Minecraft Server!**
> Tired of vanilla's monotonous crafting table? Yearning to experience the joy of real cooking in a blocky world? JiuWu's Kitchen transforms your kitchen from a functional crafting station into a gourmet workshop full of strategy and surprises!
## ✨ Core Highlights - Beyond "Crafting", It's "Cooking"
- **🔪 Dynamic Chopping Board Processing**: Say goodbye to one-click crafting! Ingredients need to be placed on the chopping board and cut multiple times with a knife. Watch the progress bar grow, listen to the crisp sound of chopping, and experience the sense of accomplishment of a chef-in-training.
- **🍳 Strategic Chinese Wok** (Brand New: **Heat control** and **sequence** are key to success! Different heat sources (campfire, magma block, lava) provide different levels of heat; the order in which ingredients are added and the number of stir-fries directly affect the final quality of the dish—undercooked if not enough, burnt if too much, perfectly recreating the essence of a master chef!
- **🤕 Immersive Event System**: Configure real kitchen risks! There’s a chance to **cut your finger** while chopping, and bare-handed retrieval from a scalding wok will **cause burns**, adding a touch of thrilling realism to every operation.
- **🎨 Visual and Auditory Feast**: Z-axis random rotation for ingredient placement, high-quality sound effects, particle effects, title animations... All feedback is meticulously designed, with quality rivaling vanilla, offering an audiovisual experience far beyond that of mods.
- **🔌 Seamless Compatibility and Expansion**: Perfectly supports **CraftEngine** custom furniture and **MMOItems** custom items. Whether for survival or RPG servers, easily integrate custom content into the cooking system to create a unique culinary gameplay experience.
---
## 🎮 Detailed Main Features
### 🔪 Chopping Board System - Artisanal Preparation
1. **Intuitive Interaction Logic**: Right-click with an empty hand to place ingredients -> Left-click with a knife to cut -> Finish and collect the product.
2. **Safe Retrieval**: Right-click with an empty hand to retrieve ingredients, preventing waste of precious materials from misoperation.
3. **Visual Progress Indicator**: The action bar on the screen clearly displays: `Progress: 3/5`, providing clear operational feedback.
4. **(Optional) Damage Events**: Configure the probability of cuts and damage value in the settings for a touch of hardcore experience in cooking.
### 🍳 Wok System - Strategic Cooking
1. **Ingredient Sequence is Crucial**: The order in which ingredients are added affects the final outcome. Study recipes deeply to find the optimal combination sequence.
2. **Independent Stir-fry Mechanism**: Each ingredient has an independent "cookedness" count, requiring separate control of stir-fry times.
3. **Master the Heat**: Recipes can require specific heat sources (e.g., Campfire = Low heat, Magma Block = High heat). Using the right heat is half the battle.
4. **Fault Tolerance**: Administrators can configure the allowable stir-fry error margin, making cooking challenging but not frustrating.
5. **Information Overview**: Right-click the wok with a spatula to view all ingredients in the wok and their current stir-fry counts, keeping you in full control.
### ⚙️ Grinder System - Precision Processing (NEW in v1.2)
1. **Time-Based Grinding**: Each ingredient has an independent grinding duration. Sneak + Left-click to start the process and wait for completion.
2. **Randomized Output**: Recipes support setting output quantity (fixed or range) and probability, making every grind an exciting surprise.
3. **Flexible Output Method**: Configure whether finished products drop on the ground or go directly into the player's inventory.
4. **Full Block Compatibility**: Uses vanilla blocks (default: Grindstone) by default, with full support for CraftEngine custom blocks.
### ⚙️ Unlimited Customization Potential
- **Custom Recipes**: Easily add chopping board/wok recipes supporting vanilla or custom items.
- **Custom Tools**: Designate any vanilla tool (e.g., Iron Axe) or CraftEngine/MMOItems equipment as knives or spatulas.
- **Physics Rules**: Configure whether space above the chopping board needs to be clear to avoid conflicts with ceilings.
- **Multi-language Support**: All text can be customized via MiniMessage format, easily adapting to multi-language servers.
---
## 🖼️ Showcase
---
## 🚀 Installation Guide
1. Download the JiuWu's Kitchen plugin file.
2. Ensure your server has **[PySpigot](https://www.spigotmc.org/resources/pyspigot.111006/)** installed.
3. Place the plugin file into the server's `plugins/PySpigot/scripts/` folder.
4. Restart the server or execute `/ps reloadall` in the console to complete the installation.
> **📢 Important**: For optimal performance and compatibility, we strongly recommend using a **Paper** or its fork (like Purpur) server software. After first installation or update, remember to delete old config files to generate new ones!
---
## ❓ Why Choose JiuWu's Kitchen?
> "From basic survival servers to complex RPG servers—from a home kitchen to a chain restaurant! JiuWu's Kitchen provides the deepest cooking experience with minimal configuration!"
>
> **Install now, and let the food on your server be not just cold data, but coveted delicacies!**
**Enjoy the joy of cooking! 👨🍳**