# Shoulder Surfing: Iron’s Spells Integration<\/p>\n
A simple client-side mod that integrates Shoulder Surfing Reloaded
\nand Iron’s Spells ‘n Spellbooks, making the camera automatically
\nfollow your crosshair whenever you cast a spell\u2014via spellbooks, normal spells, or quick cast. Compatible with controller
\nmods.<\/p>\n
[\/\/]: # (Hosted in: https:\/\/github.com\/EchoEllet\/shoulder-surfing-iron-spells-integration\/discussions\/1)
\n<\/p>\n
<\/p>\n
## Compatibility<\/p>\n
Tested with the following mods and works as expected:<\/p>\n
* Epic Fight
\n* Controlify
\n* Controllable<\/p>\n
## Bug reports<\/p>\n
This isn’t an official Shoulder Surfing Reloaded addon, so any issues should be reported
\nto this mod issue tracker
\nrather than to the Shoulder Surfing Reloaded team.<\/p>\n
## Technical Implementation<\/p>\n
**This mod fixes issues you may encounter when using the Shoulder Surfing Perspective.**
\nThe fixes are universal and apply **regardless of whether the camera is decoupled or not**.<\/p>\n
Here are the issues that this mod fix:<\/p>\n
### Continuous Spell Casting<\/p>\n
This mod uses the `IAdaptiveItemCallback`
\ncallback provided by the Shoulder Surfing Reloaded mod so that it **identifies as if we’re aiming at the crosshair target**,
\nensuring the **player looks at the crosshair target** regardless of the spell cast source (e.g., spell book, scroll item)
\nand whether the camera is decoupled or not.<\/p>\n
This fix is effective even when the camera is coupled, because without it, casting a continuous spell in Shoulder Surfing
\ncauses the player to look straight ahead instead of at the crosshair.<\/p>\n
### Look at Crosshair Target When Casting via Spell Book<\/p>\n
When casting a spell using a scroll item by right-clicking with the mouse, the Shoulder Surfing mod will automatically
\nlook at the crosshair target **if the camera is decoupled**.
\nThis is not the case when casting spells via spell books, which is a common method.<\/p>\n
Mixins into the constructors of
\n`CastPacket`
\nand
\n`QuickCastPacket`,
\nsince these are only constructed from the client side and only when the player is casting a spell from a keybind. This
\nensures that the mod stays compatible with any controller mod and remains client-side without sending packets to the
\nnetwork.<\/p>\n
The official API provided by the Iron Spells mod is
\ncurrently a bit limited, and all events are called on the server side only. This makes it difficult to keep this mod
\nclient-side only while still supporting controller mods and avoiding dependency on their internal APIs.<\/p>\n
### Always Look at Crosshair Target When Using a Scroll Item<\/p>\n
We call `ShoulderSurfingImpl.lookAtCrosshairTarget` before
\n`Scroll.use`
\nis called to fix two issues:<\/p>\n
* The Shoulder Surfing mod automatically calls
\n `ShoulderSurfingImpl.lookAtCrosshairTarget`
\n when you use any item **if the camera is decoupled**. However, when using a scroll item via controller,
\n Shoulder Surfing does not recognize it.
\n* This fix is useful **even if you don’t use a controller**, because when the camera is coupled,
\n`ShoulderSurfingImpl.lookAtCrosshairTarget` is not called automatically. Without this fix,
\nspells will be cast straight ahead of the player instead of aiming at the crosshair target.<\/p>\n
The player will **always** look at the crosshair target, **regardless of whether the camera is coupled or decoupled**,
\nand regardless of the input method\u2014controller or keyboard.<\/p>\n
## Disclaimer<\/p>\n
> **This mod is NOT AN OFFICIAL MINECRAFT PRODUCT.
\n> It is NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.**
\n>
\n> **This mod is not affiliated with the Shoulder Surfing Reloaded Team
\nor Iron’s Spells ‘n Spellbooks.**<\/p>\n
## License<\/p>\n
MIT<\/p>\n
You can also find the source code on GitHub.<\/p>\n","protected":false},"excerpt":{"rendered":"
A simple client-side mod that integrates Shoulder Surfing Reloaded and Iron’s Spells ‘n Spellbooks, making the camera automatically follow your crosshair whenever you cast a spell\u2014via spellbooks, normal spells, or quick cast.<\/p>\n","protected":false},"featured_media":138955,"template":"","meta":{"_minecraft_slug":"shoulder-surfing-iron-spells-integration","_minecraft_project_id":"d6lYuivc","_minecraft_author":"Ellet","_minecraft_license":"MIT","_minecraft_downloads":10110,"_minecraft_follows":21,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"shoulder-surfing-iron-spells-integration.zip","_minecraft_size_bytes":18844696,"_minecraft_version_count":20,"_minecraft_updated_at":"2026-05-16T05:55:20.831483Z","_minecraft_date_created":"2025-10-16T02:39:22.391721Z","_minecraft_date_modified":"2026-01-07T23:15:58.354337Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/shoulder-surfing-iron-spells-integration","_minecraft_icon_attachment_id":138955,"_minecraft_imported_at":"2026-06-08T05:29:55+00:00","_minecraft_import_hash":"6714669c3439d8a042da630f38183bf9","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104,89,122,158,90,92],"mod_loader":[106,160],"minecraft_version":[36,37],"class_list":["post-138954","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_category-game-mechanics","mod_category-magic","mod_category-neoforge","mod_category-optimization","mod_category-utility","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-20-1","minecraft_version-1-21-1"],"yoast_head":"\n