Flashpoint Datahub - User contributions [en]

File:QEMU-FP.png

2021-05-18T14:31:05Z

XXLuigiMario: XXLuigiMario uploaded a new version of File:QEMU-FP.png

2020-09-21T10:06:58Z

XXLuigiMario: Created page with "The server allows accessing zipped game contents, also known as GameZIPs, as well as merged htdocs. This page aims to cover the details of the Flashpoint implementation. == G..."

File:QEMU.png

2020-09-21T09:59:01Z

XXLuigiMario:

File:QEMU-FP.png

2020-09-21T09:20:12Z

XXLuigiMario:

YAML Format

2019-09-04T13:43:09Z

XXLuigiMario: Created page with "== Basic Principles == YAML is a very simple, human-readable text format that can be used to store data. In YAML, data is stored as a map containing keys and values associat..."

== Basic Principles ==

YAML is a very simple, human-readable text format that can be used to store data.

In YAML, data is stored as a map containing keys and values associated to those keys.
This map is in no particular order, so you may reorder it at will.

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!

=== Special Characters ===

When using special characters, it is sometimes necessary to enclose the values in quotes or double quotes. Whichever you use is up to you.

To simplify things, I suggest quoting all strings that contain special characters.

'''Invalid:'''

Developer: @bluemaxima
^
'''Valid:'''

Developer: "@bluemaxima"
or
Developer: '@bluemaxima'

To ensure that your YAML is valid, you can copy and paste it to a site like [http://www.yamllint.com/ yamllint.com], it will tell you if its valid or if it's not, point you to where the issue is.

=== Nested Keys ===

Keys may also be inside other keys, this is denoted by the use of indentation. '''Do not use tabs for indentation. Always use spaces.'''

The amount of spaces doesn't matter as long as all sub-keys use the same amount of spaces, though the general convention is to use two spaces.

Additional Applications:
Extras: drop3
Message: This message will pop up before the game runs.
Play Hacked Version:
Application Path: Games\flashplayer.exe
Launch Command: http://www.irregulargames.com/drop3/drop3-hacked.swf

=== Multiline Values ===

Multiline values can be introduced by using a pipe "|" character. Content then starts in the next line and must be indented.

These values do not need to be enclosed by quotes, regardless of any special characters.

Curation Notes: |
This is a new example meta.txt.
What do you think?

=== Comments ===

YAML files can include comments, these may appear anywhere in the file.

Title: Flashpoint
# remember to quote values with special characters
Developer: "@bluemaxima" # like this

This means that if you want to include a number sign inside a value you must quote it.

Title: "#notacomment"

=== Lists ===

A key can have multiple values, these are expressed by a dash "-" character in individual lines.

Languages:
- en
- es
- fr
- it

Alternatively, you may also express them in a single line. To do so, enclose them in square brackets and separate them using commas.

Languages: [en, es, fr, it]

=== Editor Choice ===

It's not recommended to use a WYSIWYG editor like Word to edit YAML files.

Instead, use something like Notepad++. You can also modify its settings so that pressing tab uses spaces [https://stackoverflow.com/a/7471232 like so].

== Advanced Rules ==

=== Quotes inside values ===

In values enclosed by quotes "", you may include quotes as part of the value itself by prepending them by a backslash "\" character.

Developer: "John \"Doe\" Douglas"

In values enclosed by single quotes <nowiki>''</nowiki>, you may include single quotes as part of the value itself by doubling them up.

Developer: 'John <nowiki>''Doe''</nowiki> Douglas'

'''Cool trick'''

You can also use the following to avoid having to escape values.

Curation Notes: >
"Hello World" is a typical phrase used by programmers used in their first "program"

It's very similar to the multiline value syntax but using a greater-than symbol instead of a pipe.

This syntax is called a "folded block", this is because it allows you to cosmetically break up a value into multiple lines while keeping it in a single line once parsed.

folded_newlines: >
this is really a
single line of text
despite appearances

HTML5 Curation

2019-08-06T02:25:35Z

XXLuigiMario: Placeholder

In this guide I’ll explain how to curate HTML5 games. This will only cover games that don’t require a persistent server connection.

== Recognizing an HTML5 game ==

Without looking at a web page’s source, there’s no definitive way to tell if you’re dealing with an HTML5 game. You can however easily discard Flash by whether a lego brick-shaped plug-in icon is displayed to the left of the address bar. The same goes for any technologies that make use of browser plugins (e.g. Java).

[[File:PluginIcon.PNG|plugin]]

== Required software ==

These will be required to perform the curation process:

* [https://bluemaxima.org/flashpoint/downloads/ Flashpoint Core] (Optional, recommended)
* [https://eternallybored.org/misc/wget/ wget for Windows]

The guide below will explain how to use them.

== Curation ==

In order to curate an HTML5 game, we first want to retrieve all the URLs required by the specific game we’re dealing with.

There’s two ways to do so:

* Using a web debugging proxy like Fiddler or Charles Proxy
* Using the browser’s console

I personally prefer using Charles Proxy, I also use it for curating Flash games, which requests are not displayed in the browser’s console. I like its interface and it allows you to view the directory hierarchy of all HTTP requests.

For the purposes of this guide I’m going to keep it simple and stick to Firefox’s console, which should be similar enough to that of Chrome. If you do opt for a debugging proxy it’s imperative to clear the browser’s cache EVERY time you attempt to capture the game’s requests.

I’ll illustrate each step with an example of a real HTML5 game. I’m going to attempt to curate Google’s snake clone that you get by performing a search for “snake”.

Here’s our prey:

[[File:Snake.png|screenshot]]

Let’s start off by opening the console, we can easily do this by pressing '''Ctrl+Shift+I''' or by right clicking anywhere in the page and then selecting “Inspect”. Then navigate to the “Network” tab.

If any requests are already shown, click on the “Clear” icon to get a fresh start. While this tab is selected, our browser will record all requests made by the page and display them as a list.

Refresh the page, this will cause it to make a bunch of requests to display the page. As the game loads, a bunch more requests will be made.

Now, here’s where it gets tricky because most HTML5 games won’t request all of the files it needs at once but rather will request them sort of on-demand.

Imagine a game that has multiple stages, and stage two uses a different music track, it may not request it until that stage starts. Depending on the game though, it is sometimes possible to retrieve a list of most if not all of the files it needs by exploring the contents of other files it requests.

This could be an XML or JSON file that lists the music track to be used for each stage, for example. However, I won’t get into detail for now. This game does not require any of that.

Play around with the game until no more requests are made or you feel satisfied. Then look for a button named “HAR”, it should be in the top right of the editor in Firefox, download icon in Chrome. Click it and select “Save everything as HAR”.

This file contains the data of all the requests listed in the console. You can quickly extract all the requested URLs by opening the file in a text editor (i.e. notepad) and copy/pasting the contents in the left text box shown [https://jsfiddle.net/XXLuigiMario/pxcmew9t/show here].

Copy the URLs from the right and save them in a new text file in its own dedicated folder.

At this point, make sure you have a copy of Flashpoint for testing. Flashpoint Core is recommended but any version can be used.

Next up, we’ll need to use a tool called wget. Chances are you have heard about it before, you can download it for Windows [https://eternallybored.org/misc/wget/ here].

Save it in the same folder as the text file with the URLs, then open a command line window. To do so, simply press '''Win+R''', type “cmd” and then '''Enter'''.

Type “cd”, without quotes, followed by the path to the folder where you saved your text file and '''Enter'''. Example: cd C:\Users\Foo\Game\

Then enter “wget -x -i filename.txt” and let it do its thing. Once all files have been downloaded, copy the resulting folder(s) to the “htdocs” folder in your Flashpoint directory, you will find it under a folder named “Server”.

Navigate into a folder named “FPSoftware” next to where you found “Server”, find an executable for a web browser named Basilisk in it and run it. Copy the base URL of the game into its address bar and press '''Enter'''.

If the game works then you’re almost done! :)

File:PluginIcon.PNG

2019-08-06T02:21:48Z

XXLuigiMario:

File:Snake.png

2019-08-06T02:20:18Z

XXLuigiMario:

Instructions for Curating

2019-06-17T07:38:24Z

XXLuigiMario: Dirty Joe is not a decompiler, replaced by Luyten

== Guide ==

* Download [https://drive.google.com/file/d/1qoQc32vQ7nnTmYMle1uCpluYenY61Biy/view Flashpoint Core 3], a lightweight developer version of Flashpoint
* Most games are tested within <code>Flashpoint Core X.X/Server/htdocs</code>. X.X is the version number
* Make note of the direct URL to the game's main files you've extracted
<blockquote>'''Important''', for most non-flash games, you need to save not only the game main file, but also the HTML code snippet in which the main file is embedded - place that in an index.html file, and keep reading </blockquote>
* Within htdocs, make a folder with the website name
** i.e. <code>newgrounds.com</code>, <code>static.nickjr.com</code>, etc
* Within that folder, begin mimicking the URL by building corresponding subdirectories.
** i.e. <code>newgrounds.com/alienhominid/59593_alien_booya202c.swf</code> - you would make an <code>alienhominid</code> subfolder, if your url has more, keep adding subfolders until it looks like your url
* Finally, place your game's main files in the last subfolder (along with an <code>index.html</code> if you've created one)

'''Now that you have the code set up correctly in htdocs:'''

* Open up Flashpoint Core and click on New Game on the bottom right corner
* Click on <u>Application Path</u> and select the appropriate path for your extracted game
** i.e. flashplayer.exe for flash, startUnity.bat for Unity, etc.
* The <u>Launch command</u> should be the exact URL to where you extracted the game
** '''However''', for most non-Flash games, you need to link it to the html in which the game is embedded
* If you want to edit these locations later, head to the Arcade tab and select the game (there will be a pencil image and a trash image next to the name) and click the pencil
* You should see a new game in the launcher list
* Run it

== Debugging ==

* Observe the Flashpoint redirector window and see if you're getting 404 errors - you can grab any missing assets or code by going to the indicated URL locations, downloading it and placing it correctly in the htdocs
* Hunt down other websites in which the game has been embedded or even originally hosted if any of the files end up being broken
* If you wish to decompile and look at the code, there are a few tools available.
Flash - [https://www.free-decompiler.com/flash/ JPEXS Flash Decompiler]

Java - [https://github.com/deathmarine/Luyten/releases/latest Luyten Java Decompiler]

----

Once it works, follow the instructions on the [[Curation_Format]].

Lost Games

2018-07-19T00:00:59Z

XXLuigiMario: Added Empires & Allies

This is a list of games that we couldn't find on the internet and are lost forever.

If you have any information or contact regarding these titles, please contact us in our discord.

{| class="wikitable"
! style="font-weight:bold;" | Game Name
! style="font-weight:bold;" | Status
|-
| Mystery of Time and Space (MOTAS)
| Missing episodes 14-20
|-
| Shadow Rising
| Lots of missing assets
|-
| Empires & Allies (2011)
| Missing all assets, would also require server emulation
|-
|}