The Violence Tool - User Documentation

Welcome to documentation for The Violence Tool, a Grease Pencil layer management system designed for 2D animation workflows in Blender.

Note

Version: This documentation covers v2.0 of the tool, updated for compatibility with Blender 5.x and Grease Pencil 3.

Docs for previous versions of the tool are available using the version selector in the bottom-left corner of this page. Right now, v1.0 documentation can be found by selecting “Stable” and covers the original workflow for Blender 4.1.1 if still preferred.

See Versioning & Roadmap for the full roadmap and version comparison.

Warning

v2.0 Documentation — In Progress

This documentation is being updated for The Violence Tool v2.0. Some content may still reflect v1.0 workflows and has not yet been audited against the v2.0 codebase. If something doesn’t match what you see in Blender, please report it at: <https://github.com/Danweel/ProjectViolenceDocs/issues> or in the GreasePencil channel on Discord (which is faster if you have access).

Quick Start

1. New to Blender? Start with Blender Basics for Animators to learn navigation and essential shortcuts.

2. Ready to Install? Follow the Installation & Setup guide to get the tool running.

3. Ready to Start Animating? Learn the established workflow in AFIS Workflow Guide.

User Guide

• Installation & Setup
  • Getting these files
  • Prerequisites
  • Installing the Addon
  • Importing the Keymap
  • Verifying Your Setup
  • Configuring Keybindings
  • Updating the Tool
  • Opening Your First File
  • Saving Preferences
  • Common Setup Problems
  • What if I want to use this for my own project?
  • Setup Next Steps
• Keyboard Shortcuts Reference
  • Keybind Context & Blender Modes
  • Hotkeys that you may want to know
  • About Rex’s Keymap vs. Fred’s Personal Keymap
  • Binding Operators to Keys
  • Core Workflow Keybinds
  • Secondary Keybinds
  • Advanced Configuration
  • Workflow Tips
  • Keybinding Next Steps
• Blender Basics for Animators
  • Viewport Navigation
  • Quick Navigation Reference
  • Manipulating Objects
  • Object Modes
  • Basics Next Steps
• AFIS Workflow Guide
  • Prerequisites: Gap Settings & Visual Aids
  • Core Drawing Workflow
  • Drawing Techniques
  • Fill Workflow
  • Special Workflows
  • Layer Management
  • Animation Preparation
  • Common Issues & Solutions
  • Usage Next Steps
• Troubleshooting & Known Issues
  • Quick Reference Table
  • Keybinds & Shortcuts Not Working
  • Modal Toggles Getting “Stuck” (Auto-Merge, Draw Behind, Sculpt)
  • Fills Not Working (“Unable to Fill”)
  • Installation & Script Activation
  • Performance & File Size
  • Layer Management Issues
  • Known Issues for v2.0 (and Blender 5.1.2)
  • Reporting New Issues
  • Appendix: Blender-Side Bug Summary

Developer & Reference

• Operator Inventory
• User Scenarios
• Tests written for weakspots and fixes
• Versioning & Roadmap

Resources

• The Violence Tool — Keybind Cheat Sheet

—

Need Help?

If you encounter issues, check the Troubleshooting & Known Issues page or join the discussion on Fred’s Discord.

Contributing:

This documentation is open source, see our README.md and LICENCE files.

If you find errors or have suggestions, please open an issue on GitHub after reading our CONTRIBUTING.md.