
I just got the Visual Novel game Little Busters! working on my Macbook through Wine. However, since the process was far from easy, I thought I’d share how I did in case someone else wants to play Visual Novels too. Note that this guide is made for Key/Visual Art’s Visual Novels, like Clannad, Kanon, Air, Little Busters, etc. and other game makers’ games may not work at all. You should check them up in this database before trying to run them, if they’re gold or platinum, they’re playable. Note that you also need an Intel mac, any mac with G3, G5 or G5 processors (pre-2005) runs on the PPC architecture which makes Wine impossible to run. The initial steps also requires you to be logged in as administrator. If the admin account is separate from your normal account, make sure to have the admin account’s credentials available, or ask your administrator to run the first step for you.
Note that this guide uses examples for installing the game Little Busters, other games may place the installed files in other locations, if that’s the case, you just need to change the paths.
Quick Guide to many of the special characters present in this guide:
- ~ = Refers to “/Users/<your username>”, and gives the exact same result as typing that instead. Typed by holding ALT and pressing [N] (American Keyboard) or [^/¨] (European Keyboard), and then pressing Spacebar.
- ; = Links several commands together to be performed in succession. e.g. typing “command1;command2″ is equal to first running command1, waiting until it’s done and then running command2.
General advice for interacting with the command line:
- There is a difference between “/path/to/file” and “path/to/file”. The first (begins with a “/”) will search from the root of your startup drive, while the second will start from the directory you are currently in
- There is also a difference between something between quotation marks and without. In the former case, the text is taken as a Literal, and shortcuts like ~ will not be expanded like intended. In the latter case, you need to prefix any spaces in the path with “\” without the quotation marks (space -> backslash space) or it won’t work (note that spaces separating Arguments to a command should NOT be escaped like this; in that case this is the intended behavior)
Step 1: Getting the necessary files
(this step only needs to be done once, and does not have to be repeated for every novel you install)
1.1: X11 and Wine
To install a Visual Novel, you need a number of things. For a start, you need Wine and X11 to run Windows .EXE-files. To install X11, you can either grab it from the OSX Installation disc or from here. Then, you need MacPorts to install Linux/UNIX-packages from the Command Line, grab that from here and follow the installation instructions (NOTE: it’s not just installing the package!). After you have installed Macports, open Application->Utilities->Terminal. Then type the following command (Copy it exactly! A typo will make the command fail!) and press Enter:
clear;sudo port selfupdate;sudo port install wine-devel winetricks cabextract +universal;sudo port upgrade all
Congratulations, you can now run windows applications! However, before we start doing that, we need to make said windows applications work. Type this command into the terminal (some parts are supposed to end with an “Installation Failed” message) WARNING! This step will fail (for real) if you’re not logged in as yourself!:
clear;winetricks corefonts;winetricks comctl32 comctl32.ocx d3dx9 d3dx9_28 d3dx9_36 dinput8 directmusic directplay dotnet20sp2 fontfix vb6run
The script will install much of the components required to use most Windows applications for you, just sit back and watch, however, do not leave the computer since it will occasionally ask you to accept a license agreement or ask for confirmation (Notice the gray ugly windows-style boxes? Those are actually Windows applications!). When this is done, you can theoretically run most Windows applications unless they are too complicated. However, to make it play anything in Japanese or with a japanese origin, you need to fix some more…
1.2: Japanese Fonts
(from now on, make sure you are logged into the account you are planning on playing on)
To run Japanese games, your computer need to be able to render Japanese text, of course. If you try without these installed, you will just get ASCII-gibberish and there’s a large chance of the application crashing or acting strange. To enable Japanese fonts, grab this file and type this command (don’t type the [[DROP HERE]] part, instead, drag the downloaded file from Finder to the terminal when you get to that part to make it paste the full path to the file in there):
cd ~/Desktop/;LANG=ja_JP.SJIS wine [[DROP HERE]];mv -fv ./*.ttf ~/.wine/drive_c/windows/Fonts/
This will install the required fonts. However, we’re not ready to play just yet.
Step 2: Preparing the game itself
(if you want to install more novels, repeat from here)
Step 2.1: Installing the Game
This is just what it sounds like: Install the game. If you have the physical disc, insert it. If you have an ISO or DMG with the contents of it, double-click on it to mount it. Then type the following command into the Terminal to open up the installer:
cd "/Volumes/LB";clear;LANG=ja_JP.SJIS wine ./Autorun*.EXE
If your Installation Disc is called something else than “LB”, you must replace it with the name of your disc. Note that it is case sentitive, so “LB” is not the same as “lb”, “Lb” or “lB” and so on. If the name is long, you can replace cd "/Volumes/LB" with cd /Volumes/[first few letters of the disc name]* where you insert enough letters in the disc name to make sure there’s no other devices (Hard drives, Web Servers, Discs, etc.) that are mounted (that is, appears on the desktop or the finder sidebar) that begins with the same letters. Make sure you replace any spaces with “\ ” (Backslash Space) without the quotation marks.
Step 2.2: Patching the Game Engine
(Little Busters! Exclusive; though if you have other patches you want to install, you will still want to follow this step, adapting it to use other filenames as appropriate.)
If you are installing Little Busters!, grab this patch for it. If you are installing a novel that requires a No-CD Patch, you can use the same steps there, but you have to get the Patch yourself. Note that a lot of Visual Novels doesn’t require you to patch anything, but Little Busters! and a few others can’t be played without the physical disc without a No-CD Patch. If you run the game in the final step and it doesn’t run and is saying something about a missing CD follow this step. Also note that this step assumes that your game uses REALLIVE, if your novel uses some other engine, you have to replace “REALLIVE.EXE” in the commands with the name of the executable you want to patch.
Place the downloaded EXE-file on your desktop and rename it to “Patch.exe” for the sake of simplicity (again, case sensitive). Then run this command:
cp ~/.wine/drive_c/KEY/*/REALLIVE.EXE ~/Desktop/;cd ~/Desktop/;LANG=ja_JP.SJIS wine ./Patch.exe
And choose to patch the file “REALLIVE.EXE” that will be located on your desktop. When it’s finished, run this command:
mv -f ./REALLIVE.EXE ~/.wine/drive_c/KEY/*/;rm -f ./Patch.exe;rm -f ./REALLIVE*
This will update the game engine and make it possible to actually run the game, as well as removing the used patch (remove the “rm -f ./Patch.exe” part if you want to keep it).
Step 2.2: Language Patch
If you have a Language Patch (for translating the game to english), name it “LangPatch.exe” (or change the name in the command below to whatever it’s called; just make sure to replace any spaces in the filename with “\ ” (backslash-space) or it won’t work), place it on the desktop, and run this command:
clear;cd ~/Desktop/;LANG=ja_JP.SJIS wine ./LangPatch.exe
Repeat this step for any additional patches.
Step 3: Running the Game
Step 3.1: Creating the Script
To actually run the game, there are several steps involved. To make this a easy as possible, we will be creating a script that does most of the work for you.
Open a text editor of choice (any editor works, like the built in one, which I’ll be using), and create a new file in your home folder (/Users/<yourname>) with a name along the lines of “littlebusters.sh”. The name can be anything, but it should end in “.sh”, and should only contain characters a-z and underscore( _ ).
WARNING: You should save this as PLAIN TEXT. If you’re using Text Edit, select Format -> Convert to Plain Text to remove formatting. Also, never EVER use Word, Pages or other word processors to save these files. Saving formatted text will cause the script to stop working, and instead throwing weird errors at you about commands not being found.
If you have a disc, type this into it:
if [ -e /Volumes/<< The full name of your CD >> ]
then
echo "The CD is inserted, starting game..."
LANG=ja_JP.SJIS wine ~/.wine/drive_c/KEY/*/REALLIVE.EXE
else
echo "The CD is not inserted!"
fi
Replace << The full name of your CD >> with the name of your CD (Case-Insensitive). If you have an ISO or DMG, use this code instead:
if [ -e /Volumes/<< The full name of the disc image >> ]
then echo "The Disc Image is mounted, starting game..."
else echo "Attempting to mount the Disc Image..."
hdiutil attach << The full path to the disc image >>
fi
LANG=ja_JP.SJIS wine ~/.wine/drive_c/KEY/*/REALLIVE.EXE
Replace << The full name of the disc image >> with the full name of the disc image as it shows up in the Finder sidebar when it’s mounted, and replace << The full path to the disc image >> with the full path to the Disc Image file (Note that if you move it, you need to change this). You can get the path by dropping the file into the text editing area in most cases (like the Built-in Text Edit).
Then run this command:
chmod 755 ~/*.sh
Done!
Step 4: Play!
To play the game, open up X11. You should get a large white terminal. If you don’t, press Command+N. Type this into the terminal to launch the game:
~/<filename>.sh
Where you replace <filename> with whatever you named the script you created in the last step. So if you named the script littlebusters.sh, you type ~/littlebusters.sh. It should print a few (or a lot of) messages, and start the game.
Powered by Qumana