D'Fusion Curation: Difference between revisions

From Flashpoint Datahub
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
This guide will show you how to curate D'Fusion using Flashpoint Core.
This guide will show you how to curate D'Fusion content using Flashpoint Core.


== Before You Start ==
== Before You Start ==

Revision as of 16:27, 15 July 2022

This guide will show you how to curate D'Fusion content using Flashpoint Core.

Before You Start

Recognizing D'Fusion

  • 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-web, application/x-dfusion-web2 and application/x-dfusion-web2-s64 for Mac.
  • XMLs and other files found show gibberish when viewed.

Curation Steps

First, check the Javascript embed for D'Fusion. This Javascript embed will list all of the subdirectories used by D'Fusion (except /js/ and /plugin/). Take one of the subdirectories (preferably the one that has the .dpd) and add .update.xml to the end of the URL. This will give you a list of files in the directory and will allow the plugin to decrypt files, curations will not work without this. Follow one of the instructions below and once finished, set the application path to 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.

SATCH vs D'Fusion

Some curations (most often Japanese) used SATCH Studio (not to be confused with the SATCH Viewer) as an authoring software instead of D'Fusion Studio. Curations made in SATCH look identical to regular D'Fusion curations except they won't load (Error when loading the player, please restart the application or contact support). MAD4FP will still be able to download all of the assets if .update.xml is present so it is still necessary to run the curation. The curation should then be Flashfreezed as there is currently no way to run curations which used SATCH.

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.

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.