Mastering CraftGuard: The Ultimate Minecraft Server Plugin for Action Control
Running a Minecraft server means balancing creativity with order. You want players to enjoy the game, but sometimes you need to restrict certain actions to protect your world or enforce a specific playstyle. CraftGuard steps in as a powerful, lightweight solution that lets server admins control exactly what players can craft, smelt, place, break, repair, and use—all through simple, customizable item lists. Whether you’re building a survival economy, a minigame hub, or a roleplay realm, CraftGuard gives you the precision you need without bloating your server.
What Is CraftGuard?
CraftGuard is a Bukkit/Spigot plugin designed to give you fine-grained control over player actions involving items. Unlike basic permission plugins that only block commands, CraftGuard works at the item level, allowing you to define lists of allowed or disallowed items for specific activities. The plugin has recently evolved into its second major version, CraftGuard 2, which introduces a modular system, better performance, and a host of new features that make it indispensable for any server administrator who values control.
Key Features of CraftGuard 2
The latest beta release of CraftGuard 2 completely reimagines how action control works. Instead of a monolithic approach, it splits functionality into modules, so you only enable what you need. Here are the standout capabilities:
- Modular action control: Block crafting, smelting, placing, breaking, repairing, and using items independently, each with its own configuration.
- Item list system: Define custom lists of items that are allowed or denied for each module, with support for metadata and item variations.
- List inheritance: Create parent lists that child lists inherit from, reducing duplication and making management easier.
- Automatic whitelist: Choose whether actions on items not present in any list are automatically allowed or denied, giving you a flexible default policy.
- Optimized performance: Significant code improvements ensure minimal impact on server tick rate, even with many lists and modules active.
Modular Action Control
The heart of CraftGuard 2 is its module system. Each type of player action—crafting, smelting, placing blocks, breaking blocks, repairing items, and using items (right-click interactions)—can be toggled on or off and configured separately. For example, you might allow all crafting except for diamond gear, restrict the smelting of certain ores, and completely disable the use of ender pearls in specific worlds. Each module references its own item lists, so a diamond sword could be uncraftable but still usable if you set the lists correctly.
List Inheritance and Metadata Support
Managing dozens of items can become tedious, but CraftGuard’s list inheritance simplifies the process. You can create a base list like “banned-tools” and have other lists inherit from it, so updating the parent instantly applies to all children. Metadata support means you can target items with specific durability, enchantments, or custom names, giving you surgical precision when restricting or allowing actions. This is perfect for servers with custom items from other plugins.
Automatic Whitelist Options
Not every item needs to be explicitly listed. CraftGuard’s automatic whitelist setting lets you define the default behavior for unlisted items. If you set it to “allow,” any item not found in your deny lists is freely usable. Conversely, a “deny” default means only items you explicitly whitelist can be used. This dual approach eliminates guesswork and lets you tailor the plugin to either a permissive or restrictive server policy with a single config change.
Getting Started with CraftGuard
Setting up CraftGuard on your server is straightforward. After downloading the plugin JAR, you simply drop it into your server’s plugins folder and restart. If you’re managing multiple mods and plugins, you might appreciate using the foxygame.net launcher — a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu, making it easier to keep everything organized. Once installed, you can start configuring the plugin to your liking. The first start generates a default configuration file and example lists, so you can see the structure immediately. Commands like /craftguard reload and /craftguard list let you manage everything in-game without needing to restart the server each time you tweak a rule.
Commands and Configuration
CraftGuard 2 introduces a cleaner command set. You can add or remove items from lists, check what actions are blocked, and reload the configuration on the fly. The main configuration file lets you enable or disable modules, set the automatic whitelist mode, and link lists to specific modules. All item lists are stored in a separate lists.yml file, which supports inheritance through a simple parent reference. The plugin’s wiki (available on GitHub) provides detailed examples, and the issue tracker is open for bug reports and suggestions.
What’s Next for CraftGuard?
The developer has an exciting roadmap ahead. Planned features include a brewing module to control potion creation, a “permission mode” that uses permission nodes instead of list files for even more dynamic control, and support for adding custom crafting and smelting recipes through custom GUIs. These additions will make CraftGuard not just a restriction tool but a full-fledged item management suite. You can follow the progress on the official GitHub repository where the source code is available under the GNU General Public License version 3.
Why CraftGuard Belongs on Your Server
Many plugins offer blanket bans or simple permission checks, but CraftGuard’s list-based, modular approach sets it apart. It respects the complexity of modern Minecraft servers where items often carry metadata and where different worlds may need different rules. The inheritance system keeps your configuration DRY (Don’t Repeat Yourself), and the automatic whitelist prevents unexpected blocks. Whether you’re protecting a precious economy, preventing griefing, or designing a custom game mode, CraftGuard adapts to your vision rather than forcing you into a rigid framework.
If you’re upgrading from CraftGuard 1.x, the transition is smooth thanks to detailed upgrade documentation. New users can dive into the first-start guide to get up and running in minutes. With active development and a responsive bug tracker, CraftGuard is poised to become an essential part of any administrator’s toolkit.