{"id":13661157,"url":"https://github.com/radiatoryang/scopa","last_synced_at":"2025-04-05T12:06:32.329Z","repository":{"id":42772938,"uuid":"469510279","full_name":"radiatoryang/scopa","owner":"radiatoryang","description":"Unity level design plugin that adds support for Quake .MAP / Half-Life .RMF / Source .VMF, Q1 HL1 .WAD textures, and .FGD export.","archived":false,"fork":false,"pushed_at":"2024-11-23T07:52:12.000Z","size":1185,"stargazers_count":122,"open_issues_count":0,"forks_count":19,"subscribers_count":17,"default_branch":"main","last_synced_at":"2025-03-29T11:08:37.071Z","etag":null,"topics":["3d","environment","game","game-development","half-life","half-life-2","hammer","level-design","level-editor","mod","modeling","quake","quake-engine","source-engine","trenchbroom","unity","unity-editor","unity-package","unity3d"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":false,"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/radiatoryang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2022-03-13T22:24:52.000Z","updated_at":"2025-03-26T18:06:35.000Z","dependencies_parsed_at":"2023-09-24T12:10:32.856Z","dependency_job_id":"549e4386-41cc-47cc-b6ba-28a20c754dc3","html_url":"https://github.com/radiatoryang/scopa","commit_stats":{"total_commits":122,"total_committers":3,"mean_commits":"40.666666666666664","dds":"0.024590163934426257","last_synced_commit":"0dc0787b42b340b057267cf8faa8488ed037b6cc"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radiatoryang%2Fscopa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radiatoryang%2Fscopa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radiatoryang%2Fscopa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radiatoryang%2Fscopa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/radiatoryang","download_url":"https://codeload.github.com/radiatoryang/scopa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247332605,"owners_count":20921853,"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":["3d","environment","game","game-development","half-life","half-life-2","hammer","level-design","level-editor","mod","modeling","quake","quake-engine","source-engine","trenchbroom","unity","unity-editor","unity-package","unity3d"],"created_at":"2024-08-02T05:01:30.445Z","updated_at":"2025-04-05T12:06:32.310Z","avatar_url":"https://github.com/radiatoryang.png","language":"C#","funding_links":[],"categories":["C\\#"],"sub_categories":[],"readme":"# Scopa\n\n*Scopa* (\"broom\" in Latin) is a Unity level design plugin that adds supports for various Quake / Half-Life / Source file formats. Like [Qodot](https://github.com/QodotPlugin/qodot-plugin) but for Unity. To build levels, we strongly recommend [TrenchBroom](https://github.com/TrenchBroom/TrenchBroom) and the Quake 1 .MAP file format.\n\n# WARNING: in unstable early development, not ready for production use yet, might change a lot or break\n\n- [MAP, RMF, VMF, JMF import](Documentation~/MapImporter.md) generates model prefab with meshes, colliders, entities. (note: only core Q1 MAP features)\n- [WAD import](Documentation~/WadImporter.md) / [WAD export](Documentation~/WadExporter.md) (Quake 1 WAD2 / Half-Life WAD3 textures format, not Doom)\n- FGD creator can export entity definitions out to TrenchBroom\n- works at editor time or runtime (for modding support)\n\n![Trenchbroom to Unity](Documentation~/TrenchbroomToUnity.png)\n\n## Installation\n\nThis is a [Unity Package](https://docs.unity3d.com/Manual/PackagesList.html) for Unity 2020.1 or later. To install, open [Package Manager](https://docs.unity3d.com/Manual/upm-ui.html) and add `https://github.com/radiatoryang/scopa.git` [(more info and help)](https://docs.unity3d.com/2021.2/Documentation/Manual/upm-ui-giturl.html) (TIP: You'll probably need to [install Git](https://git-scm.com/downloads) first.) There's zero dependencies, but if you have [Burst](https://docs.unity3d.com/Packages/com.unity.burst@1.8/manual/index.html) installed then map imports will be significantly faster.\n\n## Usage\n\n\u003cimg src=\"Documentation~/MapImportInspector.png\" width=256 align=right alt=\"Map import inspector\" /\u003e\n\nPut a supported file (MAP, RMF, VMF, JMF, WAD) in your `/Assets/` folder and it'll import automatically, just like any other asset file. Defaults are tuned to typical Quake / Half-Life [level design metrics](https://book.leveldesignbook.com/process/blockout/metrics), 32 map units = 1 Unity meter.\n\n**Do your edits in the level editor, not in Unity!** Any in-editor changes may be erased when you re-import the .MAP again. Treat the .MAP file as the [single source of truth](https://en.wikipedia.org/wiki/Single_source_of_truth). \n\nFor more info (i.e. runtime import for modding), see the full [Documentation](Documentation~/Index.md).\n\n## Limitations\n\n**This package doesn't have game code.** It just imports and exports files. You still have to make the game yourself.\n\n**We treat the Quake 1 Trenchbroom .MAP v220 file format as the core feature set. Anything beyond these core features (brushes and entity keyvalue pairs) is not supported.** For more info, see the [Map Importer docs](Documentation~/MapImporter.md).\n\n## Contributions\n\n- Issues currently ARE NOT ACCEPTED at this time. Development is still very early.\n- Pull Requests ARE ACCEPTED if you know what you're doing / it can be merged easily / it's not a major feature that I'll have to maintain.\n\n## Acknowledgments / Credits\n\n- lots of file format handling from [Sledge Formats](https://github.com/LogicAndTrick/sledge-formats)\n- GPU-based texture resizing from [Unity GPU Texture Resize](https://github.com/ababilinski/unity-gpu-texture-resize)\n- color palette generation from [cSharpColourQuantization](https://github.com/bacowan/cSharpColourQuantization/blob/master/ColourQuantization/MedianCut.cs)\n\n## Advice\n- I prefer more control, but if you want to pay for something simpler with magic auto configuration then try [Tremble Map Importer (Asset Store)](https://assetstore.unity.com/packages/tools/level-design/tremble-map-importer-277805)\n- looking for a BSP plugin? try [Unity3D BSP Importer](https://github.com/wfowler1/Unity3D-BSP-Importer)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradiatoryang%2Fscopa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fradiatoryang%2Fscopa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradiatoryang%2Fscopa/lists"}