This guide will show you how to curate D'Fusion content using Flashpoint.
Before You Start
- This tutorial will assume you've read the standard Curation Tutorial, which is highly recommended to go through.
- The page title will usually contain "D'Fusion @Home Web Player Sample"
- The page will ask you to install the D'Fusion web plugin.
- The D'Fusion plugin mainly uses .dpd and .ssc files, but it also uses a .dll and may use an .xml as well.
- The D'Fusion plugin uses the MIME types
application/x-dfusion-web2-s64for Mac, and
application/x-satchfor SATCH Studio-made D'Fusion content.
- XMLs and other files found often show gibberish when viewed.
- Japanese corporation KDDI released their own AR brand called SATCH which originally used D'Fusion tech; essentially works the same as regular D'Fusion.
FPSoftware\startDFusion.bat. The D'Fusion plugin will usually run fine if all assets are mirrored. If a D'Fusion curation requires a marker (a PDF/image needed for some curations to start), add it as an additional app, not as an extra. This is the same case for the Mac version of a D'Fusion player, which will often have files that exceed Windows' 256 character file path limit.
If .update.xml is present
If .update.xml is present, using MAD4FP would be enough. Make sure to download .update.xmls for all folders (excluding /js/, /plugin/ and anything not used by D'Fusion like the images directory) prior to running the curation. If not, the game will either fail to initialize or MAD4FP will be unable to get the rest of the game's assets. If you did this, you would likely need to clear your cache so that the plugin would not keep using the cached files instead of trying to downloading the scenario again.
If .update.xml is not present and other situations
If .update.xml is not present, the game is uncuratable unless the game's files are URL guessed. This can often be done by looking at previous D'Fusion curations. Once URL guessed, the game should be Flashfreezed as there is currently no way to reverse-engineer the .update.xml file to make the curation work.
If the game/animation is missing at least one asset (.update.xml or something else), the game will fail to start. This is why most D'Fusion games/animations on the Wayback Machine are uncuratable. If the game/animation is still live, then the available files should be mirrored then Flashfreezed.
Clearing Scenario Cache
To clear your D'Fusion cache, first navigate to
%appdata%\Total Immersion\Web\Scns\. This folder contains decompiled "scenarios" from D'Fusion curations which are called upon loading the game. Delete the folder with the domain matching the curation. (Note: If curating a game on a subdomain, the folder in appdata would have the site root as the folder name, not the subdomain itself; example.com not a.example.com)
If your game has a splash screen, you have to navigate to
%appdata%\Total Immersion\Web\Splash\ to delete the splash screen cache of your curation.
To fully clear cache, you would also need to delete the decrypted player files located at
%appdata%\Total Immersion\Player\gen\. It would depend on the curation for which version of the player you would need to delete to clear that particular curation's cache. You can check what version of D'Fusion your curation uses by opening up
totalimmersion_dfusion_web_plugin.js in your curation.
Decrypting Curation Files
Some of the curation files for D'Fusion are encrypted. D'Fusion uses different encryption methods for each version, and so far the encryption method of only one version can be decrypted. These files can be decrypted with a tool created by Crazyc. The tool works by opening the program in a command line, then putting the file to be decrypted then the where the program will output the file (as well as the filename of the output file).
Wrapping It Up
First, make sure that you have thoroughly tested your curation and followed the Curation Format. Scroll down in the Curate tab and click the
Export button at the bottom of your curation to save it as a .7z file. After you've exported the curation, you can find it by clicking the
Exported Curations button on the Curate tab (as long as you didn't choose to save it somewhere else). Once you have the file, submit it to the Flashpoint Submission System. An explanation of how the site works is available here.
After you have uploaded your curation to the website, a Curator will check it. This can take some time, so please be patient. You will be pinged in the #fpfss-notifications channel about whether or not your submission was approved, and if any changes need to be made.
Congratulations! Your submitted game/animation will appear in a future version of Flashpoint.