{"id":14960883,"url":"https://github.com/nicoco007/beatsabercustomavatars","last_synced_at":"2025-05-16T12:08:42.313Z","repository":{"id":37444379,"uuid":"221314333","full_name":"nicoco007/BeatSaberCustomAvatars","owner":"nicoco007","description":"Beat Saber mod that allows the use of custom player avatars for in-game body presence.","archived":false,"fork":false,"pushed_at":"2025-04-07T16:22:40.000Z","size":22739,"stargazers_count":266,"open_issues_count":11,"forks_count":40,"subscribers_count":15,"default_branch":"main","last_synced_at":"2025-04-09T11:09:14.562Z","etag":null,"topics":["beatsaber","unity","unity-scripts"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nicoco007.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2019-11-12T21:20:51.000Z","updated_at":"2025-04-07T16:22:44.000Z","dependencies_parsed_at":"2024-01-17T13:06:59.295Z","dependency_job_id":"8a6b69c6-3e38-4856-8b6b-33d66bdd0f90","html_url":"https://github.com/nicoco007/BeatSaberCustomAvatars","commit_stats":{"total_commits":1219,"total_committers":16,"mean_commits":76.1875,"dds":"0.10582444626743237","last_synced_commit":"b4c19fc952720ff2486ec29262a3280d3239f2b1"},"previous_names":[],"tags_count":62,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicoco007%2FBeatSaberCustomAvatars","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicoco007%2FBeatSaberCustomAvatars/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicoco007%2FBeatSaberCustomAvatars/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicoco007%2FBeatSaberCustomAvatars/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicoco007","download_url":"https://codeload.github.com/nicoco007/BeatSaberCustomAvatars/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248027406,"owners_count":21035594,"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":["beatsaber","unity","unity-scripts"],"created_at":"2024-09-24T13:23:20.790Z","updated_at":"2025-04-09T11:09:28.326Z","avatar_url":"https://github.com/nicoco007.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Beat Saber Custom Avatars Plugin\n[![GitHub Actions Build Status](https://img.shields.io/github/actions/workflow/status/nicoco007/BeatSaberCustomAvatars/build.yml?branch=main\u0026style=flat-square)](https://github.com/nicoco007/BeatSaberCustomAvatars/actions?query=workflow%3Abuild+branch%3Amain)\n[![Latest Release](https://img.shields.io/github/v/release/nicoco007/BeatSaberCustomAvatars?style=flat-square)](https://github.com/nicoco007/BeatSaberCustomAvatars/releases/latest)\n[![License](https://img.shields.io/github/license/nicoco007/BeatSaberCustomAvatars?style=flat-square)](https://github.com/nicoco007/BeatSaberCustomAvatars/blob/master/LICENSE.txt)\n\n## Getting Started\nThe easiest way to get Custom Avatars up and running is to use [ModAssistant](https://github.com/Assistant/ModAssistant). The latest version of Custom Avatars will always be posted in the [releases](https://github.com/nicoco007/BeatSaberCustomAvatars/releases) here, and then become available on ModAssistant a few days later. If you want to install it manually by using the releases available here or are looking for the files to create an avatar yourself, you can follow the instructions below.\n\n### Full-Body Tracking\nFull-body tracking requires [OpenXR Tracker Profiles](https://github.com/nicoco007/BeatSaber-ExtraOpenXRFeatures/tree/main/OpenXRTrackerProfiles) (which can be installed through mod managers or [downloaded and installed manually](https://github.com/nicoco007/BeatSaber-ExtraOpenXRFeatures/releases)) and setting up tracker roles in SteamVR. For instructions on how to do the latter, check out [OpenXR Tracker Profiles' instructions](https://github.com/nicoco007/BeatSaber-ExtraOpenXRFeatures/tree/main/OpenXRTrackerProfiles#assigning-steamvr-tracker-roles).\n\n### Creating your own avatar\nTo get started, check out [the avatars guide on the BSMG wiki](https://bsmg.wiki/models/avatars-guide.html). If you have questions, join the [the BSMG Discord server](https://discord.gg/beatsabermods) and ask in the [#pc-3d-modeling](https://discord.com/channels/441805394323439646/468249466865057802) channel.\n\n## Contributing\nTo resolve references and automatically copy the compiled DLL into Beat Saber's installation directory, first create files called `CustomAvatar.csproj.user` and `CustomAvatar-Editor.csproj.user` next to `Source\\CustomAvatar\\CustomAvatar.csproj` and `Source\\CustomAvatar-Editor\\CustomAvatar-Editor.csproj` respectively. Then paste in the following contents:\n\n### CustomAvatar.csproj.user\n```xml\n\u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n\u003cProject\u003e\n  \u003cPropertyGroup\u003e\n    \u003c!-- Replace this with the path to your Beat Saber installation --\u003e\n    \u003cBeatSaberDir\u003eC:\\Program Files (x86)\\Steam\\steamapps\\common\\Beat Saber\u003c/BeatSaberDir\u003e\n  \u003c/PropertyGroup\u003e\n\u003c/Project\u003e\n```\n\n### CustomAvatar-Editor.csproj.user\n```xml\n\u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n\u003cProject\u003e\n  \u003cPropertyGroup\u003e\n    \u003c!-- Replace this with the path to your Beat Saber installation --\u003e\n    \u003cBeatSaberDir\u003eC:\\Program Files (x86)\\Steam\\steamapps\\common\\Beat Saber\u003c/BeatSaberDir\u003e\n\n    \u003c!-- Replace this with the path to your Custom Avatars Unity Project or leave it empty if you don't have one --\u003e\n    \u003cUnityProjectDir\u003eC:\\Users\\Me\\Documents\\AvatarsUnityProject\u003c/UnityProjectDir\u003e\n  \u003c/PropertyGroup\u003e\n\u003c/Project\u003e\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicoco007%2Fbeatsabercustomavatars","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicoco007%2Fbeatsabercustomavatars","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicoco007%2Fbeatsabercustomavatars/lists"}