Supercell Animate

Supercell Animate is a custom platform addon and extension for Adobe Animate. This extension will allow you to create custom documents and export content of your library directly to a .sc file.

Disclaimer

This repository does not provide any instructions on how to modify any Supercell game or their assets. All information and all Assets were taken from public sources. You assume all risks from the use of this tool.

Table Of Content

• Export features
• How to use
• Limitations
• Issues
• Requirements
• Installing
• Updating
• Dependencies
• Building
• Examples
• Changelog
• Authors
• Support

Support

This project was created with the goal of exploring various interesting tools and to support a small but quite creative community of modders. I put a lot of heart and time into this creation, so if you want to support me, you can buy me a coffee right here :3

Export features

• Stroke / Fills / Brushes ✅
  Full support. It can be unstable sometimes especially with big fills and curves so try to work more with sprites

  • Fill styles ❌
    Now only solid color works and there are no plans for other styles.

• Filters ❌
  There will be no support for filters for Symbols

• Scripts (ActionScript, JavaScript) ❌
  .sc file does not support any scripts

• Sounds ❌
  .sc file does not support sounds

• Parenting / Camera / Advanced Layers ❌
  There are currently no plans for support.

• Text ✅
  Partial support

• Symbols (Graphic, MovieClip) ✅
  Full support except for "Button" type

  • Blending modes ✅
    Full support. But note that some modes may not work or crash.

  • Transform ✅ 2D Transforms are fully supported. 3D transformations have a potentially small range of uses and a small chance of being supported.

• Layers ✅
  All types of layers are supported: Normal, Masks, Folders, Guides Also note that all symbols from guide layer will be ignored and will only be used for animation if necessary.

• Classic / Animation tweens ✅
  Absolutely all types of animation tweens and their types of interpolation are supported.

• Shape animation ✅
  Full support. Be careful when using it, the result can be very unstable.

• Nine-slice ✅
  Full support. But keep in mind that on Animate 2024 and above this may not work correctly.

How to use

• Check requirements, make sure everything is satisfied
• Install or build extension
• Open your Adobe Animate and go to New Document panel
• Create new "SupercellSWF" document:

• Create something!
  In examples you can find good and different use cases for extension in different games!
  Also, before creating something, do not forget to read information about "limitations" that will help you not to create any problems.

• To set export options you need to click "File -> Publish Settings.."
  You can set all options here for the first time only once and then just press "Publish" button. You can also find a description of all options in "Publisher options"

• After setting all options, you can click on publish button. You are great!
  Then you just need to wait until file is saved.

Limitations

• Color transforms
  Be careful when transforming colors. Color values can only be positive, otherwise these values will be set to zero and the result will be undesirable.

• Text Fields
  Text fields are covered with a large layer of mystique.
  But there is also support for basic things here. Also be careful, not all settings can somehow affect text in final file (because they cannot be disabled, Animate just crashes)
  Also, text must have no more than 255 characters, otherwise text will not be written to file. To enable text outline you need to add "Glow" filter to text field

Requirements

For extension to work correctly, you need:

• Adobe Animate 2020 or higher
• Windows 10 x64 or Windows 11

MacOS support will be available one day, but it is not a priority at all right now.

Installing

First of all, download .zip package from Releases
Unpack zip to any place convenient for you.
Inside archive there is a file install.jsfl. You need to run it in Adobe Animate.
By default, .jsfl is associated with Animate, so you can double-click on it and run it as a command, but if something is wrong, you can open it in Animate itself as a script and click on run button.
After installation is complete, be sure to restart Animate. If you want to remove plugin, run install.jsfl again, and this time you will see a confirmation button.

Plugin Update

If you have an already installed plugin and want to update, run installation file and remove plugin, restart Animate and install plugin as usual.

IMPORTANT

If you are using version 1.2.0 and lower, you MUST remove extension files MANUALLY. If you do not do this, then installation may not be successful.

Building

Before starting you need to have:

• npm and node.js
• Typescript and ts-node
• MSVC Build tools (Visual Studio)

Instruction will be divided into 3 parts, instructions for building Plugin, Publish settings and installer:

• Installer
  Install node modules inside installer folder with command:
  npm install

• Publish Settings
  Open console in publisher folder and enter following command to install all dependencies needed for build:
  npm install --save-dev
  After installation, just if you want you can try to start test local server with command:
  npm run start
  Try opening localhost:8080 in your browser. If page works and you see publisher interface, then everything is OK!

• Plugin
  Install node modules inside plugin folder with command: npm install
  And make sure you have installed Visual Studio with C++ build tools and also Cmake which should be in system variables or PATH. That's all!

Next, after preparing all modules, you need to open console in root of repository.

• Debug
  If you want to use a debug build then make sure you have CEP debug mode enabled. You can read more about CEP Here
  After that you need to use this command:
  npm run build:dev
  After execution, extension should load into Adobe Animate.
• Release
  To build a installer with all packages, you need to fill in certificate details in scripts/cert.ts and then run following command:
  npm run package After the command completes, installer files will be available in dist/package folder.
  You can run it or zip and share.

Examples

You can find a list of all available examples in "examples" folder.

Issues

If you find any problem with export process or you just need any help, please report it in Issues or join our Discord Server
Also, native part of plugin saves logs in "%temp%/org.scWorkshop.SupercellSWF_export_log.txt", please provide them along with a description for a faster solution to the problem.

Changelog

v 1.3.0

• Improved Atlas Generator
• Added SC2 support
• Many performance improvements and code refactoring

v 1.2.1

• Added experimental installer

v 1.2.0

• Complete refactoring of code
• Changed and improved design of Publisher Settings
• More animations for Publisher progress window
• Improved support for Fills and Strokes. Added rasterization to sprites
• Added new algorithm to reduce shape object count
• Added support for 9slice scaling
• More bugs

v 1.1.0

• Added support for blend modes
• Added basic support for solid fills and stroke
• Added experimental shape animation
• Added support for group

v 1.0.1

• Fixed sprite transformation
• Updated localization

v 1.0

• First release. Basic export to .sc file