---

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

Category	Feature Types
Core mechanics	crafting, nether-portal, end-portal, lockdown
Workstations	anvil, furnace, blast-furnace, smoker, enchanting, brewing, smithing, loom, cartography, grindstone, stonecutter
Containers	chest, trapped-chest, ender-chest, copper-chest, shulker-box

---

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

Command	Description	Permission
/cg	Open the management GUI	craftguard.admin
/cg help	Display the help menu	craftguard.admin
/cg <world> <feature> <on/off>	Change a feature's state in a world	craftguard.admin
/cg reload	Reload plugin configuration and locales	craftguard.admin
/cg export	Export settings to a backup file	craftguard.admin
/cg import	Import settings from a file	craftguard.admin
/cg migrate [copy]	Copy or move configuration between worlds	craftguard.admin

Permissions

Permission	Description	Default
craftguard.admin	Full access to CraftGuard commands and GUI	OP
craftguard.bypass.*	Bypass all world restrictions	false
craftguard.bypass.<feature>	Bypass a specific feature restriction	false

---

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

Placeholder	Description
%craftguard_world_state%	State of the current world (enabled or disabled)
%craftguard_world_state_<feature>%	State of a feature in the current world
%craftguard_world_<world>_<feature>%	State of a feature in a specific world

Statistics

Placeholder	Description
%craftguard_stats_global_total%	Total blocked interactions across the network
%craftguard_stats_type_<feature>_total%	Total blocked interactions for a feature type
%craftguard_stats_world_<world>_total%	Total blocked interactions in a specific world

---

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.