Support Pack Tutorial - Revision history

Cheesey: /* Adding Technologies */

2024-08-27T02:03:16Z

Adding Technologies

← Older revision		Revision as of 04:03, 27 August 2024
Line 17:		Line 17:
	# Go to <code>FPSoftware\fpnavigator-portable</code>, then open <code>FPNavigator.ini</code> in a text editor. Go to <code>;(plugins path)</code>, then add the plugin directory to the path via a variable called <code>FP_(plugin)_PATH</code>, again, using a short version of the technology name instead of <code>(plugin)</code>, fully in uppercase and without spaces. For LiveMath Plugin, this would be <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code>. Go to <code>MOZ_PLUGIN_PATH</code> and also add the variable name to the end of that line. Surround the variable name with with the percent <code>%</code> symbol and place a semicolon <code>;</code> at the end. For example, with all parts, it would be <code>%FP_LIVEMATH_PATH%;</code> for LiveMath Plugin. Save the file. The text editor can be closed.		# Go to <code>FPSoftware\fpnavigator-portable</code>, then open <code>FPNavigator.ini</code> in a text editor. Go to <code>;(plugins path)</code>, then add the plugin directory to the path via a variable called <code>FP_(plugin)_PATH</code>, again, using a short version of the technology name instead of <code>(plugin)</code>, fully in uppercase and without spaces. For LiveMath Plugin, this would be <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code>. Go to <code>MOZ_PLUGIN_PATH</code> and also add the variable name to the end of that line. Surround the variable name with with the percent <code>%</code> symbol and place a semicolon <code>;</code> at the end. For example, with all parts, it would be <code>%FP_LIVEMATH_PATH%;</code> for LiveMath Plugin. Save the file. The text editor can be closed.
	# Create at least one curation in the technology to test. Go to [[Curation Tutorial]] if you don't know how to make one. If the technology does not work, a special .bat file may need to be created for it. To do so, create a file in FPSoftware, and name it in the following style: startLiveMathPlugin.bat (please note LiveMath Plugin does not require a .bat file). A [[#Example Batch File\|short example]] is below.		# Create at least one curation in the technology to test. Go to [[Curation Tutorial]] if you don't know how to make one. If the technology does not work, a special .bat file may need to be created for it. To do so, create a file in FPSoftware, and name it in the following style: startLiveMathPlugin.bat (please note LiveMath Plugin does not require a .bat file). A [[#Example Batch File\|short example]] is below.
	# Once done, find an picture for the technology to use as the icon for the technology, or related to the technology, such as the company or the most prominent program if you can't find one. This may require some image editing, which is out of scope for this article. Export it to <code>Data\Logos</code>.		# Once done, find a picture for the technology to use as the icon for the technology, or related to the technology, such as the company or the most prominent program if you can't find one. This may require some image editing, which is out of scope for this article. Export it to <code>Data\Logos</code>.
	# Create the directories <code>Data\Logos</code> and <code>FPSoftware\BrowserPlugins</code> separately, and the final picture and the technology files into them respectively. Place these directories into an empty 7Z file, preferably named after the technology, such as "LiveMath Plugin support pack" for LiveMath.		# Create the directories <code>Data\Logos</code> and <code>FPSoftware\BrowserPlugins</code> separately, and the final picture and the technology files into them respectively. Place these directories into an empty 7Z file, preferably named after the technology, such as "LiveMath Plugin support pack" for LiveMath.
	# Submit the support pack to #other-plugins on our Discord. Give a description on how to add the support pack. For instance, "LiveMath Plugin support pack - Add <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code> to <code>;(plugins path)</code> and <code>%FP_LIVEMATH_PATH%;</code> to MOZ_PLUGIN_PATH in <code>FPSoftware\fpnavigator-portable\FPNavigator.ini</code>".		# Submit the support pack to #other-plugins on our Discord. Give a description on how to add the support pack. For instance, "LiveMath Plugin support pack - Add <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code> to <code>;(plugins path)</code> and <code>%FP_LIVEMATH_PATH%;</code> to MOZ_PLUGIN_PATH in <code>FPSoftware\fpnavigator-portable\FPNavigator.ini</code>".

Nosamu: Removed outdated code from example batch file

2023-10-20T09:38:58Z

Removed outdated code from example batch file

← Older revision		Revision as of 11:38, 20 October 2023
Line 29:		Line 29:
	PUSHD %~dp0		PUSHD %~dp0
	FlashpointSecurePlayer burster "%~1"		FlashpointSecurePlayer burster "%~1"

	~~IF %ERRORLEVEL% EQU -2 (~~
	~~ECHO MsgBox "You cannot run multiple instances of Flashpoint Secure Player." > %TMP%\TMP.VBS~~
	~~WSCRIPT /nologo %TMP%\TMP.VBS~~
	~~DEL %TMP%\TMP.VBS~~
	)
	POPD		POPD

Prostagma at 12:55, 15 October 2023

2023-10-15T12:55:15Z

← Older revision		Revision as of 14:55, 15 October 2023
Line 19:		Line 19:
	# Once done, find an picture for the technology to use as the icon for the technology, or related to the technology, such as the company or the most prominent program if you can't find one. This may require some image editing, which is out of scope for this article. Export it to <code>Data\Logos</code>.		# Once done, find an picture for the technology to use as the icon for the technology, or related to the technology, such as the company or the most prominent program if you can't find one. This may require some image editing, which is out of scope for this article. Export it to <code>Data\Logos</code>.
	# Create the directories <code>Data\Logos</code> and <code>FPSoftware\BrowserPlugins</code> separately, and the final picture and the technology files into them respectively. Place these directories into an empty 7Z file, preferably named after the technology, such as "LiveMath Plugin support pack" for LiveMath.		# Create the directories <code>Data\Logos</code> and <code>FPSoftware\BrowserPlugins</code> separately, and the final picture and the technology files into them respectively. Place these directories into an empty 7Z file, preferably named after the technology, such as "LiveMath Plugin support pack" for LiveMath.
	# Submit the support pack to #plugins on our Discord. Give a description on how to add the support pack. For instance, "LiveMath Plugin support pack - Add <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code> to <code>;(plugins path)</code> and <code>%FP_LIVEMATH_PATH%;</code> to MOZ_PLUGIN_PATH in <code>FPSoftware\fpnavigator-portable\FPNavigator.ini</code>".		# Submit the support pack to #other-plugins on our Discord. Give a description on how to add the support pack. For instance, "LiveMath Plugin support pack - Add <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code> to <code>;(plugins path)</code> and <code>%FP_LIVEMATH_PATH%;</code> to MOZ_PLUGIN_PATH in <code>FPSoftware\fpnavigator-portable\FPNavigator.ini</code>".
	# ~~Submit the .7z file [https://bluepload.unstable.life/ here] if it is 1GB or less. Otherwise, a Flashpoint staff member~~ will ~~provide you with access to another upload location upon request. Once the file has been uploaded,~~ add the ~~link~~ to ~~your message~~.		# Staff will test and add the platform to Flashpoint, see: [[Support Pack Tutorial]].
	# Upload the curations you have made in the technology [[Submitting a Curation\|the same way as usual]]. Include links to the curations in your support pack message.		# Upload the curations you have made in the technology [[Submitting a Curation\|the same way as usual]]. Include links to the curations in your support pack message.

Line 36:		Line 36:
	)		)
	POPD		POPD

			<noinclude>
			[[Category:Technologies]]
			</noinclude>

Prostagma: v12 cleanup

2023-07-16T02:33:37Z

v12 cleanup

VFDan: /* Adding Technologies */

2022-08-28T03:33:30Z

Adding Technologies

← Older revision		Revision as of 05:33, 28 August 2022
Line 21:		Line 21:
	# Once done, find an picture for the technology to use as the icon for the technology, or related to the technology, such as the company or the most prominent program if you can't find one. This may require some image editing, which is out of scope for this article. Export it to <code>Data\Logos</code>.		# Once done, find an picture for the technology to use as the icon for the technology, or related to the technology, such as the company or the most prominent program if you can't find one. This may require some image editing, which is out of scope for this article. Export it to <code>Data\Logos</code>.
	# Create the directories <code>Data\Logos</code> and <code>FPSoftware\BrowserPlugins</code> separately, and the final picture and the technology files into them respectively. Place these directories into an empty 7Z file, preferably named after the technology, such as "LiveMath Plugin support pack" for LiveMath.		# Create the directories <code>Data\Logos</code> and <code>FPSoftware\BrowserPlugins</code> separately, and the final picture and the technology files into them respectively. Place these directories into an empty 7Z file, preferably named after the technology, such as "LiveMath Plugin support pack" for LiveMath.
	# Submit the support pack to #~~pending~~-~~fixes~~ on our Discord. Give a description on how to add the support pack. For instance, "LiveMath Plugin support pack - Add <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code> to <code>;(plugins path)</code> and <code>%FP_LIVEMATH_PATH%;</code> to MOZ_PLUGIN_PATH in <code>FPSoftware/Basilisk-Portable/Basilisk-Portable.ini</code>".		# Submit the support pack to #plugin-chat on our Discord. Give a description on how to add the support pack. For instance, "LiveMath Plugin support pack - Add <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code> to <code>;(plugins path)</code> and <code>%FP_LIVEMATH_PATH%;</code> to MOZ_PLUGIN_PATH in <code>FPSoftware/Basilisk-Portable/Basilisk-Portable.ini</code>".
	# Submit the .7z file [https://bluepload.unstable.life/ here] if it is 1GB or less. Otherwise, a Flashpoint staff member will provide you with access to another upload location upon request. Once the file has been uploaded, add the link to your message.		# Submit the .7z file [https://bluepload.unstable.life/ here] if it is 1GB or less. Otherwise, a Flashpoint staff member will provide you with access to another upload location upon request. Once the file has been uploaded, add the link to your message.
	# Upload the curations you have made in the technology [[Submitting a Curation\|the same way as usual]]. Include links to the curations in your support pack message.		# Upload the curations you have made in the technology [[Submitting a Curation\|the same way as usual]]. Include links to the curations in your support pack message.

Nosamu: Minor clarifications

2022-04-30T06:15:20Z

Minor clarifications

Binzy Boi at 21:43, 23 January 2022

2022-01-23T21:43:43Z

← Older revision		Revision as of 23:43, 23 January 2022
Line 15:		Line 15:
	== Adding Technologies ==		== Adding Technologies ==
	# Find and download the technology. In some cases, this involves going to the Wayback Machine, especially if the technology is from the 1990s or early 2000s. LiveMath Plugin is available [http://web.archive.org/web/20060328163425if_/http://www.livemath.com/winpreview/LiveMath_Plugin_358U22_en-US.exe here].		# Find and download the technology. In some cases, this involves going to the Wayback Machine, especially if the technology is from the 1990s or early 2000s. LiveMath Plugin is available [http://web.archive.org/web/20060328163425if_/http://www.livemath.com/winpreview/LiveMath_Plugin_358U22_en-US.exe here].
	# If the technology is built into an program, such as a EXE or MSI (Windows), a DMG, PKG or ZIP (Mac) or a TAR.GZ or RUN (Linux) file, open the installer in an program (one may need to be downloaded) that can look inside the files, then locate the technology files.		# If the technology is built into an program, such as a EXE or MSI (Windows), a DMG, PKG or ZIP (Mac) or a TAR.GZ or RUN (Linux) file, open the installer in a program (one may need to be downloaded) that can look inside the files, then locate the technology files.
	# Create a folder of the name of the technology in <code>FPSoftware\BrowserPlugins</code>, located in the Flashpoint folder, in the following style: LiveMathPlugin. Move or copy the technology files to it.		# Create a folder of the name of the technology in <code>FPSoftware\BrowserPlugins</code>, located in the Flashpoint folder, in the following style: LiveMathPlugin. Move or copy the technology files to it.
	# Go to <code>FPSoftware\Basilisk-Portable</code>, then open <code>Basilisk-Portable.ini</code> in a text editor. Go to <code>;(plugins path)</code>, then add the plugin directory to the path via a variable called <code>FP_(plugin)_PATH</code>, again, using a short version of the technology name instead of <code>(plugin)</code>, fully in uppercase and without spaces. For LiveMath Plugin, this would be <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code>. Go to <code>MOZ_PLUGIN_PATH</code> and also add the variable name to it, surrounded with the % symbol and, unless placing it at the end, a semicolon at the end. For example, with all parts, it would be <code>%FP_LIVEMATH_PATH%;</code> for LiveMath Plugin. Save the file. The text editor can be closed.		# Go to <code>FPSoftware\Basilisk-Portable</code>, then open <code>Basilisk-Portable.ini</code> in a text editor. Go to <code>;(plugins path)</code>, then add the plugin directory to the path via a variable called <code>FP_(plugin)_PATH</code>, again, using a short version of the technology name instead of <code>(plugin)</code>, fully in uppercase and without spaces. For LiveMath Plugin, this would be <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code>. Go to <code>MOZ_PLUGIN_PATH</code> and also add the variable name to it, surrounded with the % symbol and, unless placing it at the end, a semicolon at the end. For example, with all parts, it would be <code>%FP_LIVEMATH_PATH%;</code> for LiveMath Plugin. Save the file. The text editor can be closed.

Nosamu at 20:07, 29 August 2021

2021-08-29T20:07:33Z

← Older revision		Revision as of 22:07, 29 August 2021
Line 17:		Line 17:
	# If the technology is built into an program, such as a EXE or MSI (Windows), a DMG, PKG or ZIP (Mac) or a TAR.GZ or RUN (Linux) file, open the installer in an program (one may need to be downloaded) that can look inside the files, then locate the technology files.		# If the technology is built into an program, such as a EXE or MSI (Windows), a DMG, PKG or ZIP (Mac) or a TAR.GZ or RUN (Linux) file, open the installer in an program (one may need to be downloaded) that can look inside the files, then locate the technology files.
	# Create a folder of the name of the technology in <code>FPSoftware\BrowserPlugins</code>, located in the Flashpoint folder, in the following style: LiveMathPlugin. Move or copy the technology files to it.		# Create a folder of the name of the technology in <code>FPSoftware\BrowserPlugins</code>, located in the Flashpoint folder, in the following style: LiveMathPlugin. Move or copy the technology files to it.
	# Go to <code>FPSoftware\Basilisk-Portable</code>, then open <code>Basilisk-Portable.ini</code> in a text editor. Go to <code>;(plugins path)</code>, then add the plugin directory to the path via a variable called <code>FP_(plugin)_PATH<code>, again, using a short version of the technology name instead of <code>(plugin)</code>, fully in uppercase and without spaces. For LiveMath Plugin, this would be <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code>. Go to <code>MOZ_PLUGIN_PATH</code> and also add the variable name to it, surrounded with the % symbol and, unless placing it at the end, a semicolon at the end. For example, with all parts, it would be <code>%FP_LIVEMATH_PATH%;</code> for LiveMath Plugin. Save the file. The text editor can be closed.		# Go to <code>FPSoftware\Basilisk-Portable</code>, then open <code>Basilisk-Portable.ini</code> in a text editor. Go to <code>;(plugins path)</code>, then add the plugin directory to the path via a variable called <code>FP_(plugin)_PATH</code>, again, using a short version of the technology name instead of <code>(plugin)</code>, fully in uppercase and without spaces. For LiveMath Plugin, this would be <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code>. Go to <code>MOZ_PLUGIN_PATH</code> and also add the variable name to it, surrounded with the % symbol and, unless placing it at the end, a semicolon at the end. For example, with all parts, it would be <code>%FP_LIVEMATH_PATH%;</code> for LiveMath Plugin. Save the file. The text editor can be closed.
	# Create at least one curation in the technology to test. Go to [[Curation Tutorial]] if you don't know how to make one. If the technology does not work, a special .bat file may need to be created for it. To do so, create a file in FPSoftware, and name it in the following style: startLiveMathPlugin.bat (please note LiveMath Plugin does not require a .bat file). A [[#Example Batch File\|short example]] is below.		# Create at least one curation in the technology to test. Go to [[Curation Tutorial]] if you don't know how to make one. If the technology does not work, a special .bat file may need to be created for it. To do so, create a file in FPSoftware, and name it in the following style: startLiveMathPlugin.bat (please note LiveMath Plugin does not require a .bat file). A [[#Example Batch File\|short example]] is below.
	# Once done, find an picture for the technology to use as the icon for the technology, or related to the technology, such as the company or the most prominent program if you can't find one. This may require some image editing, which is out of scope for this article. Export it to <code>Data\Logos</code>.		# Once done, find an picture for the technology to use as the icon for the technology, or related to the technology, such as the company or the most prominent program if you can't find one. This may require some image editing, which is out of scope for this article. Export it to <code>Data\Logos</code>.
	# Create the directories <code>Data\Logos</code> and <code>FPSoftware\Basilisk-Portable</code> separately, and the final picture and the technology files into them respectively. Place these directories into an empty 7Z file, preferably named after the technology, such as "LiveMath Plugin support pack" for LiveMath.		# Create the directories <code>Data\Logos</code> and <code>FPSoftware\Basilisk-Portable</code> separately, and the final picture and the technology files into them respectively. Place these directories into an empty 7Z file, preferably named after the technology, such as "LiveMath Plugin support pack" for LiveMath.
	# Submit the support pack to #pending-fixes on our Discord. Give a description on how to add the support pack. For instance, "LiveMath Plugin support pack - Add <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code> to <code>;(plugins path)<code> and <code>;%FP_LIVEMATH_PATH%</code> to MOZ_PLUGIN_PATH in <code>FPSoftware/Basilisk-Portable/Basilisk-Portable.ini</code>".		# Submit the support pack to #pending-fixes on our Discord. Give a description on how to add the support pack. For instance, "LiveMath Plugin support pack - Add <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code> to <code>;(plugins path)</code> and <code>;%FP_LIVEMATH_PATH%</code> to MOZ_PLUGIN_PATH in <code>FPSoftware/Basilisk-Portable/Basilisk-Portable.ini</code>".
	# Submit the .7z file [https://bluepload.unstable.life/ here] if it is 1GB or less. Otherwise, a Flashpoint staff member will provide you with access to another upload location upon request. Once the file has been uploaded, add the link to your message.		# Submit the .7z file [https://bluepload.unstable.life/ here] if it is 1GB or less. Otherwise, a Flashpoint staff member will provide you with access to another upload location upon request. Once the file has been uploaded, add the link to your message.
	# Upload the curations you have made in the technology [[Submitting a Curation\|the same way as usual]]. Include links to the curations in your support pack message.		# Upload the curations you have made in the technology [[Submitting a Curation\|the same way as usual]]. Include links to the curations in your support pack message.

Nosamu at 20:04, 29 August 2021

2021-08-29T20:04:48Z

@@ Line 1: / Line 1: @@
 This page is a basic tutorial on how Flashpoint works and how to curate support packs for addition to Flashpoint. Support packs are packs focusing on adding or adding to technologies.
 == Setting Up Our Software ==
@@ Line 21: / Line 9: @@
 == Finding the Source of a Technology ==
-'''Be sure to check the [[Technologies to Add]] and [[Curation Format#Appendix I: Flashpoint Platforms]] pages before settling on a technology! Otherwise, it might be a waste of time and effort to save a technology that's already been saved.'''
+'''Be sure to check the [[Technologies to Add]] and [[Platforms]] pages before settling on a technology! Otherwise, it might be a waste of time and effort to save a technology that's already been saved.'''
 As a tutorial, we'll start by curating the simplest type of technology: an NPAPI plugin only requiring one DLL that works offline, specifically [http://web.archive.org/web/20140106152306/http://www.livemath.com/lmplugin/ LiveMath Plugin]. LiveMath Plugin may need to be enabled in a browser to get it to play (this tutorial won't work with another player such as the LiveMath Viewer).
 == Adding Technologies ==
-. Find and download the technology. In some cases, this involves going to the Wayback Machine, especially if the technology is from the 1990s or early 2000s. LiveMath Plugin is available [http://web.archive.org/web/20060328163425if_/http://www.livemath.com/winpreview/LiveMath_Plugin_358U22_en-US.exe here].
+# Find and download the technology. In some cases, this involves going to the Wayback Machine, especially if the technology is from the 1990s or early 2000s. LiveMath Plugin is available [http://web.archive.org/web/20060328163425if_/http://www.livemath.com/winpreview/LiveMath_Plugin_358U22_en-US.exe here].
-. If the technology is built into an program, such as a EXE or MSI (Windows), a DMG, PKG or ZIP (Mac) or a TAR.GZ or RUN (Linux) file, open the installer in an program (one may need to be downloaded) that can look inside the files, then locate the technology files.
+Congratulations! Your submitted support pack and curations will appear in the next version of Flashpoint.
      @ECHO OFF
      PUSHD %~dp0
@@ Line 46: / Line 38: @@
+     )
      POPD

Childishbeat: /* Adding Technologies */ Fixed typo in source code in which a single set of square brackets was a double set instead

2021-03-19T15:55:40Z

Adding Technologies: Fixed typo in source code in which a single set of square brackets was a double set instead

← Older revision		Revision as of 17:55, 19 March 2021
Line 26:		Line 26:

	== Adding Technologies ==		== Adding Technologies ==
	1. Find and download the technology. In some cases, this involves going to the Wayback Machine, especially if the technology is from the 1990s or early 2000s. LiveMath Plugin is available [[http://web.archive.org/web/20060328163425if_/http://www.livemath.com/winpreview/LiveMath_Plugin_358U22_en-US.exe here]].		1. Find and download the technology. In some cases, this involves going to the Wayback Machine, especially if the technology is from the 1990s or early 2000s. LiveMath Plugin is available [http://web.archive.org/web/20060328163425if_/http://www.livemath.com/winpreview/LiveMath_Plugin_358U22_en-US.exe here].

	2. If the technology is built into an program, such as a EXE or MSI (Windows), a DMG, PKG or ZIP (Mac) or a TAR.GZ or RUN (Linux) file, open the installer in an program (one may need to be downloaded) that can look inside the files, then locate the technology files.		2. If the technology is built into an program, such as a EXE or MSI (Windows), a DMG, PKG or ZIP (Mac) or a TAR.GZ or RUN (Linux) file, open the installer in an program (one may need to be downloaded) that can look inside the files, then locate the technology files.

← Older revision		Revision as of 04:33, 16 July 2023
Line 2:		Line 2:

	== Setting Up Our Software ==		== Setting Up Our Software ==
	To download technology files from the Internet, you'll need:		To download technology files from the Internet, you'll need a modern browser such as Chrome or Firefox, which can be used to find and grab the technology files, mostly found within installer EXEs or MSIs.
	* Flashpoint Core, used to add and test new technologies. It can be found at the bottom of our [https://bluemaxima.org/flashpoint/downloads/ Downloads] page. '''DO NOT''' use Flashpoint Infinity to curate, or test support packs.
	* A modern browser such as Chrome or Firefox, which can be used to find and grab the technology files, mostly found within installer EXEs or MSIs.

	Download Flashpoint ~~Core~~, extract it to an internal or external drive, run it via its shortcut in the extracted folder, and make sure that the included games play properly before you continue.		Download Flashpoint, extract it to an internal or external drive, run it via its shortcut in the extracted folder, and make sure that the included games play properly before you continue.

	== Finding the Source of a Technology ==		== Finding the Source of a Technology ==
Line 17:		Line 15:
	# If the technology is built into an program, such as a EXE or MSI (Windows), a DMG, PKG or ZIP (Mac) or a TAR.GZ or RUN (Linux) file, open the installer in a program such as 7-Zip that can look inside the files, then locate the technology files.		# If the technology is built into an program, such as a EXE or MSI (Windows), a DMG, PKG or ZIP (Mac) or a TAR.GZ or RUN (Linux) file, open the installer in a program such as 7-Zip that can look inside the files, then locate the technology files.
	# Create a folder of the name of the technology in <code>FPSoftware\BrowserPlugins</code>, located in the Flashpoint folder, in the following style: LiveMathPlugin. Move or copy the technology files to it.		# Create a folder of the name of the technology in <code>FPSoftware\BrowserPlugins</code>, located in the Flashpoint folder, in the following style: LiveMathPlugin. Move or copy the technology files to it.
	# Go to <code>FPSoftware\~~Basilisk~~-~~Portable~~</code>, then open <code>~~Basilisk-Portable~~.ini</code> in a text editor. Go to <code>;(plugins path)</code>, then add the plugin directory to the path via a variable called <code>FP_(plugin)_PATH</code>, again, using a short version of the technology name instead of <code>(plugin)</code>, fully in uppercase and without spaces. For LiveMath Plugin, this would be <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code>. Go to <code>MOZ_PLUGIN_PATH</code> and also add the variable name to the end of that line. Surround the variable name with with the percent <code>%</code> symbol and place a semicolon <code>;</code> at the end. For example, with all parts, it would be <code>%FP_LIVEMATH_PATH%;</code> for LiveMath Plugin. Save the file. The text editor can be closed.		# Go to <code>FPSoftware\fpnavigator-portable</code>, then open <code>FPNavigator.ini</code> in a text editor. Go to <code>;(plugins path)</code>, then add the plugin directory to the path via a variable called <code>FP_(plugin)_PATH</code>, again, using a short version of the technology name instead of <code>(plugin)</code>, fully in uppercase and without spaces. For LiveMath Plugin, this would be <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code>. Go to <code>MOZ_PLUGIN_PATH</code> and also add the variable name to the end of that line. Surround the variable name with with the percent <code>%</code> symbol and place a semicolon <code>;</code> at the end. For example, with all parts, it would be <code>%FP_LIVEMATH_PATH%;</code> for LiveMath Plugin. Save the file. The text editor can be closed.
	# Create at least one curation in the technology to test. Go to [[Curation Tutorial]] if you don't know how to make one. If the technology does not work, a special .bat file may need to be created for it. To do so, create a file in FPSoftware, and name it in the following style: startLiveMathPlugin.bat (please note LiveMath Plugin does not require a .bat file). A [[#Example Batch File\|short example]] is below.		# Create at least one curation in the technology to test. Go to [[Curation Tutorial]] if you don't know how to make one. If the technology does not work, a special .bat file may need to be created for it. To do so, create a file in FPSoftware, and name it in the following style: startLiveMathPlugin.bat (please note LiveMath Plugin does not require a .bat file). A [[#Example Batch File\|short example]] is below.
	# Once done, find an picture for the technology to use as the icon for the technology, or related to the technology, such as the company or the most prominent program if you can't find one. This may require some image editing, which is out of scope for this article. Export it to <code>Data\Logos</code>.		# Once done, find an picture for the technology to use as the icon for the technology, or related to the technology, such as the company or the most prominent program if you can't find one. This may require some image editing, which is out of scope for this article. Export it to <code>Data\Logos</code>.
	# Create the directories <code>Data\Logos</code> and <code>FPSoftware\BrowserPlugins</code> separately, and the final picture and the technology files into them respectively. Place these directories into an empty 7Z file, preferably named after the technology, such as "LiveMath Plugin support pack" for LiveMath.		# Create the directories <code>Data\Logos</code> and <code>FPSoftware\BrowserPlugins</code> separately, and the final picture and the technology files into them respectively. Place these directories into an empty 7Z file, preferably named after the technology, such as "LiveMath Plugin support pack" for LiveMath.
	# Submit the support pack to #~~plugin-chat~~ on our Discord. Give a description on how to add the support pack. For instance, "LiveMath Plugin support pack - Add <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code> to <code>;(plugins path)</code> and <code>%FP_LIVEMATH_PATH%;</code> to MOZ_PLUGIN_PATH in <code>FPSoftware~~/Basilisk~~-~~Portable/Basilisk-Portable~~.ini</code>".		# Submit the support pack to #plugins on our Discord. Give a description on how to add the support pack. For instance, "LiveMath Plugin support pack - Add <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code> to <code>;(plugins path)</code> and <code>%FP_LIVEMATH_PATH%;</code> to MOZ_PLUGIN_PATH in <code>FPSoftware\fpnavigator-portable\FPNavigator.ini</code>".
	# Submit the .7z file [https://bluepload.unstable.life/ here] if it is 1GB or less. Otherwise, a Flashpoint staff member will provide you with access to another upload location upon request. Once the file has been uploaded, add the link to your message.		# Submit the .7z file [https://bluepload.unstable.life/ here] if it is 1GB or less. Otherwise, a Flashpoint staff member will provide you with access to another upload location upon request. Once the file has been uploaded, add the link to your message.
	# Upload the curations you have made in the technology [[Submitting a Curation\|the same way as usual]]. Include links to the curations in your support pack message.		# Upload the curations you have made in the technology [[Submitting a Curation\|the same way as usual]]. Include links to the curations in your support pack message.

← Older revision		Revision as of 08:15, 30 April 2022
Line 11:		Line 11:
	'''Be sure to check the [[Technologies to Add]] and [[Platforms]] pages before settling on a technology! Otherwise, it might be a waste of time and effort to save a technology that's already been saved.'''		'''Be sure to check the [[Technologies to Add]] and [[Platforms]] pages before settling on a technology! Otherwise, it might be a waste of time and effort to save a technology that's already been saved.'''

	As a tutorial, we'll start by curating the simplest type of technology: an NPAPI plugin only requiring one DLL that works offline, specifically [http://web.archive.org/web/20140106152306/http://www.livemath.com/lmplugin/ LiveMath Plugin]. LiveMath Plugin may need to be enabled in a browser to get it to play (this tutorial won't work with another player such as the LiveMath Viewer).		As a tutorial, we'll start by curating the simplest type of technology: an NPAPI plugin only requiring one DLL that works offline, specifically [http://web.archive.org/web/20140106152306/http://www.livemath.com/lmplugin/ LiveMath Plugin]. LiveMath Plugin may need to be enabled in a browser to get it to play (this tutorial won't work with another player such as the LiveMath Viewer). Note that some technologies may be implemented as standalone players, Netscape plugins, or ActiveX controls; the process for adding each of these types of technologies is different from the process explained below.

	== Adding Technologies ==		== Adding Technologies ==
	# Find and download the technology. In some cases, this involves going to the Wayback Machine, especially if the technology is from the 1990s or early 2000s. LiveMath Plugin is available [http://web.archive.org/web/20060328163425if_/http://www.livemath.com/winpreview/LiveMath_Plugin_358U22_en-US.exe here].		# Find and download the technology. In some cases, this involves going to the Wayback Machine, especially if the technology is from the 1990s or early 2000s. LiveMath Plugin is available [http://web.archive.org/web/20060328163425if_/http://www.livemath.com/winpreview/LiveMath_Plugin_358U22_en-US.exe here].
	# If the technology is built into an program, such as a EXE or MSI (Windows), a DMG, PKG or ZIP (Mac) or a TAR.GZ or RUN (Linux) file, open the installer in a program ~~(one may need to be downloaded)~~ that can look inside the files, then locate the technology files.		# If the technology is built into an program, such as a EXE or MSI (Windows), a DMG, PKG or ZIP (Mac) or a TAR.GZ or RUN (Linux) file, open the installer in a program such as 7-Zip that can look inside the files, then locate the technology files.
	# Create a folder of the name of the technology in <code>FPSoftware\BrowserPlugins</code>, located in the Flashpoint folder, in the following style: LiveMathPlugin. Move or copy the technology files to it.		# Create a folder of the name of the technology in <code>FPSoftware\BrowserPlugins</code>, located in the Flashpoint folder, in the following style: LiveMathPlugin. Move or copy the technology files to it.
	# Go to <code>FPSoftware\Basilisk-Portable</code>, then open <code>Basilisk-Portable.ini</code> in a text editor. Go to <code>;(plugins path)</code>, then add the plugin directory to the path via a variable called <code>FP_(plugin)_PATH</code>, again, using a short version of the technology name instead of <code>(plugin)</code>, fully in uppercase and without spaces. For LiveMath Plugin, this would be <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code>. Go to <code>MOZ_PLUGIN_PATH</code> and also add the variable name to ~~it, surrounded~~ with the % symbol and~~, unless placing it at the end,~~ a semicolon at the end. For example, with all parts, it would be <code>%FP_LIVEMATH_PATH%;</code> for LiveMath Plugin. Save the file. The text editor can be closed.		# Go to <code>FPSoftware\Basilisk-Portable</code>, then open <code>Basilisk-Portable.ini</code> in a text editor. Go to <code>;(plugins path)</code>, then add the plugin directory to the path via a variable called <code>FP_(plugin)_PATH</code>, again, using a short version of the technology name instead of <code>(plugin)</code>, fully in uppercase and without spaces. For LiveMath Plugin, this would be <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code>. Go to <code>MOZ_PLUGIN_PATH</code> and also add the variable name to the end of that line. Surround the variable name with with the percent <code>%</code> symbol and place a semicolon <code>;</code> at the end. For example, with all parts, it would be <code>%FP_LIVEMATH_PATH%;</code> for LiveMath Plugin. Save the file. The text editor can be closed.
	# Create at least one curation in the technology to test. Go to [[Curation Tutorial]] if you don't know how to make one. If the technology does not work, a special .bat file may need to be created for it. To do so, create a file in FPSoftware, and name it in the following style: startLiveMathPlugin.bat (please note LiveMath Plugin does not require a .bat file). A [[#Example Batch File\|short example]] is below.		# Create at least one curation in the technology to test. Go to [[Curation Tutorial]] if you don't know how to make one. If the technology does not work, a special .bat file may need to be created for it. To do so, create a file in FPSoftware, and name it in the following style: startLiveMathPlugin.bat (please note LiveMath Plugin does not require a .bat file). A [[#Example Batch File\|short example]] is below.
	# Once done, find an picture for the technology to use as the icon for the technology, or related to the technology, such as the company or the most prominent program if you can't find one. This may require some image editing, which is out of scope for this article. Export it to <code>Data\Logos</code>.		# Once done, find an picture for the technology to use as the icon for the technology, or related to the technology, such as the company or the most prominent program if you can't find one. This may require some image editing, which is out of scope for this article. Export it to <code>Data\Logos</code>.
	# Create the directories <code>Data\Logos</code> and <code>FPSoftware\~~Basilisk-Portable~~</code> separately, and the final picture and the technology files into them respectively. Place these directories into an empty 7Z file, preferably named after the technology, such as "LiveMath Plugin support pack" for LiveMath.		# Create the directories <code>Data\Logos</code> and <code>FPSoftware\BrowserPlugins</code> separately, and the final picture and the technology files into them respectively. Place these directories into an empty 7Z file, preferably named after the technology, such as "LiveMath Plugin support pack" for LiveMath.
	# Submit the support pack to #pending-fixes on our Discord. Give a description on how to add the support pack. For instance, "LiveMath Plugin support pack - Add <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code> to <code>;(plugins path)</code> and <code>;%FP_LIVEMATH_PATH%</code> to MOZ_PLUGIN_PATH in <code>FPSoftware/Basilisk-Portable/Basilisk-Portable.ini</code>".		# Submit the support pack to #pending-fixes on our Discord. Give a description on how to add the support pack. For instance, "LiveMath Plugin support pack - Add <code>FP_LIVEMATH_PATH=%FP_BROWSER_PLUGINS%\LiveMathPlugin</code> to <code>;(plugins path)</code> and <code>%FP_LIVEMATH_PATH%;</code> to MOZ_PLUGIN_PATH in <code>FPSoftware/Basilisk-Portable/Basilisk-Portable.ini</code>".
	# Submit the .7z file [https://bluepload.unstable.life/ here] if it is 1GB or less. Otherwise, a Flashpoint staff member will provide you with access to another upload location upon request. Once the file has been uploaded, add the link to your message.		# Submit the .7z file [https://bluepload.unstable.life/ here] if it is 1GB or less. Otherwise, a Flashpoint staff member will provide you with access to another upload location upon request. Once the file has been uploaded, add the link to your message.
	# Upload the curations you have made in the technology [[Submitting a Curation\|the same way as usual]]. Include links to the curations in your support pack message.		# Upload the curations you have made in the technology [[Submitting a Curation\|the same way as usual]]. Include links to the curations in your support pack message.