{"id":14960569,"url":"https://github.com/am1goo/unity-plugin-spritesheet-3000","last_synced_at":"2025-10-24T18:31:49.701Z","repository":{"id":208036373,"uuid":"720673792","full_name":"am1goo/unity-plugin-spritesheet-3000","owner":"am1goo","description":"Custom pipeline plugin about how to make work together Adobe Photoshop's files with Unity Engine's sprites","archived":false,"fork":false,"pushed_at":"2025-01-24T04:35:48.000Z","size":660,"stargazers_count":16,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-31T03:38:30.331Z","etag":null,"topics":["2d","2d-sprites","animation","packer-plugin","photoshop-extension","sprite-packer","sprites","spritesheet","spritesheet-packer","unity","unity-plugin"],"latest_commit_sha":null,"homepage":"","language":"C#","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/am1goo.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":"2023-11-19T08:11:11.000Z","updated_at":"2025-01-30T09:12:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"0ef8806d-6145-4c4a-8596-829fa8e969cb","html_url":"https://github.com/am1goo/unity-plugin-spritesheet-3000","commit_stats":{"total_commits":71,"total_committers":4,"mean_commits":17.75,"dds":0.6056338028169015,"last_synced_commit":"20219335c96f8f99b3765f13214e299d00f38cfb"},"previous_names":["am1goo/unity-plugin-spritesheet-3000"],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/am1goo%2Funity-plugin-spritesheet-3000","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/am1goo%2Funity-plugin-spritesheet-3000/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/am1goo%2Funity-plugin-spritesheet-3000/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/am1goo%2Funity-plugin-spritesheet-3000/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/am1goo","download_url":"https://codeload.github.com/am1goo/unity-plugin-spritesheet-3000/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238024405,"owners_count":19403836,"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":["2d","2d-sprites","animation","packer-plugin","photoshop-extension","sprite-packer","sprites","spritesheet","spritesheet-packer","unity","unity-plugin"],"created_at":"2024-09-24T13:22:32.645Z","updated_at":"2025-10-24T18:31:49.696Z","avatar_url":"https://github.com/am1goo.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![openupm](https://img.shields.io/npm/v/com.am1goo.spritesheet3000?label=openupm\u0026registry_uri=https://package.openupm.com)](https://openupm.com/packages/com.am1goo.spritesheet3000/)\n\n# Spritesheet 3000 for Unity\nCustom pipeline plugin about how to make work together Adobe Photoshop's files with Unity Engine's sprites and sprite atlases.\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"Readme/header-image.gif\" alt=\"header-image\"/\u003e\n\u003c/p\u003e\n\n#### Unity Plugin\nThe latest version can be installed via [package manager](https://docs.unity3d.com/Manual/upm-ui-giturl.html) using following git URL: \\\n`https://github.com/am1goo/unity-plugin-spritesheet-3000.git#0.4.27`\n\n## Getting started\n#### Adobe Photoshop CC Extension\n- **Install extentions via Unity Editor menu**\\\nin top menu find and click `Spritesheet 3000 -\u003e Install extensions -\u003e Adobe Photoshop CC`\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"Readme/install-photoshop-extension.png\" alt=\"install-photoshop-extension\"/\u003e\n\u003c/p\u003e\n\nor \n\n- **Install extentions by yourself**\\\nin top menu find and click `Spritesheet 3000 -\u003e Open extensions folder -\u003e Adobe Photoshop CC`\n\n- **Copy folder `com.am1goo.photoshop.extension.spritesheet3000`**\\\ninto `C:\\Program Files\\Common Files\\Adobe\\CEP\\extensions\\` (for Windows x64)\\\nor\\\ninto `C:\\Program Files (x86)\\Common Files\\Adobe\\CEP\\extensions\\` (for Windows x86)\n\n## Format structure\nAdobe Photoshop's extensions will create some files with ease-to-use structure:\n- metafile starts with source `psd filename` (heart of this plugin, contains all required meta information about future animation clip - filter type, compression, ppu and etc.)\n- bunch of `animation frames` as single sprites starts with metafile name (don't worry about that, these files will be skipped and don't used in runtime-mode at all, needed only in editor-mode purposes)\n- `atlas texture` as result of importing process\n\n```\nfolder|-\n      |- {clipname}.txt\n      |- {clipname}_01.png\n      |- {clipname}_02.png\n      |- {clipname}_03.png\n      |- {clipname}_04.png\n      |- ...\n      |- {clipname}_xx.png\n      |- {clipname}_atlas.png\n```\n\n## How to use\n- **Open extension via Adoby Photoshop CC**\\\n`Window -\u003e Extensions -\u003e Spritesheet 3000 Exporter`\n\n- **Export all frames as single files and generate metadata**\\\nSet all options and press button `Export..`\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"Readme/export-photoshop-frames-and-metadata.png\" alt=\"export-photoshop-frames-and-metadata\" width=500 height=auto/\u003e\n\u003c/p\u003e\n\n- **Import frames via single metedata file**\\\nOpen `Unity Editor`, select single metafile in `Project` window, click `Right Mouse Button` and select `Pack from file`\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"Readme/import-unity-metadata-single-file.png\" alt=\"import-unity-metadata-single-file\"/\u003e\n\u003c/p\u003e\n\nor\n\n- **Import bunch of frames via folder**\\\nOpen `Unity Editor`, select whole folder in `Project` window, click `Right Mouse Button` and select `Pack from folder`\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"Readme/import-unity-metadata-whole-folder.png\" alt=\"import-unity-metadata-whole-folder\" /\u003e\n\u003c/p\u003e\n\n- **Use packed frames in your game**\\\nPut component `SpriteAnimator3000` on any game object\\\nRun any animations via code:\n```csharp\nusing Spritesheet3000;\nusing UnityEngine;\n\npublic class Example : MonoBehaviour\n{\n    [SerializeField]\n    private SpriteAnimationClip3000 _clip;\n    [SerializeField]\n    private SpriteAnimator3000 _anim;\n\n    private void Awake()\n    {\n        _anim.Play(_clip);\n    }\n}\n```\n\n## What's next?\n- [x] Add ability to trimming all transparent pixels from frames\n- [x] Export all frames to `UnityEngine.U2D.SpriteAtlas` file with `.asset` extension\n\n## Tested in\n- **Unity 2019.4.x**\n- **Unity 2020.3.x**\n- **Unity 2022.3.x**\n\n## Using in\n- [Sin Slayers: Reign of The 8th](https://sinslayers.com) - RPG with roguelike elements set in a dark fantasy world, where your choices determine how challenging the fights and enemies will be.\n\n## Contribute\nContribution in any form is very welcome. Bugs, feature requests or feedback can be reported in form of Issues.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fam1goo%2Funity-plugin-spritesheet-3000","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fam1goo%2Funity-plugin-spritesheet-3000","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fam1goo%2Funity-plugin-spritesheet-3000/lists"}