D'Fusion Curation: Difference between revisions

From Flashpoint Datahub
Jump to navigation Jump to search
No edit summary
mNo edit summary
(19 intermediate revisions by the same user not shown)
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 ==
* This tutorial will assume you've read the standard [[Curation Tutorial]], which is highly recommended to go through.
* This tutorial will assume you've read the standard [[Curation Tutorial]], which is highly recommended to go through.
* '''This currently needs a support pack, located at https://cdn.discordapp.com/attachments/714335844940513342/938745357008011314/DFusion_SP.7z'''


== Recognizing D'Fusion ==
== Recognizing D'Fusion ==
Line 9: Line 8:
* The page will ask you to install the D'Fusion web plugin.
* 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 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 <code>application/x-dfusion-web2</code> and <code>application/x-dfusion-web2-s64</code> (for Mac).
* The D'Fusion plugin uses the MIME types <code>application/x-dfusion-web</code>, <code>application/x-dfusion-web2</code>, <code>application/x-dfusion-web2-s64</code> for Mac, and <code>application/x-satch</code> for SATCH Studio-made D'Fusion content.
* XMLs and other files found show gibberish when viewed.
* XMLs and other files found 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 ==
== 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, '''curations will not work without this'''. Follow one of the instructions below and once finished, set the application path to <code>FPSoftware\startDFusion.bat</code>. The D'Fusion plugin will usually run fine if all assets are mirrored.
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 <code>FPSoftware\startDFusion.bat</code>. 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===
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), if not the game will fail to initialize or MAD4FP will be unable to get the rest of the game's assets.
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 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.
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 on the Wayback Machine, it is most likely uncuratable unless the page itself, or a mirror of it, is still live.
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==
==Clearing Scenario Cache==
To clear your D'Fusion cache, navigate to <code>%appdata%\Total Immersion\Web\Scns\</code>. This folder contains decompiled "scenarios" from D'Fusion curations which are called upon loading the game. If your game has a splash screen, you have to navigate to <code>%appdata%\Total Immersion\Web\Splash\</code> to delete the cache.
To clear your D'Fusion cache, first navigate to <code>%appdata%\Total Immersion\Web\Scns\</code>. 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 <code>%appdata%\Total Immersion\Web\Splash\</code> 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 <code>%appdata%\Total Immersion\Player\gen\</code>. 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 <code>totalimmersion_dfusion_web_plugin.js</code> in your curation.
 
==Decrypting Curation Files==
Some of the curation files for D'Fusion are encrypted, these files can be decrypted with [https://cdn.discordapp.com/attachments/714335844940513342/1014935236502630460/dfusiondec.zip a tool created by Crazyc]. <!--(the tool only works on D'Fusion curations which use @Home Web) uncomment when I actually add a D'Fusion curation which uses @Home instead of just @Home Web--> 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 ==
== Wrapping It Up ==

Revision as of 15:41, 13 October 2022

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

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 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\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, 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.