[Tutorial] OpenBOR - the complete guide

cyperghost

@BiZzAr721 @shift I think I can quickly improve the extracting tool, too. The scripts I've seen so far a totally messed up! Please locate PAK files to /home/pi/RetroPie/roms/ports/openbor/pak

Inside this folder the pak-files will be renamed from gamename.pak to gamename.pak.originalafter extraktion.

The extract.sh below is independent now from location because borpak offers come usefull command line usage. I asked me why it was not used this way! Instead of this they copied some executables and scripts and moved whole folders... OMG!

#!/bin/bash
# PAK EXTRACT v0.65
# by cyperghost for retropie.org.uk
# 1. PLACE  BARE PAK FILES to /home/pi/RetroPie/roms/ports/openbor/pak
# 2. RUN THE SCRIPT (with user pi!)
# Change pathes as you like!

EXTRACT_BOREXE="/opt/retropie/ports/openbor/borpak"
BORROM_DIR="/home/pi/RetroPie/roms/ports/openbor"
BORPAK_DIR="$BORROM_DIR/pak"

if [[ -f $EXTRACT_BOREXE ]]; then

    mkdir -p "$BORPAK_DIR"
    cd "$BORPAK_DIR"

    for i in *.[Pp][Aa][Kk]; do
        FILE="${i%%.*}"

        if [[ $FILE == '*' ]]; then
            echo "Aborting... No files to extract in $BORPAK_DIR!"
            exit
        fi

        mkdir -p "$BORROM_DIR/$FILE.bor"
        echo "Extracting file: $i"
        echo "to dir: $BORROM_DIR/$FILE.bor"
        sleep 3
        "$EXTRACT_BOREXE" -d "$BORROM_DIR/$FILE.bor" "$i"
        echo "-------- Done Extracting: $i ---------"
        echo "-- Backup $i >> $i.original --"
        mv "$i" "$i.original"
        sleep 5
    done

    echo "Extraction done without errors!"

else

    echo "borpak executive file not found in $EXTRACT_BOREXE"
    echo "Exit now...."

fi

sleep 5

hansolo77

Is there a link or wget method to get the actual utility used in the extraction method for Linux? I've been doing it manually in Windows them moving the files over SFTP. If this extraction script works, I'd love to try it.

cyperghost

@hansolo77 wget http://raw.githubusercontent.com/crcerror/RetroPie-OpenBOR-scripts/master/extract.sh
@BiZzAr721 I've updated the script a bit ;) It works now with spaces in filenames and mixed upper/lower PAK filename

shift

@cyperghost Thank you for the script! I added the deletion of the original files because in any case I have them somewhere else.

BiZzAr721

Default OpenBor Controller Mapping

cyperghost

@bizzar721 I link this to first posting ;) Really nice

hansolo77

@bizzar721 I like this picture..Makes it very straight forward. Is this the same layout used in Streets of Rage (via RetroArch/etc)?

dishins

Hello, the PS3 controller joypad config is not working for me, controls get all funny, i have Sony Original PS3 controllers, is there any way i can sorta debug this? i tried some other input configs also but none of them are working for me.

BiZzAr721

It stays pretty consistent with Streets of Rage. I did some research when I set up Streets of Rage Remix, and this seems to be fairly similar with what people prefer.

BiZzAr721

@dishins Use a keyboard to navigate/select and remap using your controller. Is it genuine PS3 or after market? Wired or Bluetooth? When you get it a all set up we'd love it if you could upload your config to add it to the controller database. In the first post you'll find a image with the preffered controller layout.

dishins

@bizzar721 Thanks for replying. Its a genuine PS3 controller, bluetooth with ps3controllerdriver. ATM i dont have a keyboard here, but as soon as i get one i will manually remap and upload my config :)

BiZzAr721

@cyperghost
Here is another one to add to the Joypad list
PS3 Controller Bluetooth(BiZzAr721)

@dishins Rename this file to master.bor.cfg and put it in \RETROPIE\roms\ports\openbor then use the Joypad configuration script to copy master config ---> game config
(or just wait until it gets added to the joypads.txt)
Thanks for testing out wired PS3 over Bluetooth =)

cyperghost

@bizzar721 Added the bluetooth config file, thank you
So the first PS3 was the wired config?

@dishins Maybe you can use the "Emergency setting" if this won't work for you. The emergency settings just got up/down movement and two buttons for confirment. So you can try to navigate through the menu with this and setup your joypad. It's not the best way to do this. Keyboard would be first choice if all controller settings will fail.

I hope that the PS3 config from @BiZzAr721 is working for you.

BiZzAr721

The first controller config was wired. I didn't install PS3 BT drivers since I wasn't using it anymore. I realize now inputs are different wired/wireless.

cyperghost

@BiZzAr721 Perfect! Changed description to wired and bluetooth connection

BiZzAr721

I just wanted to make mention of the issue I have had where joy2key keeps running in the background while OpenBOR is running, causing D-pad Left to exit back to Emulation Station. A quick fix was to exit to ES, then open Terminal.
Type ps -a to list running processes
Note the process ID number of joy2key
Then type kill 1234 where 1234 is the PID of joy2key

EDIT
Just enter pkill joy2key to kill joy2key - no need for doing the above Thanks Cyperghost

It seems to have something to do with hitting input buttons causing joy2key to load when it shouldn't.
I hope this will help anyone that may encounter this bug.
A thread with more information about this issue can be found here.

I will update this post if I find a solution to stop this from happening in the first place.

Denver Gamer

Hey guys, any chance you can help a noob out with my Windows configuration? This retropie forum is literally the ONLY place I can find any useful information. I am unpacking the pak files and naming the directories gamename.bor etc... But, when I launch a game from ES I am getting a message "No mods in paks folder". Here is what my config file looks like:

<system>
	<name>openBOR</name>
	<fullname>openBOR</fullname>
	<path>D:\OpenBOR\Paks</path>
	<extension>.pak .PAK .bor .BOR</extension>
	<command>D:\OpenBOR\OpenBOR.exe "%ROM%"</command>
	<platform>pc</platform>
	<theme>btmups</theme>
</system>

What am I doing wrong? Thanks in advance for helping a noob. I am a youtuber and would love to do a video on this.

cyperghost

@denver-gamer This won't work as long you did not compile the changes that were done by @darknior to the OpenBOR source code on your own build. Only this will give the ability for command line calls. You can visit darkniors github account and just copy the changes to the windows source code and compile it.

There are surly other methods like renaming files .... but these are only workarounds.

Thanks in advance for helping a noob. I am a youtuber and would love to do a video on this.

What's a youtuber?

CapNinja

@cyperghost said in [Tutorial] OpenBOR - the complete guide:

What's a youtuber?

A miserable little pile of video data. But enough talk… Have at you!

Denver Gamer

@cyperghost My YouTube is Denver Gamer brother