Chiseled Bookshelf Searcher

Chiseled Bookshelf Searcher

—

### 📖 模组介绍

Chiseled Bookshelf Searcher 是一款轻量级的 Fabric 客户端模组，适用于 Minecraft 1.20 及更高版本。它解决了摆放大量雕纹书架后，难以快速找到特定书籍的问题。只需按下快捷键并输入关键词，模组就会自动扫描附近所有雕纹书架，并通过醒目的视觉效果指引你找到目标书籍的位置。

无论是附魔书、成书，还是书与笔，无论你用中文搜索，还是输入拼音首字母，它都能轻松应对。告别逐个翻找书架的麻烦，让书籍管理变得高效又轻松。

—

### ✨ 核心功能

**智能搜索系统**

按下默认快捷键 Z，即可打开简洁的搜索界面。输入书名、附魔名称或其拼音首字母，搜索结果便会实时显示匹配的书籍，以及书架的世界坐标和相对距离。搜索支持模糊匹配——输入“保护”、“baohu”，甚至“bh”，都能找到“保护 IV”附魔书。如果有多本同名书籍，结果会列出所有对应的书架位置，并按距离由近到远排序。

**视觉指引效果**

点击搜索结果后，游戏会立即触发两种视觉指引效果。目标雕纹书架会被半透明的蓝色光幕包围，周围还会出现醒目的蓝色高亮线框；即使书架被其他方块完全挡住，也依然清晰可见。屏幕顶部还会显示当前追踪的书名和目标坐标。走到书架附近后，所有效果都会自动消失。

**自动缓存机制**

模组会在后台自动扫描玩家周围已加载区块中的所有雕纹书架，并将书籍信息持续保存到本地配置文件中。即使退出并重新启动游戏，以前的扫描记录也不会丢失。放入或取出书籍时，缓存会实时更新，确保搜索结果准确。扫描过程在后台高效运行，对游戏性能的影响微乎其微。

**完全在客户端运行**

此模组完全在客户端运行，无需安装到服务器上。即使在多人服务器中游玩，也能正常使用所有功能。不过请注意，在服务器上，由于客户端无法直接读取服务端的书架数据，模组会自动切换到仅适用于单人游戏的数据获取方式。若要获得完整体验，建议在单人世界或局域网游戏中使用此模组。

—

### 🎮 使用方法

在游戏中摆放任意数量的雕纹书架，并放入书籍。按下 Z 键打开搜索界面，在输入框中输入你记得的书名或附魔名称（支持拼音和拼音首字母）。搜索结果会显示每本书的名称、维度中文名、精确坐标，以及与玩家之间的距离。

点击任意一条搜索结果，游戏便会自动为你指引对应的书架。沿着紫色导航线和蓝色高亮框前进，就能轻松找到目标。走到书架约 1.5 格范围内后，指引效果会自动消失。你也可以随时按 ESC 取消指引，或点击新的搜索结果切换目标。

—

### ⚙️ 配置与自定义

快捷键可在游戏设置中的“控制”→“雕纹书架搜索器”分类下自由修改。缓存文件位于游戏目录中的 `config/bookshelf_searcher_cache.json`，可手动删除以清除缓存。模组语言跟随游戏语言设置，目前支持简体中文和英文。

—

### 📦 安装要求

需要 Minecraft 1.20 或更高版本、Fabric Loader 0.14.21 或更高版本，以及 Fabric API。该模组不需要其他前置或依赖。只需将模组文件放入 `.minecraft/mods/` 文件夹即可使用。

—

### 💡 注意事项

搜索范围为以玩家为中心、半径 5 个区块（约 80 格）内的已加载区域。超出范围的书架不会被扫描。在服务器上游玩时，请确保目标书架所在区块已加载；否则，引导会自动取消并提示“目标区块未加载”。引导特效仅你自己可见，其他玩家无法看到。同一时间只能有一个激活的引导目标；点击新的搜索结果会自动替换之前的目标。

简体中文：

 Chiseled Bookshelf Searcher – 雕纹书架搜索器

### 📖 模组简介

Chiseled Bookshelf Searcher 是一款轻量级的 Fabric 客户端模组，专为 Minecraft 1.20+设计。它解决了雕纹书架（Chiseled Bookshelf）数量增多后难以快速找到特定书本的痛点。只需按下快捷键，输入关键词，模组便会自动扫描周围所有雕纹书架，并以绚丽的视觉特效引导你直达目标书本所在的位置。

无论是附魔书、成书还是书与笔，无论是中文搜索还是拼音首字母搜索，都能轻松应对。从此告别逐个翻找书架的烦恼，让书本管理变得高效而优雅。

—

### ✨ 核心功能

**智能搜索系统**

按下默认快捷键 Z 键即可打开简洁的搜索界面。输入书本名称、附魔名称或它们的拼音首字母，搜索结果会实时显示匹配的书本及其所在书架的世界坐标和相对距离。搜索支持模糊匹配，输入”保护”或”baohu”甚至”bh”都能找到”保护 IV”附魔书。同名书本会列出所有匹配的书架位置，并按距离由近到远排序。

**视觉引导特效**

点击搜索结果后，游戏内会立刻触发两种视觉引导效果。目标雕纹书架将被蓝色半透明光幕包裹，同时环绕着明亮的蓝色高亮线框，即使书架被其他方块完全遮挡也能清晰透视可见。屏幕上方还会显示当前追踪的书名和目标坐标，走到书架附近后所有特效自动消失。

**自动缓存机制**

模组会在后台自动扫描玩家周围已加载区块内的所有雕纹书架，并将书本信息持久化保存到本地配置文件。即使退出游戏重新进入，之前的扫描记录也不会丢失。每次放入或取出书本时缓存会实时更新，确保搜索结果的准确性。扫描过程在后台高效运行，对游戏性能的影响几乎可以忽略不计。

**完全客户端运行**

本模组完全在客户端运行，无需在服务端安装。即使是在多人服务器上游玩，你仍然可以正常使用所有功能。不过需要注意的是，在服务器上由于客户端无法直接获取服务端的书架数据，模组会自动切换为仅限单人游戏使用的数据获取方式。建议在单人世界或局域网联机中使用以获得完整体验。

—

### 🎮 使用方法

在游戏中放置任意数量的雕纹书架并放入书本。按下 Z 键打开搜索界面，在输入框中输入你记得的书名或附魔名（支持拼音和拼音首字母）。搜索结果会显示每本书的名称、所在维度的中文名、精确坐标以及与你的距离。

点击任意搜索结果，游戏便会自动引导你前往该书架。跟随紫色导航线和蓝色高亮框即可轻松定位。走近书架约 1.5 格范围内后，引导特效自动消失。你也可以随时按 ESC 取消引导，或点击新的搜索结果切换目标。

—

### ⚙️ 配置与自定义

快捷键可在游戏设置中的”按键设置”→”雕纹书架搜索器”分类下自由修改。缓存文件位于游戏目录的 `config/bookshelf_searcher_cache.json`，可手动删除以清空缓存。模组语言跟随游戏语言设置，目前支持简体中文和英文。

—

### 📦 安装要求

Minecraft 版本需为 1.20+，需安装 Fabric Loader 0.14.21 及以上版本，以及 Fabric API。模组无需任何其他前置或依赖。直接将模组文件放入 `.minecraft/mods/` 文件夹即可使用。

—

### 💡 注意事项

搜索范围是以玩家为中心半径 5 个区块（约 80 格）内的已加载区域，超出范围的书架不会被扫描到。在服务器上游玩时，请确保目标书架所在区块已加载，否则引导会自动取消并提示”目标区块未加载”。引导特效仅自己可见，其他玩家无法看到。同一时间只能有一个激活的引导目标，点击新的结果会自动覆盖旧的。