MCPcopy Index your code
hub / github.com/AlienPolygon/pribambase

github.com/AlienPolygon/pribambase @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
136 symbols 297 edges 11 files 25 documented · 18%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

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. It also adds a few shortcuts like displaying the UV map in Aseprite or setting up a grid-scaled pixelart reference in the viewport.

Currently, the addon has mostly one-way workflow where you paint in Ase and not much in Blender. Better bidirectional workflow ~~is quite a task tell ya what~~ is planned in future versions.

  • Download packaged version for your platform
  • Geeting Started after installing, look there
  • Reference explains each button and setting
  • Itchio forum to show off your work or ask for help
  • Issue tracker for bug reports and feature requests. Kindly don't submit non-technical help requests.

​Although the entire project is distributed free of charge, I highly encourage you to support it financially sooner or later, as if it was on blen***arket or flip***rmals. There's still work left to do, and it'd be pretty great to be able to do it sooner.

Setup

Video version - all thanks to frozenMeatpopsicle

This plugin consists of two parts: for Aseprite and for Blender. Get pre-packaged version for your OS on Itchio. Do not download repo ZIP, it won't just work without extra steps.

Prerequisites

  • Blender recommended version 2.83 or later, preferrably latest. Minimum version is 2.80, but performance and stability are significantly worse
  • Aseprite minimum version 1.2.30 or 1.3-beta7. Trial version won't work

Installing Aseprite plugin

  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

  1. In Edit > Preferences > Addons click Install and chose the file called pribambase-blender-[YOUR OS]
  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 section called Sync will appear in N > Tools tab in viewport, and a new menu called Sprite will appear in the Image/uv editor.

Usage

After the plugins are installed, turn each of them on before drawing: nn 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
  • Use Sprite > Send UV to show the UV Map in aseprite

See Reference for all features.

Source

Source for aseprite plugin is the client/ folder. The repo root is the blender plugin. For using source, you'd probably want to symlink them to extension/addon locations.

Third party dependencies aren't stored in the repo. Download them from PyPI to thirdparty folder, or fetch with PIP:

cd to/project/root

## for your platform
pip download -d thirdparty -r requirements.txt

## for different platforms; the platform tags tags go look up on PyPI
pip download -d thirdparty --platform win32 --only-binary=:all: -r requirements.txt

License

In accordance with Blender developers' wishes, the addon is distributed under GPL-3.0 license. See COPYING for full license text. Specific files or libraries might be also available under different terms, see included comment or package licenses.

Acknowledgements

Async loop handling is based on Blender Cloud Addon

Core symbols most depended-on inside this repo

add_uint
called by 12
messaging/__init__.py
send
called by 8
sync.py
add
called by 7
messaging/__init__.py
add_id
called by 7
messaging/__init__.py
add_string
called by 7
messaging/__init__.py
take_uint
called by 5
messaging/__init__.py
stop
called by 4
sync.py
scale_image
called by 3
ui_3d.py

Shape

Method 78
Class 29
Function 29

Languages

Python100%

Modules by API surface

ui_2d.py27 symbols
messaging/__init__.py20 symbols
sync.py18 symbols
util.py13 symbols
messaging/handle.py13 symbols
ui_3d.py12 symbols
addon.py9 symbols
messaging/encode.py7 symbols
__init__.py7 symbols
settings.py6 symbols
async_loop.py4 symbols

For agents

$ claude mcp add pribambase \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact