Tooltip 搜索过滤器（Tooltip Filter）
基本信息
| 属性 | 值 |
|---|---|
| 类型 | 物品提示文本（tooltip）匹配过滤器 |
| 实现类 | net.moecraft.nechar.NecharTooltipFilter |
| 父类 | codechicken.nei.search.TooltipFilter |
| 构造方式 | NecharTooltipFilter::new（BiFunction<String, Pattern, ItemFilter> 方法引用） |
| 关联提供器 | tooltip（前缀 '#'，见 搜索提供者） |
字段
| 字段 | 类型 | 说明 |
|---|---|---|
searchText |
String |
构造器收到的原始搜索文本，供拼音/子串匹配使用 |
匹配逻辑（matches(ItemStack)）
整个判定只有一行，是"本模组拼音匹配 或 父类正则匹配"的短路结构：
return contain(getSearchTooltip(itemStack), searchText, enableVoltageSpecialSearchTooltips)
|| super.matches(itemStack);
| 步骤 | 文本来源 | 匹配调用 | 配置控制 |
|---|---|---|---|
| 1 | 父类的 getSearchTooltip(itemStack)——即物品提示文本 |
NecharUtils.contain(tooltip, searchText, enableVoltageSpecialSearchTooltips) |
enableVoltageSpecialSearchTooltips |
| 2 | 同一份提示文本 | super.matches(itemStack)（TooltipFilter 正则匹配） |
无 |
与 默认搜索过滤器 的差异：
| 对比项 | 默认搜索过滤器 | Tooltip 搜索过滤器 |
|---|---|---|
| 匹配对象 | 物品显示名（自定义名 → 默认名两级回退） | 物品提示文本（单次取值） |
| 前置处理 | 需 EnumChatFormatting.getTextWithoutFormattingCodes 去色 + 非空校验 |
无额外处理，直接交给匹配函数 |
| 父类回退 | PatternItemFilter |
TooltipFilter |
| 电压特殊搜索开关 | enableVoltageSpecialSearchName |
enableVoltageSpecialSearchTooltips |
相关条目
- 搜索提供者 - 本过滤器的注册位置与
#前缀 - NecharUtils.contain - 第 1 步调用的匹配函数
- 配置系统 -
enableVoltageSpecialSearchTooltips配置项 - 默认搜索过滤器 - 另一条搜索路径的过滤器