Sueta

InstaCraft

2.0.1

A plugin that allows players to instantly craft items using a simple command.

·Plugin

upload_2025-1-6_12-32-23.png
InstaCraft is a Minecraft plugin that allows players to instantly craft items with a simple command. Whether you're an admin who wants to speed up the crafting process or a player looking to easily craft items, InstaCraft is here to make your Minecraft experience more convenient and efficient.

Features

  • Instant Crafting - Craft any item instantly with /craft <item> [amount]
  • Recipe Browser GUI - Browse all craftable items with a visual interface
  • Custom Recipes - Define your own recipes in recipes.yml
  • Item Aliases - Create shortcuts like dsword for DIAMOND_SWORD
  • Favorites System - Save frequently crafted items for quick access
  • Economy Integration - Charge players for crafting (requires Vault)
  • XP System - Reward or charge XP for crafting
  • Crafting Limits - Restrict how many items players can craft per period
  • Cooldowns - Set delays between crafts
  • Statistics Tracking - Track player crafting history
  • Admin Spy - Monitor player crafting activity
  • World Restrictions - Enable/disable in specific worlds
  • PlaceholderAPI Support - Use placeholders in other plugins
  • Fully Customizable - Messages, GUI, sounds, particles, and more

Commands

  • /craft <item> [amount] - Instantly craft an item
  • /craft list [page] - List all craftable items
  • /craft browse - Open the recipe browser GUI
  • /craft search - Search items in the GUI
  • /craft recipe <item> - View recipe for an item
  • /craft fav <add|remove|list|craft> - Manage favorite items
  • /craft alias <set|remove|list> - Manage item aliases (admin)
  • /craft stats - View your crafting statistics
  • /craft spy - Toggle admin craft notifications
  • /craft reload - Reload all configuration files

Permissions

  • instacraft.use - Use the /craft command
  • instacraft.reload - Reload configs and manage aliases
  • instacraft.cooldown.bypass - Bypass crafting cooldown
  • instacraft.limits.bypass - Bypass crafting limits
  • instacraft.craft.* - Craft all items
  • instacraft.craft.<item> - Craft a specific item
  • instacraft.spy - Toggle admin craft spy

Configuration
InstaCraft is highly customizable through the different configuration files such as config.yml, messages.yml, gui.yml, etc. Below are samples of the configuration files that InstaCraft has:

config.yml
# --------------------------------------------------------------
#                    InstaCraft Configuration
#                         by SandBytes
# --------------------------------------------------------------
# Found a bug? Submit an issue in https://github.com/SandBytes/InstaCraft/issues
# and I will be glad to fix it as soon as possible. Thank you!
# --------------------------------------------------------------

# DO NOT CHANGE - used for automatic config migration
config-version: 2

# Cooldown in seconds between crafts (0 to disable)
# Players with instacraft.cooldown.bypass permission skip this
cooldown: 0

# Maximum amount a player can craft at once
max-craft-amount: 64

# Item filter mode: "blacklist" or "whitelist"
# blacklist = all items allowed EXCEPT those listed
# whitelist = ONLY listed items are allowed
filter-mode: "blacklist"

# List of items for the filter (use material names, e.g. DIAMOND_SWORD)
filtered-items: []

# Log all crafts to plugins/InstaCraft/crafting.log
crafting-log: false

# Log rotation for crafting.log
log-rotation:
  enabled: false
  # Max file size in MB before rotating
  max-size-mb: 10

# Supported recipe types: CRAFTING, FURNACE, SMITHING, STONECUTTING
enabled-recipe-types:
  - CRAFTING
  - FURNACE
  - SMITHING
  - STONECUTTING

# Sound played when an item is crafted
craft-sound:
  enabled: true
  sound: "BLOCK_ANVIL_USE"
  volume: 0.5
  pitch: 1.0

# Particle effect on successful craft
craft-particles:
  enabled: true

# Economy integration (requires Vault + an economy plugin)
economy:
  enabled: false
  default-cost: 0.0
  item-costs:
    DIAMOND_SWORD: 50.0
    DIAMOND_PICKAXE: 45.0

# XP cost or reward per craft
# mode: "cost" = deduct XP, "reward" = grant XP
xp:
  enabled: false
  mode: "reward"
  default-amount: 0
  # Per-item XP overrides
  item-amounts:
    DIAMOND_SWORD: 10
    IRON_PICKAXE: 5

# World restrictions - disable InstaCraft in certain worlds
# mode: "blacklist" = blocked in listed worlds, "whitelist" = only allowed in listed worlds
world-restrictions:
  enabled: false
  mode: "blacklist"
  worlds:
    - "world_nether"
    - "world_the_end"

# Admin spy - notify admins when players craft watched items
spy:
  enabled: false
  # Leave empty to watch all items, or list specific materials
  # watch-items: []
  watch-items:
    - DIAMOND_SWORD
    - NETHERITE_SWORD

# Crafting limits - restrict how many of each item a player can craft per period
limits:
  enabled: false
  # Reset interval in minutes (1440 = 24 hours)
  reset-minutes: 1440
  # Default limit for all items (0 = unlimited)
  default-limit: 0
  # Per-item limit overrides
  item-limits:
    DIAMOND_SWORD: 5
    NETHERITE_INGOT: 2

# Per-player crafting statistics
statistics:
  enabled: true

# Update checker
update-checker:
  enabled: true
messages.yml
# --------------------------------------------------------------
#                    InstaCraft Messages
#                         by SandBytes
# --------------------------------------------------------------
# All messages support legacy &-codes and hex colors (&#RRGGBB).
# Placeholders are listed next to each message.
# --------------------------------------------------------------

# Prefix prepended to all messages
prefix: "&6[InstaCraft] &r"

# Whether to use the prefix in messages (true/false)
use-prefix: true

# General
usage: "&cUsage: %command%" # %command%
usage_fav: "&cUsage: /craft fav <add|remove|list|craft> [name] [item]"
usage_fav_add: "&cUsage: /craft fav add <name> <item>"
usage_fav_remove: "&cUsage: /craft fav remove <name>"
usage_fav_craft: "&cUsage: /craft fav craft <name> [amount]"
usage_alias: "&cUsage: /craft alias <set|remove|list>"
usage_alias_set: "&cUsage: /craft alias set <alias> <material>"
usage_alias_remove: "&cUsage: /craft alias remove <alias>"
usage_recipe: "&cUsage: /craft recipe <item>"
no_permission: "&cYou don't have permission to use this command (%permission%)" # %permission%
player_only: "&cThis command is only for players"
reload_success: "&aConfig reloaded successfully"

# Crafting
invalid_item: "&cInvalid item: %item%" # %item%
cannot_craft: "&c%item% cannot be crafted" # %item%
missing_materials: "&cYou don't have the required materials to craft %item%" # %item%
crafted_success: "&aYou crafted %amount%x %item%" # %amount%, %item%
cooldown: "&cPlease wait %time% seconds before crafting again" # %time%
item_blocked: "&c%item% is not allowed to be crafted" # %item%
inventory_full: "&eYour inventory was full. Some items were dropped at your feet."
materials_used: "&7Materials consumed: %materials%" # %materials%
material_format: "&f%amount%x &e%material%" # %amount%, %material%
material_separator: "&7, "
world_restricted: "&cInstaCraft is not available in this world."
limit_reached: "&cYou've reached your crafting limit for %item%" # %item%

# Economy
not_enough_money: "&cYou don't have enough money. Cost: %cost%" # %cost%
money_charged: "&7Charged %cost% for crafting." # %cost%

# XP
not_enough_xp: "&cYou don't have enough XP. Required: %xp%" # %xp%
xp_rewarded: "&a+%xp% XP earned from crafting" # %xp%
xp_deducted: "&7-%xp% XP spent on crafting" # %xp%

# Recipe viewer
recipe_header: "&6Recipe for %item%:" # %item%
recipe_ingredient: "&e  - %amount%x %material%" # %amount%, %material%

# Item list
list_header: "&6Craftable items (page %page%/%total%):" # %page%, %total%
list_item: "&e  - %item%" # %item%
list_footer: "&6Use /craft list %next% for the next page" # %next%

# Favorites
fav_added: "&aFavorite '%name%' set to %item%" # %name%, %item%
fav_removed: "&aFavorite '%name%' removed" # %name%
fav_not_found: "&cFavorite '%name%' not found" # %name%
fav_empty: "&eYou have no saved favorites."
fav_list_header: "&6&lYour Favorites:"
fav_list_item: "&e  %name% &7-> &f%item%" # %name%, %item%

# Aliases
alias_set: "&aAlias '%alias%' set to %item%" # %alias%, %item%
alias_removed: "&aAlias '%alias%' removed" # %alias%
alias_empty: "&eNo aliases defined."
alias_list_header: "&6&lItem Aliases:"
alias_list_item: "&e  %alias% &7-> &f%item%" # %alias%, %item%

# Admin spy
spy_enabled: "&aCraft spy enabled. You will see craft notifications."
spy_disabled: "&cCraft spy disabled."
spy_notification: "&8[&cSpy&8] &7%player% &ecrafted &f%amount%x &e%item%" # %player%, %amount%, %item%

# Statistics
stats_header: "&6&lYour Crafting Statistics"
stats_total: "&e  Total crafts: &f%total%" # %total%
stats_top_item: "&e  Most crafted: &f%item%" # %item%
stats_disabled: "&cStatistics are currently disabled."

# Search
search_prompt: "&eType your search term in chat, or &fcancel &eto go back. &7&o(30 seconds)"
search_expired: "&cSearch timed out. Returning to browser."
search_cancelled: "&eSearch cancelled."

# Update checker
update_available: "&aA new version of InstaCraft is available: %version% (current: %current%)" # %version%, %current%
gui.yml
# --------------------------------------------------------------
#                    InstaCraft GUI Configuration
#                         by SandBytes
# --------------------------------------------------------------
# Customize the appearance of all plugin GUIs
# Supports color codes (&a, &b, etc.) and hex colors (&#RRGGBB)
# --------------------------------------------------------------

# Browser GUI settings
browser:
  # Title shown at the top (use %page% and %total% for pagination)
  title: "&6InstaCraft - Browse (%page%/%total%)"
  # Title when searching (use %filter% for search term)
  search-title: "&6Search: %filter% (%page%/%total%)"
  # Number of rows (3-6, last row is navigation)
  rows: 6

# Recipe view GUI settings
recipe-view:
  # Title for recipe view (use %item% for item name)
  title: "&6Recipe: %item%"
  # Number of rows (minimum 3)
  rows: 3
  # Slot for the result item
  result-slot: 13
  # Slot for the back button
  back-button-slot: 22

# Navigation items
navigation:
  previous-page:
    enabled: true
    slot: 45
    material: ARROW
    name: "&aPrevious Page"
    lore:
      - "&7Click to go back"

  next-page:
    enabled: true
    slot: 53
    material: ARROW
    name: "&aNext Page"
    lore:
      - "&7Click to go forward"

  search:
    enabled: true
    slot: 47
    material: COMPASS
    name: "&eSearch Items"
    lore:
      - "&7Click to search for items"
      - "&7Type 'cancel' to cancel"

  page-info:
    enabled: true
    slot: 49
    material: BOOK
    name: "&6Page %page%/%total%"
    lore: []

  back-button:
    material: BARRIER
    name: "&cBack to Browser"
    lore:
      - "&7Return to item list"

# Item display in browser
item-display:
  # Name format (use %item% for item name)
  name-format: "&e%item%"
  lore:
    - "&7Left-click to view recipe"
    - "&7Right-click to craft x1"
  # Show cost in lore if economy is enabled
  show-cost: true
  cost-format: "&7Cost: &6%cost%"

# Recipe view item display
recipe-display:
  result-name: "&a&lResult: %item%"
  result-lore:
    - "&7Amount: &f%amount%"
    - ""
    - "&aClick to craft x1"
  ingredient-name: "&e%item%"
  ingredient-lore:
    - "&7Required: &f%amount%"

# Decorative filler items
filler:
  enabled: false
  material: GRAY_STAINED_GLASS_PANE
  name: " "
  # Slots to fill (empty = fill all empty nav bar slots)
  slots: []
aliases.yml
# --------------------------------------------------------------
#                    InstaCraft Item Aliases
#                         by SandBytes
# --------------------------------------------------------------
# Define short aliases for material names.
# Players can use these in /craft instead of full material names.
#
# Format:
#   aliases:
#     shortname: MATERIAL_NAME
#
# Example:
#   aliases:
#     dsword: DIAMOND_SWORD
#     dpick: DIAMOND_PICKAXE
# --------------------------------------------------------------

aliases:
  dsword: DIAMOND_SWORD
  dpick: DIAMOND_PICKAXE
  daxe: DIAMOND_AXE
  dshovel: DIAMOND_SHOVEL
  dhoe: DIAMOND_HOE
  isword: IRON_SWORD
  ipick: IRON_PICKAXE
  iaxe: IRON_AXE
  ishovel: IRON_SHOVEL
  ihoe: IRON_HOE
recipes.yml
# --------------------------------------------------------------
#                    InstaCraft Custom Recipes
#                         by SandBytes
# --------------------------------------------------------------
# Define custom recipes that only work through /craft.
# These are separate from vanilla server recipes.
#
# Format:
#   recipes:
#     recipe-name:
#       result: MATERIAL_NAME
#       amount: 1
#       ingredients:
#         MATERIAL_NAME: amount
#         MATERIAL_NAME: amount
#
# Example:
#   recipes:
#     magic-diamond:
#       result: DIAMOND
#       amount: 2
#       ingredients:
#         COAL: 64
#         GOLD_INGOT: 8
# --------------------------------------------------------------

recipes: {}

Support
You can contact me on Discord marcifyx if you need assistance or want to suggest features for the plugin.

Found a Bug? Submit an issue by clicking HERE and I will be glad to fix it as soon as possible.

Leaving a nice review would be appreciated and will encourage me to make more plugins in the future.

Please DON'T post bug reports/suggestions in the review section.

Similar projects

Plugin →