Piston Scanner / 活塞扫描器

A lightweight client-side mod for redstone engineers. Press a key to instantly scan all pistons in loaded chunks, browse them by type, search with pinyin support, and click to highlight any piston through walls.

轻量级客户端模组，一键扫描加载区块内所有活塞，支持拼音搜索、分类筛选，点击即可透视高亮定位目标活塞。

Features / 功能

One-Key Scan / 一键扫描 Instantly scans all pistons (normal & sticky) in loaded chunks with optimized performance.

Smart Categories / 智能分类 Results grouped into 4 types: inactive/active × normal/sticky, with live count statistics.

Pinyin Search / 拼音搜索 Search by Chinese characters, full pinyin ("shitou"), initials ("st"), or English registry names — no input method switching needed.

Grouped Results / 分组浏览 Pistons are grouped by the block in front of them. Click to expand/collapse each group.

Click-to-Locate / 点击定位 Click any result to highlight the piston with a gold wireframe that glows through walls, with on-screen coordinates.

Smart Guidance / 智能引导 Highlight auto-clears when you approach within 3 blocks, or if the piston is destroyed/chunk unloads.

Area Selection / 区域选择 Press Z twice to define a cubic region; subsequent scans only search within that area. Green wireframe shows the selected region.

Usage / 使用方式

⚠️ X key conflicts with vanilla "Swap Items"! Please rebind in Controls → Key Binds. ⚠️ X键与原版"交换物品"冲突！请前往 设置→按键绑定 自行调整。

Install / 安装

1. Install Fabric Loader 0.14.21+
2. Install Fabric API
3. Drop this mod's jar into mods folder
4. Launch and press X (or your custom keybind)

Compatible with Minecraft 1.19.2 / 1.19.4 | Client-side only | Bilingual (ZH/EN)