Animal Crossing: New Leaf Pattern Tool

By Thulinma

Last updated: December 14, 2018

Questions / remarks / cookies? Please read the FAQ on the bottom of the page!


+
-






FAQ

ZOMG This thing doesn't work!

The ACNL pattern tool is completely written in HTML5 and JavaScript. As such, it requires a decently standards-compliant browser. The latest versions of Chrome / Chromium / Firefox work. No promises on anything else. Internet Explorer will probably choke on this entire page.

How do I use this thing?

Click a color on the 3x5 palette and then just "draw" on one of the pattern representations. All of the zoom levels are drawable and they will all update at the same time. When you want to import to ACNL, simply scan the QR code at the bottom using the QR machine at the Able Sisters in-game. Don't have the QR machine yet? Talk to the quiet sister in the back for 10 days in a row to unlock it. The download ACNL file button lets you save the pattern to your computer for later use. You can also upload ACNL files or images containing QR codes. Don't upload images containing multiple QR codes - multi-part codes need to be uploaded one at a time, in order.

How did you make this?

Mostly magic. It helped that I made the ACWW pattern tool, and ACNL patterns are mostly in the same format. As to how exactly it works - HTML5 and JavaScript.

I make use of the following JavaScript libraries from others (some with my own modifications or fixes), everything else is my work:

Wait if you made the ACWW Pattern tool - does that mean ACWW patterns can be imported?

Yeah, I plan to add that as a feature in the future.

This is open source? So I can re-use this code for my own projects?

Yes. Please don't claim you wrote it all yourself, and try to include a notice "Based on the ACNL Pattern tool by Thulinma" somewhere. You don't *have* to include a notice like that, but I will be very very disappointed in you if you don't.

Is there an offline version I can use without an internet connection?

Yes. This is the download link.

I made something better / fixed something / added more browser support!

That's not a question! But - yay! Drop me a line with your code changes and if I like them I'll migrate them into the main project.

Can I make a suggestion?

If you think you can program your suggestion yourself - go ahead, and see the "question" above this one. If you can't - I probably don't have interest in implementing it myself unless your idea is truly awesome (and/or I'm already working on it) - but you can always suggest it and who knows.

Why isn't my QR code being read? It works in the game!

I'm using the jsqrcode port from the zxing QR libraries. Unfortunately this port isn't very accurate and it has trouble with some QR codes. In fact, I had to make some fixes to get it to read ACNL QR codes at all (I've submitted the needed fixes to the author of the port, so everyone can benefit from them). Feel free to improve the library yourself and let me know if/when more fixes become available and I'll integrate them as soon as I can.

What are ".ACNL" files?

A small binary format storage for ACNL patterns. Similar to ACWW files, they contain the pattern and nothing more. For ACNL files I used the exact binary contents of the QR codes - so any QR code can be decoded into an ACNL file and any ACNL file encoded into QR.

What features are you still working on?

Some of the stuff I have in mind includes:

  • Importing stored ACWW files
  • Adding a pattern database with tagging/search
  • Experimenting with out of bounds color values (many values are not used in-game...)
  • Adding image conversion for pro designs
  • Figure out what the 6 bytes of unknown data represent
  • Add support for viewing/changing the pattern type

What is the changelog?

  • June 24, 2013: First working version, QR code generation.
  • June 25, 2013: Pattern editing (drawing), palette editing, title/creator/town and all related ID editing.
  • June 28, 2013: Firefox support, creator copy/paste buttons, loading ACNL files.
  • June 29, 2013: Loading QR code images now works, added an empty default pattern, removed old preset patterns (they were used without permission), added preliminary support for converting images to patterns (pretty low quality, but it works), improved the colors (now actual colors as they are in-game)
  • June 30, 2013: Support for pro patterns (both import and export), added pixel grid, added zoom buttons, added offline version download link in FAQ, added a selection box with 4 different image conversion optimizers
  • May 24, 2014: Still alive! Fixed a bug causing drawing to get stuck in several browsers. Fixed bug of having 16 shades of grey instead of the 15 from in-game. Updated jsqrcode for better QR code recognition. Added support for automatically attempting to recover from some corrupt QR codes. Special thanks to "Kiddiecat" for pointing out the drawing bug. Special thanks to "Michael New" for pointing out the 16 shades of grey bug. Special thanks to "Edel Fernández" for supplying a corrupt QR code.
  • December 14, 2018: A special update in honor of an important day exactly three years ago. Spit-shine and polish, CSS improvements and some minor typos corrected by "Myumi Kalinowski". Added 3D render for shirt and dress modes. Added ability to change pattern type as well as create other types than the standard type from scratch. More updates coming soon. Maybe. We'll see!

How do I contact you?

You can e-mail me at thulinma@thulinma.com - but please keep in mind I'm a busy guy so don't e-mail me unless you have a worthwhile contribution or something similar. :-)