Sueta

My | Ultimate custom items | Custom blocks / items with text

2.2.3

Create your own custom items and recipes, with a built-in compatible fastcraft and uncrafter

·Plugin

I don't have enough time to create new features. I will just mantain it. Collaboration is appreciated via Github.

Contact me via Discord/Twitter...
Source available

You want to support me with a donation?

Send me a message to know how yo can do it!

Hi, I'm a server owner/admin/mod, how can this plugin improve my server?
My is a plugin that improves the survival and minigames with crafting (such as UHC, skywars...) experience for your players.

This plugin is able to create your own custom blocks with textures, items, commands, crafting, furnace and brewing recipes.

Ever wanted to combine custom recipes with fastcraft? This is your plugin, it comes with a FastCraft and uncrafter module that works with custom items.

You can also remove vanilla recipes, create custom food, tools and weapons with additional effects such as an item that is able to destroy bedrock, an item that automatically melt ores when you destroy them, giftchests (something like the lootbags mod) and more, check the features below and read the Tutorials to see some pictures and see how easy is!

Hi, I code plugins for Spigot, what can offer this plugin to me?
With this plugin you can create custom blocks and items with custom textures and handle multiple events to create awesome plugins.

Also you can create custom brewing recipes and advanced recipes (Craft an item and then wih that item you can craft more shiny items). You can't do that easily with the Bukkit API. Also, you can extend this plugin functions thanks to the data storage. Read Create an advanced item section for more information about this.

Track custom items and blocks with just a few lines of code. Here I put a small example:

CARE: I didn't explained the API on the tutorials, but you can ask me via PM or on the discussion.
Or if u like exploring, check the classes of the plugin and try them.
// Convert an ItemStack into a special ItemStack
MItemStack mis = new MItemStack(tool);

// This return a custom ID if it is a custom item or null if it is not a custom item.
String id = mis.getNBTTag("MY_ID");

// You can check and get data from custom items.
if(mis.data.get("tool.effect") == null) return;


To the person that is reading this:

Be happy, like this custom block!

Some screenshots of the plugin that I didn't put in the tutorial

Tools with custom effects

Uncrafter


Features

Use the features that you want
You don't need some features? Disable them on the configuration to not waste your resources.

Custom commands

  • Create custom commands.
  • Set the arguments length.
  • Set the command usage.
  • Set the command description.
  • Set permissions to use the command.
  • Set aliases to the command.
  • API to create commands.

Custom items and blocks

  • Put custom textures to blocks. Currently supports up to 10 blocks. (From ID 1 to 10)
  • Put custom textures to items. Currently supports up to 10 items. (From ID 0 to 9)
  • Edit the damage.
  • Put enchants.
  • Edit the name.
  • Edit the lore.
  • Dye leather armor.
  • Put a skull owner (Only PLAYER_HEAD with damage 3).
  • Supports NBT Tags (items).
  • Custom data storage for plugin developers.
  • API to create custom items and blocks and handle them.

Custom recipes

  • Create crafting recipes.
  • Create furnace recipes.
  • Create brewing recipes.
  • Remove vanilla recipes.
  • Put custom items as input.
  • Put custom items as output.
  • Edit the amount of the output.
  • Edit the damage of the output.
  • Put enchants to the output.
  • Edit the name of the output.
  • Edit the lore of the output.
  • Put permissions to craft an item.
  • Multicraft (Only crafting recipes)
  • Dye leather armor.
  • Experience reward when you complete a furnace recipe.
  • Supports NBT Tags.
  • API to create custom recipes.

Fastcraft
Fastcraft is a module that allow your players to craft items without having to know the recipes, just click the crafting table and this GUI will be opened! The GUI comes with a button to open the clasic crafting table.
The difference between this fastcraft and other plugins like this is that it supports custom recipes.
Also, players need a permission to use it.

Giftchests

  • Create giftchest with custom recipes.
  • Create custom reward items.
  • Edit the amount of the reward item.
  • Edit the damage of the reward item.
  • Put enchants to the reward item.
  • Edit the name of the reward item.
  • Edit the lore of the reward item.
  • NBT support.
  • Dye armor support.
  • Skull support.
  • Configurable particles.
  • Configurable sound.

Uncrafter

  • Uncraft vanilla recipes.
  • Uncraft custom recipes.
  • A custom permission to use it.
  • Enable/disable uncrafter

ItemEffects

  • Edit the fill of the food.
  • Edit the saturation of the food.
  • Add potion effects to the food.
  • Put AutoSmelt effect to the tools.
  • Put Experience drop effect to the tools.
  • Put Break bedrock effect to the tools.
  • Put potion effects to weapons.

Planned to add

  • Recipebook

  • /my

  • my.fastcraft.use Use the FastCraft


Download and installation

  1. Download the plugin, and put into the plugins folder.
  2. Start and stop the server.
  3. Configure the plugin.
  4. Start the server.
  5. Enjoy your new custom stuff :p.


Tutorials: How to configure the plugin

» Material list «
» Enchants list «
» Potion effects list «

First time here? Start with one of the listed tutorials
Remove vanilla recipes
Create a command
Create an item

Remove vanilla recipes

Spoiler

To remove vanilla recipes go to a file named recipes.yml and paste the following:

# List where you have to put what item you don't want to be created.
# Usage: MATERIAL:damage
[SIZE=4]remove-vanilla:
- STONE_PICKAXE:0[/SIZE]

Now, time to test it. Open your server and try to craft this item.

Create a command

Spoiler
Not updated tutorial, but works.
#Here go the label of the command (/command)
<command>:
  #Amount of arguments that the command need (-1 is infinite amount)
  arguments: <number>
  # Description of the command
  description: <description>
  # Message that is sended to the user in case of wrong usage
  usage: <usage>
  # Permission to execute the command
  permission: <permission>
  # Alternative labels for the command
  aliases:
  - <aliase 1>
  - <aliase 2>
  [...]
  # Commands that will be executed when you use the command.
  # Use "server:<command>" for server-side commands
  # The placeholders for arguments are "{x}" where x is the argument number starting from 0 ("{-1}" is for put all arguments). For the argument 0 the placeholder is {0}, for the argument 1 the placeholder is {1}, etc...
  # "{sender.name}" is the placeholder of the player executing the command
  commands:
  - <command 1>
  - <command 2>
Java API
AbstractCommand test = new AbstractCommand(String label,
        String description,
        String usage,
        String permission,
        List<String> aliases){
    @Override
    public void run(CommandSender sender, String alias, String[] args) {
        // Execute the command.
    }

    @Override
    public void noPermission(CommandSender sender) {
        // What need to do if sender doesn't have permission
    }
};
test.register(Bukkit.getServer());

Create an item

Spoiler

Items are stored in a folder called item_packs.
Let's create a pack to store custom items first. Create a file named myitems.yml inside that folder.

Now we are going to create an item. Open the file and type the following:

# This is the item ID, make sure is unique.
MyBigStone:
    # The material of the item.
    material: STONE
    # The item is damaged? Not in this case!
    damage: 0
    # Look! A shiny stone!
    #Usage: ENCHANT_ID:LEVEL
    enchantments:
      - DAMAGE_ALL:2
    # The name of the item (But is not a pickax-- SHHHHHHHH)
    name: '&6The Pickaxe'
    # The lore of the Pickax-- I mean, the stone!
    lore:
    - '&rThis pickaxe can destroy bedrock. Yes. (Nope)'

Nice! Now we have an useless item that cannot be obtained. Let's create a recipe to solve this.

You can choose between crafting, furnace or brewing recipe to continue the basic tutorial.

Next chapter:
Create a brewing recipe
Create a crafting recipe
Create a furnace recipe
Create an advanced item

Create a crafting recipe

Spoiler
Previous chapter:
Create an item

To create a crafting recipe open a file called recipes.yml
Now paste this:

# ID of the recipe. Make sure is unique
CRAFT_MyBigStone:
  # The type of crafting
  type: craft
  #Is shaped or you can put the ingredients in random order?
  shaped: true
  # The permission to craft it
  permission: my.stone
  # What you have to put in every slot?
  slot:
    '1':
      material: STONE
    '2':
      material: STONE
    '3':
      material: STONE
    '4':
      material: STONE
    '5':
      material: STONE
    '6':
      material: STONE
    '7':
      material: STONE
    '8':
      material: STONE
    '9':
      material: STONE
  # The output!
  output:
    # Here goes the ID of the custom item.
    custom: MyBigStone
    # The amount huh
    amount: 1

Time to test! Run the server and craft this shiny item:

Next chapter:
Create an advanced crafting recipe

Create a furnace recipe

Spoiler
Previous chapter:
Create an item

To create a furnace recipe open a file called recipes.yml
Now paste this:

# ID of the recipe. Make sure is unique
FURNACE_MyBigStone:
  # The type of crafting
  type: furnace
  # The permission to craft it
  permission: my.stone
  # The input!
  input:
    material: STONE
  # Experience when you complete the recipe
  experience: 10
  # The output!
  output:
    # Here goes the ID of the custom item.
    custom: MyBigStone
    # The amount huh
    amount: 1

Time to test! Run the server and craft this shiny item:

Create a brewing recipe

Spoiler
Previous chapter:
Create an item

To create a brewing recipe open a file called recipes.yml
Now paste this:

# ID of the recipe. Make sure is unique
BREW_MyBigStone:
  # Type of the crafting
  type: brew
  # Upper slot of the brewing inventory
  material:
    material: STONE
  # Item to transform
  input:
    material: STONE
  # Result of the brew
  output:
    # Here goes the ID of the custom item.
    custom: MyBigStone
    # The amount
    amount: 1

Time to test! Run the server and craft this shiny item:

Create an advanced item

Spoiler
Previous chapter:
Create an item

This plugin comes with a few extra tools to improve the players experience on your server. Let's see what you can do.

Open your item pack and copy this:

#Make sure this ID is unique
SpecialLeatherItem:
    material: LEATHER_CHESTPLATE
    damage: 0
    enchantments:
     - PROTECTION_PROJECTILE:10
    - DURABILITY:2
    name: '&6Amazing chestplate'
    lore:
    - '&rIs not that good anyway'
    # You can dye leather items using RGB color codes.
    # Every color has a number from 0 - 255.
    dye:
      red: 100
      green: 100
      blue: 100
    # Skulls can have an owner to display his skin.
    # This will not work if material is not PLAYR_HEAD and damage is 3
    skull:
      owner: You
    # Here is the section to put NBT Tags
    # Usage: Argument1,argument2,argument3,...
    # DO NOT PUT SPACES
    # Every argument has a type and value except null arguments
    # Usage type:value (except null)
    # null is used to create a new list.
    # In this case, the first nbt is to make the item unbreakable
    # The other is to add +20 damage to the item
    nbt:
    - Byte:1,String:Unbreakable
    - String:generic.attackDamage,String:AttributeModifiers,null,String:AttributeName
    - String:generic.attackDamage,String:AttributeModifiers,Integer:0,String:Name
    - String:mainhand,String:AttributeModifiers,Integer:0,String:Slot
    - Double:20,String:AttributeModifiers,Integer:0,String:Amount
    - Integer:0,String:AttributeModifiers,Integer:0,String:Operation
    - Long:894654,String:AttributeModifiers,Integer:0,String:UUIDLeast
    - Long:2872,String:AttributeModifiers,Integer:0,String:UUIDMost
    # This is the most important and flexible part of items. The extra data values, but you need plugins that support it or code one yourself.
    # In this example we're going to stone the following information:
    # specialeffect.name: EXPLODE
    # specialeffect.radius: 5
    # With a plugin you can get those data tags from the custom item to perform additional effects.
    # Why I show you this? Well this plugin also uses this tag.
    data:
      specialeffect:
        name: EXPLODE
        radius: 5

If you want to test this item, create a recipe for it. You should know how! If you don't, why are you reading this instead of the basics?

Now you that you know the existence of the data tag, you can use it to create more special items. Such as giftchests, tools with effects and more!

Next chapter:
Create a block with a custom texture
Create an item with a custom texture
Create a gifchest
Create tools with extra effects
Create food with extra effects

Create a block with a custom texture

Similar projects

Plugin →