Workflow

The character-art pull-request checklist

10 min read

The character-art pull-request checklist

It's 2 AM. Your hero's left arm pops out of socket on every other run-cycle frame, and your demo is in nine hours. You just pulled the latest character art, and now everything is broken. This isn't just a bug; it's a late-night crisis that every solo or small-team developer faces. The joy of new art quickly turns into debugging a ragdoll mess when you're trying to get a build out the door. A chaotic art pipeline costs you sleep and progress, making that character-art pull-request checklist feel like a lifeline.

1.The hidden cost of

We've all been there: a new sprite sheet arrives, you drag it into Unity, and suddenly your character looks like a tangled mess of limbs. What looked perfect in Aseprite becomes a nightmare in the engine. This isn't usually due to bad art, but rather a disconnect in expectations between the artist's output and the animator's input. ==The

Illustration for "The hidden cost of"
The hidden cost of

a.Why a checklist isn't just for code

Code reviews and pull requests are standard practice for good reason. They catch bugs, ensure consistency, and distribute knowledge. For character art, the stakes are equally high. A malformed sprite sheet or an incorrectly rigged asset can halt animation, break builds, and even introduce subtle visual glitches that are hard to track down. A dedicated checklist provides a shared standard, catching issues before they become deeply embedded problems. It's about preventing tech debt in your visual assets.

Without a clear process, every art asset becomes a bespoke integration challenge. You spend hours manually adjusting pivots, renaming layers, or even re-slicing images because the initial setup wasn't quite right. This repetitive, manual work saps development time and frustrates your team. Standardizing the art pipeline frees up creative energy for actual game development, not firefighting.

  • Missing pivot points on critical layers.
  • Inconsistent layer naming across different sprite sheets.
  • Source files saved in non-standard formats (e.g., .psd instead of .png).
  • Characters designed with unworkable joint limitations for skeletal animation.
  • Art assets that don't match the project's scale or resolution.
  • Animations with incorrect loop points or missing frames.

2.Before you even touch a pixel: The spec sheet is king

Every great character starts with a solid plan, not just a sketch. Before any art is produced, define your technical constraints. This includes things like overall character dimensions, target pixel density, and the number of animation states. A clear spec sheet prevents costly rework down the line, ensuring that the art fits the technical requirements of your game engine from day one. Don't let your artist guess.

Illustration for "Before you even touch a pixel: The spec sheet is king"
Before you even touch a pixel: The spec sheet is king

a.Defining your character's technical blueprint

Think about your game's visual style and engine limitations. Are you targeting a pixel-art aesthetic where every pixel matters, or a more fluid, vector-like look? For a 2D platformer, your character might need specific collision box dimensions and a consistent ground pivot. Establish these technical specs early to guide your artist, preventing assets that are technically unusable. This blueprint is your first line of defense.

  • Target resolution for sprites (e.g., 64x64, 128x128).
  • Max texture size for sprite atlases (e.g., 2048x2048, 4096x4096).
  • Pixel-to-unit ratio in your game engine (e.g., 16 pixels per unit).
  • Required animation frame rate (e.g., 12 FPS, 24 FPS).
  • Color palette restrictions for pixel art. Aseprite is great for this.
  • Joint count limits for skeletal animation, if applicable.

b.The power of consistent naming conventions

A good naming convention is like a map for your assets. It helps you quickly identify body parts, animation states, and even variations. `Player_Torso_Front` is far more useful than `Layer 1`. This isn't just about tidiness; it's about automation potential. Tools can parse these names to automatically assign layers to bones or sort animations. Adopt a strict naming convention for all art files and layers to streamline your workflow.

If your character's walk cycle takes more than an hour to integrate, you're solving the wrong problem. The issue isn't your animation skill; it's your asset pipeline.

3.Preparing your PNGs for animation: The layered approach

For skeletal animation, your character art needs to be dissected into individual, layered PNGs. Each movable part โ€” an arm, a leg, a hand โ€” should be its own file. This allows your animation tool, like Charios, to manipulate these parts independently. Exporting a single, flat image is a common mistake that makes skeletal animation impossible. Think of it like building a digital puppet.

Illustration for "Preparing your PNGs for animation: The layered approach"
Preparing your PNGs for animation: The layered approach

a.Slice and dice: Each part its own file

When you design your character, consider the overlap and hierarchy of body parts. A forearm should overlap the bicep, and the hand should overlap the forearm. This ensures smooth deformation and prevents gaps during movement. Each of these distinct parts needs to be exported as a separate PNG with transparency. Make sure there's enough padding around each part to allow for rotation without revealing edges. Careful slicing is crucial for clean animation without visible seams.

Quick rule:

  • Every movable joint requires separate parts above and below it.
  • Ensure sufficient overlap between connected body parts.
  • Export as PNG with transparency.
  • Name layers clearly, following your naming convention.
  • Check that pivot points are logically centered for each part.

b.The crucial importance of pivot points

A pivot point is the center of rotation for each sprite. If your character's elbow pivot is in their wrist, their arm will swing wildly. Setting these correctly in your art software, or verifying them post-export, is non-negotiable. Incorrect pivots are a leading cause of unnatural-looking animation, often requiring tedious manual adjustments in the animation tool. Get them right the first time to save hours of pain.

4.The skeleton dance: Rigging it right the first time

Rigging is the process of building the skeletal structure that will control your layered character art. This involves placing bones and defining their parent-child relationships. A well-constructed rig mirrors the natural movement of a body, whether human or creature. A robust rig is the foundation for believable animation, especially when working with motion capture (mocap) data. Tools like Charios allow you to snap your layered PNGs directly to a fixed skeleton, simplifying this process.

Illustration for "The skeleton dance: Rigging it right the first time"
The skeleton dance: Rigging it right the first time

a.Building a logical bone hierarchy

Your character's skeleton should follow a logical hierarchy, starting from a root bone (often the hips or torso) and branching out to limbs and extremities. Each bone's child moves with its parent. A common mistake is to create a flat hierarchy or to misparent bones, leading to disjointed movements. Visualize how each part moves in relation to others before you start placing bones. This foresight prevents complex re-rigging later.

  1. 1Start with a root bone (e.g., 'Hips' or 'Spine_0').
  2. 2Build the main torso chain (Spine, Neck, Head).
  3. 3Attach shoulders and arms to the upper spine.
  4. 4Attach legs to the hips.
  5. 5Ensure correct parent-child relationships (e.g., 'Hand' is child of 'Forearm').
  6. 6Place bones at natural joint rotation points (elbows, knees, wrists).

b.The contrarian view: Not every character needs a full rig

While skeletal animation offers immense flexibility, it's not a universal solution. For very small, simple characters or specific particle effects, frame-by-frame animation can be faster and more expressive. Think about a tiny bird flapping its wings or a quick explosion. Rigging everything is often overkill for minor assets, adding unnecessary complexity to your pipeline. We sometimes get too caught up in best practices and forget about efficiency.

Frame-by-frame for NPCs is not malpractice; it's often the smartest use of your limited time. Don't rig a flying pixel if it just needs a few frames of movement.

5.Bringing it to life: Animation data and retargeting

Once your character is rigged, it's time to animate. For many indie devs, this means leveraging existing animation data rather than keyframing every movement from scratch. Mixamo offers a vast library of 3D mocap animations, and with tools like Charios, you can retarget Mixamo data on a 2D rig. This can save hundreds of hours. Efficient use of mocap transforms your animation capabilities, even with a small team.

Illustration for "Bringing it to life: Animation data and retargeting"
Bringing it to life: Animation data and retargeting

a.Retargeting mocap: The magic bullet for indie devs

Retargeting motion capture data involves mapping the movements of a source skeleton (like a Mixamo rig or a BVH format file) onto your character's custom 2D rig. This process requires a consistent bone naming scheme and similar joint structures. Mismatched bone names or incompatible hierarchies will lead to broken animations, so careful preparation is essential. It's not plug-and-play, but it's close.

  1. 1Ensure your 2D rig bone names match the mocap source (e.g., 'LeftArm' vs. 'L_Arm').
  2. 2Verify bone orientations; sometimes a 90-degree rotation is needed.
  3. 3Check scale differences between your rig and the mocap data.
  4. 4Adjust joint limits on your 2D rig to prevent impossible poses.
  5. 5Test with a simple walk cycle first before complex animations.
  6. 6Clean up any jitter or foot sliding post-retargeting.

When retargeting, pay close attention to bone length and proportion. While a 2D rig doesn't have the same depth as 3D, the relative lengths of limbs still affect how mocap data translates. If your character has cartoonishly short legs, a realistic mocap walk cycle might look strange. Adjusting your rig to better match the mocap source's proportions can greatly improve the visual quality of the animation. This is where Charios vs After Effects for animated shorts shows its strength.

6.Testing in engine: The real-world check

The animation might look perfect in your dedicated animation tool, but the game engine is the ultimate judge. Differences in coordinate systems, rendering pipelines, and even physics can introduce subtle (or not-so-subtle) issues. Always test your animations directly within your target engine, whether that's Unity, Godot, or a custom framework. This step catches integration problems early.

Illustration for "Testing in engine: The real-world check"
Testing in engine: The real-world check

a.Checking for scale, pivots, and visual glitches

Import your animated character into a blank scene in your engine. Check its scale against other game assets. Verify that the root pivot is at the character's feet for proper ground alignment. Look for any texture bleeding, strange layer overlaps, or unexpected deformations during movement. These visual anomalies are often due to incorrect import settings or subtle mismatches between your art tool and the engine. Platformer character animation: a complete 2D guide often covers this.

  • Is the character's scale correct in the engine?
  • Are all layers rendering as expected, with correct Z-order?
  • Are there any gaps or seams appearing between body parts?
  • Does the animation loop smoothly without hitches?
  • Does the root pivot align with the character's base?
  • Are there any performance issues with many animated characters?

b.The dreaded

Sometimes, an animation will look fine in the editor but break during gameplay. This might be due to physics interactions, script conflicts, or interpolation issues when blending between animations. For instance, a character might suddenly snap to a default pose if an animation controller state isn't set up correctly. Always test animations under actual gameplay conditions to uncover these hidden bugs. The more scenarios you test, the more robust your character will be.

7.Final checks before merging: Export and optimization

Before you commit that character art to your repository, perform a final sweep of export settings and file optimization. Incorrect export formats, bloated file sizes, or unoptimized textures can severely impact game performance. Your goal is to deliver a lean, efficient asset that integrates seamlessly and doesn't stress the game engine. A clean export is the final step in a polished character art pipeline.

Illustration for "Final checks before merging: Export and optimization"
Final checks before merging: Export and optimization

Consider your target platforms. Mobile games require aggressive optimization for texture size and draw calls. Even PC games benefit from efficient assets. Don't just export; optimize. Compress textures, combine sprite sheets where possible, and ensure your animation data is as compact as it can be. Tools often have settings for this, so explore them.

a.The export checklist for various formats

Whether you're exporting a GIF, a Unity-prefab zip, or a custom format for your engine, each has its own requirements. For GIFs, check loop settings and frame rate. For Unity, ensure your prefab correctly references all textures and animation clips. Always double-check the export logs for warnings or errors, as these can indicate underlying issues with your asset. This is where the flexibility of Charios export for Meta Ads or other platforms shines.

  • Exported PNGs are optimized (e.g., using TinyPNG).
  • All animation clips are included and correctly named.
  • File size of the exported asset is within acceptable limits.
  • Naming conventions are consistent across all exported files.
  • Any meta-data files (e.g., .json for skeletal data) are present.
  • Preview the final export in a viewer or test scene.

8.Your next character art pull request will be smoother

Building a robust character-art pipeline takes effort, but the payoff is immense. You'll spend less time debugging broken assets and more time creating compelling gameplay. This checklist isn't just about preventing errors; it's about empowering your artistic vision by removing technical friction. A consistent workflow means faster iterations and higher quality results, letting your characters truly shine.

Illustration for "Your next character art pull request will be smoother"
Your next character art pull request will be smoother

Take this checklist, adapt it to your specific project needs, and integrate it into your development process. Start with your next character art pull request. If you're struggling with mocap on musical cue in 2D or simply getting your layered PNGs to behave, consider trying Charios. It's designed to make this entire process, from layered PNGs to exported animations, as painless as possible. Your future self will thank you for the sleep you save.

Charios team

We build a browser-native 2D character animation tool โ€” drop layered PNGs onto a fixed skeleton and retarget Mixamo or BVH mocap onto the rig. Try Charios โ†’

Published May 12, 2026

FAQ

Frequently asked

  • How can a checklist prevent character art from breaking after a pull request?
    Implementing a character art pull-request checklist is crucial to prevent integration nightmares. It ensures all new assets adhere to technical specifications, use consistent naming, and have correctly set pivot points, saving countless hours of debugging broken rigs and animations. This proactive approach catches issues before they become late-night crises.
  • Why are pivot points critical for layered 2D character animation?
    Incorrect pivot points are a leading cause of 'popping' and misalignment in 2D animation. Each layered PNG part must have its pivot set at its natural rotation point, like a shoulder for an arm or the base for a head. This ensures smooth, natural movement when the character is animated or retargeted, avoiding visual glitches.
  • Can Mixamo animations be used with 2D character rigs?
    Yes, with the right tools and process, Mixamo animations and other BVH mocap data can be retargeted to 2D rigs. This often involves mapping the 3D bone structure to your 2D character's bone hierarchy, allowing indie developers to leverage vast libraries of professional motion capture. It's a powerful way to achieve complex animations efficiently.
  • Does Charios support retargeting Mixamo or BVH mocap data onto 2D character rigs?
    Absolutely. Charios is built to make 2D mocap retargeting straightforward. You can import 3D mocap data like Mixamo or BVH, then map it directly onto your 2D character's bone structure, enabling complex animations without manual keyframing. This dramatically speeds up animation workflow for 2D games and projects.
  • When is a full, complex 2D character rig unnecessary?
    Not every character needs a full, intricate rig with dozens of bones. For simple background characters, UI elements, or characters with very limited motion, a basic skeletal structure or even just frame-by-frame animation might be more efficient. Over-rigging can add unnecessary complexity, increase file size, and slow down your development process.
  • What essential information should a 2D character art spec sheet include?
    A robust spec sheet should detail expected dimensions, resolution, file formats (e.g., PNG), required layering, and consistent naming conventions for files and layers. Crucially, it must include clear instructions for pivot point placement and specify the target skeleton structure. This blueprint minimizes misinterpretations and integration errors.

Related