BlockSeek
一款高度专业化、管理员锁定的数据包,用于逐区块的世界扫描及坐标自动记录。
概述
BlockSeek 是一款高级实用工具数据包,旨在自动化检测并提取指定矩形区域内的特定方块坐标。2.0.0 版本引入了彻底的架构重构,包括基于 UUID 的安全管理员系统、游戏内交互式 GUI 以及优化的区块处理机制。
通过利用 胡萝卜钓竿 进行区域选择,并使用 副手栏 指定目标,BlockSeek 会物理扫描区块列,通过临时标记注册发现的方块,将其替换为结构方块,并向聊天框和游戏日志广播其精确坐标。
⚠️ 关键安装前须知
破坏性扫描机制: BlockSeek 并非 被动观察者。为了注册坐标,算法会将发现的目标方块物理替换为 结构方块。
- 必须备份: 安装前严格建议创建世界文件夹的完整备份。高强度的处理、刻超时或扫描普遍存在的方块(如石头或泥土)可能导致严重的 TPS 下降、内存溢出或
level.dat 损坏。
- 建筑保护: 除非你准备好从备份中恢复,否则不要扫描构成你建筑结构核心的方块。
安装与初始化
- 将
BlockSeek 文件夹或 .zip 归档文件放入你的世界目录:.minecraft/saves/<World_Name>/datapacks/。
- 启动世界并执行
/reload。
- 管理员认领:
- 单人游戏: 首位加入世界的玩家将被自动分配
admin 标签并注册为所有者。
- 多人游戏: 服务器所有者必须手动分配
admin 标签或通过 blockseek:admin owner 存储配置所有者 UUID 以授予访问权限。
使用说明
第一阶段:准备与区域选择
- 通过交互数据包(或使用提供的命令)打开 GUI,点击 [Get Tool] 获取自定义 胡萝卜钓竿。
- 站在预期扫描区域的 西北角(左上角)。
- 右键点击该工具以设置 Pos1。
- 移动到 东南角(右下角)。确保 X 和 Z 坐标严格大于 Pos1。
- 右键点击以设置 Pos2。
(注意:Y 轴在选择期间被忽略;系统会自动扫描从 Y=-64 到 Y=319 的整个建筑限制高度)。
第二阶段:目标选择
将你希望定位的确切方块放入 副手栏。
警告:避免扫描普遍存在的方块(石头、深板岩、泥土)。同时生成数千个标记会导致服务器线程崩溃。
第三阶段:配置与执行
- 打开 GUI 以访问控制面板。
- 选择你偏好的 速度(每区块列延迟):
- 2t (0.1s): 最高速度。需要高端硬件。
- 5t (0.25s): 快速扫描。
- 10t (0.5s): 最佳 / 默认。
- 20t (1.0s): 低端系统的安全模式。
- 点击 [Start scan]。玩家将被切换到旁观者模式,并自动在选定的区块间传送。
- 若要提前中止,请在 GUI 中点击 [Stop] 或执行
/function blockseek:stop。
输出格式与数据解析
发现的方块会在聊天框中宣布,并在 latest.log 文件中以严格的、可解析的语法重复显示:
blocklocator [BlockSeek] Found: <X> .X <Y> .Y <Z> .Z command
- 手动提取: 使用文本编辑器搜索
blocklocator 关键字。
- 自动化: 使用我们仓库中提供的配套脚本解析日志文件并导出干净的坐标:
命令与 GUI 参考
| 操作 |
命令 / 触发方式 |
| 打开 GUI |
/trigger bs_ui set 9 |
| 获取工具 |
/trigger bs_ui set 1 |
| 紧急停止 |
/function blockseek:stop |
| 重置点位 |
/trigger bs_ui set 8 |
| 分配管理员角色(强制) |
/tag <username> add admin |
| 移除管理员角色(强制) |
/tag <username> remove admin |
| 强制禁用数据包 |
/datapack disable "file/BlockSeek" |
BlockSeek
A highly specialized, admin-secured datapack for chunk-by-chunk world scanning with automated coordinate logging.
Overview
BlockSeek is an advanced utility datapack designed to automate the detection and coordinate extraction of specific blocks within a defined rectangular area. Version 2.0.0 introduces a complete architectural overhaul, featuring a secure UUID-based admin system, an interactive in-game GUI, and optimized chunk-processing mechanics.
By utilizing a Carrot on a Stick for area selection and the offhand slot for target designation, BlockSeek physically scans chunk columns, registers discovered blocks via temporary markers, replaces them with Structure Blocks, and broadcasts their exact coordinates to the chat and game logs.
⚠️ CRITICAL PRE-INSTALLATION NOTICE
Destructive Scanning Mechanic: BlockSeek is not a passive observer. To register coordinates, the algorithm physically replaces the discovered target blocks with Structure Blocks.
- Backup Mandatory: It is strictly required to create a full backup of your world folder before installation. Intensive processing, tick timeouts, or scanning ubiquitous blocks (like stone or dirt) can lead to severe TPS drops, RAM overflow, or
level.dat corruption.
- Build Protection: Do not scan for blocks that are integral to your architectural builds unless you are prepared to restore them from a backup.
Installation & Initialization
- Place the
BlockSeek folder or .zip archive into your world's directory: .minecraft/saves/<World_Name>/datapacks/.
- Launch the world and execute
/reload.
- Admin Claiming:
- Singleplayer: The first player to join the world is automatically assigned the
admin tag and registered as the owner.
- Multiplayer: The server owner must manually assign the
admin tag or configure the owner UUID via the blockseek:admin owner storage to grant access.
Usage Instructions
Phase 1: Preparation & Area Selection
- Open the GUI by interacting with the datapack (or use the provided commands) and click [Get Tool] to receive the custom Carrot on a Stick.
- Stand in the North-Western (top-left) corner of your intended scanning area.
- Right-click with the tool to set Pos1.
- Move to the South-Eastern (bottom-right) corner. Ensure the X and Z coordinates are strictly greater than Pos1.
- Right-click to set Pos2.
(Note: The Y-axis is ignored during selection; the system automatically scans the full build limit from Y=-64 to Y=319).
Phase 2: Target Selection
Place the exact block you wish to locate into your offhand slot.
Warning: Avoid scanning ubiquitous blocks (stone, deepslate, dirt). Spawning thousands of markers simultaneously will crash the server thread.
Phase 3: Configuration & Execution
- Open the GUI to access the control panel.
- Select your preferred Speed (Delay per chunk column):
- 2t (0.1s): Maximum speed. Requires high-end hardware.
- 5t (0.25s): Fast scanning.
- 10t (0.5s): Optimal / Default.
- 20t (1.0s): Safe mode for lower-end systems.
- Click [Start scan]. The player will be shifted into Spectator mode and automatically teleported across the selected chunks.
- To abort prematurely, click [Stop] in the GUI or execute
/function blockseek:stop.
Output Format & Data Parsing
Discovered blocks are announced in the chat and duplicated in the latest.log file using a strict, parseable syntax:
blocklocator [BlockSeek] Found: <X> .X <Y> .Y <Z> .Z command
- Manual Extraction: Use a text editor to search for the
blocklocator keyword.
- Automation: Utilize the companion script available at our repository to parse the log file and export clean coordinates:
Commands & GUI Reference
| Action |
Command / Trigger |
| Open GUI |
/trigger bs_ui set 9 |
| Get Tool |
/trigger bs_ui set 1 |
| Emergency Stop |
/function blockseek:stop |
| Reset Points |
/trigger bs_ui set 8 |
| Assign Admin Role (Force) |
/tag <username> add admin |
| Remove Admin Role (Force) |
/tag <username> remove admin |
| Force Disable Datapack |
/datapack disable "file/BlockSeek" |
评论 0
登录后参与评分
还没有评论,来抢沙发吧