ActiveX Curation: Difference between revisions

From Flashpoint Datahub
Jump to navigation Jump to search
(Removed curation instructions since they are outdated)
(Added Tomysshadow's instructions from the Discord)
Line 1: Line 1:
An ActiveX Curation tutorial will be created in the near future. In the meantime, a link to the ActiveX player required to play many games on [http://www.zylom.com/us/en/ Zylom], can be found [http://game.zylom.com/activex/zylomgamesplayer.cab here].
Before curating ActiveX, make sure that you have the [https://bluemaxima.org/flashpoint/downloads/ latest version of Flashpoint Core].


== How to recognize an ActiveX application ==


>How to recognize ActiveX application
# You can see text like "This game uses an ActiveX control and will not play in your browser" on the page.
# The app tells you it needs Internet Explorer to work.
# There's file with extension .cab.


== How to curate an ActiveX application ==


1. You can see text like "This game uses an ActiveX control and will not play in your browser" on the page.  
The first thing you need to do is locate your ActiveX Control. This is typically a DLL or OCX file. You'll often find ActiveX Controls distributed in Cabinet (CAB) files. If your ActiveX Control is in a Cabinet file, open it in Windows Explorer so you can get the DLL or OCX file.


2. The app tells you it needs Internet Explorer to work.
Once you have the ActiveX Control, you need to move it into an ActiveX folder. If you look in Flashpoint at FPSoftware\ActiveX, you'll see a number of folders, and every folder has an ActiveX Control inside. Create a folder for your ActiveX Control and put it inside. The folder can have any name, but is typically named after the control itself.
You'll need to include your ActiveX folder in your curation when done. Include a FPSoftware folder alongside your content folder.


3. There's file with extension .cab.
Now, use the Flashpoint Launcher to create a new curation like normal. Set the Application Path to the startActiveX script:
Application Path: FPSoftware\startActiveX.bat


When you set the Launch Command, start with the URL. Then, specify the ActiveX Control's location within the ActiveX folder. But then, only for the first time you run this, add <code>--activex</code> onto the end of the Launch Command. Here's an example Launch Command, for the game Zenerchi:
http://www.shockwave.com/content/zenerchi/sis/index.html ZenerchiWeb.1.0.0.10\zenerchi.1.0.0.10.dll --activex
The first argument is the URL. The second argument is the location of the control (under FPSoftware\ActiveX.) And finally <code>--activex</code>.


>Curating the application
Now, when you run this, it's going to prompt for administrator privileges.
Then it's going to take about five seconds to import the control.
And then (hopefully) it'll say it imported successfully and you can close the window.


Finally, remove <code>--activex</code> from the end of your Launch Command.
so now it looks like:
http://www.shockwave.com/content/zenerchi/sis/index.html ZenerchiWeb.1.0.0.10\zenerchi.1.0.0.10.dll
And now, when you run it, it'll open a browser to the page with the control on it (and it should work).
Importing the control will have created a file at <code>FPSoftware\FlashpointSecurePlayerConfigs</code>, named after the control. Move this file to <code>http://flashpointsecureplayerconfigs/</code> and include it in your curation.


This section will be updated soon, please check back later!
If the control does not work, it's possible that it requires other changes. For example, it may require to be run with Windows Compatibility Settings, or need to be run as an administrator. If so, the Flashpoint Secure Player can be used to accomplish that. If you are having trouble figuring out the correct options, ask for help in the Flashpoint Discord server.

Revision as of 07:44, 10 October 2020

Before curating ActiveX, make sure that you have the latest version of Flashpoint Core.

How to recognize an ActiveX application

  1. You can see text like "This game uses an ActiveX control and will not play in your browser" on the page.
  2. The app tells you it needs Internet Explorer to work.
  3. There's file with extension .cab.

How to curate an ActiveX application

The first thing you need to do is locate your ActiveX Control. This is typically a DLL or OCX file. You'll often find ActiveX Controls distributed in Cabinet (CAB) files. If your ActiveX Control is in a Cabinet file, open it in Windows Explorer so you can get the DLL or OCX file.

Once you have the ActiveX Control, you need to move it into an ActiveX folder. If you look in Flashpoint at FPSoftware\ActiveX, you'll see a number of folders, and every folder has an ActiveX Control inside. Create a folder for your ActiveX Control and put it inside. The folder can have any name, but is typically named after the control itself. You'll need to include your ActiveX folder in your curation when done. Include a FPSoftware folder alongside your content folder.

Now, use the Flashpoint Launcher to create a new curation like normal. Set the Application Path to the startActiveX script:

Application Path: FPSoftware\startActiveX.bat

When you set the Launch Command, start with the URL. Then, specify the ActiveX Control's location within the ActiveX folder. But then, only for the first time you run this, add --activex onto the end of the Launch Command. Here's an example Launch Command, for the game Zenerchi:

http://www.shockwave.com/content/zenerchi/sis/index.html ZenerchiWeb.1.0.0.10\zenerchi.1.0.0.10.dll --activex

The first argument is the URL. The second argument is the location of the control (under FPSoftware\ActiveX.) And finally --activex.

Now, when you run this, it's going to prompt for administrator privileges. Then it's going to take about five seconds to import the control. And then (hopefully) it'll say it imported successfully and you can close the window.

Finally, remove --activex from the end of your Launch Command. so now it looks like:

http://www.shockwave.com/content/zenerchi/sis/index.html ZenerchiWeb.1.0.0.10\zenerchi.1.0.0.10.dll

And now, when you run it, it'll open a browser to the page with the control on it (and it should work). Importing the control will have created a file at FPSoftware\FlashpointSecurePlayerConfigs, named after the control. Move this file to http://flashpointsecureplayerconfigs/ and include it in your curation.

If the control does not work, it's possible that it requires other changes. For example, it may require to be run with Windows Compatibility Settings, or need to be run as an administrator. If so, the Flashpoint Secure Player can be used to accomplish that. If you are having trouble figuring out the correct options, ask for help in the Flashpoint Discord server.