EmakiForge brings deep crafting gameplay to your server. Players learn recipes through blueprints, gather and contribute materials, make trade-offs within capacity limits, and forge equipment of varying quality. The six-tier quality system makes every forge attempt exciting, while the material contribution system turns the forging process itself into meaningful decision-making.<\/p>\n
## Forging Workflow<\/p>\n
A complete forging session follows these steps:<\/p>\n
1. **Blueprint Selection** \u2014 Players open the forge interface and select an unlocked blueprint recipe. Blueprints can be distributed as items or controlled via permissions.
\n2. **Material Input** \u2014 Place base materials and optional materials into the forge GUI. The system displays real-time capacity usage to help plan material combinations.
\n3. **Quality Roll** \u2014 Upon confirmation, the system performs a weighted random roll based on total material contribution to determine the output quality tier.
\n4. **Result Output** \u2014 The final item is generated with quality multipliers applied to attributes, name\/lore modifications executed, audit records written, and the forge is complete.<\/p>\n
## Core Features<\/p>\n
### Quality System<\/p>\n
EmakiForge provides a six-tier quality system, each with independent weight and attribute multiplier:<\/p>\n
| Quality Tier | Default Weight | Multiplier | Description |
\n| ———— | ————– | ———- | —————————————– |
\n| Flawed | 10 | 0.95x | Slightly below standard output |
\n| Common | 60 | 1.0x | Most frequent base quality |
\n| Fine | 30 | 1.05x | Minor improvement |
\n| Superior | 5 | 1.1x | Noticeably above average |
\n| Flawless | 2 | 1.15x | Rare quality, triggers server broadcast |
\n| Perfect | 1 | 1.2x | Extremely rare, triggers server broadcast |<\/p>\n
Key quality features:<\/p>\n
– Weights determine roll probability; more material contribution shifts odds toward higher tiers
\n– Attribute multiplier directly scales all base attribute values defined in the recipe
\n– Each tier can have independent name prefixes (e.g., [Perfect], [Fine])
\n– Pity system: after a configurable number of consecutive forges, a minimum quality is guaranteed (default: Flawless after 60 attempts)
\n– Quality pools can be customized globally or per-recipe<\/p>\n
### Material Contribution System<\/p>\n
Forging isn’t simple crafting \u2014 it’s a strategic contribution process:<\/p>\n
**Base Materials**
\n– Minimum requirements that must be fully met before forging can begin
\n– Each base material has fixed quantity requirements and capacity cost<\/p>\n
**Optional Materials**
\n– Extra input to improve quality chances or add special effects
\n– Each optional material provides different attribute directions (fire damage, movement speed, magic penetration, etc.)
\n– The number of optional material types per forge is capped by `optional_material_limit`<\/p>\n
**Capacity Limit**
\n– Total `capacity_cost` of all materials cannot exceed the recipe’s `forge_capacity`
\n– Forces players to make trade-offs between multiple optional materials
\n– Special materials can provide `capacity_bonus` effects to expand the capacity ceiling<\/p>\n
**Contribution Calculation**
\n– Each material has an independent capacity cost value (`capacity_cost`)
\n– Material effects stack additively onto the output item upon successful forge
\n– Quality multiplier is applied to all material-provided attribute values<\/p>\n
### Name\/Lore Action System<\/p>\n
Six action types for modifying output item appearance:<\/p>\n
| Action Type | Description | Example Use |
\n| —————- | —————————————- | ———————————- |
\n| `append_suffix` | Append text to end of item name | Add `[Flame]` marker |
\n| `prepend_prefix` | Prepend text to beginning of item name | Add quality tag `[Perfect]` |
\n| `prepend` | Insert lines at top of lore | Display quality info |
\n| `append` | Append lines at bottom of lore | Add attribute descriptions |
\n| `insert_below` | Insert lines below a matched anchor line | Insert values below “Forge Stats:” |
\n| `replace_line` | Replace the entire matched anchor line | Update existing attribute values |<\/p>\n
All name\/lore modifications are built on CoreLib’s Ledger system, making them fully reversible and layer-independent. If an item is later modified by another system, the forge layer can be independently reverted without affecting other layers.<\/p>\n
### Effect System<\/p>\n
Each material can provide multiple effect types:<\/p>\n
| Effect Type | Description |
\n| —————- | ———————————————————————————— |
\n| `variables` | Expression engine variables for lore placeholder rendering and attribute calculation |
\n| `ea_attribute` | EmakiAttribute PDC attributes written directly to item data |
\n| `es_skill` | EmakiSkills skill binding for active\/passive abilities |
\n| `name_action` | Item display name modifications |
\n| `lore_action` | Item lore description modifications |
\n| `capacity_bonus` | Special type that expands the forge capacity ceiling for the current session |<\/p>\n
Effects support variable placeholders (e.g., `{physical_damage}`, `{fire_damage}`) that are automatically resolved to actual values during lore rendering.<\/p>\n
### Recipe Codex GUI<\/p>\n
Players can browse all available recipes through a codex interface:<\/p>\n
– Chest-based GUI displaying all registered forge recipes
\n– Shows required materials, quantities, and capacity costs
\n– Displays possible quality ranges and attribute directions
\n– Pagination support for large recipe collections
\n– Completed recipes marked with “Crafted” status<\/p>\n
### Forge Audit Trail<\/p>\n
Every forged item stores complete forging information via PDC (PersistentDataContainer):<\/p>\n
– **Crafter** \u2014 Player UUID and name who performed the forge
\n– **Blueprint** \u2014 Recipe ID used
\n– **Materials** \u2014 Type and quantity of each material contributed
\n– **Quality** \u2014 Rolled quality tier and multiplier
\n– **Timestamp** \u2014 Millisecond-precision forge time<\/p>\n
Audit data supports post-forge refresh: when recipes are updated, existing items can recalculate attributes from audit records without requiring players to re-forge.<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission |
\n| —————– | ———————————– | ——————- |
\n| `\/ef help` | Display help information | `emakiforge.use` |
\n| `\/ef forge` | Open the standalone forge interface | `emakiforge.use` |
\n| `\/ef book` | Open the recipe codex | `emakiforge.book` |
\n| `\/ef reload` | Reload all configuration files | `emakiforge.reload` |
\n| `\/ef list recipe` | List all loaded recipes | `emakiforge.admin` |<\/p>\n
Command aliases: `\/eforge`, `\/ef`<\/p>\n
## Permissions<\/p>\n
| Permission Node | Description | Default |
\n| ——————- | ——————– | ———– |
\n| `emakiforge.use` | Basic forge access | All players |
\n| `emakiforge.book` | Recipe codex access | All players |
\n| `emakiforge.reload` | Reload configuration | OP |
\n| `emakiforge.admin` | Full admin access | OP |<\/p>\n
## PAPI Placeholders<\/p>\n
Prefix: `%emakiforge_ | Placeholder | Description | ## Ideal Server Types<\/p>\n EmakiForge is particularly well-suited for:<\/p>\n – **RPG\/MMORPG servers** \u2014 Provides deep crafting gameplay as an alternative to simple crafting tables Not recommended for pure vanilla survival or small casual servers, as the forge system requires configuration effort and player learning investment.<\/p>\n ## Requirements<\/p>\n | Item | Requirement | View Full Wiki Documentation | Join Discord Community | QQ Group<\/p>\n","protected":false},"excerpt":{"rendered":" Blueprints, material contribution, capacity limits, six quality tiers \u2014 a complete forging chain from raw materials to finished gear.<\/p>\n","protected":false},"featured_media":62685,"template":"","meta":{"_minecraft_slug":"emaki-forge","_minecraft_project_id":"Ksqjj9TX","_minecraft_author":"JiuWu","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":85,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"emaki-forge.zip","_minecraft_size_bytes":3326698,"_minecraft_version_count":17,"_minecraft_updated_at":"2026-05-15T20:03:27.347458Z","_minecraft_date_created":"2026-03-28T01:46:04.861930Z","_minecraft_date_modified":"2026-05-11T07:40:33.583309Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/emaki-forge","_minecraft_icon_attachment_id":62685,"_minecraft_imported_at":"2026-06-03T15:05:43+00:00","_minecraft_import_hash":"a08c78056f2cef843e839532f39fd7e0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[88,89,866,127,128,129],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-62684","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-equipment","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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
\n| ————————- | ————————————————————— |
\n| `recipe_count` | Total number of loaded recipes |
\n| `craft_count_
\n| `has_crafted_
\n| `total_crafts` | Player’s total forge count across all recipes |
\n| `last_crafted` | Recipe ID of the player’s most recent forge |
\n| `guarantee_
\n– **Long-term survival servers** \u2014 Quality system provides ongoing goals for extended play
\n– **Economy servers** \u2014 Quality variance naturally creates trading markets
\n– **Dungeon servers** \u2014 Dungeon material drops + forge system creates complete gear loops<\/p>\n
\n| —————– | ——————————————- |
\n| Server | Spigot 1.21+ |
\n| Java | 21+ |
\n| Hard Dependencies | EmakiCoreLib |
\n| Soft Dependencies | EmakiAttribute, EmakiSkills, PlaceholderAPI |<\/p>\n