Welcome to SharpEdif!

By Kostya

Table of Contents	Description
What is SharpEdif?	A short description of what SharpEdif is and what it's used for.
Installation and Usage	How to clone, code, compile, and release an extension using SharpEdif.
To-Do List	What needs to be done to mark SharpEdif as stable.
Full Credits	Everyone who helped make SharpEdif a reality.

What is SharpEdif?

SharpEdif is a Clickteam Fusion 2.5 Unicode Extension SDK created for use with C#. Developed by Kostya, SharpEdif makes it possible to code your own fully operational Clickteam Fusion 2.5 extensions in C# to be used with with the Clickteam Fusion 2.5 game engine.

With SharpEdif's attribution and custom build system, it's easy for anyone to make an extension compatible with Clickteam Fusion 2.5 with little knowledge of C# or the Edif SDKs.

Installation and Usage

Dependencies

SharpEdif requires the .NET 4.7.2 Development Kit.

SharpEdif's Builder requires .NET 7.0 SDK.

After running the installer, you may proceed.

Cloning the repo with Visual Studio 2022

Make sure you have Visual Studio 2022 installed and open.

On the GitHub branch, click Code and copy the HTTPS URL.

In Visual Studio 2022, under Get started, click Clone a repository, then paste the HTTPS URL from earlier. Input your desired path and press Clone.

Creating a simple extension with SharpEdif

Once you have SharpEdif loaded into Visual Studio 2022, in your solution browser, under SharpEdif, go into Extension.cs.

From here you can change the extension's name, author, copyright, description, and website. But under those you can see 1 example Condition, 2 example Actions, and 1 example Expression.

Once you've modified the template to your hearts content, you can move onto compiling.

Compiling your extension

Right click the SharpEdif.Builder solution on the right and press Build Solution or do it through the keybind Control + Shift + B, and do the same for the SharpEdif solution. Then, right click the solution once again and press Open Folder in File Explorer.

In the File Explorer go to the CompiledExtensionfolder, from there you should find your extension with the .mfx file extension. Copy this extension into your Clickteam Fusion/Extensions/Unicode folder and, you should be able to use your extension without problems!

Releasing your extension

Clickteam Fusion extensions also have a secondary build option called "Runtime" which needs to be released alongside the one we compiled earlier.

To do this, change the build type to Runtime, and then compile your extension again. In the CompiledExtension folder, copy the new .mfx file into your Clickteam Fusion/Data/Runtime/Unicode folder.

Now, for release you're going to create a new folder anywhere you'd like (Desktop, CompiledExtension folder, etc.), then inside that folder, you're going to create the file structure shown below.

Extensions
- Unicode
  - YourNormalExtension.mfx
Data
- Runtime
  - Unicode
    - YourRuntimeExtension.mfx

Zip that folder, and it's ready to be released for anybody's use!

To-Do List

%	Task	Description
50%	Properties	Allow editing of the extension's properties panel.
20%	Implement All Structures	Implement all missing/empty structures from the original SDK.
0%	Parameter Names	Allowing naming of parameters.
0%	Condition Events	Implement fire condition events (The green conditions).
0%	Rendering API	Expose the Rendering API.

Full Credits

Name	Credit for...
Clickteam	Creation of the original SDK and Clickteam Fusion 2.5.
Kostya	Developer of SharpEdif.
Yunivers	Minor help implementing structures, and testing.
SortaCore	Developer of DarkEdif, which was used for a small amount of reference.

SharpEdif is licensed under an MIT License.

Last Updated May 29th, 2023.

CTFAK / SharpEdif