{"id":23557642,"url":"https://github.com/emperorofmars/mars-avatar-guide","last_synced_at":"2025-05-16T00:31:15.865Z","repository":{"id":218266979,"uuid":"745612663","full_name":"emperorofmars/Mars-Avatar-Guide","owner":"emperorofmars","description":"User guide for my avatars.","archived":false,"fork":false,"pushed_at":"2024-06-28T16:53:30.000Z","size":1026,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-17T15:14:03.088Z","etag":null,"topics":["avatar","chilloutvr","documentation","user-guide","vr","vrchat","vrm"],"latest_commit_sha":null,"homepage":"https://avatar-guide.squirrel.pub/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/emperorofmars.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-01-19T17:58:42.000Z","updated_at":"2024-07-26T00:11:58.000Z","dependencies_parsed_at":"2024-02-06T03:25:02.845Z","dependency_job_id":"170cf3d9-bb76-442f-b069-9af0065dae52","html_url":"https://github.com/emperorofmars/Mars-Avatar-Guide","commit_stats":null,"previous_names":["emperorofmars/mars-avatar-guide"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emperorofmars%2FMars-Avatar-Guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emperorofmars%2FMars-Avatar-Guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emperorofmars%2FMars-Avatar-Guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emperorofmars%2FMars-Avatar-Guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emperorofmars","download_url":"https://codeload.github.com/emperorofmars/Mars-Avatar-Guide/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254447353,"owners_count":22072753,"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":["avatar","chilloutvr","documentation","user-guide","vr","vrchat","vrm"],"created_at":"2024-12-26T15:15:50.876Z","updated_at":"2025-05-16T00:31:15.826Z","avatar_url":"https://github.com/emperorofmars.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mars' Avatar Guide\n*squeak*\n\n**Thank you for getting one of my avatars!**\n\n***Please don't forget to rate your [Itch](https://emperorofmars.itch.io) and [Gumroad](https://emperorofmars.gumroad.com) products!***\n\n## General Tips\n* The only blendshapes that are meant for editing are contained within the `=== User Editing ===` section.\n* The Blender file is set up, so you can just apply the `Subdivision Surface` modifier. Be sure to check the `Use Custom Normals` option under the advanced settings for that modifier. You may also want to remove all of the projected floof. These are parts which projected the UV map and normals from the main body and look ugly after subdivision. Usually they are selected by a vertex-group called something like `Project Floof` or `Hip and Shoulder Floof`.\n\n## VRChat Setup\n1. Set up a project with the [VRChat Creator Companion](https://vrchat.com/home/download)\n2. Add **[D4rk's Avatar Optimizer](https://d4rkc0d3r.github.io/vpm-repos/main_redirect.html)**\n3. Import the `.unitypackage`\n\nThe setup scene is located under `Assets/**AVATAR NAME**/Setup VRChat/Scenes`\n\nAdapt and upload an avatar with the VRC SDK and have fun!\n\n## ChilloutVR Setup (if included)\n1. Set up a project with the current ChilloutVR [Unity Version](https://documentation.abinteractive.net/cck/setup/#download-unity)\n2. Import the newest [CCK](https://documentation.abinteractive.net/cck/setup/#download-cck)\n2. Import the `.unitypackage`\n\nThe setup scene is located under `Assets/**AVATAR NAME**/Setup ChilloutVR/Scenes`\n\nAdapt and upload an avatar with the CVR SDK and have fun!\n\n## VRM Setup (if included)\n1. Set up a Unity project\n2. Import the latest supported [UniVRM 0.X](https://github.com/vrm-c/UniVRM/releases)\n3. Import the `.unitypackage`\n\nThe setup scene is located under `Assets/**AVATAR NAME**/Setup VRM/Scenes`\n\nExport through UniVRM.\n**Be sure to check the 'Reduce Blendshape' option**\n\n## Blender Export\nUse these export settings:\n![](res/Guide_Export_Blender.png)\n\n## Unity Import\n* Drag the model into Unity and ensure that this are its import settings.\n\t* **Make sure that `Read/Write Enabled` and `Legacy Blend Shape Normals` is ticked.**\n![](res/Guide_Import_Unity_Model.png)\n* In the `Rig` tab set the `Animation Type` to `Humanoid`.\n* For the `Avatar Definition` you can either reuse one from the original Avatar, or if you modified the Rig, you must configure a new one. (To do so set the Animation Type to `None`, apply, and then set it again to `Humanoid`. Yes, Unity is stupid.)\n![](res/Guide_Import_Unity_Rig.png)\n* Ensure the `Avatar Definition` is configured the following way:\n\t* Unity sometimes doesn't map the `Chest`, ensure it is mapped.\n\t* Map the `Toes.L|R` as the Unity `Foot`.\n\t* Don't map the Unity `Toes`.\n\t* Unmap the `Jaw`. (Under Head)\n![](res/Guide_Unity_Avatar_Definition.png)\n\n---\n\n### Contact / Links\n**Find all my links at [mars.squirrel.pub](https://mars.squirrel.pub)**\n* [Mastodon](https://squirrel.pub/@mars)\n* [Bluesky](https://bsky.app/profile/mars.squirrel.pub)\n* [Furaffinity](https://www.furaffinity.net/user/emperorofmars/)\n* [Twatter](https://twitter.com/Emperor_of_Mars)\n* [Discord Server](https://discord.gg/MDggMXSttM)\n* [VRC Group](https://vrc.group/SQRL.0269)\n\n\\- Mars\n\nCheers!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femperorofmars%2Fmars-avatar-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femperorofmars%2Fmars-avatar-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femperorofmars%2Fmars-avatar-guide/lists"}