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.
Developer API
Compile against the matching jar (provided in Maven, compileOnly in Gradle); install it locally if needed. Declare FoConvertors in your plugin metadata (softdepend for an optional integration).
<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());
}
API methods (overloads grouped):
FoConvertorsApi:inspectItem,createItem,templateIds,template,activeTemplateIds,requestConversion.
Other API types: ConversionEntry, ConvertorItemInfo, ConvertorRecipeSnapshot, ConvertorTemplateSnapshot.
Events: ConvertorConversionAttemptEvent, ConvertorConversionCompletedEvent, ConvertorItemToggledEvent.
Browse API and event source for signatures and event details.
No gallery available for this project.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
FoConvertors 2.3 2.3 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
bukkit, paper, purpur, spigot
|
Download |
|
FoConvertors 2.2 2.2 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
bukkit, paper, purpur, spigot
|
Download |
|
FoConvertors 2.1 2.1 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, paper, purpur, spigot
|
Download |
|
FoConvertors 1.9 1.9 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, paper, purpur, spigot
|
Download |
|
FoConvertors 1.8 1.8 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, paper, purpur, spigot
|
Download |
|
FoConvertors 1.7 1.7 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, paper, purpur, spigot
|
Download |
|
FoConvertors 1.6 1.6 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, paper, purpur, spigot
|
Download |
|
FoConvertors 1.5 1.5 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2
|
bukkit, paper, purpur, spigot
|
Download |
|
FoConvertors 1.4 1.4 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2
|
bukkit, paper, purpur, spigot
|
Download |
|
FoConvertors 1.3 1.3 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, paper, purpur, spigot
|
Download |
|
FoConvertors 1.2 1.2 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
paper, purpur, spigot
|
Download |
|
FoConvertors 1.1 1.1 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
paper, purpur, spigot
|
Download |
|
FoConvertors 1.0 1.0 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
paper, purpur, spigot
|
Download |