CraftGuard

插件

· 作者 ItzzNotMateo

一个轻量级、高度可配置的 Minecraft 插件,用于按世界管理工作站的使用限制。

0 本站下载 0 关注 更新于 7 个月前

最新 2.2.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)
CraftGuard Banner

CraftGuard

适用于 Minecraft 服务器的细粒度、按世界保护

Minecraft Paper Java 21+ Per-World Protection WorldGuard Integration

CraftGuard 让您能够精确控制各个 Minecraft 世界中的合成、工作台、容器和传送门。专为灵活的服务器管理而构建,它非常适合用于生存枢纽、创造地块、小游戏竞技场和冒险地图。


项目演进与品牌重塑

  • 继任者: CraftGuard 是 FlameAntiCraft 的官方继任者。
  • 即将进行的品牌重塑: CraftGuard 将在 VOMLabs organization 旗下更名为 ServerGuard*。此次过渡包括一次专注于性能和可靠性的完全重写,并且 Maven 支持将被弃用,转而使用带有 Kotlin DSL 的 Gradle。

功能特性

按世界保护

为每个世界配置独立的规则。针对生存世界、创造地块、大厅和小游戏实例定制交互体验。

工作台控制

单独管理工作台的访问权限,包括:

anvil(铁砧)、furnace(熔炉)、blast-furnace(高炉)、smoker(烟熏炉)、enchanting(附魔台)、brewing(酿造台)、smithing(锻造台)、loom(织布机)、cartography(制图台)、grindstone(砂轮)和 stonecutter(切石机)。

容器安全

限制对箱子、陷阱箱、末影箱、铜箱和潜影盒的交互。

传送门管理

独立启用或禁用每个世界的下界和末地传送门转换。

灵活存储

支持多种存储后端,包括 YAML、H2、MySQL、MariaDB、PostgreSQL、MongoDB 和 Redis。

交互式管理 GUI

通过 /cg 界面管理设置,提供快速切换、显式配置、导入、导出和世界迁移的命令。

集成与本地化

支持 PlaceholderAPI 以实现动态占位符,可选的 WorldGuard 基于区域的绕过功能,以及多种语言。


支持的功能

类别 功能类型
核心机制 crafting(合成)、nether-portal(下界传送门)、end-portal(末地传送门)、lockdown(锁定模式)
工作台 anvil(铁砧)、furnace(熔炉)、blast-furnace(高炉)、smoker(烟熏炉)、enchanting(附魔台)、brewing(酿造台)、smithing(锻造台)、loom(织布机)、cartography(制图台)、grindstone(砂轮)、stonecutter(切石机)
容器 chest(箱子)、trapped-chest(陷阱箱)、ender-chest(末影箱)、copper-chest(铜箱)、shulker-box(潜影盒)

安装

要求

  • 服务器: Paper 1.21.x 或兼容的分叉版本,如 Purpur 和 Folia
  • Java: 21 或更高版本
  • 可选: PlaceholderAPI 用于动态占位符,WorldGuard 用于基于区域的绕过

[!WARNING] 版本支持: CraftGuard 目前正式不支持 26.x.x 或更早的版本。官方支持和可靠性改进计划将在即将到来的 ServerGuard 品牌重塑和重写中实现。

设置

  1. 从 Modrinth 下载最新的 craftguard-X.X.X.jar。
  2. 将 JAR 文件放入服务器的 plugins/ 目录中。
  3. 重启服务器以生成配置文件。
  4. 在 plugins/CraftGuard/config.yml 中配置插件。
  5. 使用 /cg 打开管理界面。

快速命令

# 在大厅世界中禁用合成
/cg lobby crafting off

# 在生存世界中启用下界传送门
/cg survival nether-portal on

# 打开管理 GUI
/cg

命令与权限

命令

命令 描述 权限
/cg 打开管理 GUI craftguard.admin
/cg help 显示帮助菜单 craftguard.admin
/cg <world> <feature> <on/off> 更改世界中某功能的开关状态 craftguard.admin
/cg reload 重新加载插件配置和本地化文件 craftguard.admin
/cg export 将设置导出到备份文件 craftguard.admin
/cg import 从文件导入设置 craftguard.admin
/cg migrate [copy] 在世界之间复制或移动配置 craftguard.admin

权限

权限 描述 默认值
craftguard.admin 完全访问 CraftGuard 命令和 GUI OP
craftguard.bypass.* 绕过所有世界限制 false
craftguard.bypass.<feature> 绕过特定功能限制 false

配置

设置存储在 plugins/CraftGuard/ 下的 YAML 文件中。

示例配置:

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

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

PlaceholderAPI 集成

使用 PlaceholderAPI 占位符在记分板、标签页列表和全息图中显示实时的功能状态和交互统计信息。

将 <world> 和 <feature> 替换为相关的世界名称或功能类型。

世界状态

占位符 描述
%craftguard_world_state% 当前世界的状态(enabled 启用 或 disabled 禁用)
%craftguard_world_state_<feature>% 当前世界中某功能的开关状态
%craftguard_world_<world>_<feature>% 特定世界中某功能的开关状态

统计

占位符 描述
%craftguard_stats_global_total% 整个网络中拦截的交互总数
%craftguard_stats_type_<feature>_total% 特定功能类型被拦截的交互总数
%craftguard_stats_world_<world>_total% 特定世界中被拦截的交互总数

开发者 API

使用 CraftGuard 的 API 构建集成。

[!NOTE] 即将发生的变更: ServerGuard 的过渡将包含插件的全面重写,API 也将在此过程中重新设计。过渡后可能需要更新现有的集成。

Maven 配置

<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>

从源码构建

或者,克隆仓库并在本地构建。

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

API 使用示例

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

// 检查生存世界中是否启用了合成
boolean isCraftingEnabled =
    configManager.isFeatureEnabled("survival", "crafting");

// 禁用生存世界中的熔炉交互
configManager.setFeatureEnabled("survival", "furnace", false);

支持与社区


CraftGuard 与 ServerGuard 嵌入组件

Servers & Players


VOMLabs · Advanced Server Solutions

由 ItzzMateo* 和 VOMLabs 团队精心打造。


* 开发与开源声明: ServerGuard 仓库* 和 Modrinth 项目已作为草稿存在并正在积极开发中。然而,该项目目前尚未开源或发布。源代码将在插件完整重新正式发布后才会公开可用。在此之前,仓库的存在并不意味着源代码可供公众使用。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源