CraftGuard

⚠️ About FlameAntiCraft/FlameCraft
CraftGuard is the next evolution of my original plugin, FlameAntiCraft (FlameCraft).
FlameAntiCraft/FlameCraft is no longer maintained—if you’re seeking new features, improvements, or support, CraftGuard is the official upgrade!

Want total control over where and how players craft? CraftGuard gives you powerful, per-world management for crafting, workstation use, and portals.

Features • How to Install • Commands • Configuration • For Developers

---

📋 What is CraftGuard?

CraftGuard gives you precise control over crafting, workstation use, and portal access on your Minecraft server—world by world.
Shut down crafting in a creative hub, restrict furnaces in adventure maps, block the nether in box, or lock portals on challenge worlds: CraftGuard is your all-in-one solution for flexible server management.

Why CraftGuard?

• ⚡ Ultra-Lightweight – Meticulously optimized to keep your server running smooth, no matter the size.
• 🚀 Multi-Database Support – Effortlessly use YAML, H2, MySQL, MariaDB, PostgreSQL, or MongoDB to store your settings and restrictions.
• 📂 Easy Backup & Migration – Instantly export and import configurations to switch between storage types or servers without hassle.
• 🎛️ Deep Customization – Individually toggle crafting, each workstation, or portal type for every world—enforce only what you want, where you want it.
• 🌎 Per-World Freedom – Build adventure maps, minigames, or creative hubs with unique restrictions for each world.
• 🧩 PlaceholderAPI Integration – Unlock dynamic placeholders for scoreboards, titles, and messages covering every plugin feature.
• 🎨 Modern Messaging – Style plugin messages with MiniMessage or legacy color codes for a polished, contemporary look.
• 👩‍🔧 Auto-Migration of Configs – Existing setups are auto-upgraded; effortlessly keep up with new features and settings.

---

Optional: WorldGuard, PlaceholderAPI
Recommended: Multiverse-Core for multi-world management

---

✨ Features

Main

• Total Control: Instantly enable or disable crafting, nether/end portal use, anvils, furnaces, and 10+ workstation types—each on a per-world basis.
• Flexible Per-World Settings: Fine-tune exactly which features are allowed in each world with just one command.
• Beautiful, Intuitive GUI: Manage everything from an in-game chest menu with modern MiniMessage styling and real-time status indicators.
• Automatic Update Checker: Stay up-to-date with built-in version checking via Modrinth, including optional auto-download and admin notifications.
• Bypass & Permissions System: Lets specific players or groups ignore certain restrictions with detailed, granular permissions.
• Smart Help Command: Redesigned, user-friendly /cg help menu provides context-aware guidance for every command.
• Clean, Consistent Commands: Use logical, streamlined commands for everything—no more guesswork, just /cg.

Toggle Use Of:

• Core mechanics: crafting, nether-portal, end-portal
• Workstations: anvil, furnace, blast-furnace, smoker, cartography, grindstone, loom, smithing, enchanting, brewing, stonecutter
• And more—covering every major utility and workstation block

---

📦 How to Install

Requirements

• Paper (Minecraft 1.21.x)
• Java 21 or newer
• (Optional) PlaceholderAPI for better placeholder support

Quick Start Guide

1. Get CraftGuard:
   • Download the latest craftguard-1.7.0.jar from the Modrinth project page.
2. Install:
   • Place the downloaded .jar file into your server’s plugins/ directory.
3. Start Your Server:
   • Restart (or start up) the server to let CraftGuard generate its files automatically.
4. Configure:
   • Edit the configuration at plugins/CraftGuard/config.yml to suit your world and preferences.
   • (Optional) Configure storage or permissions if you use databases or custom roles.
5. You’re Ready!
   • Use /cg help for the full command list, or just /cg to access the GUI and start managing features right away.

Need help? See the full documentation and tips on the Modrinth page or use the built-in /cg help command for instant guidance!

---

🎮 Commands

Base command: /craftguard (or /cguard, /cg)

Command	What it does	Who can do it
/cg	Opens the management GUI	craftguard.admin
/cg help	Shows help menu	craftguard.admin
/cg <world> <type> on	Allow a feature in a world	craftguard.admin
/cg <world> <type> off	Block a feature in a world	craftguard.admin
/cg <world> <type> toggle	Flip feature on/off	craftguard.admin
/cg reload	Reload configuration	craftguard.admin

Command Examples

# Block anvils in "survival"
/cg survival anvil off

# Enable nether portals in "world"
/cg world nether-portal on

# Toggle crafting in "lobby"
/cg lobby crafting toggle

Permissions

Permission	Description	Default
craftguard.admin	Manage all settings	OP
craftguard.bypass.<type>	Bypass specific restriction	false
craftguard.bypass.*	Bypass all restrictions	false

---

🔌 PlaceholderAPI Support

Supports both %placeholder% and formats

Placeholders follow a simple pattern: %craftguard_world_state_<type>% (for player's current world) %craftguard_world_<worldname>_<type>% (for specific world)

Examples:

• %craftguard_world_state_crafting% -> enabled
• %craftguard_world_survival_anvil% -> disabled
• %craftguard_world_state_nether-portal% -> enabled

---

👨‍💻 Developers

Building from Source

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

ConfigManager API

You can access the ConfigManager via CraftGuard.getInstance().getConfigManager().

• isFeatureEnabled(String world, String type)
• setFeatureEnabled(String world, String type, boolean enabled)

---

📝 License

MIT License — see LICENSE.

---

🤝 Support

• Issues? GitHub Issues
• Discussions: Feature Requests
• Discord: Join our Discord