CraftGuard

Granular, Per-World Protection for Minecraft Servers

CraftGuard gives you precise control over crafting, workstations, containers, and portals across individual Minecraft worlds. Built for flexible server management, it's ideal for survival hubs, creative plots, minigame arenas, and adventure maps.

Project Evolution & Rebranding

• Successor: CraftGuard is the official successor to FlameAntiCraft.
• Upcoming Rebrand: CraftGuard will transition to ServerGuard* under the VOMLabs organization. The transition includes a complete rewrite focused on performance and reliability, with Maven support being deprecated in favor of Gradle with Kotlin DSL.

Features

Per-World Protection

Configure independent rules for every world. Tailor interactions to survival worlds, creative plots, lobbies, and minigame instances.

Workstation Control

Manage workstation access individually, including:

anvil, furnace, blast-furnace, smoker, enchanting, brewing, smithing, loom, cartography, grindstone, stonecutter.

Container Security

Restrict interactions with chests, trapped chests, ender chests, copper chests, and shulker boxes.

Portal Management

Enable or disable Nether and End portal transitions independently for each world.

Flexible Storage

Supports multiple storage backends, including YAML, H2, MySQL, MariaDB, PostgreSQL, MongoDB, and Redis.

Interactive Management GUI

Manage settings through the /cg interface, with commands for quick toggles, explicit configuration, imports, exports, and world migration.

Integrations & Localization

Supports PlaceholderAPI for dynamic placeholders, optional WorldGuard region-based bypasses, and multiple languages.

Supported Features

Installation

Requirements

• Server: Paper 1.21.x or compatible forks such as Purpur and Folia
• Java: 21 or higher
• Optional: PlaceholderAPI for dynamic placeholders and WorldGuard for region-based bypasses

[!WARNING] Version support: CraftGuard does not officially support versions 26.x.x or older at this time. Official support and reliability improvements are planned for the upcoming ServerGuard rebrand and rewrite.

Setup

1. Download the latest craftguard-X.X.X.jar from Modrinth.
2. Place the JAR in your server's plugins/ directory.
3. Restart your server to generate the configuration files.
4. Configure the plugin in plugins/CraftGuard/config.yml.
5. Open the management interface using /cg.

Quick Commands

# Disable crafting in the lobby world
/cg lobby crafting off

# Enable Nether portals in the survival world
/cg survival nether-portal on

# Open the management GUI
/cg

Commands & Permissions

Commands

Permissions

Configuration

Settings are stored in YAML files under plugins/CraftGuard/.

Example configuration:

settings:
  enabled: true
  language: en-us
  default-state: true

item-blockability:
  enabled: true
  blocked-items:
    CRAFTING:
      - DIAMOND_SWORD
      - NETHERITE_*

PlaceholderAPI Integration

Use PlaceholderAPI placeholders to display live feature states and interaction statistics in scoreboards, tablists, and holograms.

Replace <world> and <feature> with the relevant world name or feature type.

World States

Statistics

Developer API

Build integrations against CraftGuard using its API.

[!NOTE] Upcoming changes: The ServerGuard transition will include a complete plugin rewrite, and the API will be redesigned as part of that process. Integrations may need to be updated after the transition.

Maven Setup

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.github.itzzjustmateo</groupId>
        <artifactId>CraftGuard</artifactId>
        <version>VERSION</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

Build from Source

Alternatively, clone the repository and build locally.

git clone https://github.com/itzzjustmateo/CraftGuard.git
cd CraftGuard
mvn clean package

API Usage

CraftGuard plugin = CraftGuard.getInstance();
ConfigManager configManager = plugin.getConfigManager();

// Check whether crafting is enabled in the survival world
boolean isCraftingEnabled =
    configManager.isFeatureEnabled("survival", "crafting");

// Disable furnace interactions in the survival world
configManager.setFeatureEnabled("survival", "furnace", false);

Support & Community

• 🐛 Bug Reports: GitHub Issues*
• 💡 Feature Requests: GitHub Discussions*
• 💬 Discord Support: Join the VOMLabs Discord

CraftGuard AND ServerGuard Embed

* Development & Open-Source Notice: The ServerGuard repository* and Modrinth project already exist as drafts and are actively being developed. However, the project is not currently open-source or released. The source code will become publicly available again only when the complete plugin is officially re-released. Until then, the repository's existence does not imply that the source code is available for public use.