{"id":15138830,"url":"https://github.com/zkxs/hooligan","last_synced_at":"2025-10-23T15:31:43.517Z","repository":{"id":246622427,"uuid":"821688216","full_name":"zkxs/hooligan","owner":"zkxs","description":"Manages VRChat LocalPlayerModerations file","archived":false,"fork":false,"pushed_at":"2024-07-13T06:09:08.000Z","size":45,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-30T19:12:05.598Z","etag":null,"topics":["vrchat"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zkxs.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":"2024-06-29T06:43:51.000Z","updated_at":"2024-07-26T00:09:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"16c0dcc1-6b7e-4ab8-9416-d88c9a2b586c","html_url":"https://github.com/zkxs/hooligan","commit_stats":null,"previous_names":["zkxs/hooligan"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zkxs%2Fhooligan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zkxs%2Fhooligan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zkxs%2Fhooligan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zkxs%2Fhooligan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zkxs","download_url":"https://codeload.github.com/zkxs/hooligan/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237852407,"owners_count":19376675,"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":["vrchat"],"created_at":"2024-09-26T08:00:19.720Z","updated_at":"2025-10-23T15:31:43.506Z","avatar_url":"https://github.com/zkxs.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hooligan\n\nHooligan is a program that resets manually shown avatars in VRChat between each play session.\n\nIf Hooligan notices you've manually shown the same person 3 or more times, then it will \"stick\" and Hooligan will stop\nresetting the shown status for that person. You can always un-show that person again in-game to cause them to unstick.\n\n## Installation and Usage\n\n1. Download [hooligan.exe](https://github.com/zkxs/hooligan/releases/latest/download/hooligan.exe) from the \n  [latest release](https://github.com/zkxs/hooligan/releases/latest) to a location of\n   your choice. Make note of where you saved it.\n2. In Steam, change the VRChat launch option to `\u003cINSTALL_LOCATION\u003e\\hooligan.exe %command%`, where `\u003cINSTALL_LOCATION\u003e`\n   is where you saved hooligan.exe. For example, if you saved it to `C:\\Users\\Tupper\\Downloads\\` then you should use\n   `C:\\Users\\Tupper\\Downloads\\hooligan.exe %command%` as the Steam launch option.\n\nHooligan will now automatically run when you start VRChat from Steam.\n\n## FAQ\n\n### Why make Hooligan?\n\nI personally use very aggressive performance rank settings to save my FPS, so find it annoying when I manually show\nsomeone's avatar and then a year later I run into them again in the least optimized avatar I've ever seen. Hooligan\nsolves this problem by making all manually shown avatars temporary to a single play session.\n\n### How does Hooligan work?\n\nIt just edits your \n[LocalPlayerModerations file](https://docs.vrchat.com/docs/local-vrchat-storage#localplayermoderations-file-format) to\nremove shown avatar entries. This file is where VRChat records which players you've manually shown or hidden.\n\n### Where does Hooligan store data?\n\nLogs, configs, and history database are stored in `%localappdata%\\hooligan`.\n\n### Can I change the shown avatar sticking threshold?\n\nYes, open up `%localappdata%\\hooligan\\config\\config.props` and change the `auto_hide_threshold` value there. Anyone\nyou've manually shown at least that number of times will no longer be automatically un-shown.\n\n### What's up with the weird Steam launch option?\n\nWhen you put `%command%` in the Steam launch options for a game, Steam will execute the entire launch option text as a\ncommand, and the actual game launch command is substituted in place of `%command%`.\n\nSo `C:\\hooligan.exe %command%` will become `C:\\hooligan.exe C:\\Steam\\steamapps\\common\\VRChat\\launch.exe`, or in desktop\nmode `C:\\hooligan.exe C:\\Steam\\steamapps\\common\\VRChat\\launch.exe --no-vr`\n\nAfter Hooligan cleans up your LocalPlayerModerations file it will take those launch options and run them to start VRChat.\n\nNote that you can still use Hooligan without this process launching behavior: just don't pass any arguments to it.\n\n### Why Windows?\n\nVRChat only supports Windows natively, so there is not a compelling reason to provide Linux binaries for Hooligan. I\nsuggest that if you're running VRChat under Proton then you should also run Hooligan within the same Proton prefix.\n\nIf you have a use-case for native linux support, please let me know!\n\n### Why is this called Hooligan?\n\nVRChat Local Player Moderation Manager is too long, and this is used to unshow hooligans' avatars before they change\ninto something with terrible performance while you're not playing. Also, I like the word \"hooligan\".\n\n## Installing from Source\n\n1. [Install Rust](https://www.rust-lang.org/tools/install)\n2. `cargo install hooligan`\n\n## Building from Source\n\n1. [Install Rust](https://www.rust-lang.org/tools/install)\n2. Clone the project\n3. `cargo build --release`\n\n## License\n\nCopyright 2025\n\nHooligan is provided under the [GPL-3.0 license](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzkxs%2Fhooligan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzkxs%2Fhooligan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzkxs%2Fhooligan/lists"}