FoConvertors

Turn special convertor items into automatic inventory converters so players can transform materials on the fly with zero command spam.

FoConvertors is a lightweight Paper/Spigot/Purpur plugin for servers that want configurable item-to-item conversion loops. Give players convertor items, let them toggle each convertor on or off, and have matching items converted automatically while they play.

Features

• Create custom convertor templates for any item pair (input item + amount to output item + amount).
• Convert items automatically while players move loot in their inventory, pick items up, swap hands, or re-organize stacks.
• Toggle each convertor item with a left-click, with configurable cooldown and optional toggle feedback messages.
• Require convertors in offhand only or allow active convertors from inventory, based on your server setup.
• Use strict item-meta matching (name/lore/enchant-aware) for precise conversion control.
• Manage everything in-game with an admin GUI editor: create, edit, enable-by-default, and delete templates.
• Browse large template and recipe lists with pagination and ID search.
• Use consistent editor visuals and navigation across template, recipe, and item editing screens.

Commands

• /foconvertors version - Show plugin author and version
• /foconvertors editor - Open the convertor editor GUI (admin)
• /foconvertors give <player> <convertorId> [amount] - Give convertor items (admin)
• /foconvertors reload - Reload config and templates (admin)
• Alias: /convertors

Permissions

• foconvertors.admin - Access admin commands and editor

Optional admin tools include configurable toggle messaging, conversion-per-pass limits, and offhand-only enforcement for tighter balancing.

<dependency>
  <groupId>me.foesio</groupId>
  <artifactId>FoConvertors</artifactId>
  <version>2.3</version>
  <scope>provided</scope>
</dependency>

import me.foesio.foConvertors.api.FoConvertorsApi;
import me.foesio.foConvertors.event.ConvertorConversionAttemptEvent;

FoConvertorsApi api = Bukkit.getServicesManager().load(FoConvertorsApi.class);
if (api != null) api.templateIds();

@EventHandler
public void onConvertorConversionAttemptEvent(ConvertorConversionAttemptEvent event) {
    Bukkit.getLogger().info(event.getClass().getSimpleName());
}