# Skeletor

**Repository Path**: okay_6/Skeletor

## Basic Information

- **Project Name**: Skeletor
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-16
- **Last Updated**: 2025-05-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Skeletor
<div align=center>
  
[![Thumbnail](https://github.com/user-attachments/assets/3f5ec294-600e-4cd4-9049-7c0124801662)](https://youtu.be/RqCqg34G6Zg)

</div>

This is a pixelorama extension that add basic Skeletal animation capabilities to the software. You may play with this extension on [a Demo Project](https://github.com/user-attachments/files/18762945/Demo.Project.Extract.me.zip).

## Highlight Features:
<div align=center>
  
### 1. Basic movement:
You can move any bone in the skeleton and it's children will move with it.
  
  https://github.com/user-attachments/assets/b7b54324-013e-4ef6-9ad2-46cbc91caba4

### 2. Bone Chaining:
In chaining mode you are only allowed to rotate a bone. the children of the bones move with parent bone but preserve their rotation.
  
https://github.com/user-attachments/assets/190254b8-f62f-4ea6-831c-5ced66af898b

### 3. Tweening Support
Gererate In-Betweens from a chosen start frame to the current frame.

https://github.com/user-attachments/assets/11c7b4c1-26bc-430e-98ce-591356a67bf6

### 4. Draw <=> Pose Mode:

You can switch between the two views with ease.

https://github.com/user-attachments/assets/c3918ef7-fc7e-4c4f-ac00-5f4dc283e094

### 5. Quick set bones:
You can quickly place bones to roughly over their intended sprites with a single click.

https://github.com/user-attachments/assets/3f2f8328-a181-4533-80fe-db4521b1140d
</div>

## How to use:
1. There should be a Pixel Layer named "Pose Layer" in the project (It can be renamed later, once the extension has detected it). This Layer will be used to render the final "pose" of the frame.
2. The bones are given to groups (Arrange Groups as Bones in a skeleton).

## Controls (parts of the bone):
The extension gives you access to a new **Skeleton** tool (![Tool Image](https://github.com/user-attachments/assets/6002d741-87f9-42b2-9aee-acbb61bc91c0))

1. **The bigger circle** is the pivot, the image of the bone will rotate around this pivot. The pivot is set by hovering over the circle then hold (`Ctrl` + `Left/Right` click) key and move the mouse. Also, moving the pivot using (`Left/Right` click) will move the image instead of setting pivot.
2. **Smaller circle** controls rotation. Hold (`Ctrl` + `Left/Right` click) with mouse movement to move the circle without rotating the image (this is just to move it somewhere more comfortable). Holding (`Left/Right` click) and mouse movement Will rotate image.
3. **The solid line** joining the two circles does the same as the above (however the width of the line won't change this time).

The rest of the important stuffs are explained in [this video](https://youtu.be/RqCqg34G6Zg).