MAD4FP: Difference between revisions

From Flashpoint Datahub
Jump to navigation Jump to search
mNo edit summary
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
MAD4FP, or Multi-Asset Downloader for Flashpoint, is a built in mode for Flashpoint Core 8.2 or higher for easily downloading multi-asset games. This article explains how to set up and use this mode. If for some reason you still need to use in Infinity follow those instructions instead.  
'''MAD4FP''', or '''M'''ulti-'''A'''sset '''D'''ownloader '''for''' '''F'''lash'''p'''oint, is a built in mode for Flashpoint Core 8.2 or higher for easily downloading multi-asset games. This article explains how to set up and use this mode. This features is present in Ultimate and Infinity as well, but for curation only Core should be used.  


'''Note:''' using MAD4FP will download everything including unwanted ads, videos and possibly other files not needed for the curation to work. We do not want these unneeded files in Flashpoint as it will add to the size with no benefits. It is expected that after using MAD4FP you will go to the contents folder and remove these unneeded items. If you are unsure about what might be needed or not please ask any questions in '''#curator-lounge''' in our [https://discord.gg/S9uJ794 Discord].
'''Note:''' using MAD4FP will download everything including unwanted ads, videos and possibly other files not needed for the curation to work. We do not want these unneeded files in Flashpoint as it will add to the size with no benefits. It is expected that after using MAD4FP you will go to the contents folder and remove these unneeded items. If you are unsure about what might be needed or not please ask any questions in '''#curator-lounge''' in our [https://discord.gg/S9uJ794 Discord].


== Using in Core 8.2 ==
There are two ways of activating MAD4FP
 
== Run With MAD4FP ==
 
This method requires Windows Admin prompts, but has the most streamlined process;


# In Flashpoint Core 8.2 or higher, click the Curate tab, then click New Curation. For more information about using the Curate tab, see [[Curation Tutorial]].  
# In Flashpoint Core 8.2 or higher, click the Curate tab, then click New Curation. For more information about using the Curate tab, see [[Curation Tutorial]].  
# Make sure that the "Symlink Curation Content Folder" checkbox is checked.
# Make sure that the <code>Symlink Curation Content Folder</code> checkbox is checked.
# Enter the title and platform of the game, and any other metadata you wish. For the Launch Command, paste the URL of the page where the game is located. If you plan to use the Flash projector, paste the direct link to the game SWF instead.
# Enter the title and platform of the game, and any other metadata you can find. For the Launch Command, paste the URL of the page where the game is located. If you plan to use the Flash projector, paste the direct link to the game SWF instead.
#* Note that if the original URL uses HTTPS, you will need to replace <code>https</code> with <code>http</code>.
#* Note that if the original URL uses HTTPS, you will need to replace <code>https</code> with <code>http</code>.
# For the Application Path, click the dropdown and choose the appropriate application in Flashpoint for the type of game you are curating.
# For the Application Path, click the dropdown and choose the appropriate application in Flashpoint for the type of game you are curating.
# Double-click the game to launch it. The game should load in the application you specified. Watch the Logs tab of Flashpoint Launcher as you play the game.
# Double-click the game to launch it. The game should load in the application you specified. Watch the Logs tab of Flashpoint Launcher as you play the game.
# The assets will download directly into the curation's content folder with the correct folder structure.
# The assets will download directly into the curation's content folder with the correct folder structure.
# After getting all assets, run the game again, this time without MAD4FP to test no assets are missing. If they are, copy 404 URLs to download them or run the game with MAD4FP again.


== Setting Up in Infinity ==
== Switching Servers ==
[[File:MAD4FP Server Setup.png|thumb|300px|Dropdown Showing server options.]]
 
This method does not require Windows Admin prompts, but this process is slower to use;


Follow these steps to activate MAD4FP:
Follow these steps to activate MAD4FP:
# If you are using an old version of Flashpoint Infinity, [[Extended FAQ#UpdateRouter|update Flashpoint Router]].
# Go to the <code>Config</code> tab on the launcher, scroll to <code>Advanced</code>, and on <code>Server</code> switch to <code>MAD4FP Mode</code>.
# Navigate into the <code>Server</code> folder of your Flashpoint Infinity folder.
#* Keep in mind that the defaults for Core and Ultimate are <code>Apache Webserver</code> and for Infinity it's <code>PHP Router</code>.
# Open the <code>router.php</code> file using a text editor such as Notepad.
#* Note the regular functions of Flashpoint Infinity (playing games regularly) do not work while MAD4FP is enabled.
# Find the line that says <code>const ROUTER_MAD4FP = false;</code> and change the <code>false</code> part to <code>true</code>. Save the file.
# Press the <code>Save and Restart</code> button at the bottom of the Config page.
Note the regular functions of Flashpoint Infinity (playing games regularly) do not work while MAD4FP is enabled.
# After Flashpoint restarts, go to the Curate tab
 
# Enter the title and platform of the game, and any other metadata you can find. For the Launch Command, paste the URL of the page where the game is located. If you plan to use the Flash projector, paste the direct link to the game SWF instead.
=== Using in Infinity ===
 
# In Flashpoint Infinity, click New Game on the bottom-right corner of the launcher. If you do not see a New Game button, switch to the Config tab and check "Enable Editing."
#* Alternatively, you can switch to the Curate tab, then click New Curation instead of New Game. For more information about using the Curate tab, see [[Curation Tutorial]].
# Enter the title and platform of the game, and any other metadata you wish. For the Launch Command, paste the URL of the page where the game is located. If you plan to use the Flash projector, paste the direct link to the game SWF instead.
#* Note that if the original URL uses HTTPS, you will need to replace <code>https</code> with <code>http</code>.
#* Note that if the original URL uses HTTPS, you will need to replace <code>https</code> with <code>http</code>.
# For the Application Path, click the dropdown and choose the appropriate application in Flashpoint for the type of game you are curating.
# Once all of the assets seem to have loaded, navigate to Flashpoint's <code>Legacy\htdocs\content</code> folder, copy all the files and folders to your curation's <code>content</code> folder, retaining the same structure. Refer to the [[Curation Tutorial]].
# Double-click the game to launch it. The game should load in the application you specified. Watch the Logs tab of Flashpoint Launcher as you play the game.
#* For Flashpoint 8.2 Infinity or below, go to <code>Server\htdocs</code> folder and sort the contents by Date Modified. Determine which files and folders belong to the game you just downloaded.
# Once all of the assets seem to have loaded, navigate to Flashpoint's <code>Legacy\htdocs</code> folder and sort the contents by Date Modified. Determine which files and folders belong to the game you just downloaded.
# After getting all assets, switch back the server from MAD4FP Mode, Save and Restart, and run the curation again to test no assets are missing. If they are, copy 404 URLs to download them or run the game with MAD4FP again.
# Copy the files and folders from the htdocs folder to your curation's <code>content</code> folder, retaining the same structure. Refer to the [[Curation Tutorial]].
 
=== Turning Off in Infinity ===
 
After you're done using MAD4FP, you will need to turn it off to use Flashpoint Infinity normally. To do this, follow the steps described in [[#Setting Up MAD4FP|Setting Up MAD4FP]], but change <code>true</code> back to <code>false</code>.

Revision as of 16:05, 10 January 2021

MAD4FP, or Multi-Asset Downloader for Flashpoint, is a built in mode for Flashpoint Core 8.2 or higher for easily downloading multi-asset games. This article explains how to set up and use this mode. This features is present in Ultimate and Infinity as well, but for curation only Core should be used.

Note: using MAD4FP will download everything including unwanted ads, videos and possibly other files not needed for the curation to work. We do not want these unneeded files in Flashpoint as it will add to the size with no benefits. It is expected that after using MAD4FP you will go to the contents folder and remove these unneeded items. If you are unsure about what might be needed or not please ask any questions in #curator-lounge in our Discord.

There are two ways of activating MAD4FP

Run With MAD4FP

This method requires Windows Admin prompts, but has the most streamlined process;

  1. In Flashpoint Core 8.2 or higher, click the Curate tab, then click New Curation. For more information about using the Curate tab, see Curation Tutorial.
  2. Make sure that the Symlink Curation Content Folder checkbox is checked.
  3. Enter the title and platform of the game, and any other metadata you can find. For the Launch Command, paste the URL of the page where the game is located. If you plan to use the Flash projector, paste the direct link to the game SWF instead.
    • Note that if the original URL uses HTTPS, you will need to replace https with http.
  4. For the Application Path, click the dropdown and choose the appropriate application in Flashpoint for the type of game you are curating.
  5. Double-click the game to launch it. The game should load in the application you specified. Watch the Logs tab of Flashpoint Launcher as you play the game.
  6. The assets will download directly into the curation's content folder with the correct folder structure.
  7. After getting all assets, run the game again, this time without MAD4FP to test no assets are missing. If they are, copy 404 URLs to download them or run the game with MAD4FP again.

Switching Servers

Dropdown Showing server options.

This method does not require Windows Admin prompts, but this process is slower to use;

Follow these steps to activate MAD4FP:

  1. Go to the Config tab on the launcher, scroll to Advanced, and on Server switch to MAD4FP Mode.
    • Keep in mind that the defaults for Core and Ultimate are Apache Webserver and for Infinity it's PHP Router.
    • Note the regular functions of Flashpoint Infinity (playing games regularly) do not work while MAD4FP is enabled.
  2. Press the Save and Restart button at the bottom of the Config page.
  3. After Flashpoint restarts, go to the Curate tab
  4. Enter the title and platform of the game, and any other metadata you can find. For the Launch Command, paste the URL of the page where the game is located. If you plan to use the Flash projector, paste the direct link to the game SWF instead.
    • Note that if the original URL uses HTTPS, you will need to replace https with http.
  5. Once all of the assets seem to have loaded, navigate to Flashpoint's Legacy\htdocs\content folder, copy all the files and folders to your curation's content folder, retaining the same structure. Refer to the Curation Tutorial.
    • For Flashpoint 8.2 Infinity or below, go to Server\htdocs folder and sort the contents by Date Modified. Determine which files and folders belong to the game you just downloaded.
  6. After getting all assets, switch back the server from MAD4FP Mode, Save and Restart, and run the curation again to test no assets are missing. If they are, copy 404 URLs to download them or run the game with MAD4FP again.