Spritesheet 3000
Custom pipeline plugin about how to make work together Adobe Photoshop's files with Unity Engine's sprites
Unity Plugin
The latest version can be installed via package manager using following git URL:
https://github.com/am1goo/unity-plugin-spritesheet-3000.git
Getting started
Adobe Photoshop CC Extension
- Install extentions via Unity Editor menu
Spritesheet 3000 -> Install extensions -> Adobe Photoshop CC
or
-
Install extentions by yourself
Spritesheet 3000 -> Open extensions folder -> Adobe Photoshop CC
-
Copy folder
com.am1goo.photoshop.extension.spritesheet3000
intoC:\Program Files\Common Files\Adobe\CEP\extensions\
(for Windows x64)
or
intoC:\Program Files (x86)\Common Files\Adobe\CEP\extensions\
(for Windows x86)
Format structure
Adobe Photoshop's extensions
will create some files with ease-to-use structure:
- metafile with source psd filename (heart of this plugin, contains all required meta information about future animation clip - filter type, compression, ppu and etc.)
- bunch of animation frames as single sprites (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)
folder|-
|- metafile
|- frame_01
|- frame_02
|- frame_03
|- frame_04
|- ...
|- frame_xx
How to use
-
Open extension via Adoby Photoshop CC
Window -> Extensions -> Spritesheet 3000 Exporter
-
Export all frames as single files and generate metadata
Set all options and press buttonExport..
- Import frames via single metedata file
OpenUnity Editor
, select single metafile inProject
window, clickRight Mouse Button
and selectPack from file
or
- Import bunch of frames via folder
OpenUnity Editor
, select whole folder inProject
window, clickRight Mouse Button
and selectPack from folder
- Use packed frames in your game
Put componentSpriteAnimator3000
on any game object
Run any animations via code:
using Spritesheet3000;
using UnityEngine;
public class Example : MonoBehaviour
{
[SerializeField]
private SpriteAnimationClip3000 _clip;
[SerializeField]
private SpriteAnimator3000 _anim;
private void Awake()
{
_anim.Play(_clip);
}
}
Tested in
- Unity 2019.4.x
- Unity 2020.3.x
Using in
- Sin Slayers - RPG with roguelike elements set in a dark fantasy world, where your choices determine how challenging the fights and enemies will be.
Contribute
Contribution in any form is very welcome. Bugs, feature requests or feedback can be reported in form of Issues.