SwordSight

Minecraft 版本： 26.2

平台： fabric

标签： equipment game-mechanics mobs

⚔️ SwordSight: Server-Authoritative Hit Through the Clutter

SwordSight is a mod designed to enhance combat by preventing blocks like tall grass, flowers, and other non-solid clutter from blocking your weapon's line of sight, allowing you to hit enemies and blocks behind them seamlessly.

This version introduces server-side configuration, ensuring that in multiplayer, the rules for which blocks are ignored are consistent and controlled by the server, while retaining the familiar functionality in single-player.

---

? Contact Me & Support Information ### ? Primary Support Channel (Preferred) **All general questions, feature requests, and non-urgent bug reports should be posted in the appropriate channels on our [Discord Server](https://discord.gg/48sZCbdHzJ).** We actively monitor the server and will respond as soon as possible. This ensures that the whole community can benefit from the discussion and solutions. ### ? Urgent Private Messaging (PM) Policy While we prefer all issues to be handled via the Discord server first, you are welcome to PM me directly under **specific urgent circumstances**: * **Allowed Reason:** Your server is **crashing** or experiencing **critical, game-breaking errors** directly related to one of my mods/plugins. * **Requirement:** You must be the **owner** of the server. * **Time Zone:** I am operating in the **(CET/CEST) Time Zone**. * **PM Hours:** Please only send private messages between **10:00 AM and 10:00 PM (Brussels Time)**. I will endeavor to answer your PM as soon as I can to be helpful and see what I can do to resolve your urgent issue. However, please understand that immediate responses are not guaranteed, and **private messaging is a professional courtesy, not an entitlement.** Thank you for your understanding and cooperation!

? Features

? Default Ignored Blocks

The default configuration file (swordsight.json) includes a comprehensive list of non-solid plant and clutter blocks.

ℹ️ This list is hardcoded in SwordsightConfig.java to ensure clients playing on servers without the mod still benefit from the expected features (Vanilla Server Fallback).

? Hardcoded Block List { // --- 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 --- "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", "minecraft:big_dripleaf_stem", "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" }

Server-Authoritative Configuration ?

• Multiplayer Consistency: When installed on a dedicated server, the configuration (ignored blocks and Axe settings) is managed server-side. Client-side commands are disabled in multiplayer and config changes must be done by a server operator.
• Single-Player (Integrated Server): In single-player worlds, the mod functions as a client-side mod, allowing the local commands to modify the local config file as expected.
• Vanilla Server Fallback: If the mod is installed on the client but not on the server, the client automatically falls back to a hardcoded default block list to ensure basic hit-through functionality works immediately.

Bypass Vision-Obscuring Blocks

• Raycast Override: The mod intercepts the game's raycast check and forces non-solid clutter blocks defined in the config/cache to return an empty hitbox (VoxelShapes.empty()), allowing the weapon's line-of-sight to pass through them.
• Performance Cache: The mod maintains an internal cache of ignored blocks as actual Block objects (IGNORED_BLOCK_CACHE) for quick lookup during gameplay, avoiding performance bottlenecks.

Configurable Weapon Eligibility

The hit-through functionality is strictly controlled by weapon type:

• Automatic Eligibility: Works automatically with Swords (checked via the #minecraft:swords item tag), Trident, and Mace.
• Axe Support (Toggleable): Axe functionality is toggled on/off via configuration (/swordsight axe).
  • Enchant Requirement: Optionally requires the Axe to have a combat enchantment (Sharpness, Smite, Bane of Arthropods, or Fire Aspect) to enable the hit-through feature (/swordsight axe enchant).

---

⚙️ In-Game Commands

Commands are registered client-side for suggestions and execution. In multiplayer, commands only display local config status and warnings; all modifications occur server-side.

Commands are accessible using either /swordsight or the alias /swords.

Command	Description	Context
/swordsight	Displays the command list and links.	Client-side info
/swordsight reload	Reloads the config from disk and updates the block cache.	Single-player only.
/swordsight list	Shows all currently ignored blocks (using the active cache).	Client/Server-synced list
/swordsight list <item_id>	Toggles an item/block in the ignored list.	Single-player only.
/swordsight axe	Toggles Axe Hit-Through functionality (Enabled/Disabled).	Single-player only.
/swordsight axe enchant	Toggles the enchantment requirement for axes (Required/Not Required).	Single-player only.

---

Modpack Policy

• You ARE PERMITTED to include this mod in any modpack.
• Please do not modify the mod's JAR file directly.
• The modpack itself, or access to this mod within the modpack, must not be sold.