/Looty

Highly configurable custom items for Minecraft

Primary LanguageKotlinMIT LicenseMIT

Looty

Maven Contribute

Looty is a Paper plugin for creating custom items with config files. We extend on basic item functionality in Geary to help create complicated items all in config.

Features

  • Useful components like hat to make any item wearable, or food to create food items with custom effects.
  • Support for custom recipes
  • Write configs in yaml, json, and more.

Usage

Coming soon

Examples

Custom item from our server

star-compass.yml

# Make items in the same inventory share one entity
- !<looty:player_instanced_item>

# Specify item name, model, and lore,
# if this ever changes, Looty will update existing items
- !<looty:type>
  item:
    type: PAPER
    customModelData: 125
    displayName: <dark_aqua>Star Compass
    lore:
      - <aqua>Points towards the center of the <green>Abyss

# Add a recipe using other custom items
- !<looty:recipes>
  discoverRecipes: true
  recipes:
    - !<shapeless>
      items:
        - prefab: mineinabyss:star_compass_needle
        - prefab: mineinabyss:titanjaw_pearl


# A component provided another plugin
- !<mineinabyss:starcompass>

Custom recipe for a vanilla item

lead.yml

- !<looty:recipes>
  discoverRecipes: true
  result:
    type: LEAD
    amount: 2
  removeRecipes:
    - minecraft:lead
  group: "looty:lead"
  recipes:
    - !<shaped>
      items:
        S:
          prefab: mineinabyss:silkfang_silk
        Z:
          prefab: mineinabyss:abyssal_snail_gunk
      configuration: |-
        |ZZ |
        |ZS |
        |  Z|