Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details

Build and manage server kits directly in-game with a player-friendly claim menu, full admin editor, and per-kit cooldown/one-time controls.
FoKits is a configurable kit plugin for Spigot/Paper servers that focuses on speed and control: players can claim or preview kits from a clean GUI, while admins can create, edit, and organize kits without leaving Minecraft.

Features
- Open a player kit menu with
/fokits(aliases:/kits,/kit) and claim or preview kits with clicks. - Let players directly claim a specific kit with
/fokits <kit>. - Manage kits fully in-game with
/fokitsadmin editor: create, search, rename, preview, and delete kits. - Edit complete kit contents (inventory, armor, offhand) with full item meta support.
- Configure per-kit rules: enabled/disabled, required permission, cooldown or one-time mode, and blocked worlds.
- Add automation per kit with optional broadcast messages and console commands on claim.
- Customize presentation per kit with display name, icon material, custom model data, sort order, and claimed-state icon.
- Customize the player GUI layout using chest slot markers, static decorative items, title, rows, and filler material.



Dependencies
- PlaceholderAPI (optional) for FoKits placeholders
Commands
/fokits- Open the player kit menu/fokits <kit>- Claim a specific kit directly/fokitsadmin version- Show plugin version/author info/fokitsadmin reload- Reload config and kit files/fokitsadmin editor- Open the in-game admin editor
Permissions
fokits.use- Use player kit command (/fokits,/kits,/kit)fokits.admin- Use admin command (/fokitsadmin)- Per-kit permission node (optional) - Set in kit settings as
required-permission
Placeholders
Identifier: %fokits_<token>_<kitKey>%
Available tokens:
time_remaining(formatted remaining time)time_remaining_seconds(remaining seconds)can_claim(true/false)next_claim_at(epoch seconds)claimed_once(true/false)
Examples:
%fokits_time_remaining_starter%%fokits_can_claim_starter%
FoKits also includes admin-focused tools for quick dialog-input editing, searchable kit lists, and per-player claim tracking in YAML files.
Developer API
Compile against the matching jar (provided in Maven, compileOnly in Gradle); install it locally if needed. Declare FoKits in your plugin metadata (softdepend for an optional integration).
<dependency>
<groupId>me.foesio</groupId>
<artifactId>FoKits</artifactId>
<version>2.2</version>
<scope>provided</scope>
</dependency>
import me.foesio.foKits.api.FoKitsApi;
import me.foesio.foKits.api.event.KitClaimPreEvent;
FoKitsApi api = Bukkit.getServicesManager().load(FoKitsApi.class);
if (api != null) api.listKits();
@EventHandler
public void onKitClaimPreEvent(KitClaimPreEvent event) {
Bukkit.getLogger().info(event.getClass().getSimpleName());
}
API methods (overloads grouped):
FoKitsApi:listKits,findKit,evaluateClaim,claimKit,resetCooldown,resetAllCooldowns,resetOneTimeClaim,openKitsGui.
Other API types: KitClaimOutcome, KitClaimStatus, KitResetBatchOutcome, KitResetResult, KitSnapshot.
Events: KitClaimPreEvent, KitClaimedEvent.
Browse API and event source for signatures and event details.


