Pribambase

Pribambase is a small tool that connects Aseprite and Blender, to allow painting with instant viewport feedback and all functionality of external editor at the same time. Currently, the addon has mostly one-way workflow where you paint in Ase and not much in Blender.

It also  allows displaying the UV map in Aseprite and adds a few shortcuts like setting up materials and animation rigs. It also can generate spritesheets and animations to use in Armory3D engine games.

• How Do I... tutorials and advice.
  
• Reference explains each button and setting.
• Community to show off your work or ask for help.
  
• Issues tracker for errors, bugs and feature requests.
• Hashtag #pribambase to browse or share the work you created.

---

Setup

Installing Aseprite plugin

Aseprite recommended version is newer than 1.2.31 or 1.3-beta8, preferrably latest.  Oldest supported is 1.2.30 or 1.3-beta7 (see issues below). Trial version doesn't work.

1. Launch Aseprite and drag the file called pribambase-aseprite into the window.
2. Press Install.
3. Restart Aseprite.

After that, a new menu option called Sync should appear in the File menu

Installing Blender plugin

Blender recommended version is newer than 2.83, preferrably latest. Oldest supported is 2.80, but performance and stability are significantly worse.

1. In Edit > Preferences > Addons click Install and chose the file called pribambase-blender-{...}.
2. After the addon appears in the list, check the box next to its name to activate it. The app might freeze for several seconds.
3. Save preferences from the "burger" menu.

After that, a new panel titled Pribambase will appear on the right side of the viewport and in the Image/UV editor, and a new menu called Sprite will appear in the Image/UVeditor.

---

Usage

After the plugins are installed, turn each of them on before drawing: in blender press Connect on top of the plugin's panel in the viewport, in Aseprite press File > Sync .  After that you can:

• Open any texture used in blendfile normally in Aseprite, and it will be updated in Blender as you paint. This applies to both textures created normally with blender, and textures set up by the plugin.
• Use Image Editor > Sprite menu to load aseprite files as textures, or create new ones.
• Enable Show UV to show the UV Map in aseprite. It works similar to blender's UV editor.
• Use shortcuts on addon panel for setting up grid, materials, and animations. These do not require aseprite connected.

---

Known Issues

• Undo/redo in aseprite after sending UVs makes the  reference layer do odd things.
• It's better to disable auto-reloading images by Sprytile or other addons. It does not conflict with syncing per se, but it stops blender from saving file backups.
  
• In older versions of Aseprite plugin fails to notice the change in sprite location until the next edit.
  
• In blender 2.80-2.82 the UV only syncs after exiting edit mode.
• In blender 3.1 image contents do not update due to a bug (T96030 or a similar one). Enable `Addon Preferences > Save After Sync` to use a reload hack, at cost of performance/disk load.