You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
By default, the Internet Explorer version used in Server Mode is Internet Explorer 7. Changing the Internet Explorer version to use may be accomplished by means of HTTP headers or meta elements.
47
48
48
49
Here are some examples of meta elements that may be used to change the Internet Explorer version.
@@ -96,7 +97,8 @@ Here is an example of a Modification that does not do anything, called "Example.
The important element here is the `modification` element, which in future examples is all that will be shown. The rest of the configuration file will be the same in every configuration file Flashpoint Secure Player uses.
102
104
@@ -120,14 +122,16 @@ The command line below launches the Astro Avenger II ActiveX Control in Administ
120
122
The `modification` element below also causes Administrator Mode to be used.
The Mode Templates can modify the behaviour of the Server Mode and Software Mode such that a particular configuration file will cause these modes to be used. There is no ActiveX Mode Template.
129
132
130
133
**Server Mode Template**
134
+
131
135
The Server Mode Template provides the ability to apply a regex to the URL that was in the command line. For example, a `modification` element could be created which prefixes the URL with a specific domain.
132
136
133
137
```
@@ -139,13 +143,15 @@ The Server Mode Template provides the ability to apply a regex to the URL that w
139
143
</regexes>
140
144
</serverModeTemplate>
141
145
</modeTemplates>
142
-
</modification>```
146
+
</modification>
147
+
```
143
148
144
149
With the "Miniclip" Modification Name specified, all URLs passed into Server Mode will be modified, such that the command line below would cause the URL of http://www.miniclip.com/games/save-the-sheriff/en/ to open in the Internet Explorer frame.
**Software Mode Template and hideWindow Attribute**
154
+
149
155
The Software Mode Template works identically to the Server Mode Template in that it provides the ability to replace the command line passed in with regexes. The Software Mode Template also has an additional attribute, `hideWindow`, which causes the window of the software to be hidden. This is ideal for hiding console windows for softwares that have them.
150
156
151
157
For example, a practical use of the Software Mode Template would be to create a `modification` element that always ensures the use of important Java options.
@@ -159,7 +165,8 @@ For example, a practical use of the Software Mode Template would be to create a
159
165
</regexes>
160
166
</softwareModeTemplate>
161
167
</modeTemplates>
162
-
</modification>```
168
+
</modification>
169
+
```
163
170
164
171
With the "Java" Modification Name specified, the URL is factored into the regex, such that only the URL needs to be given when specifying the Software Mode argument. The command line below could be interpreted as passing the URL to the software.
165
172
@@ -178,18 +185,21 @@ Here is a modification `element` that sets the FP_UNITY_PATH variable to the loc
It is possible to use the Environment Variables Modification to set compatibility layers by setting the __COMPAT_LAYERS environment variable to a [compatibility fix.](http://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-7/cc765984(v=ws.10)) Here is a `modification` element that starts the software in 640 x 480 resolution.
The `type` attribute of the `registryBackup` element specifies whether the element represents a `KEY` or `VALUE`. If not specified, the default is `KEY`. The `keyName` and `valueName` attributes specify the location of the registry key and value. The `valueKind` attribute specifies the kind of value that will be set. Currently, only `String` (REG_SZ) is supported. If the `type` attribute is `KEY`, the `valueName`, `value`, and `valueKind` attributes are ignored.
245
258
246
259
There is no way to delete a registry key or value, only set them. The application may set a `_deleted` attribute, which is for internal use by the application only, and is ignored outside of the active configuration file (see the section about [Crash Recovery](#crash-recovery) below.)
247
260
248
261
**binaryType Attribute and WOW64 Keys**
262
+
249
263
*You do not need to include the WOW6432Node or WOW64AANode subkeys when creating a Registry Backup.* If the `binaryType` attribute of the `registryBackups` element is not set to `SCS_64BIT_BINARY`, the 32-bit registry view is used, so the WOW6432Node and WOW64AANode subkeys will be used automatically where necessary.
250
264
251
265
**ActiveX Imports**
266
+
252
267
See the section about [ActiveX Mode](#activex-mode) above.
253
268
254
269
**<aname="#crash-recovery"></a>Crash Recovery**
270
+
255
271
The configuration file in the same folder as the executable is the *active configuration file.* This configuration file is maintained by the application and is not meant to be modified by curators or users (unless there is an issue with loading the file.) This file is created so that the registry may be restored in the event of a crash, shutdown or power outage.
256
272
257
273
There are four possible scenarios.
@@ -266,6 +282,7 @@ In scenarios one and two, Flashpoint Secure Player reverts the active Registry B
266
282
If the Registry Backups Modification cannot be reverted, an error occurs and the application will exit, and not do anything else regardless of what Modes or Modifications are specified until the issue is resolved. If the registry has been modified by a different application outside of Flashpoint Secure Player, the application no longer assumes control of those registry keys and values, and the active Registry Backups Modification is silently discarded.
267
283
268
284
**Administrator Mode**
285
+
269
286
ActiveX Imports are always created in Administrator Mode, but it is not required during playback. Please note that in some cases, ActiveX Controls may be required to be launched in Administrator Mode. Flashpoint Secure Player will attempt to play the game without running as administrator by default, and in these cases, the ActiveX Control will not work unless the Run As Administrator Modification is used. For more information, see the section about the [Run As Administrator Modification](#run-as-administrator) above.
270
287
271
288
## Single Instance
@@ -288,7 +305,8 @@ This command line in combination with this `modification` element uses the Singl
The Single Instance Modification has two attributes: `strict` and `commandLine`. The `strict` attribute specifies whether the test only looks for the process with the exact same pathname or any process on the machine with a matching name. The default is `false`. The `commandLine` attribute specifies an alternate command line to test for. For example, in this instance, if the `commandLine` attribute were empty, it would instead look for `Basilisk-Portable.exe`.
294
312
@@ -297,13 +315,15 @@ Let's curate the game Zenerchi. The first step is to add the ActiveX Control to
**Creating a Registry Backup from an ActiveX Control**
318
+
300
319
The first time an ActiveX Control is added to Flashpoint, a curator must create an ActiveX Import. This is accomplished with the following command line, substituting the ActiveX Control's location. If not run as administrator, the curator will be asked to launch in Administrator Mode. This command line is NOT to be included in the curation metadata, it is only used to create the Registry Backup.
This will produce a file in the FlashpointSecurePlayerConfigs folder called `activex.zenerchiweb.1.0.0.10.zenerchi.1.0.0.10.dll.config`. This file may be included in the curation as if it existed at the URL of http://flashpointsecureplayerconfigs/activex.zenerchiweb.1.0.0.10.zenerchi.1.0.0.10.dll.config and it will be downloaded from the Flashpoint Server by Flashpoint Secure Player when required.
305
324
306
325
**Using the Registry Backup**
326
+
307
327
To use the ActiveX Control, the same Modification Name is specified but the Mode is changed to Server Mode with the URL to load. This is the command line the curation metadata may include.
@@ -339,10 +359,13 @@ You may notice that because the Flashpoint Secure Player is effectively capable
339
359
340
360
# Questions And Answers
341
361
**Is there is Linux version?**
362
+
342
363
No, but also, what? This application deals mostly in solving Windows specific problems (to do with the registry, or running as administrator, etc.) for Windows specific plugins. The types of programs Flashpoint Secure Player is useful for would not have run natively on Linux in the first place.
343
364
344
365
**Why does the Modification Name need to be specified in the configuration file if the filename of the configuration file also reflects it?**
366
+
345
367
It provides additional redundancy, ensuring the configuration file loaded was the one intended, and also opens the door for potentially allowing single configuration files to have multiple `modification` elements in the future.
346
368
347
369
**Shouldn't the Flashpoint Launcher just have these features built in?**
0 commit comments