_

Plugin Name: WildKits Target Version: Spigot/Paper 1.21+

Core Logic & Custom Items:

Create a system that recognizes and handles the following items based on their PersistentDataContainer (NBT) keys. Items must be consumed (1 per use) and respect the specified cooldowns.

DYNAMITE

NBT Key: wildkits:evox-wildkits (Value: DYNAMITE)

Material: Blaze Rod

Effect: Shoots a primed TNT; explodes on impact, dealing area damage.

Cooldown: 3 seconds.

SPEED BUFF

NBT Key: wildkits:evox-wildkits (Value: SPEED)

Material: Sugar

Effect: Applies Speed III for 5 seconds.

Cooldown: 10 seconds.

STRENGTH BUFF

NBT Key: wildkits:evox-wildkits (Value: STRENGTH)

Material: Sugar

Effect: Applies Strength III for 5 seconds.

Cooldown: 10 seconds.

DASH

NBT Key: wildkits:evox-wildkits (Value: DASH)

Material: Feather

Effect: Launches the player in their facing direction.

Cooldown: 5 seconds.

Token Economy System (/deposit & /withdraw):

Implement a virtual balance system using a specific physical Token item (Sunflower with NBT Key: wildkits:evox-token).

Command /deposit [amount|all]: Scans the player's inventory for matching Token items. Removes the physical items and adds the value to their virtual balance.

Command /withdraw [amount]: Checks if the player has enough virtual balance and enough empty inventory slots. If they have space and funds, subtract from the balance and give the physical Token item.

Validation: Only sunflowers with the specific NBT key should be accepted or given. Regular sunflowers must be ignored.

Technical Requirements:

Item Consumption: When a player uses a custom item (Right-Click), remove exactly 1 item from the stack, not the whole stack.

Cooldown Management: Store cooldowns per player UUID. If an item is on cooldown, cancel the event and send a configurable message.

Configuration (config.yml): Make everything fully customizable. This includes display names, lore (using MiniMessage or legacy colors), cooldown times, potion effect levels, and all system messages.

Data Persistence: Store player token balances in a local data.yml or players.yml file to ensure they save across restarts.

Kodari AI
KodariMar 20 at 9:28 pm 15,410 (v2)

I’ll create a fully-featured custom items and token economy plugin with NBT-based item recognition.

WildKits
Advanced custom items system featuring special consumable items (dynamite, buffs, dash) with cooldowns and NBT tracking. Includes a token-based economy with physical-to-virtual conversion through deposit/withdraw commands. All items use PersistentDataContainer for reliable identification and full MiniMessage configuration support.

All files created successfully. The WildKits plugin features:

  • 4 Custom Items (Dynamite, Speed Buff, Strength Buff, Dash) identified via PersistentDataContainer

  • Token Economy with physical-to-virtual conversion using NBT-tagged Sunflowers

  • Cooldown System preventing item spam with configurable timers

  • Item Consumption (removes 1 item per use, preserves stack)

  • Full MiniMessage Support for all text with gradient/hex color capability

  • Data Persistence via YAML storage for player token balances

  • Commands: /deposit [amount|all] and /withdraw <amount> with inventory validation

_

Gemini said Here is the updated prompt for your AI plugin maker. I have added a /wildkits give command with sub-arguments for each item and the tokens, including permission nodes to keep it secure.

AI Developer Prompt: Minecraft Plugin Development (WildKits)

Plugin Name: WildKits Target Version: Spigot/Paper 1.21+

Core Logic & Custom Items:

Create a system that recognizes and handles the following items based on their PersistentDataContainer (NBT) keys. Items must be consumed (1 per use) and respect the specified cooldowns.

DYNAMITE

NBT Key: wildkits:evox-wildkits (Value: DYNAMITE)

Material: Blaze Rod

Effect: Shoots a primed TNT; explodes on impact, dealing area damage.

Cooldown: 3 seconds.

SPEED BUFF

NBT Key: wildkits:evox-wildkits (Value: SPEED)

Material: Sugar

Effect: Applies Speed III for 5 seconds.

Cooldown: 10 seconds.

STRENGTH BUFF

NBT Key: wildkits:evox-wildkits (Value: STRENGTH)

Material: Sugar

Effect: Applies Strength III for 5 seconds.

Cooldown: 10 seconds.

DASH

NBT Key: wildkits:evox-wildkits (Value: DASH)

Material: Feather

Effect: Launches the player in their facing direction.

Cooldown: 5 seconds.

Admin Give Commands:

Implement a command to give these specific items to players. The items must have the exact NBT keys, names, and lore defined in the config.

Command /wildkits give [player] [item_type] [amount]:

Valid item_types: dynamite, speed, strength, dash, token.

Permission: wildkits.admin.give

Logic: Check if the player is online and if the amount is a valid number. Give the item directly to their inventory. and perms to use the withdraw and the deposit

Kodari AI
KodariMar 20 at 9:33 pm 24,019 (v2)

I’ll read the existing project files to understand the current structure and then add the give command with proper permissions.

I’ll add the /wildkits give command with proper permissions and update the existing commands to have permission checks.

All files have been updated with the /wildkits give command and proper permissions for all commands.

_

WorldGuard Integration:

Region Blacklist: In the config.yml, add a section for disabled-regions.

Logic: Before any custom item effect triggers, check if the player is currently standing in a WorldGuard region listed in the config.

Support: Allow the user to list multiple regions (e.g., spawn, market, safezone).

Message: If a player tries to use an item in a disabled region, cancel the event and send a configurable "You cannot use this here!" message.

Admin Give Commands:

Command: /wildkits give [player] [item_type] [amount]

Types: dynamite, speed, strength, dash, token.

Permission: wildkits.admin.give

Vault Economy Integration (/deposit & /withdraw):

Command /deposit [amount|all]: Scans inventory for the Token item (Sunflower with NBT wildkits:evox-token). Removes them and adds the equivalent value to the player's Vault balance.

Command /withdraw [amount]: Checks if the player has enough money in their Vault balance. If they have funds and inventory space, subtract the money from Vault and give the physical Token items.

Configurable Value: Add a token-value setting in config.yml.

Technical Requirements:

Hooks: Implement soft-dependencies for Vault and WorldGuard. Ensure the plugin still enables if these are missing (but disables the specific features).

Item Consumption: When using a custom item (Right-Click), remove exactly 1 item from the stack.

Inventory Check: In /withdraw, if the player’s inventory is full, cancel the transaction.

Configuration (config.yml): Use a StringList for disabled-regions. All messages and cooldowns must be editable.

Kodari AI
KodariMar 21 at 12:40 am 39,382 (v2)

I’ll add WorldGuard region blacklist, admin give commands, and Vault economy integration to your WildKits plugin. Let me first read the existing files to understand the structure.

Let me read the WorldGuard and Vault documentation to implement the integration correctly.

Now I’ll implement WorldGuard region blacklist, Vault economy integration, and ensure the admin give commands work properly.

Now I’ll create the VaultManager and update the necessary files to integrate WorldGuard region blacklist and Vault economy:

All files have been updated with WorldGuard region blacklist, Vault economy integration, and admin give commands. The plugin now:

  • WorldGuard Integration: Checks if player is in a disabled region before allowing item use

  • Vault Economy: /deposit and /withdraw now use Vault balance instead of internal storage

  • Token Value: Configurable multiplier for token-to-money conversion (default: 100)

  • Region Blacklist: List regions in disabled-regions config section

  • Soft Dependencies: Plugin enables without Vault/WorldGuard but disables those features

_

Color Support (MiniMessage & Legacy):

The plugin must support BOTH formatting styles in the config.yml for all names, lore, and messages:

MiniMessage: e.g., <aqua><bold>SPEED

Legacy: e.g., &b&lSPEED

Requirement: Use a utility method that parses both formats so the user can choose their preferred style.

Kodari can make mistakes. Review important code before using.
Files
src
build.gradle
Code
17 1,157
src/main/java/com/evox/wildkits/WildKits.java
package com.evox.wildkits;

import com.evox.wildkits.commands.DepositCommand;
import com.evox.wildkits.commands.GiveCommand;
import com.evox.wildkits.commands.WithdrawCommand;
import com.evox.wildkits.listeners.ItemUseListener;
import com.evox.wildkits.managers.CooldownManager;
import com.evox.wildkits.managers.DataManager;
import com.evox.wildkits.managers.ItemManager;
import com.evox.wildkits.managers.TokenManager;
import com.evox.wildkits.managers.VaultManager;
import com.evox.wildkits.managers.WorldGuardManager;
import lombok.Getter;
import org.bukkit.Bukkit;
import org.bukkit.plugin.java.JavaPlugin;

@Getter
public class WildKits extends JavaPlugin {
    private CooldownManager cooldownManager;
    private DataManager dataManager;
    private TokenManager tokenManager;
    private ItemManager itemManager;
    private VaultManager vaultManager;
    private WorldGuardManager worldGuardManager;
    
    @Override
    public void onEnable() {
        saveDefaultConfig();
        
        cooldownManager = new CooldownManager();
        dataManager = new DataManager(this);
        tokenManager = new TokenManager(dataManager);
        itemManager = new ItemManager(this);
        vaultManager = new VaultManager(this);
        worldGuardManager = new WorldGuardManager(this);
        
        ItemUseListener itemUseListener = new ItemUseListener(this, cooldownManager, itemManager);
        Bukkit.getPluginManager().registerEvents(itemUseListener, this);
        
        getCommand("deposit").setExecutor(new DepositCommand(this, tokenManager, itemManager));
        getCommand("withdraw").setExecutor(new WithdrawCommand(this, tokenManager, itemManager));
        getCommand("wildkits").setExecutor(new GiveCommand(this, itemManager));
        
        getLogger().info("WildKits has been enabled!");
    }
    
    @Override
    public void onDisable() {
        if (dataManager != null) {
            dataManager.saveData();
        }
        
        getLogger().info("WildKits has been disabled!");
    }
}