Old Zipping Guide: Difference between revisions

From Flashpoint Datahub
Jump to navigation Jump to search
mNo edit summary
(new curate stuff simplify all this)
Line 1: Line 1:
This page describes how to create and test GameZIPs. The goal is to create GameZIPs for existing Legacy games, allowing the ZIP to replace the existing game files in <code>Legacy\htdocs</code>. You'll need a copy of Flashpoint Core, as well as a copy of either Flashpoint Infinity or Ultimate.
This page describes how to create and test GameZIPs. The goal is to create GameZIPs for existing Legacy games, allowing the ZIP to replace the existing game files in <code>Legacy\htdocs</code>. You'll need a copy of Flashpoint Core.


== Creating a GameZIP ==
== Creating a GameZIP ==
Line 5: Line 5:
=== Setting it Up ===
=== Setting it Up ===


# Find the '''Utilities''' folder in your copy of Flashpoint Core. Copy it into the same location in Flashpoint Infinity or Ultimate.
To set up your copy of Core, open the Data folder and back up the <code>flashpoint.sqlite</code> file. (You can rename it to something like flashpoint.sqlite.bak, for example.) Then replace Core's flashpoint.sqlite file with the one from your copy of Infinity/Ultimate, or [http://infinity.unstable.life/Flashpoint/Data/flashpoint.sqlite download a fresh database file]. You normally should see the same list of games you see in Infinity/Ultimate.
# Open Flashpoint Infinity or Ultimate and find the game that you'd like to convert. Right-click the game and copy its UUID.
 
# Create a new folder and name it according to the UUID you just copied.
=== Making a GameZIP ===
#* '''Note:''' Do ''not'' create a "content" folder inside this folder!
 
To make a GameZIP of a legacy game, search it in Core, right-click it and then click on "Make Curation from Game". After you've gathered the files of the game and put them in the content folder of the curation you have newly created, in the exact same way as if you were making a curation, you can simply click on "Export Data Pack" to get a GameZIP, which you can find in the Data Packs folder in the Exported folder. image.ddd


=== Gathering the Files ===
=== Gathering the Files ===


There are a number of approaches for finding files for your zip. You might want to use some combination of the approaches below:
There are a number of approaches for finding files for your zip. You might want to use some combination of the approaches below:
* Launch the game in Flashpoint and check the Logs tab. Make a note of which files the game loads and where they are located. Find and copy these files into the UUID folder you created earlier.
* Launch the game in Core and check the Logs tab. Make a note of which files the game loads and where they are located. Find and copy these files into the content folder. You can right-click the game after launching it and clicking on "Open File Location" to directly get to its files.
* [[Downloading Curations|Find and download the game's original curation]]. Ensure that curation's files and file locations match those in your copy of Infinity/Ultimate. You'll probably need to launch the game and check the Logs tab to find those file locations. Copy the files from the curation into your UUID folder.
* [[Downloading Curations|Find and download the game's original curation]]. Ensure that curation's files and file locations match those in your modified copy of Core. You'll probably need to launch the game and check the Logs tab to find those file locations. Copy the files from the curation into your content folder.
** '''Note:''' The game files/folders should be located ''directly inside'' the UUID folder! There should not be a "content" folder.
 
Once you've gathered the files, you may want to open your copy of Flashpoint Core and create a new curation just to quickly test that you didn't miss any files. Be sure to [[Extended_FAQ#ClearWinINetCache|clear your cache]] before testing!
 
=== Zipping up the Files ===


# Open the Utilities folder in Flashpoint Infinity/Ultimate (the one you copied in earlier). Open the "bluezip" folder.
Once you've gathered the files, you may want to run the new curation just to quickly test that you didn't miss any files. Be sure to [[Extended_FAQ#ClearWinINetCache|clear your cache]] before testing!
# Copy and paste your UUID folder containing the game files into the "bluezip" folder.
#* '''Note:''' The game files/folders should be located ''directly inside'' the UUID folder! There should not be a "content" folder.
# Drag the UUID folder onto "_CONVERT.bat". You should see some output showing that the conversion was successful. If it asks you whether to delete files, just press Enter to skip that. Then press Enter to close the Command Prompt window.
# In your main Flashpoint Infinity/Ultimate folder, you should now see a Games folder. Open that folder and verify that a ZIP file named according the game's UUID has been created.


== Testing a GameZIP ==
== Testing a GameZIP ==
Line 31: Line 23:
Below are instructions for testing your own GameZIP after creating it, or testing someone else's GameZIP to verify that it works.
Below are instructions for testing your own GameZIP after creating it, or testing someone else's GameZIP to verify that it works.


=== Setting it Up ===
For setting Core up, follow the same instructions in "Creating a GameZIP".
 
Testing should be done in '''Flashpoint Core'''. To set up your copy of Core, open the Data folder and back up the <code>flashpoint.sqlite</code> file. (You can rename it to something like flashpoint.sqlite.bak, for example.) Then replace Core's flashpoint.sqlite file with the one from your copy of Infinity/Ultimate, or [http://infinity.unstable.life/Flashpoint/Data/flashpoint.sqlite download a fresh database file].


=== Importing the GameZIP ===
=== Importing the GameZIP ===

Revision as of 11:16, 13 August 2022

This page describes how to create and test GameZIPs. The goal is to create GameZIPs for existing Legacy games, allowing the ZIP to replace the existing game files in Legacy\htdocs. You'll need a copy of Flashpoint Core.

Creating a GameZIP

Setting it Up

To set up your copy of Core, open the Data folder and back up the flashpoint.sqlite file. (You can rename it to something like flashpoint.sqlite.bak, for example.) Then replace Core's flashpoint.sqlite file with the one from your copy of Infinity/Ultimate, or download a fresh database file. You normally should see the same list of games you see in Infinity/Ultimate.

Making a GameZIP

To make a GameZIP of a legacy game, search it in Core, right-click it and then click on "Make Curation from Game". After you've gathered the files of the game and put them in the content folder of the curation you have newly created, in the exact same way as if you were making a curation, you can simply click on "Export Data Pack" to get a GameZIP, which you can find in the Data Packs folder in the Exported folder. image.ddd

Gathering the Files

There are a number of approaches for finding files for your zip. You might want to use some combination of the approaches below:

  • Launch the game in Core and check the Logs tab. Make a note of which files the game loads and where they are located. Find and copy these files into the content folder. You can right-click the game after launching it and clicking on "Open File Location" to directly get to its files.
  • Find and download the game's original curation. Ensure that curation's files and file locations match those in your modified copy of Core. You'll probably need to launch the game and check the Logs tab to find those file locations. Copy the files from the curation into your content folder.

Once you've gathered the files, you may want to run the new curation just to quickly test that you didn't miss any files. Be sure to clear your cache before testing!

Testing a GameZIP

Below are instructions for testing your own GameZIP after creating it, or testing someone else's GameZIP to verify that it works.

For setting Core up, follow the same instructions in "Creating a GameZIP".

Importing the GameZIP

  1. Open your modified copy of Core. You should see the same list of games you normally see in Infinity/Ultimate.
  2. Find the game corresponding to your GameZIP. You can search for id:TheUUID to find the right entry quickly. (Replace TheUUID with the game's UUID.)
  3. Select the game and click "Open Game Data Browser" on the right-hand side of the launcher.
  4. Click the "Import Data" button. Select your ZIP file and close the Game Data Browser.

Testing the GameZIP

  1. Clear your cache to ensure that cached files don't interfere with the test.
  2. Click "Play" to launch and test the game!