https://github.com/fadookie/SpriteSlicer
Tool to export Unity sprite sheet slices as individual images
https://github.com/fadookie/SpriteSlicer
Last synced: 25 days ago
JSON representation
Tool to export Unity sprite sheet slices as individual images
- Host: GitHub
- URL: https://github.com/fadookie/SpriteSlicer
- Owner: fadookie
- License: mit
- Created: 2019-08-15T04:03:54.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-10-02T00:38:21.000Z (about 1 year ago)
- Last Synced: 2025-08-20T07:42:56.703Z (4 months ago)
- Language: C#
- Size: 1.11 MB
- Stars: 61
- Watchers: 4
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- anything_about_game - SpriteSlicer
README
# Unity Sprite Slice Export Tool
## Background
I wanted a way to quickly slice up spritesheet rips for a game I am working on. [Unity's built-in spritesheet editor](https://docs.unity3d.com/Manual/SpriteEditor.html) has some fantastic tools to slice spritesheets automatically. However, at this time of writing there is no built-in way to export the sprites as individual images. This editor script is intended to bridge that gap, turning Unity into an automatic spritesheet-slicing machine.
## Installation
This works as a standalone Unity project, or you may copy the `Scripts` folder into an existing project.
## Usage
### Pre-Processing
You will get the best results if you pre-process your spritesheet by deleting any unwanted graphics along with the background color if any, and save it as an alpha-transparent PNG. This will help Unity's automatic slicing algorithm, as well as usually being what you want in order to use the sprite in a modern game engine. If you are looking for tools to help do this, I recommend [Pixen](https://pixenapp.com/) (macOS), [Paint.NET](https://www.getpaint.net/) (free, Windows), or [GIMP](https://www.gimp.org/) (free, all platforms).
### Required Import Settings
Each texture you want to use should have the following import settings:
| Property | Value | Explanation |
| ------------- | ------------- | ------------- |
| `Texture Type` | `Sprite (2D and UI)` | This script is only designed to export sliced sprite sheets. |
| `Sprite Mode` | `Multiple` | " |
| `Advanced` → `Read/Write Enabled` | ☑️ | Required for exporter to read texture. |
| `Default` → `Max Size` | `8192` (Or highest available) | Prevents automatic downsampling of large textures. If your sheet is larger than this (8192 x 8192,) split it into smaller sheets using an image editor first. |
### Export Steps
1. Slice your spritesheets using the [Sprite Editor](https://docs.unity3d.com/Manual/SpriteEditor.html).
* I recommend using the automatic slicing feature and then tweaking if needed.
3. From the main menu bar, click `SpriteTextureSliceExporter` → `Export Slices`. (You can also use `Export Slices` from the context menu.)
* I wanted this to be in the context menu as well but couldn't get it working. If you can figure this out please send a PR!
4. Choose a folder to export images to.
Note: I have not tested this on atlases, only spritesheets attached to individual sprite assets as described above.
# Credits
* [Eliot Lash](https://www.eliotlash.com) - Original author
* [James Hughes](https://github.com/james1997hughes) - Context menu, error messaging improvements
Note that the MIT License applies to the code in this repo only and not the spritesheets themselves which are only provided for demo purposes.