剑视

剑视

剑视使武器无视草丛、高草丛等！

装备

剑视预览查看大图

⚔️ SwordSight：服务端权威的穿透杂物命中

SwordSight 是一个旨在增强战斗体验的模组，它能防止高草、花朵以及其他非固体杂物阻挡你武器的视线，让你能够无缝地击中它们后面的敌人。

除了原有的服务端权威配置系统之外，SwordSight 现在还附带了完整的游戏内配置菜单——一个类似 JEI/REI 的双列表选择器，让你精确选择哪些方块被忽略，并对生长阶段的作物做了专门处理，这样你就可以决定完全长成的植物是否仍能用武器收割。

📧 联系我与支持信息

💬 主要支持渠道（首选）

所有一般性问题、功能请求和非紧急错误报告都应发布到我们 Discord 服务器的相应频道中。 我们会积极关注服务器，并尽快回复。这能确保整个社区都能从讨论和解决方案中受益。

🆘 紧急私信（PM）政策

尽管我们更希望所有问题都先通过 Discord 服务器处理，但在特定的紧急情况下，欢迎你直接私信我：

  • 允许的理由： 你的服务器崩溃了，或遇到了与我某个模组/插件直接相关的严重、破坏游戏的错误。
  • 要求： 你必须是服务器的所有者。
  • 时区： 我所在的时区是 (CET/CEST)。
  • 私信时间： 请仅在**上午 10:00 至晚上 10:00（布鲁塞尔时间）**之间发送私信。

我会尽快回复你的私信，尽我所能帮助你解决紧急问题。但请理解，我无法保证立即回复，私信是一种职业礼节，而非你的权利。 感谢你的理解与配合！

🎯 功能特性

🖱️ 游戏内配置菜单（按键：M）

按下 M（默认按键，可在控制中完全重新绑定）或运行 /swordsight//swords 即可直接打开 SwordSight 的配置菜单——不再需要聊天命令来查看当前启用了什么。

  • 双列表选择器：左侧是已启用列表（当前忽略的方块），右侧是所有方块列表（其他所有你可以启用的方块），就像 JEI/REI 物品浏览器一样。点击任意一侧的条目即可将其移动到另一侧。
  • 智能排序：已启用列表遵循精心策划的、对农业友好的顺序——草类（矮草、高草、枯草、海草）→ 其他绿色植物 → 花朵（先矮后高）→ 树苗 → 珊瑚扇 → 珊瑚 → 其余内容按原版创造模式物品栏的相同顺序排列。所有方块列表会优先展示植物类方块（包括模组植物），将原木和其他固体方块排在后面。
  • 两种编辑配置：我的设置始终由你编辑，属于个人配置，独立于任何服务器。编辑：服务器仅在单人游戏中可用，或在多人游戏中拥有真正的服务器验证权限的玩家可用——按钮始终可见，但没有正确的权限就无法切换模式。服务器编辑模式会将列表染成黄色，让你始终知道自己正在编辑哪个配置。
  • 生长阶段作物，妥善处理：小麦、胡萝卜、马铃薯、甜菜根、可可豆、下界疣、火把花、瓶子草和甜浆果灌木各自都有两个专门的条目——倒数第二阶段和完全长成——使用它们在游戏中的真实生长纹理渲染，而不是通用的种子图标。切换它们可以精确控制每种作物的行为：
    • 倒数第二阶段启用：你的武器会穿过所有更早的生长阶段，但完全长成的植物仍会阻挡命中——因此它仍然可以收割。
    • 完全长成阶段也启用：该植物在所有阶段都受到保护，包括完全长成之后。
  • 整洁的图标：纹理缺失或损坏的条目会被自动过滤掉，非原版/自定义头颅方块会被排除，成对的方块（如火把/墙上的火把，或生物头颅及其墙上的变体）会合并为一个条目，这样你就不会看到重复项。
  • 重置我的列表可随时将你的个人配置恢复为出厂默认值。

🌐 服务端权威配置

  • 多人游戏一致性：当安装在专用服务器上时，服务器自己的方块列表就是可用内容的唯一事实来源——普通玩家只能看到和使用服务器当前允许的方块，从而确保每位玩家的体验都与服务器意图保持一致。
  • 你的设置，由服务器许可：你自己的启用/停用选择始终属于你——服务器不会覆盖你的个人选择。相反，它定义了可能性的边界：任何超出服务器允许列表的内容，无论你自己的偏好如何，都不会生效或出现。
  • 服务器管理员：拥有服务器权限的玩家可以在菜单中切换到编辑：服务器（或使用等效的聊天命令）来更改服务器上每位玩家都必须遵守的列表。
  • 原版服务器回退：连接到未安装 SwordSight 的服务器时，会自动回退到内置的、精心策划的“安全”方块列表，因此基本的穿透命中功能无需任何服务器端设置即可立即使用。
  • 单人游戏：作为完全本地、自包含的模组运行——你的个人设置就是一切，无需担心服务器边界。

📝 默认忽略的方块

出厂默认配置包含了一份全面的非固体植物和杂物方块列表，涵盖草类、作物、花朵、藤蔓、珊瑚等。

📦 默认方块列表
// --- GRASSES, FERNS, BUSHES ---
"minecraft:short_grass",
"minecraft:tall_grass",
"minecraft:dead_bush",
"minecraft:fern",
"minecraft:large_fern",
"minecraft:short_dry_grass",
"minecraft:tall_dry_grass",
"minecraft:bush",
"minecraft:firefly_bush",

// --- CROPS & GROWABLES (with dedicated growth-stage handling — see In-Game Configuration Menu) ---
"minecraft:sugar_cane",
"minecraft:wheat",
"minecraft:carrots",
"minecraft:potatoes",
"minecraft:beetroots",
"minecraft:cocoa",
"minecraft:nether_wart",
"minecraft:torchflower_crop",
"minecraft:pitcher_crop",
"minecraft:sweet_berry_bush",
"minecraft:bamboo",
"minecraft:bamboo_sapling",
"minecraft:cactus",
"minecraft:cactus_flower",

// --- FLOWERS (Short & Tall) ---
"minecraft:poppy",
"minecraft:dandelion",
"minecraft:allium",
"minecraft:azure_bluet",
"minecraft:red_tulip",
"minecraft:orange_tulip",
"minecraft:white_tulip",
"minecraft:pink_tulip",
"minecraft:oxeye_daisy",
"minecraft:cornflower",
"minecraft:lily_of_the_valley",
"minecraft:wither_rose",
"minecraft:blue_orchid",
"minecraft:torchflower",
"minecraft:sunflower",
"minecraft:lilac",
"minecraft:rose_bush",
"minecraft:peony",
"minecraft:pink_petals",
"minecraft:wildflowers",

// --- VINES, ROOTS, FOLIAGE ---
"minecraft:vine",
"minecraft:twisting_vines",
"minecraft:twisting_vines_plant",
"minecraft:weeping_vines",
"minecraft:weeping_vines_plant",
"minecraft:cave_vines",
"minecraft:cave_vines_plant",
"minecraft:hanging_roots",
"minecraft:glow_lichen",
"minecraft:mangrove_propagule",
"minecraft:mushroom_stem",
"minecraft:crimson_roots",
"minecraft:warped_roots",
"minecraft:azalea",
"minecraft:flowering_azalea",
"minecraft:small_dripleaf",
"minecraft:big_dripleaf", // its stem segment always follows automatically
"minecraft:pitcher_plant",

// --- WATER PLANTS/CORALS ---
"minecraft:seagrass",
"minecraft:tall_seagrass",
"minecraft:kelp",
"minecraft:kelp_plant",
"minecraft:lily_pad",
"minecraft:tube_coral",
"minecraft:brain_coral",
"minecraft:bubble_coral",
"minecraft:fire_coral",
"minecraft:horn_coral",
"minecraft:tube_coral_fan",
"minecraft:brain_coral_fan",
"minecraft:bubble_coral_fan",
"minecraft:fire_coral_fan",
"minecraft:horn_coral_fan",
"minecraft:sea_pickle",
"minecraft:moss_carpet",
"minecraft:pale_moss_carpet"

绕过遮挡视线的方块

  • 射线检测覆盖：模组会拦截游戏的射线检测检查，并强制将当前配置中定义的非固体杂物方块返回为空白碰撞箱，从而让你武器的视线能够穿过它们。
  • 性能缓存：一个内部缓存将忽略的方块解析为 Block 对象，确保游戏过程中查找速度很快，没有每次命中的性能开销。

可配置的武器适用性

穿透命中功能严格受武器类型控制：

  • 自动适用：对剑（通过 #minecraft:swords 物品标签）、三叉戟和重锤自动生效。
  • 斧支持（可切换）：可在游戏内菜单中或通过 /swordsight axe 和 /swordsight axe enchant 在禁用 → 仅附魔 → 始终启用之间循环切换斧的行为。
    • 仅附魔要求斧携带战斗附魔（锋利、亡灵杀手、节肢杀手或火焰附加）后，穿透命中才会生效。

⚙️ 游戏内命令

命令可通过 /swordsight 或其别名 /swords 访问，现在除了常规的聊天输出外，还会直接打开游戏内配置菜单。

命令 描述 上下文
/swordsight 显示命令列表和链接，并打开配置菜单。 所有上下文
/swordsight reload 从磁盘重新加载配置并更新方块缓存。 单人游戏 / 服务器管理员
/swordsight list 显示所有当前忽略的方块。 所有上下文
/swordsight list <item_id> 在忽略列表中切换某个物品/方块。 单人游戏 / 服务器管理员
/swordsight axe 在禁用 / 仅附魔 / 始终启用之间循环切换斧的穿透命中。 单人游戏 / 服务器管理员
/swordsight axe enchant 切换斧的附魔要求。 单人游戏 / 服务器管理员

在多人游戏中，没有服务器权限的玩家仍然可以查看当前配置，并通过游戏内菜单自由管理自己的个人配置——只有修改服务器的共享列表才需要管理员权限。

整合包政策

  • 你被允许将此模组包含在任何整合包中。
  • 请勿直接修改模组的 JAR 文件。
  • 整合包本身，或整合包内对此模组的访问，不得用于销售。