zella

Zella

Zella is a premium Paper plugin that helps server owners track valuable Minecraft items with invisible item IDs. It is made for staff teams that want a simple way to investigate duplicated, suspicious, or admin-spawned items without needing to edit code.

What Zella Does

Adds invisible Zella IDs to important items
Tracks where an item came from, such as crafting, pickup, or staff stamping
Stores item history on the item and in a database
Alerts staff when matching item IDs are found in a player's inventory
Alerts staff when an admin-origin item reaches a regular player
Lets staff scan inventories for tracked or missing-ID items
Supports SQLite by default and MySQL for larger servers
Includes editable config.yml and messages.yml files

Requirements

Paper 1.21.4
Java 21 or newer
A server restart after changing database settings

Zella is built for Paper. What does that mean? Any other Server Fork such as - Purpur, Spigot, Bukkit are supported too, because they are built around Paper Fork.

Installation

1. Download the purchased Zella .jar file.
2. Stop your server.
3. Place the .jar file inside your server's plugins folder.
4. Start the server.
5. Open plugins/zella/config.yml and choose the items you want to track.
6. Run /zella reload after simple message or material changes, or restart after database changes.

No source code setup is required. This is a drag-and-drop plugin.

Commands

| Command | What it does | Permission |
| /analyze | Shows the Zella report for the item in your hand. | zella.command.analyze |
| /zella lookup | Looks up the tracked item in your hand. | zella.command.lookup |
| /zella lookup <id> | Looks up a specific Zella ID. | zella.command.lookup |
| /zella scan <player> | Scans an online player's inventory. | zella.command.scan |
| /zella stamp <origin> | Manually adds a Zella ID to the held item. | zella.command.stamp |
| /zella reload | Reloads config and messages. | zella.command.reload |

Staff alert permissions:

Code:

zella.admin
zella.alerts

Configuration

Zella only tracks the materials you list in tracked-materials. Keep this list focused on valuable items to avoid unnecessary database activity.

YAML:

settings:
  auto-purge-duplicates: true
  alert-staff-on-admin-transfer: true
  debug-logging: false

tracked-materials:
  - "DIAMOND_BLOCK"
  - "NETHERITE_BLOCK"
  - "NETHERITE_INGOT"
  - "ELYTRA"
  - "BEACON"
  - "DRAGON_EGG"

Messages are fully editable in messages.yml and support MiniMessage formatting, including colors and gradients.

Storage

SQLite is enabled by default and is recommended for most single-server setups.

MySQL is optional and recommended if you want external database tools, backups, or larger production storage.

YAML:

storage:
  type: "SQLITE"
  mysql:
    host: "localhost"
    port: 3306
    database: "zella"
    username: "root"
    password: ""

Database is created automatically when the plugin starts.

Recommended Setup

Track only economy-sensitive items such as netherite, beacons, elytras, dragon eggs, and rare event items.
Give lookup and scan permissions only to trusted staff.
Keep debug logging disabled unless you are troubleshooting.
Back up your database before major server resets or item migrations.
Test the plugin on a staging server before adding it to a live economy.

Support
When requesting support, please include:

Your Paper version
Your Java version
The Zella version
Any console error
Your config.yml, with passwords removed
A short explanation of what you expected and what happened

Important Notes

Zella is a moderation and investigation tool. It helps staff find suspicious item history and duplicate fingerprints, but staff should still review alerts before punishing players or removing valuable items.

This product is sold as a compiled .jar resource. Source code is not included.

zella v1.0

Overview Dependencies Updates (1) History