Submission Testing Instructions: Difference between revisions

From Flashpoint Datahub
Jump to navigation Jump to search
(Remove (via Wayback Machine) method)
(Added content patches inability to change tags and platforms to the respective fields)
 
(4 intermediate revisions by 4 users not shown)
Line 1: Line 1:
==How To Test Using the FPFSS==
In order to test submissions, you must be a Staff Member with the Curator role in the Discord server. The process for how to test a submission is fairly simple and is similar to the old Batch Check system.


In order to test submissions, you must be a Staff Member with the Curator role in the Discord server. The process for how to test a submission is fairly simple, and is similar to the old Batch Check system.
==Using FPFSS==
# Assign yourself to the submission(s) you want to test. The '''Ready for Testing''' and '''Ready for Verification''' buttons at the top of [https://fpfss.unstable.life/ FPFSS]'s '''Browse Submissions''' page will provide you with a list of submissions in need of testing, sorted by oldest first. The former option will show you submissions that have not been reviewed at all yet, while the latter shows ones that have been tested by one staff member already and need to be double checked. There is no difference in the process whether you are testing or verifying, other than having to use the blue '''Assign Testing''' button if you are testing and the brown '''Assign Verification''' if you are verifying. If you just want to test curations and not [[Content Patches|content patches]], go to the '''Filter by type''' section in the '''Quick filters''' menu and select '''Curations'''.  ‎<br /> If you are assigning yourself to a single submission, go to the submission's page and click the appropriate assignment button at the bottom of the page. If you are assigning yourself to multiple submissions, check the boxes for each submission you want on the left side of the list on the Browse page then use the assignment buttons at the bottom of the list to apply the action to all selected submissions.
# Use the '''Get''' button to download that submission or, for multiple submissions, with the boxes still checked from when you assigned yourself to them, use the '''Download Selected''' button near the bottom of the pag to compress all of the submissions together as a file that will need to be extracted using 7-Zip before you can open them.
# In your Flashpoint's Curate tab, use the '''Load Archive''' button at the right panel and select the downloaded file(s). Check over their metadata for any errors and run each submission to make sure it works (do not use MAD4FP). You are not required to play through the entire game, but enough that you can be confident that it works.
[[File:FPFSS Buttons.PNG|thumb|300px|Actions available while testing and verifying, respectively.]]
# <li value="4"> Submit an action on the submission. There are a number of buttons that will appear at the bottom of a submission's page when you are assigned to it:
## '''Comment''' - Adds a message on the page and pings the submitter. You can use this action even if you are not assigned to the submission.
## '''Unassign Testing'''/'''Unassign Verification''' - Removes the submission from your assignments and returns it to the queue so that another tester can test it.
## '''Request Changes''' - If there is an issue with the submission that needs to be corrected, write a message in the Comment box explaining the problem and then use this button. Once the submitter has fixed the submission, you can look over again and approve it if everything has been corrected.
## '''Approve'''/'''Verify''' - Marks that everything is correct and working with the submission. This can also be done as a batch action, applying it to multiple submissions at once. With the boxes of all submissions you want to Approve or Verify checked, you can use the appropriate button at the bottom of the page.
## '''Reject''' - Removes the submission from the queue, used for duplicates of games already in Flashpoint or FPFSS. Write the reason for the rejection in the Comment box before using this action.
## '''Delete''' - Available to Moderators, removes the submission from FPFSS entirely. Should only be used if a submission is on the [[Not Accepted Curations]] list. If you are not a Moderator and come across a submission that needs to be deleted, ask in one of the staff channels for a Mod to take care of it.


# The first step is to assign yourself to the submission(s) you want to test. The '''Ready for Testing''' and '''Ready for Verification''' buttons near the top of the '''Browse Submissions''' page on the FPFSS will provide you with a list of submissions in need of testing, sorted by oldest first. The '''Ready for Testing''' option will show you submissions that have not been reviewed at all yet, while the '''Ready for Verification''' option will show you ones that have been tested by one staff member already and need to be double checked. There is no difference in the process whether you are Testing or Verifying, other than making sure to use the blue '''Assign Testing''' button if you are Testing and the brown '''Assign Verification''' if you are verifying. If you just want to test curations and not content fixes, go to the '''Filter by type''' section in the '''Quick filters''' menu and select '''Curations'''.  ‎<br /> If you are assigning yourself to a single submission, go to the submission's page and click the appropriate assignment button at the bottom of the page. If you are assigning yourself to multiple submissions, check the boxes for each submission you want on the left side of the list on the Browse page. Then use the assignment buttons at the bottom of the list to apply the action to all selected submissions.
==Basic metadata requirements==
# Next you'll need to download the submission(s). For a single submission, use the '''Download Latest Version''' button on the submission's page. For multiple submissions, with the boxes still checked from when you assigned yourself to them, use the '''Download Selected''' button near the bottom of the page. It will compress all of the submissions together as a file that will need to be extracted using 7-Zip before you can open the submissions in Core.
If you're unsure whether something is allowed, you may ask in one of the staff channels.
# The next thing you'll need to do is open the submissions in Core. In the Curate tab, use the '''Load Archive''' in the right panel and select the downloaded curation file(s). Once Core has opened all of the files, you can start testing. You'll need to check over the metadata for any errors, as well as running the submission to make sure it works. You are not required to play through the entire game, you only need to play enough that you can be confident that it works.
## For submissions which are very large in file size or have a large number of files, it may be helpful to use the Symlink option found in the right panel of the Curate tab, making sure to use the regular Run button and not Run with MAD4FP. This will cause Core to run the curation from the submission's Content folder directly instead of copying the files into <code>Legacy/htdocs</code>. This will make the curation launch much faster.
# The last thing you'll need to do is submit an action on the submission. There are a number of buttons that will appear at the bottom of a submission's page when you are assigned to it. These are:
## '''Comment''' - This button will not affect the submission's current approval status and will ping the submitter to pass along your message to them. You can use this action even if you are not assigned to the submission. [[File:FPFSS Buttons.PNG|thumb|300px|The top image shows the actions available while Testing. The bottom shows the actions available while Verifying.]]
## '''Unassign Testing'''/'''Unassign Verification''' - Depending on whether you are assigned to Test or Verify the submission, one of these two buttons will be present. This will remove the submission from your assignments and return it to the queue so that another tester can test it.
## '''Request Changes''' - If there is an issue with the submission that needs to be corrected, you'll need to write your message in the Comment box explaining the problem and then use this button. Once the submitter has fixed the submission, you'll be able to look over the submission again and Approve it if everything has been corrected.
## '''Approve'''/'''Verify''' - This action means that everything is correct and working with the submission. This can also be done as a batch action, applying it to multiple submissions at once. With the boxes of all submissions you want to Approve or Verify checked, you can use the appropriate button at the bottom of the page.
## '''Reject''' - This action removes the submission from the queue, and should only be used for duplicates of games already in Flashpoint or previously submitted to the FPFSS. You will need to write the reason for the rejection in the Comment box before using this action.
## '''Delete''' - This action is only available to Moderators and removes the submission from the FPFSS entirely. It should only be used if a submission is something on the [[Not Accepted Curations]] list. If you are not a Moderator and come across a submission that needs to be deleted, you'll need to ask in one of the staff channels for a Mod to take care of it.
 
==Checking Metadata==
 
This list contains the basic requirements for each metadata field, however this is not a complete list of all ways that the metadata can be correct or incorrect. If you're unsure whether something is allowed, you should ask in one of the staff channels.


{| class="wikitable sortable"
{| class="wikitable sortable"
Line 37: Line 35:
|-
|-
| '''Series'''
| '''Series'''
|The Series field should not be the franchise it relates to, a Franchise Tag should be added to the curation instead if it isn't already.
| Should not be the franchise it relates to.
:- e.g. a Mario game should have the <code>Super Mario</code> tag and not "Super Mario" in the Series field.
:- e.g. a Mario game should have the <code>Super Mario</code> tag and not "Super Mario" in the Series field.
:- If an unofficial series uses this name, request the field to be <code>Super Mario (dev/publisher's name)</code> instead.
|-
|-
| '''Developer''' and '''Publisher'''
| '''Developer''' and '''Publisher'''
| Changes should be requested for either of these two fields if:
| Changes should be requested for either if:
* The field is wrong.
* The field is wrong.
* There is nothing in the field despite Developer or Publisher is shown in an obvious place in the game/animation.
* There is nothing in the field despite Developer or Publisher is shown in an obvious place in the game/animation.
Line 54: Line 53:
* The curation has no Gameplay (or Animation) Tags or if the Gameplay tags it has are incorrect.
* The curation has no Gameplay (or Animation) Tags or if the Gameplay tags it has are incorrect.
* The tag is no longer used, e.g. <code>LEGACY-Extreme</code>, <code>Find</code>, <code>Unusual Input</code>. These tags should not be added to any new submissions.
* The tag is no longer used, e.g. <code>LEGACY-Extreme</code>, <code>Find</code>, <code>Unusual Input</code>. These tags should not be added to any new submissions.
This section is '''not relevant''' if you're testing content patches since they are unable to change tags.
|-
|-
| '''Play Mode'''
| '''Play Mode'''
Line 64: Line 64:
|-
|-
| '''Version''' and '''Release Date'''
| '''Version''' and '''Release Date'''
| These fields are only incorrect if the information is wrong. The information being missing is not something that needs to have changes requested for.
| Only incorrect if the information is wrong. The information being missing is not something that needs to have changes requested for.
|-
|-
| '''Language'''
| '''Language'''
Line 79: Line 79:
|-
|-
| '''Platform'''
| '''Platform'''
| Changes should be requested if this field is incorrect.
| Changes should be requested if this field is incorrect. For information specific to each Platform go to [[#Platform Specific Requirements|Platform Specific Requirements]].
For information specific to each Platform go to [[#Platform Specific Requirements]].
This section is '''not relevant''' if you're testing content patches since they are unable to change the platform.
|-
|-
| '''Application Path'''
| '''Application Path'''
Line 103: Line 103:
* The Notes are overly long or complex at explaining some information the player needs.
* The Notes are overly long or complex at explaining some information the player needs.
* The submission has an Extras Application, but no Note explaining what the Extras are.
* The submission has an Extras Application, but no Note explaining what the Extras are.
* The submission is accompanied with the <code>Broken Feature</code> tag, but there is no note explaining what is broken.
|-
|-
| '''Original Description'''
| '''Original Description'''
| This field is only incorrect if what's in it is not an Original Description. This includes the curator making up their own description or the Notes or Curation Notes being in the wrong field.
| Only incorrect if what's in it is not an Original Description. This includes the curator making up their own description or the Notes or Curation Notes being in the wrong field.
|-
|-
| '''Curation Notes'''
| '''Curation Notes'''
| This field is only incorrect if the information in it should actually be in the Notes field. Since the Curation Notes are not kept when the submission is added to Flashpoint, unnecessary text is not an issue.
| Only incorrect if the information in it should actually be in the Notes field. Since the Curation Notes are not kept when the submission is added to Flashpoint, unnecessary text is not an issue.
|-
|-
| '''Alternate Applications'''
| '''Alternate Applications'''
| Changes should be requested if:
| Changes should be requested if:
* The Application doesn't work.
* The Application doesn't work. (Note: there's currently a bug for running alternate apps in the Curate tab, so you'll need to replace the launch command with them during testing)
* Any of the fields for the Application are empty.
* Any of the fields is empty or incorrect. This requirements also apply to the fields of Alternate Applications.
* The Application is irrelevant to the Main Application.
* The Application is unrelated to the Main Application.
* The Application Path or Launch Command is incorrect. All of the same requirements apply to these fields for Alternate Applications.
|-
|-
| '''Extras'''
| '''Extras'''
Line 124: Line 124:
* The Extras folder is empty.
* The Extras folder is empty.
* The Extras folder is inside the Content folder.
* The Extras folder is inside the Content folder.
* The '''Extras Folder''' field is empty or is something not specific to the curation such as "Extras" or "Game". This field should be roughly the name of the curation without spaces, but it doesn't need to be exact.
* The field is empty or is something not specific to the curation such as "Extras" or "Game". This field should be roughly the name of the curation without spaces, but it doesn't need to be exact.
* The '''Extras Folder''' field contains spaces or punctuation.
* The field contains spaces or punctuation.
* An Extras folder is included in the curation, but there is no Extras Application to go with it.
* An Extras folder is included in the curation, but there is no Extras Application to go with it.
* There is more than one Extras Application.
* There is more than one Extras Application.
Line 152: Line 152:
| Changes should be requested if:
| Changes should be requested if:
* The curation doesn't work.
* The curation doesn't work.
* The curation contains a large amount of unnecessary files or contains files for other games.
* The curation contains unnecessary files including files for other games.
* Contains any DLL files.
** EXE files are allowed in the Extras folder only.
* Contains EXE files in the Content folder. These files are allowed in the Extras folder only.
* Files have been hacked but the original, unhacked files aren't in the Content folder.
* Files have been hacked but the originals, unhacked files aren't in the Content folder.
|}
|}


==Platform Specific Requirements==
==Platform Specific Requirements==


Some Platforms have their own specific requirements for what makes a properly curated submission. These things will need to be checked when testing a game of that Platform. If a Platform is not listed in the sections below, it has no special requirements. For submissions of those Platforms, you will only need to check whether it works.
If a Platform is not listed below, you will only need to check whether it works.


===Common Platforms===
===Common Platforms===


====Flash====
;Flash


Flash is the most common Platform you will come across while testing.
* Flash submissions must run in Flash Player or Basilisk. Which of the two a submission runs in, or what version of Flash Player is chosen, does not matter as long as the submission works as intended.
* Flash submissions cannot be run in Browser Mode.
* Flash submissions cannot be run in Browser Mode.
* If the submission is set to run in Basilisk, it should typically have an HTML embed. Games that run properly in a full screen size may be fine without embed.
* If the submission is using FPNavigator, it should typically have an HTML embed. Games that run properly in a full screen size may be fine without embed.
* Submissions running in Flash Player should not open tabs in the user's normal browser when run or when clicking buttons that aren't supposed to link to other websites. If a game has this issue, it should be run in Basilisk using an HTML embed. An exception is made for games which need an older version of Flash Player than Flash 32, as they cannot be run in Basilisk, however they do need a Note about the issue.
* Flash submissions should not open tabs in the user's normal browser when run or when clicking buttons that aren't supposed to link to other pages. If a game has this issue, it should be run in FPNavigator using an HTML embed. An exception is made for games which need an older version of Flash Player than Flash 32, as they cannot be run in FPNavigator, however they do need a Note about the issue.


====Shockwave====
;Shockwave


* Shockwave submissions must run in the Shockwave Projector or in Basilisk.
* If the submission is running in FPNavigator, it must have an HTML embed. Unlike with Flash, there is no exception to this.
* If the submission is running in Basilisk, it must have an HTML embed. Unlike with Flash, there is no exception to this.
* Curations should not have Script Errors unless absolutely unavoidable and with a Note explaining the issue.
* Shockwave curations should not have Script Errors unless absolutely unavoidable and with a Note explaining the issue.
* Curations running in the Shockwave Projector should close by clicking the X button in the top right corner.
* Curations running in the Shockwave Projector should close by clicking the X button in the top right corner.
* Submissions running in the Shockwave Projector should not open tabs in the user's normal browser.
* Submissions running in the Shockwave Projector should not open tabs in the user's normal browser.


====HTML5====
;HTML5
[[File:UnityWebglError.PNG|thumb|300px|Submissions with a QuotaExeededError will need to be run in a browser other than Basilisk.]]
[[File:UnityWebglError.PNG|thumb|300px|Submissions with a QuotaExeededError will need to be run in a browser other than FPNavigator.]]
* HTML5 submissions can run in any of the five browsers currently in Flashpoint. The chosen browser does not matter as long as the submission works as intended.
* HTML5 submissions can run in any of the browsers currently in Flashpoint. The chosen browser does not matter as long as the submission works as intended.
* If the submission gives a <code>QuotaExeededError</code> or any other error related to the browser it's running in, changes should be requested to have it run in a different browser, unless the error is unavoidable and a Note is included.
* If the submission gives a <code>QuotaExeededError</code> or any other error related to the browser it's running in, changes should be requested to have it run in a different browser, unless the error is unavoidable and a Note is included.
* HTML5 submissions should run as intended with the browser window at full size, unless otherwise Noted.
* Submissions should run as intended with the browser window at full size, unless otherwise Noted.
* HTML5 Alternate Applications cannot run in Browser Mode.
* HTML5 Alternate Applications cannot run in Browser Mode.


====Unity====
;Unity


* Unity submissions must have an HTML embed, without exception.
* Unity submissions must have an HTML embed, without exception.
* Unity submissions cannot contain a <code>webplayer.unity3d.com</code> folder with updater files inside.
* Unity submissions cannot contain a <code>webplayer.unity3d.com</code> folder with updater files inside.


====Java====
;Java


* If the submission is running in browser, it should have a Curation Note listing a domain that needs to be added to the Exceptions List.
* If the submission is running in browser, it should have a Curation Note listing a domain that needs to be added to the Exceptions List.
* Before testing a Java submission that runs in browser, you will need to copy and paste that domain onto the end of the file <code>FPSoftware\Java\JDK_1.8.0_181\jre\lib\exception.sites</code> in your Core folder. If the domain is already on the list, then this is not needed.
* Before testing a Java submission that runs in browser, you will need to copy and paste that domain onto the end of the file <code>FPSoftware\Java\JDK_1.8.0_181\jre\lib\exception.sites</code> in your Flashpoint folder. If the domain is already on the list, then this is not needed.
* Java submissions instead running in AppletViewer should not have a Curation Note about an exception.
* Java submissions running in AppletViewer instead should not have a Curation Note about an exception.


===Less Common Platforms===
===Other Platforms===


====ActiveX====
;ActiveX


ActiveX submissions will have a <code>FPSoftware</code> folder next to their Content folder. This folder will need to be merged with Core's <code>FPSoftware</code> folder before testing.
ActiveX submissions should have a <code>FPSoftware</code> folder next to their Content folder. This folder will need to be merged with Flashpoint's <code>FPSoftware</code> folder before testing.


If this folder is missing, inside the Content folder, or is otherwise incorrect, the submission is not properly curated and changes will need to be requested.
If this folder is missing, inside the Content folder, or is otherwise incorrect, the submission is not properly curated and changes will need to be requested.


====BitPlayer====
;BitPlayer


If you've never tested a BitPlayer submission before, you'll need to set up a Testing Curation in the Games tab of Core. In the Games tab, you will need to click the New Game button in the bottom right of the window. The only field you need to fill out is the Application Path, which needs to be <code>FPSoftware\FlashpointSecurePlayer.exe</code>. You can set any other fields however you want.
If you've never tested a BitPlayer submission before, you'll need to set up a Testing Curation in Flashpoint's Games tab. In the Games tab, you will need to click the New Game button in the bottom right of the window. The only field you need to fill out is the Application Path, which needs to be <code>FPSoftware\FlashpointSecurePlayer.exe</code>. You can set any other fields however you want.


When testing a BitPlayer submission, you'll need to copy all of the files in the Content folder and move them into the <code>Legacy/htdocs</code> folder of Core. You'll then copy the submission's Launch Command and paste it into your Testing Curation's Launch Command field. Then run the submission using the Testing Curation's Play button.
When testing a BitPlayer submission, you'll need to copy all of the files in the Content folder and move them into Flashpoint's <code>Legacy/htdocs</code> folder. You'll then copy the submission's Launch Command and paste it into your Testing Curation's Launch Command field. Then run the submission using the Testing Curation's Play button.


Bitplayer Submissions must have the <code>-extract</code> Mount Parameter.
Bitplayer Submissions must have the <code>-extract</code> Mount Parameter.


====Hyper-G and Hypercosm====
;Hyper-G and Hypercosm
[[File:HypercosmError.PNG|thumb|350px|If you get an error like this while testing Hypercosm, it means you didn't copy over the files.]]
[[File:HypercosmError.PNG|thumb|350px|If you get an error like this while testing Hypercosm, it means you didn't copy over the files.]]
Before you can test a Hyper-G or Hypercosm submission, you will need to copy all of the files in the Content folder and move them to Core's <code>Legacy/htdocs</code> folder. You can then test the submission as normal.
Before testing a Hyper-G or Hypercosm submission, copy all of the files in the Content folder to Flashpoint's <code>Legacy/htdocs</code> folder. Submissions of these Platforms must also have the <code>-extract</code> Mount Parameter.


Submissions of these Platforms must have the <code>-extract</code> Mount Parameter.
;VRML


====VRML====
A small number of curations need to use the Application Path <code>FPSoftware\startVRweb.bat</code>, these requiring you to copy its files from the Content folder to Flashpoint's <code>Legacy/htdocs</code> folder before testing. They must also have the <code>-extract</code> Mount Parameter.
 
The majority of VRML submissions can be tested as normal with no special requirements. However, a small number of them will use the Application Path <code>FPSoftware\startVRweb.bat</code>. Submissions with this Application Path must have all of the files from the Content folder copied and moved to the <code>Legacy/htdocs</code> folder of Core before testing. These VRML submissions are required to the <code>-extract</code> Mount Parameter.


==Frequently Asked Questions==
==Frequently Asked Questions==


;What is the difference between Approving and Verifying?
;What is the difference between Approving and Verifying?
: There isn't any significant difference between the two. Two people are required to test a submission before it can be added to Flashpoint. The Approver is the first person and the Verifier is the second. The process for testing the submission is the same regardless.
: Two people are required to test a submission before it can be added to Flashpoint. The Approver is the first person and the Verifier is the second. The process for testing the submission is the same regardless.
;What do I do if I Reject a submission by mistake?
;What do I do if I Reject a submission by mistake?
: Moderators are able to undo rejections by deleting the rejection comment. If you are not a Moderator, you will need to ask one to do this for you.
: Moderators are able to undo rejections by deleting the rejection comment. If you are not a Moderator, you will need to ask one to do this for you.
Line 234: Line 227:
: The '''Assigned to me for Testing''' and '''Assigned to me for Verification''' buttons at the top of the Browse Submissions page will take you to a list of your assignments for each stage of testing.
: The '''Assigned to me for Testing''' and '''Assigned to me for Verification''' buttons at the top of the Browse Submissions page will take you to a list of your assignments for each stage of testing.
;Is it okay if I only test Flash submissions?
;Is it okay if I only test Flash submissions?
: The overwhelming majority of submissions are Flash, so that's where we need the most people working. While Non-Flash Platform submissions do still obviously need to be tested, Flash submissions are the priority. We always need more testers and it doesn't really matter if you only test Flash ones.
: We always need more testers but there's no problem if you only test specific ones.
;I requested changes on a submission and the submitter never fixed it. What do I do?
;I requested changes on a submission and the submitter never fixed it. What do I do?
: If the person is active in the Discord server and has submitted curations in the time since you requested the changes, they probably didn't see the request or forgot about it. Send a Comment on the submission or ping them in the Discord server to see if they're going to fix it. If the person isn't active in the server and hasn't been submitting curations, and it has been over a month since you requested the changes, you can go ahead and fix it yourself if you want to. If you submit a fix for a submission you requested changes on, you'll need to have a Moderator remove the Request Changes comment so that another tester can test the submission.
: If the person is active in the Discord server and has submitted curations in the time since you requested the changes, they probably didn't see the request or forgot about it. Send a Comment on the submission or ping them in the Discord server to see if they're going to fix it. If the person isn't active in the server and hasn't been submitting curations, and it has been over a month since you requested the changes, you can go ahead and fix it yourself if you want to. If you submit a fix for a submission you requested changes on, you'll need to have a Moderator remove the Request Changes comment so that another tester can test the submission.
Line 241: Line 234:
;I Approved a submission another tester requested changes on. Why does it still say the submission has an active RC?
;I Approved a submission another tester requested changes on. Why does it still say the submission has an active RC?
: Only the tester who requested the changes can Approve the submission. While you can still assign yourself and perform the Approve action, it won't remove the RC status.
: Only the tester who requested the changes can Approve the submission. While you can still assign yourself and perform the Approve action, it won't remove the RC status.
<noinclude>
[[Category:Curation Guides]]
</noinclude>

Latest revision as of 12:24, 26 October 2024

In order to test submissions, you must be a Staff Member with the Curator role in the Discord server. The process for how to test a submission is fairly simple and is similar to the old Batch Check system.

Using FPFSS

  1. Assign yourself to the submission(s) you want to test. The Ready for Testing and Ready for Verification buttons at the top of FPFSS's Browse Submissions page will provide you with a list of submissions in need of testing, sorted by oldest first. The former option will show you submissions that have not been reviewed at all yet, while the latter shows ones that have been tested by one staff member already and need to be double checked. There is no difference in the process whether you are testing or verifying, other than having to use the blue Assign Testing button if you are testing and the brown Assign Verification if you are verifying. If you just want to test curations and not content patches, go to the Filter by type section in the Quick filters menu and select Curations. ‎
    If you are assigning yourself to a single submission, go to the submission's page and click the appropriate assignment button at the bottom of the page. If you are assigning yourself to multiple submissions, check the boxes for each submission you want on the left side of the list on the Browse page then use the assignment buttons at the bottom of the list to apply the action to all selected submissions.
  2. Use the Get button to download that submission or, for multiple submissions, with the boxes still checked from when you assigned yourself to them, use the Download Selected button near the bottom of the pag to compress all of the submissions together as a file that will need to be extracted using 7-Zip before you can open them.
  3. In your Flashpoint's Curate tab, use the Load Archive button at the right panel and select the downloaded file(s). Check over their metadata for any errors and run each submission to make sure it works (do not use MAD4FP). You are not required to play through the entire game, but enough that you can be confident that it works.
Actions available while testing and verifying, respectively.
  2. Submit an action on the submission. There are a number of buttons that will appear at the bottom of a submission's page when you are assigned to it:
    1. Comment - Adds a message on the page and pings the submitter. You can use this action even if you are not assigned to the submission.
    2. Unassign Testing/Unassign Verification - Removes the submission from your assignments and returns it to the queue so that another tester can test it.
    3. Request Changes - If there is an issue with the submission that needs to be corrected, write a message in the Comment box explaining the problem and then use this button. Once the submitter has fixed the submission, you can look over again and approve it if everything has been corrected.
    4. Approve/Verify - Marks that everything is correct and working with the submission. This can also be done as a batch action, applying it to multiple submissions at once. With the boxes of all submissions you want to Approve or Verify checked, you can use the appropriate button at the bottom of the page.
    5. Reject - Removes the submission from the queue, used for duplicates of games already in Flashpoint or FPFSS. Write the reason for the rejection in the Comment box before using this action.
    6. Delete - Available to Moderators, removes the submission from FPFSS entirely. Should only be used if a submission is on the Not Accepted Curations list. If you are not a Moderator and come across a submission that needs to be deleted, ask in one of the staff channels for a Mod to take care of it.

Basic metadata requirements

If you're unsure whether something is allowed, you may ask in one of the staff channels.

Field Requirements
Title and Alternate Title Changes should be requested if:
  • The Title doesn't roughly match the submission's logo (if it has one).
  • There are spelling errors.
  • The Title text was clearly intended to be a description of the game, not the actual title. Descriptions go in the Original Description field.

Along with the above, Alternate Titles should not:

  • Be a shorter version of the Main Title.
  • Be the same text as the Main Title. For example, an Alternate Title which is the same as the Main Title but with different capitalization should be removed.
Library The Library field should be:
  • Games if the submission contains some interactive element beyond a start menu or play button.
  • Animations if the submission contains no interactivity beyond a start menu or play button.
Series Should not be the franchise it relates to.
- e.g. a Mario game should have the Super Mario tag and not "Super Mario" in the Series field.
- If an unofficial series uses this name, request the field to be Super Mario (dev/publisher's name) instead.
Developer and Publisher Changes should be requested for either if:
  • The field is wrong.
  • There is nothing in the field despite Developer or Publisher is shown in an obvious place in the game/animation.
  • There are significant spelling errors that would prevent the submission from being properly searched for.

You don't need to request changes for differences in how the Developer or Publisher's name is written. For example Addicting Games, AddictingGames, and AddictingGames.com are different ways people could write the same Publisher. In the future Flashpoint may have a way to unify these spellings, but for now they don't matter.

Tags Changes should be requested if:
  • The tags are irrelevant to the curation.
  • The curation is missing Content Warning or NSFW tags.
  • There is a tag used which is not on the Tags wiki page.
  • The curation has no Gameplay (or Animation) Tags or if the Gameplay tags it has are incorrect.
  • The tag is no longer used, e.g. LEGACY-Extreme, Find, Unusual Input. These tags should not be added to any new submissions.

This section is not relevant if you're testing content patches since they are unable to change tags.

Play Mode Changes should be requested if the Play Mode is missing supporting modes or if the listed mode is incorrect.
Status Changes should be requested if:
  • The Status is incorrect.
  • The submission is labeled as Partial or Hacked and has no Note explaining why.
Version and Release Date Only incorrect if the information is wrong. The information being missing is not something that needs to have changes requested for.
Language This field should:
  • Include all language options present in the work, regardless of whether it's written or spoken.
  • Use the two letter ISO 639-1 language codes, unless the language doesn't have a two letter code. In these cases the three letter code can be used.
  • Works which have no text or spoken language in them should have either en or the language that the Title is, if not English. Either is correct.
Source The Source should:
  • Be the full URL of where the curator found the game.
  • If the curation was sourced from the Wayback Machine, this should have the full web.archive.org URL as the Source.
  • If the curation was not sourced from a webpage, there will be some other way of indicating where it came from, e.g. a game from a CD should have the name of the CD.
Platform Changes should be requested if this field is incorrect. For information specific to each Platform go to Platform Specific Requirements.

This section is not relevant if you're testing content patches since they are unable to change the platform.

Application Path Changes should be requested if:
  • It is incorrect for the submission's Platform.
  • It is invalid or otherwise not working.
Launch Command Changes should be requested if:
  • It is missing http:// or has https:// instead.
  • It is written or formatted in a way which causes the curation to not launch.
Mount Parameters The only valid parameter for this field is -extract. If there is anything other than that in this field, changes need to be requested to have it removed.
Notes Changes should be requested if:
  • There are only Non-English Notes. Notes in a language other than English are fine as long as there is also an English translation of them.
  • The Notes are irrelevant to the curation, for example saying who curated the game or listing information that should be in another metadata field.
  • The curation opens in full screen, but there is no Note or Message about it. Having just a Note, just a Message, or both are all correct.
  • The Notes contain instructions or walkthroughs that are explained in game or are easy to figure out without an explanation.
  • The Notes are overly long or complex at explaining some information the player needs.
  • The submission has an Extras Application, but no Note explaining what the Extras are.
  • The submission is accompanied with the Broken Feature tag, but there is no note explaining what is broken.
Original Description Only incorrect if what's in it is not an Original Description. This includes the curator making up their own description or the Notes or Curation Notes being in the wrong field.
Curation Notes Only incorrect if the information in it should actually be in the Notes field. Since the Curation Notes are not kept when the submission is added to Flashpoint, unnecessary text is not an issue.
Alternate Applications Changes should be requested if:
  • The Application doesn't work. (Note: there's currently a bug for running alternate apps in the Curate tab, so you'll need to replace the launch command with them during testing)
  • Any of the fields is empty or incorrect. This requirements also apply to the fields of Alternate Applications.
  • The Application is unrelated to the Main Application.
Extras Changes should be requested if:
  • The Extras are irrelevant to the curation.
  • The Extras contain unnecessary videos, such as video walkthrough guides.
  • The Extras folder contains only files that are already in the Content folder.
  • The Extras folder is empty.
  • The Extras folder is inside the Content folder.
  • The field is empty or is something not specific to the curation such as "Extras" or "Game". This field should be roughly the name of the curation without spaces, but it doesn't need to be exact.
  • The field contains spaces or punctuation.
  • An Extras folder is included in the curation, but there is no Extras Application to go with it.
  • There is more than one Extras Application.
Logo Changes should be requested if:
  • Is not from the game/animation, although there may be rare exceptions to this.
  • Is animated.
  • Is exactly the same as the Screenshot, with the exception of very simple games and animations where it may not be possible to make the two images look distinct.
  • Is the whole title screen and/or shows menu buttons that can be easily cropped out. If buttons are present in the Logo, but removing them would require more editing than just cropping, it's fine for them to stay.
  • Is switched with the Screenshot.
  • Has noticeable white bars along the side(s) or other things included which are not part of the game.
Screenshot Changes should be requested if:
  • Is not from the game/animation.
  • Is animated.
  • Is the exact same as the Logo, with the exception of very simple games and animations where it may not be possible to make the two images look distinct.
  • Is just the title screen, menu, or tutorial, unless the work is made up of only that.
  • Is switched with the Logo.
  • Has noticeable white bars along the side(s) or other things included which are not part of the game.
  • Has a significant amount of the game window cropped out.
  • Is a significantly different resolution than the game opens as. This doesn't apply to HTML5 games as they don't have a set size.
Content Files Changes should be requested if:
  • The curation doesn't work.
  • The curation contains unnecessary files including files for other games.
    • EXE files are allowed in the Extras folder only.
  • Files have been hacked but the original, unhacked files aren't in the Content folder.

Platform Specific Requirements

If a Platform is not listed below, you will only need to check whether it works.

Common Platforms

Flash
  • Flash submissions cannot be run in Browser Mode.
  • If the submission is using FPNavigator, it should typically have an HTML embed. Games that run properly in a full screen size may be fine without embed.
  • Flash submissions should not open tabs in the user's normal browser when run or when clicking buttons that aren't supposed to link to other pages. If a game has this issue, it should be run in FPNavigator using an HTML embed. An exception is made for games which need an older version of Flash Player than Flash 32, as they cannot be run in FPNavigator, however they do need a Note about the issue.
Shockwave
  • If the submission is running in FPNavigator, it must have an HTML embed. Unlike with Flash, there is no exception to this.
  • Curations should not have Script Errors unless absolutely unavoidable and with a Note explaining the issue.
  • Curations running in the Shockwave Projector should close by clicking the X button in the top right corner.
  • Submissions running in the Shockwave Projector should not open tabs in the user's normal browser.
HTML5
Submissions with a QuotaExeededError will need to be run in a browser other than FPNavigator.
  • HTML5 submissions can run in any of the browsers currently in Flashpoint. The chosen browser does not matter as long as the submission works as intended.
  • If the submission gives a QuotaExeededError or any other error related to the browser it's running in, changes should be requested to have it run in a different browser, unless the error is unavoidable and a Note is included.
  • Submissions should run as intended with the browser window at full size, unless otherwise Noted.
  • HTML5 Alternate Applications cannot run in Browser Mode.
Unity
  • Unity submissions must have an HTML embed, without exception.
  • Unity submissions cannot contain a webplayer.unity3d.com folder with updater files inside.
Java
  • If the submission is running in browser, it should have a Curation Note listing a domain that needs to be added to the Exceptions List.
  • Before testing a Java submission that runs in browser, you will need to copy and paste that domain onto the end of the file FPSoftware\Java\JDK_1.8.0_181\jre\lib\exception.sites in your Flashpoint folder. If the domain is already on the list, then this is not needed.
  • Java submissions running in AppletViewer instead should not have a Curation Note about an exception.

Other Platforms

ActiveX

ActiveX submissions should have a FPSoftware folder next to their Content folder. This folder will need to be merged with Flashpoint's FPSoftware folder before testing.

If this folder is missing, inside the Content folder, or is otherwise incorrect, the submission is not properly curated and changes will need to be requested.

BitPlayer

If you've never tested a BitPlayer submission before, you'll need to set up a Testing Curation in Flashpoint's Games tab. In the Games tab, you will need to click the New Game button in the bottom right of the window. The only field you need to fill out is the Application Path, which needs to be FPSoftware\FlashpointSecurePlayer.exe. You can set any other fields however you want.

When testing a BitPlayer submission, you'll need to copy all of the files in the Content folder and move them into Flashpoint's Legacy/htdocs folder. You'll then copy the submission's Launch Command and paste it into your Testing Curation's Launch Command field. Then run the submission using the Testing Curation's Play button.

Bitplayer Submissions must have the -extract Mount Parameter.

Hyper-G and Hypercosm
If you get an error like this while testing Hypercosm, it means you didn't copy over the files.

Before testing a Hyper-G or Hypercosm submission, copy all of the files in the Content folder to Flashpoint's Legacy/htdocs folder. Submissions of these Platforms must also have the -extract Mount Parameter.

VRML

A small number of curations need to use the Application Path FPSoftware\startVRweb.bat, these requiring you to copy its files from the Content folder to Flashpoint's Legacy/htdocs folder before testing. They must also have the -extract Mount Parameter.

Frequently Asked Questions

What is the difference between Approving and Verifying?
Two people are required to test a submission before it can be added to Flashpoint. The Approver is the first person and the Verifier is the second. The process for testing the submission is the same regardless.
What do I do if I Reject a submission by mistake?
Moderators are able to undo rejections by deleting the rejection comment. If you are not a Moderator, you will need to ask one to do this for you.
How can I see what submissions I'm assigned to?
The Assigned to me for Testing and Assigned to me for Verification buttons at the top of the Browse Submissions page will take you to a list of your assignments for each stage of testing.
Is it okay if I only test Flash submissions?
We always need more testers but there's no problem if you only test specific ones.
I requested changes on a submission and the submitter never fixed it. What do I do?
If the person is active in the Discord server and has submitted curations in the time since you requested the changes, they probably didn't see the request or forgot about it. Send a Comment on the submission or ping them in the Discord server to see if they're going to fix it. If the person isn't active in the server and hasn't been submitting curations, and it has been over a month since you requested the changes, you can go ahead and fix it yourself if you want to. If you submit a fix for a submission you requested changes on, you'll need to have a Moderator remove the Request Changes comment so that another tester can test the submission.
I requested changes while Assigned to Verify a submission and now I can't Verify the fixed submission. Is it broken?
This is intentional. When a changes are requested on a submission, it gets reset back to the Approval phase. You'll need to unassign yourself from verification and assign yourself to test the submission. Then you'll be able to Approve it. Another tester will need to Verify it.
I Approved a submission another tester requested changes on. Why does it still say the submission has an active RC?
Only the tester who requested the changes can Approve the submission. While you can still assign yourself and perform the Approve action, it won't remove the RC status.
Retrieved from "https://flashpointarchive.org/w/index.php?title=Submission_Testing_Instructions&oldid=10679"