- D1 Meta Docs - Denizen Script -
Home Page / Pi to one million places / Contact mcmonkey / Donate / Paste Scripts / Denizen Help /
You are browsing as a guest.
Login | Register




Search:

Listing Language Explanations...

 View All

Found 1 match.
NameItem Script Containers
DescriptionItem script containers are an easy way to pre-define custom items for use within scripts. Item
scripts work with the ItemTag object, and can be fetched with the Object Fetcher by using the
ItemTag constructor ItemTag_script_name. Example: - drop <player.location> super_dooper_diamond

The following is the format for the container. Except for the 'material' key (and the dScript
required 'type' key), all other keys are optional.

# The name of the item script is the same name that you can use to construct a new
# ItemTag based on this item script. For example, an item script named 'sword_of_swiftness'
# can be referred to as simply 'sword_of_swiftness'.
Item_Script_Name:
 
  type: item
 
  # Must be a valid ItemTag. See 'ItemTag' for more information.
  # | All item scripts MUST have this key!
  material: base_material
 
  # List any mechanisms you want to apply to the item within
  # | Some item scripts should have this key!
  mechanisms:
    # An example of a mechanism to apply
    unbreakable: true
 
  # The 'custom name' can be anything you wish. Use color tags to make colored custom names.
  # | Some item scripts should have this key!
  display name: custom name
 
  # Lore lines can make items extra unique. This is a list, so multiple entries will result in multiple lores.
  # If using a replaceable tag, they are filled in when the item script is given/created/dropped/etc.
  # | Some item scripts should have this key!
  lore:
  - item
  - ...
 
  # If you want an item to be damaged on creation, you can change its durability.
  # | Most item scripts should exclude this key!
  durability: 12
 
  # Each line must specify a valid Minecranft enchantment name.
  # | Some item scripts should have this key!
  enchantments:
  - enchantment_name:level
  - ...
 
  # You can optionally add crafting recipes for your item script.
  # Note that recipes won't show in the recipe book when you add a new item script, until you either reconnect or use the "resend_recipes" mechanism.
  # | Most item scripts should exclude this key, unless you're specifically building craftable items.
  recipes:
      1:
          # The type can be: shaped, shapeless, stonecutting, furnace, blast, smoker, or campfire.
          type: shaped
          # The recipe can optionally have a custom internal recipe ID (for recipe books).
          # If not specified, will be of the form "<type>_<script.name>_<id>" where ID is the recipe list index (starting at 1, counting up).
          # IDs will always have the namespace "denizen". So, for the below, the full ID is "denizen:my_custom_item_id"
          # Note that most users should not set a custom ID. If you choose to set a custom one, be careful to avoid duplicates or invalid text.
          # Note that the internal rules for Recipe IDs are very strict (limited to "a-z", "0-9", "/", ".", "_", or "-").
          recipe_id: my_custom_item_id
          # You can optional add a group as well. If unspecified, the item will have no group.
          # Groups are used to merge together similar recipes (in particular, multiple recipes for one item).
          group: my_custom_group
          # You can optionally specify the quantity to output. The default is 1 (or whatever the item script's quantity is).
          output_quantity: 4
          # You must specify the input for the recipe. The below is a sample of a 3x3 shaped recipe. Other recipe types have a different format.
          # You are allowed to have non-3x3 shapes (can be any value 1-3 x 1-3, so for example 1x3, 2x1, and 2x2 are fine).
          # For an empty slot, use "air".
          # By default, items require an exact match. For a material-based match, use the format "material:MaterialNameHere" like "material:stick".
          # To make multiple different items match for any slot, just separate them with slashes, like "stick/stone". To match multiple materials, use "material:a/b/c".
          input:
          - ItemTag|ItemTag|ItemTag
          - ItemTag|ItemTag|ItemTag
          - ItemTag|ItemTag|ItemTag
     # You can add as many as you want.
     2:
          # Sample of the format for a 2x2 recipe
          type: shaped
          input:
          - ItemTag|ItemTag
          - ItemTag|ItemTag
     3:
         # Shapeless recipes take a list of input items.
         type: shapeless
         input: ItemTag|...
     4:
         # Stonecutting recipes take exactly one input item.
         type: stonecutting
         input: ItemTag
     5:
         # Furnace, blast, smoker, and campfire recipes take one input and have additional options.
         type: furnace
         # Optionally specify the cook time as a duration (default 2s).
         cook_time: 1s
         # Optionally specify experience reward amount (default 0).
         experience: 5
         input: ItemTag
 
  # Set to true to not store the scriptID on the item, treating it as an item dropped by any other plugin.
  # NOTE: THIS IS NOT RECOMMENDED UNLESS YOU HAVE A SPECIFIC REASON TO USE IT.
  # | Most item scripts should exclude this key!
  no_id: true/false
 
  # For colorable items, such as leather armor, you can specify a valid ColorTag to specify the item's appearance.
  # See 'ColorTag' for more information.
  # | Most item scripts should exclude this key!
  color: ColorTag
 
  # If your material is a 'm@written_book', you can specify a book script to automatically scribe your item
  # upon creation. See 'book script containers' for more information.
  # | Most item scripts should exclude this key, though there are certain rare cases it may be useful to.
  book: book_script_name


GroupScript Container System