NetherGuard

在玩家划定的区域内阻止下界传送门生成
Prevent nether portal creation within player-defined regions.

一个轻量的 Minecraft 服务端插件，允许玩家用 /ng pos1、/ng pos2 划定区域，并阻止该区域内生成下界传送门。支持 SQLite / MySQL 存储、多语言（内置 zh_CN / zh_TW / en_US），采用异步单线程写入队列，保证数据一致性的同时不阻塞主线程。

目录

• 功能特性
• 兼容性
• 安装
• 快速开始
• 命令
• 权限

功能特性

• 区域保护：玩家用两个对角点划定立方体区域，区域内禁止生成下界传送门。
• 拦截事件：
  • 拦截 PortalCreateEvent（玩家点火、自然生成等）
  • 拦截 PlayerPortalEvent（玩家穿过传送门进入受保护区域）
• 2D / 3D 模式：可配置忽略 Y 轴，整列高度都受保护。
• 多存储后端：内置 SQLite，可选 MySQL。
• 异步写入：所有 INSERT / DELETE 走单线程写入队列，避免 SQLite 锁冲突，不卡主线程。
• 失败保守策略：数据库加载失败时默认"拒绝放行"（fail-closed），可配置。
• i18n：内置简体中文、繁体中文、英文；支持自定义语言文件。
• 每玩家区域上限：可配置最大区域数，OP 可绕过。

兼容性

已在 Purpur 1.21.8 上验证。

安装

1. 从 Releases 下载最新 NetherGuard-x.x.x.jar。
2. 放入服务端 plugins/ 目录。
3. 重启服务器。
4. 首次启动应会生成：

   plugins/NetherGuard/
   ├── config.yml
   ├── lang/
   │   ├── zh_CN.yml
   │   ├── zh_TW.yml
   │   └── en_US.yml
   └── regions.db        # SQLite 模式
   

快速开始

/ng pos1              # 站在第一个角，设置 pos1
/ng pos2              # 站在对角，设置 pos2
/ng create my_region  # 用当前选区创建名为 my_region 的区域
/ng list              # 查看自己的区域列表
/ng info my_region    # 查看区域详情
/ng delete my_region  # 删除区域

设置完成后，任何玩家在该区域内点燃下界传送门都会被阻止，穿过传送门进入该区域也会被拦截。

命令

主命令：/netherguard，别名 /ng。

不带子命令时显示帮助（帮助内容会根据权限过滤）。

权限

NetherGuard

Prevent nether portal creation within player-defined regions. 在玩家划定的区域内阻止下界传送门生成

A lightweight Minecraft server plugin that allows players to define regions using /ng pos1 and /ng pos2, blocking nether portal generation inside those areas. Supports SQLite / MySQL storage, multi-language (built-in zh_CN / zh_TW / en_US), and uses an asynchronous single-thread write queue to ensure data consistency without blocking the main server thread.

Table of Contents

• Features
• Compatibility
• Installation
• Quick Start
• Commands
• Permissions

Features

• Region Protection: Players define cuboid regions with two diagonal points. Nether portals cannot be created inside protected regions.
• Event Interception:
  • Intercept PortalCreateEvent (player ignition, natural generation, etc.)
  • Intercept PlayerPortalEvent (players entering protected regions via nether portals)
• 2D / 3D Mode: Configurable option to ignore the Y-axis, protecting the entire vertical column.
• Multiple Storage Backends: SQLite by default, MySQL optional.
• Asynchronous Writes: All INSERT / DELETE operations go through a single-thread write queue to avoid SQLite lock contention and prevent main thread blocking.
• Fail-Closed Policy: Deny portal access by default if database fails to load; this behavior is configurable.
• i18n Support: Built-in Simplified Chinese, Traditional Chinese, English; custom language files are supported.
• Per-player Region Limit: Configurable maximum number of regions per player. Operators can bypass this limit.

Compatibility

Verified on Purpur 1.21.8.

Installation

1. Download the latest NetherGuard-x.x.x.jar from Releases.
2. Place the jar into your server's plugins/ folder.
3. Restart your server.
4. On first startup, these files will be generated:

plugins/NetherGuard/
├── config.yml
├── lang/
│   ├── zh_CN.yml
│   ├── zh_TW.yml
│   └── en_US.yml
└── regions.db        # SQLite mode

Quick Start

/ng pos1              # Stand at your first corner and set pos1
/ng pos2              # Stand at the opposite diagonal and set pos2
/ng create my_region  # Create a region named my_region using your current selection
/ng list              # List all your regions
/ng info my_region    # View details of my_region
/ng delete my_region  # Delete my_region

Once configured, any player attempting to ignite a nether portal within this region will be blocked. Players will also be blocked if they attempt to enter the protected region via an existing nether portal.

Commands

Main command: /netherguard, alias /ng.

Running the base command without subcommands shows help text, filtered according to the executor's permissions.

Permissions