mCraft

Source-provided project description. FreeMinecraftMods keeps creator credit and adds separate compatibility and decision guidance below.

Project overview

mCraft Custom items and exact shaped or shapeless recipes for Paper, Purpur, and Folia. ## What it does - Defines custom items with stable PDC IDs, versions, MiniMessage names/lore, enchantments, unbreakable state, and modern `item_model` components. - Creates shaped and shapeless recipes with exact custom-item ingredients. - Indexes recipe candidates by material instead of scanning every recipe on each grid update. - Provides a localized in-game browser and virtual recipe editor. Editor previews never consume or duplicate player-owned items. - Supports recipe permission, minimum-level, world allow-list, and automation conditions. - Adds item tags and item flags, plus automatic version upgrades that preserve stack amount and durability. - Exposes `MCraftAPI` through Bukkit Services Manager, including tag queries and overflow-safe item grants. mCraft uses modern `item_model` components but does not generate or distribute resource packs. ## Requirements - Java 25 - Paper, Purpur, or Folia 26.2 ## Install 1. Put `mCraft-1.1.0.jar` in `plugins`. 2. Start the server. 3. Add item definitions under `plugins/mCraft/items` or use the GUI recipe editor. Items use stable `mcraft:item_id` and `mcraft:item_version` PDC tags. Increment an item's `version` after changing its definition; old copies upgrade on join, pickup, or hotbar selection without repairing their durability. English is the default language. Set `language: ru_RU` in `config.yml` and run `/mcraft reload` to switch to Russian. Existing language files receive new default keys automatically. ## Item example ```yaml id: ruby_sword material: DIAMOND_SWORD display-name: " Ruby Sword" lore: - " Forged from ruby" version: 2 item-model: "my_pack:ruby_sword" unbreakable: false tags: [weapon, ruby] item-flags: [hide_attributes] enchantments: sharpness: 6 ``` IDs must match `[a-z0-9][a-z0-9_-]{0,63}`. Files with invalid IDs or malformed values are skipped with a focused warning instead of disabling the plugin. ## Recipe conditions The in-game editor creates shaped and shapeless recipes. Advanced conditions can be added to the generated recipe YAML: ```yaml conditions: permission: "mcraft.craft.ruby_sword" minimum-level: 15 worlds: [world, world_nether] allow-automation: false ``` Custom ingredients are matched by stable PDC ID, not display name or base material. Vanilla ingredients deliberately reject mCraft custom items made from the same material. ## Commands and permissions - `/mcraft` — GUI, `mcraft.command.mcraft` - `/mcraft item ` — open an item directly - `/mcraft recipe ` — open a recipe directly - `/mcraft give [amount] [player]` — `mcraft.command.give` - `/mcraft reload` — `mcraft.command.reload` - `mcraft.admin` grants all permissions. ## API Obtain `MCraftAPI` from Bukkit's Services Manager. It supports item lookup, tag lookup, ID lookup, overflow-safe giving, and upgrading older item versions without direct storage access. ## Telemetry and updates mCraft uses anonymous [bStats metrics](https://bstats.org/plugin/bukkit/mCraft/33357). Disable them with `metrics.enabled: false`. No item contents or player identifiers are collected. Disable public version checks separately with `updates.enabled: false`. ## Build ```bash ./gradlew clean build ``` Licensed under the MIT License.

FreeMinecraftMods decision guide

This mod is most relevant to players looking for game mechanics, utility on folia, paper, purpur. Treat those labels as discovery hints, then verify the exact file and dependency list on the official project page.

The source record was updated on Aug 31, 2026, which is a recent freshness signal. A recent date does not guarantee support for every loader or Minecraft version, so still inspect the current file list.

What to verify before choosing a file

• Confirm that the file is published by the credited creator on the linked official source.
• Match the Minecraft version exactly instead of relying only on a broad category label.
• Read dependencies, incompatibilities, and changelog notes before updating an existing instance.
• Match the loader or server platform and its required version. Forge and NeoForge are not interchangeable.
• Back up worlds and configuration files before testing the project in a long-term save or public server.

Compatibility at a glance

Minecraft versions in this snapshot: 26.2

Loaders and platforms: folia, paper, purpur

Before you install

Match the exact Minecraft version and loader, install every required dependency, and test in a separate profile before opening an important world. Keep a backup before changing a working mod list.

Source, licensing, and corrections

FreeMinecraftMods does not mirror the project files. Use the official source for downloads, release notes, dependencies, support, and licensing details. Project names, images, and creator-written descriptions remain the property of their respective owners.

How listings are reviewed | Report incorrect project information | Rights-holder and DMCA information