BG Auto-Scroll Toolbar
A downloadable tool for Windows, macOS, Linux, and Android
Community Showcase Vol. 2 Has Been Released!
Creating scrolling backgrounds made much easier and WAY FASTER!
Requires Aseprite Version 1.2.22 or newer.
On June 24th 2020 a user by the name of "Red-Halo" on the Aseprite Discord was in search for a way to animate scrolling backgrounds in a much faster way. I saw this comment and thought this feature could be very beneficial to the community. So naturally I rolled up my sleeves and got to work.
This toolbar started out quite small but has evolved exponentially. Due to this reason I decided that this needed to be its own separate toolbar apart from my main "Carbs Toolbar".
Features:
Minimize To Reduce Its Presence When Not In Use
Built-In Info / Help Section For Quick Reference
Supports 8 Directions Of Scrolling
Supports Multiple Layer Speeds / Parallax
Each layer can be set to a separate speed. Useful for layers that are farther away!
Supports Multiple Layer Directions
Each layer can be set to animate in a separate direction!
Animations Are Inserted At Cel Selection
This allows animations to have other frames that are not animated. Also allows you to produce a pause like effect.
NEW! Toolbar Auto Resize (Now Working)
Toolbar should now properly resizes its self even when using the file menu to launch the toolbar. (Previously the resizing only happened if you had the toolbar set up on a hotkey!)
The toolbar resizing should also now work properly with the following themes:
- Default
- Dase
- Minimal Dark HD
- Dark Mort HD
Let me know you use another theme I would love to test and support it!
Community Showcases
Check out these awesome examples of scrolling backgrounds!
Vol.1
Vol.2
Check the video descriptions for all the links! :D
If you would like to share your own scrolling BG art be sure to tag @CarbsCode , use #CarbsTools on Twitter or leave a comment below with a link to your art so he check what you have created!
I can't wait to see your scrolling backgrounds!
To install / Run:
- File > Scripts > Open Script Folder
- Place BG Auto-Scroll Toolbar.lua in this folder
- Restart Aseprite
- File > Scripts>BG Auto-Scroll Toolbar to open
Currently the toolbar scrolls the entire canvas in the selected cel. Hope to add a selection option in a future update where it will only scroll a set selection of the cel :)
Hopefully the links in the thank you section are working in the mac and linux version. I am unable to test these versions so let me know if they are broken for some reason or if they are working correctly! Thanks guys!
--Simple Usage License / Rights--
Simple Usage License / Rights © CarbsCode 2021 - 2024 All Rights Reserved.
By using the script included with this file you understand that you are using it ASIS with no guarantees.
Though the script / toolbar is not intended to cause any harm, you understand that any such harm, such as lost of work,time or any other issues financial or otherwise, CarbsCode can not be held responsible. Always save your work regularly!
Please use at your own risk! If you change any of the script that may cause issues support may or may not be available.
CarbsCode reserves the right to revise this license as needed.
YOU CAN / SHOULD:
Use this script as a toolbar to assist in Aseprite for personal and/or professional use.
Learn from the code within.
Make changes as you see fit for your use-case. However support may not be available for modified scripts so do so at your own risk.
YOU CAN'T / SHOULDN'T:
Re-sell, copy, transfer or distribute entire script or parts of this script without permission.
Usage of this tool in any training of AI (Artificial Intelligence) models with out permission is not permitted.
Usage of this tool to create NFT (Non-Fungible Tokens) is not permitted.
------------------
Please report any bugs if you find some and Carbs will try and resolve as soon as possible!
Hope you all enjoy the tool! Please feel free to reach out or leave a comment if you have any issues or feedback!
❤ Thank you all for the amazing support ❤
Bugs / Feature Requests:
Please check out the new issues page if you find any bugs or want to make a feature request!
Purchase
In order to download this tool you must purchase it at or above the minimum price of $3.75 USD. You will get access to the following files:
Development log
- Community Showcase Vol. 2 Video Released!May 03, 2022
- Community Showcase #2 Coming Soon! Submit Your Art Today!Jan 05, 2022
- Community Showcase! Thank You For Your Submissions!May 30, 2021
- BG Auto-Scroll Toolbar 1.1.4 Left And Right Loop Fixes Whoops 😰May 19, 2021
- BG Auto-Scroll Toolbar 1.1.3 Major Bug Fix!Apr 15, 2021
- BG Auto-Scroll Toolbar v1.1.2 For Windows / MacOS / LinuxSep 24, 2020
- BG Auto-Scroll Toolbar Now Available For Windows / MacOS / Linux!Jul 05, 2020
Comments
Log in with itch.io to leave a comment.
Aseprite can't load (filepath) file ("lua)
getting this error when I attempt to install on windows:![]()
Which version of aseprite? Ive not see this error before. Would you be able to post a screen shot?
Hello, I am a fool who can't write scripts,but you are a genius! I have been looking for a script to import psd files into aseprite, If I just import lines and colors from the normal layer of the PSD file (without any effect) into aseprite, will this be difficult to achieve? Honestly, I really hope you can help me (i will pay you).
Hello there, thank you for reaching out and thank you for your kind words! I would love to help on this but currently i don't think i could take this one on.
Ive look in to this a bit and it does seem there is an psd exporter script available, however it does not import psd to aseprite.
When looking over the script and it looks really quite complicated and they seem to be creating a binary file from scratch. Basicly this process would need to go the other way looking at a binary file and taking it apart which might be doable but I'm not sure how long it would take to make sure it's working correctly.
Here is a link to the script I found that exports to psd though! Just for reference.
https://github.com/Tsukina-7mochi/aseprite-scripts/tree/0ccb70e8cbf8e42545c41b12...
This might be something that eventually gets added to aseprite though again it's really quite complicated to get it working correctly. Espcially if Adobe changes anything in their file format. Something to look at in the future for sure though!
Thank you for your reply! Ok, I see what you mean
Does this script not play well with indexed colours? it sometimes recolours my layers unless I set it to RGB. Otherwise a super handy tool. :)
Ah yeah v1.1.4 has the color mode issue. I've already got the fix for this implemented for the next release though! :D
More info on the bug tracker here:
https://github.com/CarbsCode/CarbsAsepriteExtensions/issues/7
And yeee thank you for your kind words! I'm glad you were able to find this :D
Awesome! Can't wait to try out some more of your stuff.
Absolutely! Thank you for your support! Feel free to reach out if you have any troubles at all 😀
thank you very much for a simple and very necessary tool))) the result can be seen on my page))) I made the parallax effect everywhere))))
I rate the tool - 1000/1000
Ayeeee! This looks awesome, your page has def got the scrolling as well 😆
Thank you for your kind words, glad your enjoying the tool! 🥰
Hi! Recently I bought an autoscroll toolbar for Aseprite. It worked perfectly for months, but it stopped working today for some reason. Instead of creating animation frames, it renames other frames above and creates new files, which disappear in a second. I don't know what's wrong. I tried to restart it but it didn't work. Can you help me, please?
I just found out that 1.3.3 is where this is happening.
I'm guessing your on aseprite 1.3.3 that just updated a few days ago D:
It seems there is some major issues with transactions in 1.3.3, I've reached out directly to Aseprite this morning to see if there was an unnoted change.
TO FIX FOR NOW:
https://gyazo.com/3d09d01bd54afaa358e3c330e5d08d80
Simply revert to 1.3.2 like so and everything will work again!
Sorry about this! Sometimes things are out of my control and it's inside aseprite itself. I'll be digging deeper in to this if there is something I need to change for 1.3.3 but so far nothing on the docs says there was a change :(
Good Afternoon! This has been resolved and patch in the Aseprite v1.3.4 :D Latest Aseprite should restore this back to working again!
Wait wtf, this post is mentioning me, I stumbled on this by accident. lol
Omg you never downloaded this tool?!?!?! No way hahahaha Dude let me send you a key for goodness sake. You were looking for a this feature so I made it way back then 😆
Some time ago, I purchased this tool, which was delivered to me via email, but it does not appear in my library. Is there any way to solve this issue?
Hmm looking in to this I do see the purchase, it looks like it was a gift? You might be able to add it to your library by clicking the link in the email 😀 Let me know if it doesn't work though I can send another key if needed as you should have access. 😀
In actuality, I am not sure how the system registered my purchase. I still have access to the download page from my email, but I am unable to link it to my library. If possible, I would like it to appear in my library for the sake of organization, as I have to constantly avoid deleting the aforementioned email. Additionally, I would like to express my gratitude for creating such useful tools.
I have had the opportunity to acquire most, if not all, of the published materials and I am eagerly anticipating the release of the new ones.
Im not excatly sure how it works on the back end either but I sent you over a key which should allow you to claim the tool and add to your library 😀
Thank you so much for your kind words and gratitude! The tools take a lot of work to make so it's quite nice to see and hear they are being so useful!
I do have atleast a few tools in the works which I hope to release soon enough! So def be on the look out for those 😀
Appreciate all your support and hopefully this works for you!
Is there a way to animate a layer that has animation?
Up, down, left, and right work fine but Diagonal isn't working right. It duplicates in different areas which seems weird to me
Uh oh! Any chance you might be able to send a gif or video so I can see what's going on?
There seems to be a bug where animations going left or right don't match at the end of the loop. All other directions are working as intended. But the loop is wrong for left and right directions.
Love the script tho!
Oh gees that's not good xD I wonder if I broke left and right when I fixed up down and diagonals D:
I will take a look at this today when I get home from work :)
Any chance you could send me an example?
The only thing I can think of, if I didn't break something recently, would be that the ratio between the canvas size and the # of frames might result in a funky math leaving an extra pixel shift or something at the end. Also might deleting the last frame fix this for you? Any extra information on size and what's inputted in to the toolbar will help debug 😀 and fix up more quickly!
As a triple check if you could let me know what version of the toolbar and aseprite you are using aswell that would help a ton too 😀
I'm super glad your finding it useful btw! It's honestly my favorite of the tools that I've made so far because you get instant smooth results and if you don't like it you can undo in one quick step and try again 😀
Thank you for reaching out too! With out it its much harder to find issues 😆
Oh gees yup I see what is happening. I must have broke this in my last update. I will get this fixed up today!
I've figured out what the issue was. It was so small but a real bugger to find lol 😆
In lua the "or" operator works a bit differently then I had though. With some of my math related to horizontal shifting and vertical shifting I had used it like so:
If direction = "Left" or "Right" then
<Math stuffs here>
But it should have been:
If direction = "Left" or direction ="Right" then
<Math stuffs here>
See how little a difference this is but because both Left Right and up down do shifting it was shifting extra causing the issue 😆
TLDR:
I will put this update out today and this will be working in all directions again 😀
Update 1.1.4 this will be fixed so be sure to grab it when its up 😀
This update is now out :)
Duude! Awesome! Really glad that you found the bug!
Thanks! :D
Yee! Your welcome! Thank you for bringing it to my attention! 😀
Now you can make the nice smooth animations again 😆
Awesome script! The only issue I see is that there is a tiny stutter when an animation fully loops. You have to really be watching closely to see this problem. Is there a duplicated last frame or something? Can this issue be fixed in an update? Then this script would really be perfect!
Sorry for the delay!
I think that I might have found this issue, was it happening only on up down or diagonals? Left and right was okay or was it also happening on left and right?
I just uploaded an update which fixed some stuttering issues hopefully this was the issue you had!
Let me know if it's still doing it after you update :D
This tool is a life saver. The days of creating parallax animations manually is gone.
Yeah! I'm glad you're finding it quite useful!
Would love to see what you create with it :)
One more great script from you. Thank you very much. I tried this script in Asperite for Linux (on Debian GNU/Linux) and everything works fine. Links in the "Thank You" section are working too. They correctly open in the default browser after clicking a button "Allow Execute Access".
Awesome! Glad to hear everything is working as planned :) I do wish I could test these things out but its good that you were able to try it out and make sure :D So thank you for confirming this! Its quite helpful especially for future development as I know it will be working :)
And you are quite welcome! Its pretty great that I'm able to make something quite useful for the community :)
I tested the script on Debian. The most common and popular Linux distributive is Ubuntu. Ubuntu is based on Debian. So in most cases this should work without problems. Some distributives may have some specific dependencies but this is a rare case. Thanks again for the script. Parallax animations created by your script look amazing and fantastically easy to make. It can save hundreds of hours.
Heck yeah! Thanks again for testing that :) would def love to see your scrolling backgrounds!! Its really fun to play with haha
how do you use the bg scrolling effect inside of unity or game engines?
You could export the animation either as a gif or as a spritesheet if your wanting to use just this animation you've set up.
However in a game engine you might be better off just importing each layer and writing some code to handle this.
Its a bit complicated but I know in Godot there is an option in the texture to have it repeat which could be used some how. I'm sure unity also has an option as well but I've not used unity yet.
Also, another idea I've seen before is a technique where you take the image and tween it to the left lets say and then spawn a copy all the way to the right off screen and keep that going which also moves to the left. Essentially while the one is moving off screen another is moving in to its place creating a loop effect.
I know there are probably atleast a couple handfuls of ways to do this though! :)
ok. and say no to godot. used it for 6 months not going back. I am used to using lot of other softwares besides godot. It don't support those export or don't have a plugin for it. And no m not wasting my time to make plugin for it. On the other hand unity has all plugins and works out of box. No crashes either. I got tired of godot T_T. So say no to godot aka GOAT! :P
Interesting I've actually had nothing but good experiences with Godot over the past couple years. Though I guess having experience in an engine is what you got to do to understand it more :) This is also why I don't poo poo unity because I haven't used it enough. I think they are both very great engines with tons of functionality. I agree sure Godot may be missing some stuff but thats the power of open source some one could make it happen :)
Out of curiosity what were you trying to import? They have been adding alot of support lately :)
Either way I think once you find an engine its quite hard to swap to another. Atleast not as easily. Bit of a transition haha
This is why I'm glad we have choices we can all use what we want and in the end its all about what we make with them :)
Try making any 3rd party plugin for godot. An example would be making spriter animations work in godot or spine among many others.I have used 12 game engines so far. Keep coming back to unity. Unity is also annoying. Also 20x more resources for unity than any other engines combined. I am a fan of making my games finished or product released. So whatever tools makes it easier and have more solutions i tend to use it. Godot is awesome by itself and if u don't plan to use not many 3rd party software. Its mainly geared towards intermediate or expert programmer or hobbyists.
To each their own I guess :) Again this is why its nice that we have options :) People have different needs and preferences. No harm in that :)
Personally I would rather figure things out my self then use a bunch of plugins especially when making games only because it gives you the freedom to do literally anything and your not restricted by what the plugin has to offer :)
Sure you could toss together a game that is 90% some one else's plugin but whats the fun in that and its super hard to debug or expand on because the plugins doesn't do that one thing you needed haha
But again that's just me I totally get that plugin make it easier to get the idea rolling but feel like using too many and relying on them could stunt your abilities especially when the plug in maybe stops working or something D:
I've actually heard great things of unity but often oven also seen people struggle with it too. Same can be said for godot. Sometimes the node system isn't for everyone. Again personally I find it quite intuitive :)
Works perfectly! Super pumped to see what will come from this. Thank you for the clear, concise directions in the info section. Sent a tip for it. Thank you again!
Thank you very much Xuriah! You are quite welcome, I tried my best to try and polish everything as much as I could :D I'm also hoping to make a little video on it showing off some cool techniques too!
Here is the little scene I might use for the video :3
Mountain Scene Night via CarbsCode Twitter
Annnnddd here is the video XD Working fast here! :D
Thanks for sharing this wonderful addition aseprite!
Absolutely! Hope you have a great time with it! :D Let me know if you have any troubles. Also would love to see what you create with it! :D Very fun tool to play with hahaha