Getting Started with the FirstKit Plugin for Minecraft Servers
Every server owner knows the struggle of welcoming new players. You want to give them a helpful starter kit without flooding their inventory or enabling exploits. That is exactly where FirstKit shines. This lightweight Bukkit and Spigot plugin delivers a fully customizable one-time kit to users, ensuring a fair and controlled onboarding experience. Whether you run a survival world, a minigame hub, or a faction server, FirstKit helps you define exactly what each newcomer receives—and just as importantly, when they stop receiving it.
What Makes FirstKit Stand Out
Unlike many kit plugins that hand out items on every login or respawn, FirstKit is designed around a single-use philosophy. Once a player claims their kit, they are automatically flagged and cannot grab it again unless an admin manually resets their status. This prevents duplication abuse and keeps your economy balanced. But the plugin goes far beyond a simple one-time handout.
Core Features at a Glance
- One-time kit delivery – Players receive the kit only once, with no repeat claims.
- Group support – Assign different kits to different permission groups, so VIPs, staff, or donors get unique starting gear.
- Fully customizable items – Define any combination of items, quantities, and even custom lore via the configuration file.
- Color-coded messages – Adjust chat message colors to match your server’s theme.
- Simple admin commands – Easily ban or unban players from receiving a kit, or change group assignments on the fly.
- Lightweight and compatible – Works with any permissions plugin, and Vault is optional in version 1.3.1.
Commands That Put You in Control
FirstKit’s command set is small but powerful, making it easy to manage even for admins new to plugin configuration. Here is the full reference:
- /fkgive – Gives the command sender a kit immediately (useful for testing).
- /fkset [player] – Bans a player from ever receiving a kit. Use this to revoke kit access from rule-breakers.
- /fkunset [player] – Removes the ban, allowing the player to get a kit again.
- /fk [groups] [setkit:setallowed] [Group:(Kit)] – Main administrative command for linking groups to specific kits or toggling whether a group can claim a kit at all.
- /fkinfo – Displays the current version and basic plugin information.
All commands are case-sensitive when it comes to group names, so double-check your permissions plugin setup before running them.
Deep Dive into the Configuration
The heart of FirstKit lies in its config.yml file, located in plugins/FirstKit/. When you first run the plugin, it generates a default configuration that gives new players a set of stone tools and cooked beef. You can then modify this to your liking.
Understanding the Default Kit Structure
The default kit block looks something like this:
kit-default:
items:
- STONE_SWORD,1
- STONE_PICKAXE,1
- STONE_AXE,1
- STONE_SPADE,1
- COOKED_BEEF,10
Each line under items follows the format ITEM_NAME,QUANTITY. If you omit the quantity, it defaults to 1. You can add any valid Minecraft item ID, including enchanted books or potions, as long as you use the correct Bukkit material names. For reference, you can always check the official Minecraft item ID list to ensure your entries are valid.
Colors and Group Settings
Below the kit definition, you will find color codes for positive, negative, and error messages. These use standard Minecraft color names like GOLD, RED, and DARK_RED. Adjusting them is a quick way to keep your server’s chat branding consistent. The groups section is best managed through in-game commands, but if you edit the file manually, remember that proper YAML indentation is critical. Use exactly four spaces for each level—never tabs—or Bukkit will refuse to load the plugin.
When creating custom kits for different groups, copy the default kit block and modify it. This avoids indentation mistakes. Also, keep inventory size in mind: a player has only 36 slots, and some may already be occupied. Overstuffing a kit can cause items to be lost, so plan quantities carefully.
Group-Based Kits: Rewarding Different Player Tiers
FirstKit really becomes powerful when you pair it with a permissions plugin like LuckPerms or GroupManager. By using the /fk groups setkit [Group]:[KitName] command, you can define separate kits for your default rank, donors, moderators, or any other group. For example, you might give regular players basic stone tools, while VIPs receive iron gear and a few golden apples. You can also toggle whether a group is allowed to receive a kit at all with /fk groups setallowed [Group], which is handy for temporarily disabling starter kits during events.
If you’re managing multiple servers or simply want a more streamlined way to install and test plugins like FirstKit, the foxygame.net launcher offers a modern, flexible solution. It lets you browse and download plugins directly from its menu, so you can skip manual file transfers and get right to configuring your server’s welcome experience.
Dependencies and Compatibility
Version 1.3.1 of FirstKit no longer hard-depends on Vault, meaning you can run it without that API if your setup doesn’t require economy integration. However, having Vault installed is still recommended because many permissions plugins rely on it. The plugin itself is built for Bukkit and Spigot, and it plays nicely with any group management system that hooks into Vault. Always test new configurations on a staging server before pushing them live to avoid unexpected behavior.
Pro Tips for Smooth Operation
- Back up your config.yml before making manual edits. If you break the indentation, simply delete the file and restart the server—FirstKit will generate a fresh default.
- Validate item names and colors using standard Minecraft references. A single typo can prevent the kit from loading.
- Use the /fkunset command sparingly to reset players who accidentally lost their kit due to a bug or a server rollback.
- Test with /fkgive after every config change to confirm the kit appears correctly in-game.
Final Thoughts
FirstKit fills a specific niche in the Minecraft server ecosystem with elegance and simplicity. Its one-time delivery model prevents abuse, while group support and deep configuration options give you full control over the new-player experience. Whether you are building a hardcore survival world or a casual creative server, this plugin helps you set the right tone from the very first login. With a bit of YAML know-how and the right permissions setup, you can craft a welcome kit that feels rewarding without unbalancing your game.