Bedrock Allow Deny Border

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 <player>
/allowdeny whitelist remove <player>
/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+:

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