# MERICLE’S CUSTOM RECIPES<\/p>\n
## Project Description<\/p>\n
CustomRecipes is a lightweight, developer-friendly Minecraft Spigot plugin that enables server administrators to easily add custom crafting recipes to their Minecraft servers using simple JSON configuration files. The plugin bridges the gap between complex recipe management systems and user-friendly configuration, providing a clean and intuitive way to extend Minecraft’s crafting system.<\/p>\n
## Core Purpose<\/p>\n
This plugin addresses the common need for Minecraft server administrators to add custom crafting recipes without requiring complex programming knowledge. It provides a simple, JSON-based approach to recipe creation that’s both human-readable and easy to maintain:
\n– **File-driven configuration** – Recipes defined in individual JSON files
\n– **Hot-reload capability** – Add recipes without server restarts
\n– **ZenScript-inspired syntax** – Familiar format for experienced users
\n– **Zero dependencies** – Standalone plugin with no external requirements<\/p>\n
## Key Features<\/p>\n
### **JSON-Based Recipe System**
\n– Recipes stored in individual `.json` files in the `recipes\/` folder
\n– Comprehensive error handling with detailed logging for troubleshooting
\n– Automatic example recipe generation on first run<\/p>\n
### **Comprehensive Recipe Support**
\n– **Shaped Recipes**: Position-dependent crafting patterns (like vanilla tools)
\n– **Shapeless Recipes**: Order-independent ingredient combinations (like vanilla dyes)
\n– **Item Tag Support**: Uses Minecraft’s item tags (e.g., `#minecraft:sand`) to accept multiple material variants<\/p>\n
### **Advanced Item Customization**
\n– **Custom display names**: Full color code support using `&` formatting
\n– **Rich lore text**: Multi-line item descriptions with color formatting
\n– **Enchantment application**: Automatic enchantment application to crafted items
\n– **Flexible output quantities**: Support for recipes producing multiple items<\/p>\n
### **Recipe Management**
\n– Hot-reload system with `\/customrecipes reload` command
\n– Recipe validation with detailed error reporting
\n– Automatic registration with Bukkit’s crafting system
\n– Conflict detection and resolution<\/p>\n
### **Developer-Friendly Architecture**
\n– Modular design with clean separation of concerns
\n– Extensible structure for future feature additions
\n– Modern Java practices utilizing Java 21 features<\/p>\n
### **Commands**
\n– `\/customrecipes` – Show plugin information
\n– `\/customrecipes reload` – Reload all recipes without server restart<\/p>\n
## Recipe Format Examples<\/p>\n
### Shaped Recipe (position matters)
\n“`json
\n{
\n “type”: “shaped”,
\n “name”: “reinforced_sword”,
\n “result”: {
\n “item”: “minecraft:diamond_sword”,
\n “count”: 1,
\n “display_name”: “&bReinforced Sword”,
\n “lore”: [“&7Enhanced with special materials”],
\n “enchantments”: {“sharpness”: 2, “unbreaking”: 1}
\n },
\n “pattern”: [
\n [“minecraft:diamond”, “minecraft:diamond”, “minecraft:diamond”],
\n [“minecraft:air”, “minecraft:stick”, “minecraft:air”],
\n [“minecraft:air”, “minecraft:stick”, “minecraft:air”]
\n ]
\n}
\n“`<\/p>\n
### Shapeless Recipe (order doesn’t matter)
\n“`json
\n{
\n “type”: “shapeless”,
\n “name”: “dirt_diamonds”,
\n “result”: {
\n “item”: “minecraft:diamond”,
\n “count”: 4,
\n “display_name”: “&aDirt Diamond”
\n },
\n “ingredients”: [
\n “minecraft:dirt”, “minecraft:dirt”,
\n “minecraft:dirt”, “minecraft:stick”
\n ]
\n}
\n“`<\/p>\n
## Server Impact<\/p>\n
– **Performance**: Efficient recipe registration with minimal runtime overhead
\n– **Compatibility**: Works with Spigot, Paper, and Bukkit-based servers
\n– **Scalability**: Handles numerous custom recipes without performance impact
\n– **Data**: Minimal storage footprint with file-based configuration<\/p>\n
## Installation<\/p>\n
1. Download the plugin JAR file
\n2. Place in your server’s `plugins\/` folder
\n3. Restart the server
\n4. Add JSON recipe files to `plugins\/CustomRecipes\/recipes\/`
\n5. Use `\/customrecipes reload` to load new recipes<\/p>\n","protected":false},"excerpt":{"rendered":"
CustomRecipes is a lightweight Minecraft Spigot plugin that allows server administrators to add custom crafting recipes using simple JSON files. The plugin supports both shaped and shapeless recipes with hot-reload functionality.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"mericles-customrecipes","_minecraft_project_id":"w75viAs8","_minecraft_author":"Mericle","_minecraft_license":"MIT","_minecraft_downloads":22,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mericles-customrecipes.zip","_minecraft_size_bytes":20600,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:26:44.480621Z","_minecraft_date_created":"2025-10-09T04:43:40.014368Z","_minecraft_date_modified":"2025-10-07T12:46:11.985669Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mericles-customrecipes","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-05T18:50:13+00:00","_minecraft_import_hash":"1395957c3a1a784c8528be856545f7aa","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,129],"mod_loader":[132,134],"minecraft_version":[62,37,73,74,38,78,79,80,81,82],"class_list":["post-100613","mod","type-mod","status-publish","hentry","mod_category-paper","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n