Difference between revisions of "New Curation Format"

From Flashpoint Database
Jump to: navigation, search
(This page has been rolled out to the main Curation Format page!)
 
(21 intermediate revisions by the same user not shown)
Line 1: Line 1:
This guide will walk you through everything you need to know about putting together a curation and submitting it to Flashpoint. If this is your first time contributing, be sure to follow our [[Curation Tutorial|step-by-step tutorial]].
+
#REDIRECT [[Curation Format]]
 
 
==What is a Curation?==
 
 
 
Flashpoint is not just a collection of files; it is a museum of playable web games. As in any other museum, each item needs to be curated before it can be put on display. Curating for Flashpoint is more than downloading an SWF, dropping it off in the Discord and expecting it to appear in the next update. You'll need a specific folder setup, screenshots, and a text file, all packaged in an archive called a ''curation''. All of this will be explained as you read further.
 
 
 
==Before You Start==
 
 
 
===Checking the Master List===
 
Often times, somebody will request a game or animation that's already been added to the project, better yet waste time curating it themselves. To make sure this doesn't happen to you, please check the [[Game Master List]] (and for animations, the [[Animation Master List]]) before possibly taking time out of your day to save something that's already been saved. '''Use CTRL+F to search the list of titles.'''
 
 
 
===Barred Games===
 
 
 
{{:Not Accepted Games}}
 
 
 
==Overview==
 
 
 
A ''curation'' is a compressed folder (any common archive format like ZIP or 7Z is fine). To make a curation, you'll be making a folder, adding all of the required files to it, and finally zipping it up. First, create a new folder with the name of the game you'd like to save. (Windows won't let you create a folder name with certain special characters; you'll need to remove them from the folder name if that happens.) Inside your curation folder, you'll adding a ''screenshot'' and ''logo'', a ''text file'' containing metadata about the game, and a ''content'' folder containing all of the files required to run the game. The next sections will explain each of these required items in detail. Be sure to download our complete [http://bluemaxima.org/flashpoint/datahub/AlienHominid.zip example curation ZIP file] and follow along.
 
 
 
<gallery mode="traditional">
 
 
 
Image:FolderContents.png | A sample of what a completed curation folder looks like.
 
 
 
</gallery>
 
 
 
==Content==
 
 
 
All content must be placed inside a '''content''' folder, then arranged in the same way that they would be placed in Flashpoint proper from the htdocs folder - the best practice is to try and recreate the same structure that the game had on the internet. For example, if a game was hosted at 'http://uploads.ungrounded.net/59000/59593_alien_booya202c.swf' you would do the folders in this example like the image below. If that is not working for some reason, a secondary format is acceptable - a domain folder, a folder with the game's name, then the game files, displayed as the second example.
 
 
 
You might notice that some games in Flashpoint use a domain called <code>localflash</code> instead of a website domain. This is a legacy practice, and it is '''not used anymore''' unless the source files come from a CD, ZIP file, or other offline location.
 
 
 
===Examples===
 
 
 
<gallery mode="traditional">
 
 
 
Image:Curate1.png | This is assuming you've already tested the game with Flashpoint Core. '''Don't forget the folder with the game's name!'''
 
 
 
</gallery>
 
 
 
==Logo==
 
 
 
Logos must be in PNG format, and have the entire title of a game, or something that is representative of the game. To be named 'logo.png' in all cases.
 
 
 
Recommended tools include Snipping Tool and Paint, both included in Windows 10 by default. You're free to use other tools, just remember, always use PNG.
 
 
 
===Examples===
 
 
 
<gallery mode="traditional">
 
 
 
Image:Logo-bad.png | Bad example. Crop it down to just the logo.
 
Image:Logo-good3.png | Good example. Logo is sufficiently cropped.
 
Image:Logo-good.png | Good example. Can show off a bit of the artist's work, but no menu options or other things to get in the way.
 
Image:Logo-good2.PNG | Good example. If no title is available, a decent shot of the focal point of the game will do instead.
 
 
 
</gallery>
 
 
 
==Screenshot==
 
 
 
Screenshots must be in PNG format, and have a credible 'action shot' of the game (no menus or obvious tutorials). To be named 'ss.png' in all cases.
 
 
 
Recommended tools include Snipping Tool and Paint, both included in Windows 10 by default. You're free to use other tools, just remember, always use PNG.
 
 
 
===Examples===
 
 
 
<gallery mode="traditional">
 
 
 
Image:Ss-bad1.png | Bad example. Don't show obvious tutorials.
 
Image:Ss-bad2.png | Bad example. Don't show menus, unless the entire point of the game is menus. Work your way to a battle in an RPG or strategy game.
 
Image:Ss-good.png | Good example. Shows some action. Dying is sometimes unavoidable - don't feel bad if the screenshot is otherwise good.
 
Image:Ss-good2.png | Great example. Shows a lot of action and what the game's big draw is.
 
 
 
</gallery>
 
 
 
==Metadata==
 
 
 
The metadata must be included in a file named '''meta.txt'''. All fields should be included if they are applicable. Pay special attention to fields marked with <span style="color:#ff0000">*</span>; they are required at least some of the time. If a field is not applicable and not required for your curation, either omit it or leave it blank.
 
 
 
Many fields allow multiple values. If they do, separate each value with a <code>;</code> (semicolon).
 
 
 
Some fields have a few possible values to choose from. If this is the case, they'll be in a bulleted list, with the default value in ''italics''. If you omit this type of field, it will take on its default value automatically.
 
 
 
===List of Metadata Fields===
 
 
 
{| class="wikitable sortable"
 
! Field !! Explanation
 
|-
 
| '''Title'''<span style="color:#ff0000">*</span>
 
| '''Always required.''' The name of the game, in full. When in doubt, use the name indicated in the game's logo. We plan to allow multiple values to indicate alternate names, but this is not implemented yet.
 
|-
 
| '''Library'''<span style="color:#ff0000">*</span>
 
| '''Required if you are curating for Flashpoint Theatre.''' Possible values:
 
* ''Arcade'': This is a game that should go in Flashpoint Arcade.
 
* Theatre: This is an animation that should go in Flashpoint Theatre.
 
|-
 
| '''Series'''
 
| The franchise or game series.
 
|-
 
| '''Developer'''
 
| The name of the developer, or developers. Separate multiple developers with the <code>;</code> symbol. Make sure that each person or game studio actually developed the game; sponsorship does not count. Look for a Credits section!
 
|-
 
| '''Publisher'''
 
| The site that published (sponsored/branded) the game. Look for a "More Games" link or prominent logo; it will probably lead to the Publisher's website.
 
|-
 
| '''Play Mode'''
 
| One of the following, but up to three per game is possible:
 
* ''Single Player'': A solo experience from start to finish.
 
* Cooperative: Like "Single Player", but with others being in the journey of finishing the game from start to finish.
 
* Multiplayer: Playing against someone else or multiple players in a session, competing to win.
 
|-
 
| '''Release Date'''
 
| The date that the game was first released. Use YYYY-MM-DD format, with whatever precision is available. For example, if you knew a game was released in January 2010, you could say <code>2010-01</code>.
 
|-
 
| '''Version''
 
| The version number of the game. This is not for
 
| Alien Hominid
 
|-
 
| Vertically-Scrolling Shooter
 
| The game is played with a playfield that scrolls from bottom to top (usually in a ship).
 
| Enigmata 2
 
|-
 
|}
 
===A Good meta.txt===
 
 
 
Title: Alien Hominid
 
Series:
 
Developer: The Behemoth
 
Publisher:
 
Play Mode: Single Player
 
Status: Playable
 
Extreme: No
 
Genre: Shooter
 
Source: Newgrounds.com
 
Launch Command: http://uploads.ungrounded.net/59000/59593_alien_booya202c.swf
 
Notes:
 
Author Notes: Thanks for your work!
 
 
 
===Blank meta.txt===
 
 
 
Title:
 
Series:
 
Developer:
 
Publisher:
 
Play Mode:
 
Status: Playable
 
Extreme: No
 
Genre:
 
Source:
 
Launch Command:
 
Notes:
 
Author Notes:
 
 
 
Remember to place all 3 just outside the content folder.
 
 
 
==Testing==
 
 
 
You'll need [https://bluemaxima.org/flashpoint/Flashpoint%20Core%203.1.zip Flashpoint Core] to test your games in a lightweight copy of Flashpoint you can afford to break.
 
 
 
Place the files from inside your content folder within the '''Server\htdocs\''' directory. Once you've done this, open the Core launcher, click the "New Game" button in the bottom right and mirror the info from your Meta.txt into the right panel. Click the checkmark and open your curation - if everything goes well, your game should open in a new window! If it doesn't, make sure you're copying the contents of your content folder and not the folder itself.
 
 
 
'''All games should be tested in Flashpoint, if not Core then at least the full version. Just opening the game in a projector or browser is not enough of a test.'''
 
 
 
==Packing it up==
 
 
 
You've finished your first curation! All of these files should now be packed into a single .ZIP file and submitted to our #curator-lounge on the Discord. If your curation is up to snuff, you'll be given Trial Curator status, which will let you submit curations through the curation channels. You can use Discord's own upload feature for files under 8MB, or [https://unstable.life/submissions.html our own file host] for bigger files. This is also linked in the channel topics of our submission channels on Discord.
 
 
 
[http://bluemaxima.org/flashpoint/datahub/AlienHominid.zip Here is the full example ZIP file.]  
 
(This was also linked earlier, in the Overview section).
 
 
 
==After Submitting==
 
 
 
===Editing Your Curations===
 
 
 
If you notice a mistake with your curation after you've submitted it, just delete it and resubmit. (If you used our upload service, you might have to ask a Curator to delete your file for you.) If your curation has already been added to Flashpoint read our article on [[Metadata Edits]] and head over to the #metadata-edits channel in our Discord so you can make necessary changes. If you're wondering whether your curation has been added to Flashpoint yet, look for a <code>:Tools:</code> emoji reaction anywhere below your post in the Curations channel.
 
 
 
===Having Problems?===
 
 
 
Because we can't remind you enough already: [https://discord.gg/S9uJ794 Join our Discord] and ask away in the #help-me-please channel.
 

Latest revision as of 11:17, 1 November 2019

Redirect to: