Bedrock Allow Deny Border

English

A faithful, client-side Fabric mod for Minecraft Java Edition 1.21 that ports the Bedrock / Education Edition Allow, Deny, and Border blocks to Java Edition.

Designed specifically for single-player adventure maps and LAN co-op worldbuilding. Every rule is evaluated consistently across all clients, and host configurations are synchronized live to everyone on the LAN.

Note: In LAN worlds, all participating players must have the same mod version installed for permissions and barrier rules to be enforced uniformly.

🧱 What Does It Add?

Three "teacher-block" style utility blocks in a dedicated creative tab:

Block	Purpose & Behavior
Allow Block	Marks its vertical column as buildable even within restricted areas.
Deny Block	Prohibits block placement and breaking throughout the entire column (highest stacked block takes precedence).
Border Block	Creates an invisible impassable wall covering the entire (X, Z) column across all Y levels (cannot be jumped over, flown over, or tunneled beneath).

All utility blocks are blast-resistant, unmovable by pistons, and immune to griefing.

🛡️ Border Passing Matrix

The border wall operates in two distinct modes, configurable in-game:

Entity Type	Bedrock-like (Default)	Block All Entities
Unprivileged Players & Hostile Mobs	❌ Blocked	❌ Blocked
Privileged Players (Whitelist / OP + Creative)	✅ Allowed	✅ Allowed
Spectator Mode Players	✅ Allowed	✅ Allowed
Projectiles (Arrows, Ender Pearls, Fireballs, etc.)	✅ Allowed	❌ Blocked
Vex & Ender Dragon	✅ Allowed	❌ Blocked

✨ Key Features

• Column-Based Protection: Build permissions apply to the entire vertical column above the block, faithfully matching Bedrock Edition mechanics.
• Whole-Column Barrier: Border walls span from world bottom (Y=-64) to world ceiling (Y=320).
• Flexible Permission Hierarchy:
  • Global whitelist (/allowdeny whitelist ...)
  • Per-block NBT whitelist (attached directly to item/block entities)
  • Operator bypass (OP level 2, optionally requiring Creative mode)
• Visual Cues: Optional subtle red particles render when players approach invisible border walls.
• Host-to-Client Live Sync: Config and whitelist updates by the host instantly replicate to all LAN peers.
• In-Game GUI Support: Direct configuration via the Mods menu when Mod Menu & Cloth Config are installed.

⚙️ Configuration & Commands

Graphical Interface

Open Mods Menu → Select Bedrock Allow Deny Border → Click Config.

In-Game Commands (OP Level 2)

# Switch border barrier behavior mode
/allowdeny config borderMode bedrock_like
/allowdeny config borderMode block_all_entities

# Toggle operator bypass and creative requirements
/allowdeny config opBypass <true|false>
/allowdeny config requireCreative <true|false>

Toggle boundary particle indicator

/allowdeny config showBorderEffect <true|false>

Manage global whitelist

/allowdeny whitelist add /allowdeny whitelist remove /allowdeny whitelist list /allowdeny whitelist clear

Query current position rules or reload configuration

/allowdeny query /allowdeny reload

### 📦 Requirements

| Component | Required Version |
| :--- | :--- |
| **Minecraft** | Java Edition 1.21 |
| **Fabric Loader** | ≥ 0.19.4 |
| **Fabric API** | Any compatible 1.21 build |
| **Mod Menu** *(Optional)* | 11.x (for in-game config button) |
| **Cloth Config** *(Optional)* | 15.x (for in-game config GUI) |

### 🔨 Building from Source

Requires **JDK 21+**:

```bash
git clone https://github.com/zihan-ds/minecraft-bedrock-adb.git
cd minecraft-bedrock-adb
./gradlew build

---

中文说明

Bedrock Allow Deny Border 是一款专为 Minecraft Java 版 1.21 打造的 Fabric 客户端模组。它完美还原了基岩版 / 教育版中的允许方块 (Allow)、拒绝方块 (Deny) 与边界方块 (Border)，专为单人冒险地图制作与局域网联机合作设计。

所有规则由各客户端一致判定，房主修改的配置与白名单会自动实时同步给局域网内的所有玩家。

注意：在局域网联机世界中，所有加入的玩家都需要安装相同版本的模组，以确保权限与空气墙阻挡规则在各客户端表现完全一致。

🧱 新增方块与作用

在创造模式独立标签页中新增了三种“教师方块”风格的实用功能方块：

方块	功能与核心机制
允许方块 (Allow Block)	将其所在垂直列标记为允许建造（即使处于被拒绝的区域内也可生效）。
拒绝方块 (Deny Block)	禁止在其整列范围内放置与破坏方块（位置下方最近的规则生效；堆叠时位置最高的方块优先）。
边界方块 (Border Block)	在该坐标生成一道贯穿整列全高度 (所有 Y 轴) 的隐形阻挡墙——无法通过搭高翻越、飞行越过或向下挖掘绕过。

所有实用方块均具备极高的抗爆性能，无法被活塞推动，防止被恶意破坏。

🛡️ 边界阻挡通行矩阵

边界方块提供两种不同的运作模式，可在游戏内随时切换：

实体类型	仿基岩版模式 (默认)	拦截所有实体模式
无特权玩家 & 敌对生物	❌ 拦截阻挡	❌ 拦截阻挡
特权玩家 (白名单 / OP + 创造模式)	✅ 正常通行	✅ 正常通行
旁观模式玩家	✅ 正常通行	✅ 正常通行
弹射物 (箭矢、末影珍珠、恶魂火球等)	✅ 正常穿过	❌ 拦截阻挡
恼鬼 (Vex) & 末影龙	✅ 正常穿过	❌ 拦截阻挡

✨ 核心特性

• 整列保护机制：破坏与建造权限作用于方块上方的整条垂直列，完全还原基岩版原生机制。
• 全高度绝对屏障：边界墙从世界最底层（Y = -64）一直延伸至世界顶层（Y = 320）。
• 灵活的权限体系：
  • 全局白名单（通过 /allowdeny whitelist ... 管理）
  • 方块级 NBT 白名单（直接存储在物品/方块实体中）
  • 管理员特权绕过（OP 权限等级 2，可选是否强制要求创造模式）
• 视觉粒子提示：当玩家靠近隐形边界墙时，会产生微弱的红色粒子效果以作提示（可配置开关）。
• 局域网实时同步：房主对配置与白名单的任何改动，均会秒级同步给局域网内的其他客户端。
• 游戏内图形化配置：安装 Mod Menu 与 Cloth Config 后，可直接在 Mods 界面呼出配置面板。

⚙️ 配置与指令速查

图形化配置界面

进入游戏主菜单或暂停菜单 → Mods (模组) → 选择 Bedrock Allow Deny Border → 点击 Config (配置)。

游戏内指令 (需 OP 等级 2)

# 切换边界墙行为模式（仿基岩版 / 拦截所有实体）
/allowdeny config borderMode bedrock_like
/allowdeny config borderMode block_all_entities

# 设置管理员绕过权限及是否强制创造模式
/allowdeny config opBypass <true|false>
/allowdeny config requireCreative <true|false>

# 开关边界隐形墙红色粒子提示效果
/allowdeny config showBorderEffect <true|false>

# 白名单管理（添加/移除/查看列表/清空）
/allowdeny whitelist add <玩家名>
/allowdeny whitelist remove <玩家名>
/allowdeny whitelist list
/allowdeny whitelist clear

# 查询当前站立位置生效的规则 / 重载配置文件
/allowdeny query
/allowdeny reload

📦 环境依赖

组件	要求版本
Minecraft	Java Edition 1.21
Fabric Loader	≥ 0.19.4
Fabric API	适配 1.21 的任意正式构建版本
Mod Menu (选装)	11.x (用于在模组列表显示配置按钮)
Cloth Config (选装)	15.x (用于提供游戏内图形化配置弹窗)

🔨 源码构建指南

构建需要安装 JDK 21+ 环境：

git clone https://github.com/zihan-ds/minecraft-bedrock-adb.git
cd minecraft-bedrock-adb
./gradlew build

---

📄 License & Credits / 开源许可

• License: MIT License
• Author: Developed and maintained by zihan_ds.
• Repository: zihan-ds/minecraft-bedrock-adb