The in-game creator

On Paper 1.21.7+, /<command> create opens a multi-page Dialog wizard so you can author codes without touching a single file.

Version gated

The Dialog API only exists on Paper 1.21.7+. On 1.21.1–1.21.6 the creator is automatically disabled — the plugin still loads and everything else works, and /<command> create reports that it’s unavailable. There, author voucher files manually.

Creating a code

1. Run /<command> create (requires claimo.admin).
2. Page 1 — the code itself:
   • Name — the code players type.
   • Command — the command it runs (supports %player%).
   • Run as console — toggle on to run with console permissions.
   • Hide from list — keep it out of the GUI and tab-completion.
   • Usage limit — an optional max-uses value with a per-player / shared toggle.
3. Following page(s) — requirements: every registered requirement type is listed — built-in and any added by addons — each with an on/off toggle and its configurable fields. Flip on the ones you want and fill in their values.
4. Use « Back / Next » to move between pages, then click Create on the last page. Claimo writes vouchers/<name>.yml and reloads.

Requirements are paginated

If there are too many requirement types to fit on one page, the wizard adds more pages automatically. Addon-registered types show up here too, as long as they declared their input fields — see Custom requirements.

Editing a code

/<command> edit <voucher> reopens the same wizard pre-filled from an existing code and overwrites it on save.

Caution

• The id can’t be changed from the edit dialog.
• A code with several cmd lines collapses to the single command field — keep multi-command codes file-edited to avoid losing the extra lines.

Deleting a code

/<command> delete <voucher> shows a confirmation dialog and removes the file.

When to edit files instead

The creator covers the common case. Reach for the voucher file directly for advanced options:

Multiple commands

Several cmd lines that all run on redeem.

Whitelist / blacklist

Material filters on the blocks_mined requirement.

Expiry

A human-friendly expires duration like 30d or 1d12h.

How the gating works under the hood

The jar is built against the 1.21.8 API (which has Dialog) but keeps api-version: 1.21. All Dialog code is isolated and loaded reflectively, so the JVM never verification-loads those classes on older servers — that’s what keeps Claimo safe all the way down to 1.21.1.