ItemsLite
Custom Items, Blocks, Recipes, Drops and Visual Armor for Paper servers
Official Website and Documentation
Custom Items, Blocks, Recipes, Drops and Visual Armor for Paper servers
Official Website and Documentation
Description
ItemsLite is a lightweight Paper plugin that lets you create custom items, placeable custom blocks, recipes, drops, item actions and visual custom armor without requiring client-side mods.
The plugin can generate and host its own resource pack, so players can receive custom textures directly when they join your server.
Visual custom armor requires Paper 1.21.4 or newer.
Other features work on Paper 1.20.x and newer.
Main Features
- Custom items using CustomModelData
- Placeable custom blocks
- Visual custom armor on Paper 1.21.4+
- Automatic resource-pack generation
- Built-in resource-pack web host
- Crafting and furnace-style recipes
- Custom mob and block drops
- Item actions for clicks, attacks, kills, block breaks and armor events
- Custom food items
- Cooldowns and limited-use items
- Admin item menu
- Basic in-game editor
- Item categories
- Content pack support
- PlaceholderAPI support
- Diagnostics command for setup checks
Compatibility
- Paper 1.20.x+ - custom items, blocks, recipes, drops, actions, menus and resource-pack hosting
- Paper 1.21.4+ - all main features plus visual custom armor
- Newer Paper versions - best-effort support
ItemsLite does not use NMS for its core features, which helps compatibility across Minecraft updates.
Quick Start
- Put ItemsLite.jar inside your server plugins folder.
- Start the server once.
- Edit the generated files in plugins/ItemsLite.
- Add your textures inside the plugin texture folders.
- Run the reload commands.
Code (Text):
/itemslite reload
/itemslite reloadpack
/itemslite pack
Code (Text):
/itemslite give <your_name> ruby_sword 1
Code (Text):
/itemslite doctor
ItemsLite can generate and host the resource pack automatically.
For public servers, make sure your resource-pack URL is reachable by players and that the selected host port is open.
Players do not need to manually install the texture pack. Minecraft will ask them to download the server resource pack when they join.
Visual Custom Armor
ItemsLite supports real visual armor textures on Paper 1.21.4+.
Armor sets use a simple folder structure:
Code (Text):
plugins/ItemsLite/textures/armor/ruby/
helmet.png
chestplate.png
leggings.png
boots.png
layer_1.png
layer_2.png
layer_2.png is used for leggings.
ItemsLite automatically converts this simple folder into the correct Minecraft resource-pack structure.
Commands
Code (Text):
/itemslite
/itemslite give <player> <item> [amount]
/itemslite list
/itemslite menu [category]
/itemslite editor
/itemslite pack [player]
/itemslite reloadpack
/itemslite create <id>
/itemslite delete <item>
/itemslite info <item>
/itemslite settexture <item> <file.png>
/itemslite setmaterial <item> <material>
/itemslite setmodel <item> <generated|handheld|cube>
/itemslite exportfiles
/itemslite exportdocs
/itemslite doctor
/itemslite debug
/itemslite reload
Code (Text):
/ilite
/customitems
Code (Text):
itemslite.admin
itemslite.give
itemslite.reload
itemslite.list
itemslite.pack
itemslite.debug
itemslite.menu
itemslite.reloadpack
itemslite.create
itemslite.doctor
itemslite.editor
itemslite.exportdocs
Useful Links
Support
DISCORD
Before asking for support, please include:
- Your Paper version
- Your ItemsLite version
- Any console errors
- Your /itemslite doctor result
- A screenshot if the issue is texture-related
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
ItemsLite - ⚡️Custom Items, Blocks, Recipes, Drops & Visual Armor is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21, 26.1 and newer. Downloaded 86 times (via Spigot). Download it and open it directly in the game.