Jump to content

All my products and services are free. All my costs are met by donations I receive from my users. If you enjoy using any of my products, please donate to support me. Thank you for your support. Tom Speirs

Patreon

PinballX API Launcher (also with PINemHI Challange selector) 1.0.1

   (2 reviews)

2 Screenshots

About This File

This is the first PinballX application that can be used in your menu to make some things easy.

What is it used for ?
With this small program, you can launch through the GameEx online API  a random table, or even the correct PINemHI Weekly Challenge

Prerequisite :

  • Your cabinet needs internet connection
  • Within Settings.exe (from pinballx directory), you need to setup the Gameex Online section and define a Username and Password
  • You need  an API from GameEx Online
  • To use PINemHI leaderboard, you must setup and configure PINemHI.
    An small tutorial how to setup PINemHI leaderboard can be found here: 

Setup:
First make sure you meet all the requirements.
Download the Zip file and extract the PinballXAPILauncher.exe file to your Pinball Cabinet somewhere on the harddrive.
Run the file PinballXAPILauncher.exe by doubleclick it.
The next Screen appear :
MainScreen.png.d28104ce9ef7123648388fc0678ea5cb.png
Got to https://online.gameex.com/APIinfo.aspx and login with your GameEx account. The blue link in the app direct you to the same location.
You can also go to https://online.gameex.com/ (login with your credentials) go to the tab My Page and select on API
image.png.6c436c4d55d89f310efe43be6df5b9f2.png
On the API screen, copy the string under User and paste it into the application User. Do the same for Password

image.png.5c999ceda2c989ab3c28045c20025190.png

This should result like this :
image.png.e0cf55ae2ee7957be033bc8c0bfed10b.png
Click on the Test API to check your credentials
This should result in
image.png.4a46e0b481769fc45b78063a4e8ae59d.png

If you want to setup PINemHI 5 min challenge toggle key
image.png.dd9bc6d16eaad0a53a7c0c968c7a8bee.png

Click the Input button to set your Key. This must match the key you setup in pinemhi.ini for value 5min_key=

image.thumb.png.a6cbac4228c11fd45da8337f17a8b025.png

In the Input dialog I press the "period" key on my keyboard
image.png.c451a8a95f1cb1ae8ddc9be2f3f5f336.png

That results that the period key is in the program
image.png.73dc6c51ea9bf41ffaf00d82e1ea256e.png
Click on Save & Exit to close the program
(if you want to know all the command line parameters, click on the blue question mark icon)

Setup in PinballX:
Open settings.exe from your PinballX directory
Select in the left menu Menu Applications
image.png.7baed35f1a332da7b61de39b770f243f.png

In the right pane of the screen, you can setup Menu applications.
Right now you can setup 8 applications , but I'm sure that Tom will extend this ;) 

How to setup up API access :

Use the menu applications in Settings.exe to setup your program
image.thumb.png.80bf0e0e3e561d5acf9058ecfaf9a277.png

  • Name - Will display the name in the menu within PinballX
  • Enabled - If this application is enabled (select Yes to show)
  • Hide Media - During launch of the program , it will hide or show the media
    Note : This program doesn't show anything. PinballX will fade away and return. This needs to be adjusted in PinballX by Tom, but takes some time. 
    In a future release this can be toggled
  • Working Path - Path where the PinballXapiLauncher.exe is located
  • Executable - Executable that needs to be launched (PinballXapiLauncher.exe)
  • Parameters - The program has multiple parameters and needs to be setup correctly
    • -r or /r : This will launch a randomized table from your complete collection
      • use above parameter with -s or /s followed by system name : will randomize a table for that system. System name must match the system names in PinballX
    • -w or /w :  This parameter will check the Weekly challenge for PINemHI.
      It will check all your database files and select the database files that are setup for Visual Pinball
      It will try to match a table
      If it found a matching table, it will launch it
      • use above parameter with -s or /s followed by system name : will do the same, but only for that specific system . System name must match the system names in PinballX
    • -c or /c : This parameter will check the Weekly 5 min challenge for PINemHI.
      It will check all your database files and select the database files that are setup for Visual Pinball
      It will try to match a table
      If it found a matching table, it will launch it
      • use above parameter with -s or /s followed by system name : will do the same, but only for that specific system . System name must match the system names in PinballX
        NOTE : THIS WILL NOT ENABLE THE 5 MINUTE CHALLENGE. IT ONLY LAUNCH THE TABLE
    • -5 or /5 : This parameter will toggle the 5 minute challenge

 

Here are some examples I use

Random FX3 Table launcher:
image.thumb.png.21f3c062a876f725b048d4fcb5d50b3d.png

PinemHI 5 min Toggle:
image.thumb.png.a557180e917ea88dc417d936e3cee781.png

PinemHi Weekly Challenge launcher:
image.thumb.png.3f18c0ed7088c7df3d5d581ac7ce7129.png
 

PinemHi Weekly 5 minute Challenge launcher:
image.thumb.png.e7fa4bb3a839f001542cb6feb2b81d70.png

This was the setup part. One time only. Not difficult, but need to check all your steps.

How to use it in PinballX:
Launch PinballX
Wait until your GameEx account is logged in (this should take not long):
LoggedIn_small.png.026bcf7e7a9b03500047661326304489.png

Go to the menu by pressing the Start/Select button/key. In the menu scroll to Applications and press your Start/Select  button/key
Applications_small.thumb.png.7cb7e7091f255a96ac4b8ce039b76bc0.png
 

This will show all the applications you created in settings.exe

20527298_Applicationsmenu_small.thumb.png.86dd293db1b8f9af68d86d225f727985.png

Just select an option and the program will do the rest !

FAQ:

  • "I select an option for launching a table, and no table is loaded" 
    •  Check the log file that is created in the same directory (by default)  as your application is located
  • "I setup all, but selecting an option in PinballX shows me the settings application instead of launching/toggle"
    • This is properly caused by an incorrect parameter settings
      Options like -r , -w, -c and -5 cannot be combined 
      Check the log file that is created in the same directory (by default)  as your application is located
  • "I run into a problem and don't understand what is in the log file"
    • Close PinballX, launch PinballXAPILauncher.exe again and select the Log tab
      Set Log Level to Verbose and click Save & Exit
      Note Never set the logfile level to Nightmare mode ! You've been warned:D 
    • Reproduce your issue and post your logfile/ini file and pinballx.ini in the support thread
  • "Matching of table for PINemHI challenges is incorrect and launches wrong table"
    • Best way is to use the PinballX Databasemanager (not because Scutters and I created it), because the following flow will be done :
      • Read the database XML files
      • Check the weekly table and  matching rom(s)
      • Match your XML database file on rom
        • multiple tables found ? It would pick a random table that matches the rom that supports the challenge
      • No rom matching ?
        • This will check the PINemHI tablename against your XML  database file if it can match a direct hit to filename or description.
          multiple tables found ? It would pick a random table that matches the direct hit that supports the challenge
      • No direct matching on filename or description name ?
        • Last option will do a fuzzy search .
          This will check the PINemHI tablename against your XML  database file if it can match fuzzy hit to filename or description.
          Fuzzy search only matching 65 or higher!
          multiple tables found ? It would pick a random table that matches the direct hit that supports the challenge

Thanks To
@Tom Speirs for adding the applications part to PinballX
  (I hope that he will add the option to toggle the fade the screen when launching, so nothing the application can run in the background ;) )  

@Dna Disturberfor PINemHI and creating an 'API' for getting the information for the weekly challenge

@scutters for his testing, ideas, mental support  and feedback during this whole project 

(I hope I doesn't forget anybody)

Enjoy !

Edited by Mike_da_Spike
uploaded new version and added new screenshot of gameex site with new specs of my PC


What's New in Version 1.0.1   See changelog

Released

Updated code to check on both versions of PinballX.
When Legacy (XP /32bit) and .net Core is found, it will use the .net Core version

  • Like 1
  • Thanks 1

User Feedback

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest

scutters

   1 of 1 member found this review helpful 1 / 1 member

Great little addon!

Thanks for the app@Mike_da_Spike , and for adding the Applications menu @Tom Speirs - guess i'd better pull my finger out and check what impact it has on PinballX plugins now!

  • Like 1
Link to review
×
×
  • Create New...