ItemsAPI
A Minecraft server plugin that provides an API for managing custom items and storing them in the configuration.
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
ItemsAPI
ItemsAPI (1.16.5-1.21.8)
A plugin for Minecraft servers that provides an API for managing custom items and storing them in the configuration.
📦 Features
- Save, load, and give items via commands - Simple API interface for integration with plugins - Items are stored in a configuration file
🔧 Commands
| Command | Description | Permission | |---------|----------|------------| | `/items give <player> <item>` | Give a saved item to the specified player | `ItemsAPI.use` | | `/items add` | Save all items from your inventory | `ItemsAPI.use` |
💻 API for Developers
```java // Getting an instance of the API: @Override public void onEnable() { itemsAPI = ItemsAPIProvider.getAPI(); }
// Getting and giving an ItemStack: ItemStack needItem = itemsAPI.getItem("CRUSHER_TALISMAN");
// Get all saved items Map<String, ItemStack> allItems = api.getAllItems(); ```
⭐ Example Usage in a Menu
```java public class MenuPlugin extends JavaPlugin implements CommandExecutor { private ItemsAPIInterface itemsAPI; private final MiniMessage mm = MiniMessage.miniMessage();
@Override public void onEnable() { itemsAPI = ItemsAPIProvider.getAPI(); getServer().getPluginManager().registerEvents(this, this); getCommand("menu").setExecutor(this); }
@Override public boolean onCommand(CommandSender sender, Command command, String label, String[] args) { if (!(sender instanceof Player player)) { return true; }
Inventory inv = Bukkit.createInventory(player, 3*9, mm.deserialize("<blue>API Example</blue>")); inv.setItem(13, itemsAPI.getItem("CRUSHER_TALISMAN")); player.openInventory(inv);
return true; } } ``` - Don't forget to add depend: [ItemsAPI] to your plugin's plugin.yml - And also to your build.gradle: compileOnly files('libs/ItemsAPI-1.0.jar')