{"id":15014987,"url":"https://github.com/exopandora/shouldersurfing","last_synced_at":"2025-04-05T16:05:11.392Z","repository":{"id":44245450,"uuid":"61964757","full_name":"Exopandora/ShoulderSurfing","owner":"Exopandora","description":"Shoulder Surfing Reloaded is a highly configurable third person camera mod for minecraft.","archived":false,"fork":false,"pushed_at":"2025-04-05T15:51:02.000Z","size":3414,"stargazers_count":106,"open_issues_count":12,"forks_count":19,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-05T16:05:05.795Z","etag":null,"topics":["fabric","fabric-mod","forge","forge-mod","java","minecraft","minecraft-forge","minecraft-mod","neoforge","neoforge-mod","neoforged"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Exopandora.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-06-25T22:52:07.000Z","updated_at":"2025-04-05T15:41:18.000Z","dependencies_parsed_at":"2023-11-10T17:30:52.611Z","dependency_job_id":"250f35a1-46a1-4a7b-8fe1-0595f805b475","html_url":"https://github.com/Exopandora/ShoulderSurfing","commit_stats":{"total_commits":645,"total_committers":9,"mean_commits":71.66666666666667,"dds":0.5054263565891473,"last_synced_commit":"eebf5db867d039531a1f623c466f8542599cfa27"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exopandora%2FShoulderSurfing","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exopandora%2FShoulderSurfing/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exopandora%2FShoulderSurfing/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exopandora%2FShoulderSurfing/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Exopandora","download_url":"https://codeload.github.com/Exopandora/ShoulderSurfing/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247361617,"owners_count":20926642,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fabric","fabric-mod","forge","forge-mod","java","minecraft","minecraft-forge","minecraft-mod","neoforge","neoforge-mod","neoforged"],"created_at":"2024-09-24T19:46:21.717Z","updated_at":"2025-04-05T16:05:11.355Z","avatar_url":"https://github.com/Exopandora.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Shoulder Surfing Reloaded #\n[![CurseForge Downloads](https://img.shields.io/curseforge/dt/243190?style=flat-square\u0026logo=curseforge\u0026label=CurseForge\u0026color=%23F16436)](https://www.curseforge.com/minecraft/mc-mods/shoulder-surfing-reloaded) [![Modrinth Downloads](https://img.shields.io/modrinth/dt/kepjj2sy?style=flat-square\u0026logo=modrinth\u0026label=Modrinth\u0026color=%2300AF5C)](https://modrinth.com/mod/shoulder-surfing-reloaded) ![GitHub License](https://img.shields.io/github/license/Exopandora/ShoulderSurfing?style=flat-square\u0026label=License)\n\nShoulder Surfing Reloaded is a highly configurable third person camera mod for minecraft.\n\n# Features #\n* Over-the-shoulder camera - see what you are interacting with in 3rd person\n* Decoupled camera - walk left and right without turning your mouse\n* Free look (default: `left alt`) - keep walking in a direction while looking in a different one\n* Hotkeys to move the camera (default: `arrow keys`, `page up` and `page down`, `o` to switch shoulders)\n* Corrective cross-hair positioning when using adaptive or dynamic crosshair\n* Adaptive player transparency - fades the player model to transparent when view is obstructed\n* Highly configurable - customize your 3rd person experience with many configuration options\n* Client side only - no server mods required\n\nPlease note that this mod modifies the camera position and player movement, which can be an issue for servers with strict anti-cheat.\nUse at your own risk!\n\n# Installation #\nDownload Shoulder Surfing Reloaded from [CurseForge](https://www.curseforge.com/minecraft/mc-mods/shoulder-surfing-reloaded/files/) or [Modrinth](https://modrinth.com/mod/shoulder-surfing-reloaded) or [build from source](#building-from-source).\n\n## Forge ##\n### Prerequisites ###\n1. Make sure [Minecraft Forge](http://files.minecraftforge.net/) is installed\n2. Make sure Forge Config API Port ([CurseForge](https://www.curseforge.com/minecraft/mc-mods/forge-config-api-port-fabric), [Modrinth](https://modrinth.com/mod/forge-config-api-port)) is installed\n\n### Manual ###\n1. Navigate to `.minecraft/mods`\n2. Move `ShoulderSurfing-Forge-[VERSION].jar` into the folder\n3. Follow the steps below\n\n### Launcher Settings ###\n1. Select Forge as your profile\n2. Launch Minecraft\n3. Join a world or server\n4. Use `arrow keys`, `page up` and `page down` to adjust the perspective, `o` to switch shoulders\n\n## Fabric ##\n### Prerequisites ###\n1. Make sure [Fabric](https://fabricmc.net/) is installed\n2. Make sure Fabric API ([CurseForge](https://www.curseforge.com/minecraft/mc-mods/fabric-api), [Modrinth](https://modrinth.com/mod/fabric-api)) is installed\n3. Make sure Forge Config API Port ([CurseForge](https://www.curseforge.com/minecraft/mc-mods/forge-config-api-port-fabric), [Modrinth](https://modrinth.com/mod/forge-config-api-port)) is installed\n\n### Manual ###\n1. Navigate to `.minecraft/mods`\n2. Move `ShoulderSurfing-Fabric-[VERSION].jar` into the folder\n3. Follow the steps below\n\n### Launcher Settings ###\n1. Select Fabric as your profile\n2. Launch Minecraft\n3. Join a world or server\n4. Use `arrow keys`, `page up` and `page down` to adjust the perspective, `o` to switch shoulders\n\n## NeoForge ##\n### Prerequisites ###\n1. Make sure [NeoForge](https://neoforged.net/) is installed\n\n### Manual ###\n1. Navigate to `.minecraft/mods`\n2. Move `ShoulderSurfing-NeoForge-[VERSION].jar` into the folder\n3. Follow the steps below\n\n### Launcher Settings ###\n1. Select NeoForge as your profile\n2. Launch Minecraft\n3. Join a world or server\n4. Use `arrow keys`, `page up` and `page down` to adjust the perspective, `o` to switch shoulders\n\n# Configuration #\n### Version 3.0.0 and later ###\nManual: `.minecraft/config/shouldersurfing-client.toml`  \nIngame: Install Forge Config Screens ([CurseForge](https://www.curseforge.com/minecraft/mc-mods/config-menus-forge), [Modrinth](https://modrinth.com/mod/forge-config-screens))\n\n### Version 2.9.7 and older ###\n≥ 1.13: Manual: `.minecraft/config/shouldersurfing.toml`  \n≤ 1.12: Ingame: Mods → ShoulderSurfing → Config (Manual: `.minecraft/config/shouldersurfing.cfg`)\n\n# API Documentation #\nThe API Documentation can be found in the [wiki](https://github.com/Exopandora/ShoulderSurfing/wiki).\nIt currently allows other mod developers to define custom rules for when and what items should have adaptive crosshair functionality.\n\n# Building From Source #\nClone the repository and run the following command in the root directory of this repository:\n```bash\ngradlew build\n```\nThe binaries for each platform can be found in the following directories:\n\n| Platform | Path                                  |\n|----------|---------------------------------------|\n| Forge    | `ShoulderSurfing/forge/build/libs`    |\n| Fabric   | `ShoulderSurfing/fabric/build/libs`   |\n| NeoForge | `ShoulderSurfing/neoforge/build/libs` |\n\n# FAQ #\n**Q:** Why is the player not looking at the position of the crosshair when holding item x?  \n**A:** This needs to be configured using the config options `adaptive_crosshair_hold_items` or `adaptive_crosshair_use_items`.\n\n**Q:** Why is the player not render correctly when using shader pack x?  \n**A:** This is caused by player transparency effects of Shoulder Surfing Reloaded. Either disable them in the config (`adjust_player_transparency`) and restart your game or report this to the authors of the shader pack.\n\n**Q:** Can you port feature x to version y?  \n**A:** No.\n\n**Q:** Can you port this to quilt, liteloader, rift, etc.?  \n**A:** No.\n\n**Q:** Can I add this to my mod pack?  \n**A:** Yes.\n\n# Compatibility #\nShoulder Surfing Reloaded has builtin compatibility for the following mods (a-z):\n- 3D Skin Layers\n- Cobblemon\n- Create\n- Entity Model Features\n- Iris\n- Oculus\n- OptiFine\n- Sodium\n- TslatEntityStatus\n\nShoulder Surfing Reloaded is known to be incompatible with the following mods (a-z):\n- Better Third Person\n- Camera Utils\n- Nimble\n- Valkyrien Skies\n- YDM's Custom Camera View\n\nShoulder Surfing Reloaded is known to have minor incompatibility issues with the following mods (a-z):\n- Clutter (hats do not render transparent)\n- Epic Fight (player does not render transparent in battle mode, player keeps punching in the same direction)\n- EssentialClient (player look script hooks do not work)\n- Inmis (backpack does not render transparent)\n- MedievalWeapons (player is permanently in aiming mode)\n  - Workaround: Remove `minecraft:throwing` from `adaptive_crosshair_use_item_properties` in the config\n- MrCrayfish's Gun Mod (crosshair does not render when using ads, fov does not update when using ads)\n- Tweakeroo (freecam movement)\n- YDM's Weapon Master (weapons do not render transparent)\n\n# License #\nMIT License, Original project by Sabar: [Minecraft Forum](https://www.minecraftforum.net/forums/mapping-and-modding-java-edition/minecraft-mods/1287308-shoulder-surfing-modded-third-person-camera), [GitHub](https://github.com/sabarjp/ShoulderSurfing)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexopandora%2Fshouldersurfing","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexopandora%2Fshouldersurfing","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexopandora%2Fshouldersurfing/lists"}