{"id":28879759,"url":"https://github.com/techcable/supersrg","last_synced_at":"2025-07-27T00:38:52.461Z","repository":{"id":77922083,"uuid":"102035040","full_name":"Techcable/SuperSrg","owner":"Techcable","description":"The ultimate srg mappings tool","archived":false,"fork":false,"pushed_at":"2018-09-19T19:29:01.000Z","size":118,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-21T17:17:46.008Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","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/Techcable.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,"zenodo":null}},"created_at":"2017-08-31T19:03:00.000Z","updated_at":"2025-07-14T07:46:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"2adca0b4-25cd-4c58-91e9-92598e708e59","html_url":"https://github.com/Techcable/SuperSrg","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Techcable/SuperSrg","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Techcable%2FSuperSrg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Techcable%2FSuperSrg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Techcable%2FSuperSrg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Techcable%2FSuperSrg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Techcable","download_url":"https://codeload.github.com/Techcable/SuperSrg/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Techcable%2FSuperSrg/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267277023,"owners_count":24063227,"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","status":"online","status_checked_at":"2025-07-26T02:00:08.937Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-06-20T18:34:33.886Z","updated_at":"2025-07-27T00:38:52.455Z","avatar_url":"https://github.com/Techcable.png","language":"Rust","readme":"SuperSrg\n=========\nThe ultimate srg mappings tool.\n\n## Features\n- Fast source remapping\n  - First determines what names need to be changed in Java with Spoon AST\n    - This info can be reused unless the original source files change,\n     regardless of what mappings need to be applied.\n  - Then, applies the range map in rust in less than a second\n- Minecraft mapping generation\n  - Generates mappings between any combination of spigot, MCP and obfuscated names.\n  - Supports any MCP version\n  - Can optionally remap just the obfuscated names, preserving the original.\n    - This is useful for applying the MCP mappings to the spigot ones,\n      since it'd preserve the deobfuscated spigot names,\n      while replacing the remaining obfsucated names with the MCP mappings.\n- Highly efficient binary mappings format used internally, but also supports srg and csrg.\n\n\n## Available Commands (native)\n\n### Generate Minecraft mappings\nGenerates minecraft mappings based on the MCP and Spigot deobfuscation info :o\n````\nUSAGE:\n    supersrg generate_minecraft [FLAGS] [OPTIONS] \u003cminecraft_version\u003e \u003coutput_dir\u003e \u003ctargets\u003e...\n\nFLAGS:\n        --cache             Specify an alternate cache location, defaulting to the output directory\n    -h, --help              Prints help information\n        --refresh-spigot    Refresh spigot BuildData information, checking if it's changed\n    -V, --version           Prints version information\n\nOPTIONS:\n        --builddata-commit \u003cbuilddata_commit\u003e\n            The spigot BuildData commit to generate the mappings for, infered by default\n\n        --format \u003cformat\u003e\n            The mapping format to emit the resulting mappings in [default: binary]\n\n        --mcp \u003cmcp_version\u003e                      The MCP version to generate the mappings for\n\nARGS:\n    \u003cminecraft_version\u003e    The minecraft version to generate the mappings for\n    \u003coutput_dir\u003e           The output directory to place generated mappings\n    \u003ctargets\u003e...           The target mappings to generate\n````\nSuperSrg supports any combination of the following:\n- `srg` - MCP's unique srg mappings, which are the same for each minecraft version.\n- `mcp` - MCP's crowd sourced deobfuscated mappings, fetched from `MCPBot`\n  - These have a independent version based on the date, which must be specified as an option.\n- `spigot` - Spigot's deobfuscation mappings, held in the `BuildData` git repo\n  - These are significantly lower quality than the MCP mappings, and most member names are still obfuscated\n  - These mappings don't change very often, since plugins use them and would break if the change\n  - Therefore the latest available mappings for the minecraft version are fetched by default, though this can be configured\n- `obf` - The obfuscated mojang names, which are used to unify the mappings systems\n\nMapping targets take the form `{original}2{renamed}` with an optional modifier at the end.\nFor example, `spigot2mcp` specifies mappings from the spigot names into the MCP names.\nThree modifiers are supported:\n- `classes` - Restricts the mappings to just class names.\n- `members` - Restricts the mappings to just member names.\n- `onlyobf` - Restricts the mappings to just names that are still obfuscated.\n  - This allows you to take advantage of other mappings, without changing names that are already deobfuscated.\n  - The motivating example is `spigot2mcp-onlyobf`, which would take advantage of the MCP mappings\n     without changing names spigot already deobfuscated.\n  - This is helpful since people often become familiar with and prefer a particular naming scheme (like spigot),\n     but still want to take advantage of the additional naming information.\n\n#### Available mappings targets\n\n### Apply range\nApplies the specified range map to the source directory\n````\nUSAGE:\n    supersrg apply_range [FLAGS] \u003crangemap\u003e \u003cmappings\u003e \u003csource\u003e \u003coutput\u003e\n\nFLAGS:\n    -f, --force      Delete the output directory if it already exists\n    -h, --help       Prints help information\n    -V, --version    Prints version information\n    -v, --verbose    Show verbose output\n\nARGS:\n    \u003crangemap\u003e    The SuperSrg binary rangemap to apply\n    \u003cmappings\u003e    The mappings file to apply\n    \u003csource\u003e      The source directory containing the files to remap\n    \u003coutput\u003e      Where to place the remapped files\n````\nThe rangemap is a binary file generated by the java class `net.techcable.supersrg.RangeExtractor`.\nRun the command `java -cp SuperSrg.jar net.techcable.supersrg.RangeExtractor --help` to get more info on that.\nMake sure to reuse the generated range map unless the original source files change,\nbecause it's very slow to generate.\n\n### Convert\nConverts from one mapping format into another.\n````\nConverts from one mapping format into another\n\nUSAGE:\n    supersrg convert [OPTIONS] \u003cinput\u003e \u003coutput\u003e\n\nFLAGS:\n    -h, --help       Prints help information\n    -V, --version    Prints version information\n\nOPTIONS:\n        --format \u003cformat\u003e    The mapping format to emit the resulting mappings in [default: binary]\n\nARGS:\n    \u003cinput\u003e     The input mappings file to convert\n    \u003coutput\u003e    The output file to place the resulting mappings\n````\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechcable%2Fsupersrg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechcable%2Fsupersrg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechcable%2Fsupersrg/lists"}