Paper plugin

Custom items, blocks, recipes and visual armor made simple.

ItemsLite lets server owners add custom content without client-side mods. The plugin can generate and host the resource pack, then send it to players when they join.

Install Commands Armor guide
ItemsLite plugin artwork

What it does

Main features

Custom Items

Create textured items with names, lore, CustomModelData, durability, uses, cooldowns and actions.

Custom Blocks

Place custom-looking blocks in the world and drop the correct custom item when they are broken.

Visual Armor

Use real custom armor textures on modern Minecraft versions, with a simplified folder layout.

Recipes and Drops

Add shaped recipes, furnace-style recipes, mob drops and block drops from configuration files.

Resource Pack Generator

Generate the pack automatically from your textures and item settings.

Admin Tools

Use menus, diagnostics, exports and reload commands to build and test content faster.

Download

Get ItemsLite

Download the latest version of ItemsLite from the official project pages, then follow the installation guide below to add it to your Paper server.

Useful links

Download on Spigot Read installation guide View command list

Setup

How to install

  1. Download ItemsLite.jar.
  2. Put the jar inside your server plugins folder.
  3. Start the Paper server once.
  4. Open plugins/ItemsLite and edit the generated files.
  5. Add your textures in the plugin texture folders.
  6. Run /itemslite reload and then /itemslite reloadpack.
  7. Use /itemslite pack to send the resource pack again while testing.

Textures

Automatic resource pack

ItemsLite builds the Minecraft resource pack from the textures and configuration inside the plugin folder. Players do not need to manually install the pack on their computer.

For a public server, set a public resource-pack URL in the config. For local testing, the built-in host can serve the pack from your server machine.

Useful testing flow

/itemslite reload /itemslite reloadpack /itemslite pack /itemslite doctor

Modern armor

How to add custom armor

Create one folder for each armor set. Put the item icons and the armor layer textures in the same place, then use the same model name in the item configuration.

Visual armor requires Minecraft/Paper 1.21.4 or newer. On 1.20.x the armor item can still exist, but the full visual armor texture is not supported by the client. 

plugins/ItemsLite/textures/armor/ruby/
  helmet.png
  chestplate.png
  leggings.png
  boots.png
  layer_1.png
  layer_2.png

Armor config

Example armor item

The armor.model value connects the item to the texture folder. In this example, the plugin uses textures/armor/ruby. 

items:
  ruby_helmet:
    material: NETHERITE_HELMET
    custom_model_data: 13000
    texture: "ruby/helmet.png"
    model: "generated"
    name: "&cRuby Helmet"
    armor:
      enabled: true
      slot: HEAD
      model: "ruby"

Blocks

Custom blocks

ItemsLite can create custom block visuals by generating block models in the resource pack. When a player places a custom block item, the plugin stores which custom block it is and handles breaking, drops and protection from unwanted vanilla behavior.

Place custom textured blocks Drop the correct custom item Use generated cube models Run diagnostics with /itemslite doctor

Admin commands

Commands

/itemsliteShow the main command help.
/itemslite menu [category]Open the item browser menu.
/itemslite give <player> <item> [amount]Give a custom item to a player.
/itemslite listList loaded custom items.
/itemslite create <id>Create a new item entry.
/itemslite delete <item>Delete an item entry.
/itemslite info <item>Show item information.
/itemslite settexture <item> <file.png>Set an item texture.
/itemslite setmaterial <item> <material>Change the base Minecraft material.
/itemslite setmodel <item> <generated|handheld|cube>Change the generated model type.
/itemslite editorOpen the editor menu.
/itemslite pack [player]Send the resource pack again.
/itemslite reloadpackRegenerate the resource pack.
/itemslite reloadReload ItemsLite configuration.
/itemslite doctorCheck common setup problems.
/itemslite exportfilesExport generated files for inspection.

Access control

Permissions

itemslite.adminAccess to all admin commands.
itemslite.command.giveUse the give command.
itemslite.command.menuOpen the item menu.
itemslite.command.editorOpen the editor menu.
itemslite.command.packSend the resource pack.
itemslite.command.reloadReload plugin data.

Versions

Compatibility

Paper 1.20.x Custom items, blocks, recipes, drops and resource pack generation.
Paper 1.21.4+ All main features plus modern visual armor support.
Latest Minecraft versions Best-effort support because ItemsLite avoids NMS for core features.

Help

Common problems

The texture does not appear

Run /itemslite reloadpack, accept the resource pack again and check missing files with /itemslite doctor.

Players cannot download the pack

Make sure the resource-pack URL is reachable by players. Local addresses such as 127.0.0.1 only work on your own computer.

Armor is not visually custom

Visual armor needs Minecraft/Paper 1.21.4 or newer and valid layer_1.png and layer_2.png files.