Extensions, or also known as Objects, allow the user to expand the functionality of Fusion by either installing additional Extension Packs, purchasing extensions from the ClickStore or by downloading from the Extension Manager (Fusion 2.5 only). Extensions are compatible with both Standard and Developer editions of Multimedia Fusion 2 and Clickteam Fusion 2.5, and will appear in the “Create new object” dialog once installed. The Games Factory 2, demo and free edition do not support extensions, and some are exclusive to the Developer versions or certain runtimes only.
There are over 360 extensions available from both Clickteam and third party developers, with more in development. It will be impossible to document every single extension out there. However, EncycloFusion will do its best to list the vast majority of them.
Contents
- Extension List
- Default Objects
- Sources of Extensions
- Installing an Extension
- Built-in Objects Across Exporters
- Writing Your Own
- Common Problems
Extension List
EncycloFusion aims to achieve a number of past, present and future extensions. Note that not all extensions can be documented.
Extension Categories:
- 3D
- Firefly
- Android
- Audio
- Backgrounds
- User Input (Controls)
- Data Handling
- Database
- Events
- File Management
- Games
- Graphics and Animations
- HTML5
- Interface
- Internet
- iOS
- Math
- Movements
- Network
- Other Objects
- Physics
- Printer
- Protection
- Script
- Storage
- System
- Text
- Time
- Video
- XNA
Default Objects
These objects are part of the Fusion runtime and are available for all platforms.
- System Object (Special Conditions)
- Sound Object
- Storyboard Object (Storyboard controls)
- Timer Object (The timer)
- Create Object (Create new objects)
- The mouse pointer and keyboard
- Player Object
Sources of Extensions
Extensions are files ending .’mfx’ and are usually packaged in zip files or in rare cases, an installer. Most extensions come with help documentation and examples. The most common sources that you can obtain extensions are:
- via the Extension Manager (Fusion 2.5)
- via the Community Forums
- via the ClickStore
- by visiting third party sites listing available extensions
- by hiring an independent developer.
Most extensions built for Multimedia Fusion 2 are compatible with Clickteam Fusion 2.5, but new extensions written for 2.5 are not backwards compatible with 2.0. If you have MMF2 installed and run Fusion 2.5 for the first time, you’ll be offered to import your old extensions. Some extensions required tweaks from its author in order to prevent crashes and should be re-downloaded should the user upgrade from 2.0 to 2.5, for example, this is the case with the File-Folder Object.
Installing an Extension
Depending on the medium you retrieved an extension, you can add them into Fusion in a couple of ways:
From a zip file
-
Navigate to your installation directory for Fusion. This will differ depending on your installed edition and version.
For Windows users, this will be:
C:\Program Files (x86)\Clickteam Fusion 2.5
For Steam users, this will be:
C:\Program Files (x86)\Steam\steamapps\common\Clickteam Fusion 2.5
-
Most extensions have a directory structure like this:
- Data
- Examples
- Extensions
- Help
Extract these folders to the installation folder, prompting “Yes” to append into these directories.
-
Start Fusion to re-index the extensions (or if it is already running, click “Refresh” on the Create new object dialog)
From the extension manager
A new feature introduced in Clickteam Fusion 2.5 is the Extension Manager. This can be accessed by clicking “Manager” from the Create New Object dialog. This feature currently only lets you browse, install and uninstall extensions very conveniently. It lacks functionality for checking for updates or changing the category.
Read more about the Extension Manager.
Built-in Objects Across Exporters
These objects are part of the Fusion runtime that work across all platforms and cannot be removed or modified. Note that some features are specific to certain runtimes and are disabled other exporters. The table below lists the differences in features between exporters.
If you want export to Mac but the Mac exporter lacks a function your app requires, you can use a Only available for the Developer editions of Clickteam Fusion 2.5 and Multimedia Fusion 2. Java Runtime (now deprecated) Java Mac Application, or a Wine wrapper if the Java Runtime (now deprecated) Java exporter also lacks that function or you don’t have the Clickteam Fusion 2.5 Developer version.
This table is a dump from the previous MediaWiki instance.
Object/Function | |||||||||
---|---|---|---|---|---|---|---|---|---|
Special / Special Conditions | |||||||||
╍ Actions | |||||||||
╍╍ Execute another program | Yes | Yes | ? | No | No | No | No | No | Yes* |
╍╍ Application menu / menu bar | Yes | Partial | ? | No | No | No | No | No | Yes* |
╍╍ Clipboard | Yes | Yes | ? | Yes | Yes | No | No | No | Yes* |
╍╍ Binary files | Yes | No | ? | No | No | No | No | No | Yes* |
*Not available on Mobile Devices and BlackBerry | |||||||||
╍ Conditions | |||||||||
╍╍ Application Menu | Yes | Partial | ? | No | No | No | Partial | Partial | Yes* |
*Partially available on Mobile Devices and BlackBerry | |||||||||
╍╍ Have files been dropped? | Yes | Yes | ? | No | No | No | No | No | No |
╍╍ Is text available on clipboard? | Yes | Yes | ? | Yes | Yes | No | No | No | Yes* |
*Not available on Mobile devices or BlackBerry | |||||||||
╍ Expressions | |||||||||
╍╍ Filenames | Yes | Partial | ? | No | No | Partial | Partial | Partial | Yes* |
╍╍ Drag & Drop | Yes | No | ? | No | No | No | No | No | Partial* |
╍╍ Command Line | Yes | No | ? | No | No | No | Partial | No | Yes* |
╍╍ Read text from clipboard | Yes | Yes | ? | Yes | Yes | No | No | No | Yes* |
*Not available on Mobile devices or BlackBerry | |||||||||
Sound | |||||||||
╍ Actions | |||||||||
╍╍ Samples | Yes | Partial | ? | Partial | Yes | Partial* | Yes | Partial | Partial |
╍╍ Music (MIDI) | Yes | Partial | ? | No | Yes | No | No | No | Partial* |
*No File actions available on HTML5, Java for Mobile Devices, or Java for BlackBerry. | |||||||||
╍ Conditions | |||||||||
╍╍ Music (MIDI) | Yes | No | ? | No | Yes | No | No | No | Yes |
╍ Expressions | |||||||||
╍╍ Main Pan | Yes | No | ? | No | Yes | Yes | Yes | Yes | No |
╍╍ Sample & Channel Pan | Yes | No | ? | No | Yes | No | Yes | No | No |
Note: Java lacks many Sound expressions not listed here. | |||||||||
Storyboard Controls | |||||||||
╍ Actions | |||||||||
╍╍ Frame Position | Yes | No | ? | No | No | No | No | No | Yes* |
╍╍ Demo | Yes | No | ? | No | No | No | No | No | Yes* |
╍╍ Clear screen/zone | Yes | Yes | ? | Yes | No | No | No | No | Yes |
╍╍ Change full screen / window mode | Yes | No | ? | No | No | Yes | Yes | Yes | No |
*Not available on Mobile Devices and BlackBerry. | |||||||||
╍ Conditions | |||||||||
╍╍ All exporters are compatible with this object's conditions. | |||||||||
╍ Expressions | |||||||||
╍╍ All exporters are compatible with this object's expressions. | |||||||||
The timer | |||||||||
╍╍ All exporters are compatible with this object. | |||||||||
Create new objects / New Objects | |||||||||
╍ Actions | |||||||||
╍╍ Create object by name | Yes | Yes | ? | Yes | Yes | Yes | No | Yes | No |
*Not available on Mobile Devices and BlackBerry. | |||||||||
╍ Conditions | |||||||||
╍╍ All exporters are compatible with this object's conditions. | |||||||||
╍ Expressions | |||||||||
╍╍ All exporters are compatible with this object's expressions. | |||||||||
The mouse pointer and keyboard | |||||||||
╍ Actions | |||||||||
╍╍ Hide/Show Mouse Pointer | Yes | No | ? | No | No | Yes | Yes | Yes | Yes* |
*Not available on Mobile Devices or BlackBerry | |||||||||
╍ Conditions | |||||||||
╍╍ The keyboard | Yes | Yes | ? | No | Yes | Yes | Yes | Yes | Yes |
╍╍ Mouse wheel movement | Yes | No | ? | No | No | Yes | Yes | Yes | Yes* |
*Not available on Mobile Devices or BlackBerry | |||||||||
╍ Expressions | |||||||||
╍╍ All exporters are compatible with this object's expressions. | |||||||||
Player | |||||||||
╍ Actions | |||||||||
╍╍ All exporters are compatible with this object's actions. | |||||||||
╍ Conditions | |||||||||
╍╍ All exporters are compatible with this object's conditions. | |||||||||
╍ Expressions | |||||||||
╍╍ Current key/input device | Yes | Yes | ? | No | No | No | No | No | Yes* |
*Not available on Mobile Devices or BlackBerry |
Writing Your Own
If you are a programmer, Clickteam have SDKs available for you to create your own extensions for use in Fusion for various exporters, providing you know the programming language.
Common Problems
Antivirus False Positives
Unfortunately, there are a minority of extensions are suspect to being flagged by antiviruses as “false positives” (namely Norton and Avast!). Don’t worry, these extensions are not harmful, however they can affect Fusion and installation procedures. It is strongly recommended you inform the organisation behind your antivirus about this, so they can prevent this happening in future. In the meantime, to prevent the false positive, you can:
- Exclude *.mfx files from being scanned.
- Exclude the Fusion installation directory from being scanned.
- Switch to another antivirus.
- Turn off real-time scanning (not generally recommended)
Third party extensions may diminish
When you encounter a problem and seek advise from the Community Forums, you may discover that the extension you were using has been deprecated, abandoned or is no longer supported by its author. Due to this, you may be using buggy code that may be the cause of crashing or unpredicted results from your projects.
Stuck in the “Other Objects” Category
When you install many extensions, some of them may not be assigned a category. To clean them up from the “Other Objects” category, you will need to manually edit a file called exts.ini from the Extensions folder.