Skip to main content

Installation

This guide walks you through installing zItems on your Minecraft server.

Requirements​

RequirementVersion
Minecraft1.21+
JavaJava 21 (required)
Server SoftwarePaper, Purpur, or Folia

Download​

You can download zItems from:

Installation Steps​

Step 1: Download the Plugin​

Download the latest version of zItems.jar from one of the sources above.

Step 2: Install the Plugin​

  1. Stop your Minecraft server if it's running
  2. Place the zItems.jar file in your server's plugins/ folder
  3. Start your server

Step 3: Verify Installation​

After starting your server, verify that zItems loaded correctly:

  1. Check the server console for:

    [zItems] zItems has been enabled!

  2. Run /zitems in-game to verify commands work

Step 4: Initial Configuration​

After the first startup, zItems will create the following folder structure:

plugins/zItems/
├── config.yml           # Main configuration
├── items/               # Custom item definitions
│   ├── armor-trim.yml
│   ├── custom_seed.yml
│   ├── food.yml
│   ├── glass-breaker.yml
│   ├── loot-chest.yml
│   ├── multitools.yml
│   ├── strength-potion.yml
│   └── hoe.yml
└── runes/               # Rune configurations

Configuration​

config.yml​

The main configuration file:

# Enable debug mode
debug: false

# Database settings for persistent data
storage-type: SQLITE

Optional Dependencies​

zItems works standalone but integrates with these plugins:

PluginIntegration
zMenuUse zItems in menu configurations
zJobsJob Money/XP Boost runes
PlaceholderAPIDynamic placeholders in item names/lore

Updating​

To update zItems:

  1. Download the latest version
  2. Stop your server
  3. Replace the old zItems.jar with the new one
  4. Start your server
  5. Run /zitems reload if needed
Backup First

Always backup your plugins/zItems/ folder before updating.

Troubleshooting​

Plugin Not Loading​

If zItems doesn't appear in /plugins:

  1. Check console for errors during startup
  2. Verify you're using Java 21
  3. Verify you're using Minecraft 1.21+
  4. Make sure the JAR file isn't corrupted

Items Not Working​

If custom items don't work:

  1. Check for YAML syntax errors in item files
  2. Use a YAML validator like YAML Lint
  3. Verify material names are correct
  4. Run /zitems reload after making changes

Next Steps​

Copyright © 2026 GroupeZ|Build #loading...|-