D'Fusion Curation

From Flashpoint Datahub
Revision as of 01:17, 2 March 2024 by Cursed-light (talk | contribs) (changed to new system)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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.

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, application/x-dfusion-web2-s64 for Mac, and application/x-satch for 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.

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\FlashpointSecurePlayer.exe and put the dfusion prefix in the Launch Command, following the format prefix URL. 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.