{"id":23379719,"url":"https://github.com/zaaarf/lillero-mapper","last_synced_at":"2025-08-08T06:16:15.999Z","repository":{"id":190848027,"uuid":"652269111","full_name":"zaaarf/lillero-mapper","owner":"zaaarf","description":"A lightweight mapping library used by the Lillero processor.","archived":false,"fork":false,"pushed_at":"2025-07-14T16:54:22.000Z","size":148,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2025-07-14T21:30:52.866Z","etag":null,"topics":["java","mappings","obfuscation"],"latest_commit_sha":null,"homepage":"https://docs.zaaarf.foo/lillero-mapper/","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/zaaarf.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,"zenodo":null}},"created_at":"2023-06-11T16:09:54.000Z","updated_at":"2025-07-14T16:54:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"36549b8d-9979-40ad-b368-6311f1fd6991","html_url":"https://github.com/zaaarf/lillero-mapper","commit_stats":null,"previous_names":["zaaarf/lillero-mapper"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/zaaarf/lillero-mapper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaaarf%2Flillero-mapper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaaarf%2Flillero-mapper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaaarf%2Flillero-mapper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaaarf%2Flillero-mapper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zaaarf","download_url":"https://codeload.github.com/zaaarf/lillero-mapper/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zaaarf%2Flillero-mapper/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269373399,"owners_count":24406376,"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-08-08T02:00:09.200Z","response_time":72,"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":["java","mappings","obfuscation"],"created_at":"2024-12-21T19:27:12.814Z","updated_at":"2025-08-08T06:16:15.489Z","avatar_url":"https://github.com/zaaarf.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lillero-mapper\nA tiny library to process mappings in various formats.\n\n## Why?\nI initially [meant to fork Enigma](https://github.com/FabricMC/Enigma), but honestly it was far more than I needed, even when stripped down to its core library.\n\nThe purpose of this library is to act as base for [Lillero-processor](https://github.com/zaaarf/lillero-processor/), to work with various mapping formats.\n\n## Usage\nSimply call `MapperProvider.getMapper()` and pass it a `List` of `String`s representing the mapping file's contents, line by line. Call then `populate()` on the resulting `IMapper`, passing the same `List` once again, and you'll have an object that can process stuff back and forth - granted that a mapper capable of parsing the input was found.\n\n## Supported formats\nThese are the formats currently supported by this library:\n- `srg`\n- `tsrg`\n- `tinyv2`\n- `multi` (see below)\n\n### Multimapper\nA case where multiple passes of deobfuscation may be needed is also supported, although unrecommended; I would also very much advise against referencing an untrusted multimapper in a remote location, for reasons that will be obvious to you in a second. A multimapper looks like this:\n\n```\nlll multimapper\n\u003curl-or-path-for-first-mapping\u003e\n\u003curl-or-path-for-second-mapping\u003e\n...\n\u003curl-or-path-for-last-mapping\u003e\n```\n\nYou obviously don't want a remote location you don't control telling you what to download on your computer.\n\nThe passes are applied in the provided order, from the first to the last.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzaaarf%2Flillero-mapper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzaaarf%2Flillero-mapper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzaaarf%2Flillero-mapper/lists"}