MAD4FP: Difference between revisions

From Flashpoint Datahub
Jump to navigation Jump to search
mNo edit summary
m (category)
(33 intermediate revisions by 5 users not shown)
Line 1: Line 1:
MAD4FP, or Multi-Asset Downloader for Flashpoint, is a new mode of Flashpoint Infinity for easily downloading multi-asset games. This article explains how to set up and use this mode. Please note that MAD4FP only works on HTTP URLs! You will need to use a different method to save games on HTTPS URLs.
'''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.  


== Setting Up MAD4FP ==
'''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].


If you are using Flashpoint Infinity 6.1 or older, follow these steps first:
There are two ways of activating MAD4FP
# Navigate to https://raw.githubusercontent.com/FlashpointProject/Flashpoint-Router/master/router.php.
# Save the file to <code>Flashpoint\Server</code> in your Flashpoint Infinity folder. Use the filename <code>router.php</code>. You may back up the old <code>router.php</code> file first.


Regardless of your Flashpoint Infinity version, follow these steps:
== Run With MAD4FP ==
# Open the <code>router.php</code> file in the <code>Flashpoint\Server</code> folder using a text editor such as Notepad.
# 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.


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


# 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."
# 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]].  
# 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.
# Make sure that the <code>Symlink Curation Content Folder</code> checkbox is checked.
# For the Application Path, click the dropdown and choose the path for K-Meleon or Basilisk. K-Meleon is recommended for most plugin-based games, while Basilisk is recommended for HTML5 and Unity games.
# 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.
# Double-click the game to launch it. The game should load in the browser you specified. Watch the Flashpoint Redirector window as you play the game.
#* Note that if the original URL uses HTTPS, you will need to replace <code>https</code> with <code>http</code>.
# Once all of the assets seem to have loaded, navigate to <code>Flashpoint\Server\htdocs</code> and sort the contents by Date Modified. Determine which files and folders belong to the game you just downloaded.
# For the Application Path, click the dropdown and choose the appropriate application in Flashpoint for the type of game you are curating.
# Copy the files and folders from the htdocs folder to your curation's <code>content</code> folder, retaining the same structure. Refer to [[Instructions for 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.
# 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.
 
== 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:
# 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>.
#* Keep in mind that the defaults for Core and Ultimate are <code>Apache Webserver</code> and for Infinity it's <code>PHP Router</code>.
#* Note the regular functions of Flashpoint Infinity (playing games regularly) do not work while MAD4FP is enabled.
# Press the <code>Save and Restart</code> button at the bottom of the Config page.
# 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.
#* Note that if the original URL uses HTTPS, you will need to replace <code>https</code> with <code>http</code>.
# 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]].
#* 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.
# 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.
 
<noinclude>[[Category:Launcher]]</noinclude>

Revision as of 03:04, 22 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.