⚔️ 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. 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.