Boxer

Developer diary: plans and progress reports.

Posts tagged with “Betas”

Bombs away Sunday 13th December 2009

That's right boys and girls, the sourcecode for Boxer 1.0 alpha is now available on Bitbucket. There's also a ready-to-roll universal binary too, if you're squeamish about building stuff yourself. Check out the previous blog post for an idea of what's new in Boxer 1.0.

What you will need:

How to build it:

How to run it:

Caveats:

As always, give it a try and tell me what you think in the comments!

Fixing the foundations, ironing the drapes Sunday 2nd August 2009

As further proof that I have absolutely no idea what ‘beta’ is supposed to mean, recent Boxer 0.86 betas include some fairly fundamental internal changes. Of these, two will actually be visible and relevant to you:

  1. Boxer’s “built-in” DOS utilities and Gravis Ultrasound drivers are now actually built-in: they are kept inside Boxer itself, instead of being copied into your DOS Utilities folder. This saves you about a dozen megabytes, and me a lot of heartache when the utilities need updating.

    The DOS Utilities folder still works, but is now solely for your own personal programs and not Boxer’s. You can safely delete the REQUIRED and ULTRASND folders from your existing DOS Utilities, as these are leftovers and unused by Boxer.

  2. Boxer's default DOSBox settings are now also built-in, instead of being mixed up with your own settings in ~/Library/Preferences/Boxer/DOSBox Preferences.conf. In fact, that preferences file is no longer used by the latest betas: if you have customised any settings, you should now put them in ~/Library/Preferences/Boxer/Shared Preferences.conf. This new file is solely for your own personal settings, and not Boxer’s.

The rationale behind these changes is to minimise Boxer’s reliance on files that are out there in Userland. This makes it harder for you to break Boxer’s intended behaviour (not that you would ever do such a thing) and much easier for me to push updates that don’t trample all over your personal stuff.

At the other end of the feature spectrum, the latest Boxer beta applies an ostentatious game-shelf appearance to the icon view for new DOS Games folders. Here’s how it looks:

Out of courtesy, Boxer will not apply this appearance to your existing DOS Games folder: only to new games folders it makes. If you want this appearance for your existing DOS Games folder, then the simplest way is:

  1. Drag your games folder to the Trash; (it’s safe!)
  2. Launch Boxer, and tell it to create a new games folder when it complains;
  3. Move your games from the Trash back into the new games folder.

There are other ways, but they’re complicated and hard to explain. If you don’t want to trash files, send me an email and I’ll walk you through it.

Cover Flow is still the default view for the DOS Games folder in OS X 10.5, but you can switch to the shelf appearance by choosing icon view from the Finder View menu. You will also need to adjust the folder’s View Options panel if you want it to always use this view mode.

Another beta, and a peek behind the curtain Saturday 18th July 2009

Boxer 0.86 20090718-1 has been released, which fixes a couple of bugs and tweaks some interface strings. This version is also up on the Boxer betacast and will appear as an automatic update for previous betas.

At the same time, I figured some users might be interested in a peek at the iterative rewriting process that Boxer’s interfaces go through.

First, a little background

In the newest 0.86 betas, Boxer will ask you after game installation if you’d like to import the original installation files into your new gamebox. These files then become available to the game as a fake CD-ROM drive. This is necessary for games that still need access to those files after installation: usually, CD-based games that only install part of their total files. Boxer 0.8 and up would already offer to do this after installing from a physical CD: but now Boxer offers to after installing from any installation source, such as a regular folder of files copied from a CD.

Round and round we go

The first released version of the interface for that choice looked like this:

This is unsatisfactory: the window tells you broadly what would happen (the installation files would be imported), but not why you would need to do so, nor what effect this would have on the game.

After a few iterations, it became this:

This is better: the window now specifies why you would choose to import the files (because games that check for a CD will need them), and what effect it would have (the files would become a new CD for the game).

However, the wording is clunky and ambiguous: users could mistakenly think that Boxer would burn a physical CD from those files. The buttons also refer to two separate concepts: “importing” and “making a CD.”

A few more iterations later, and we have this:

Clearer still: the text flows better and does away with the distracting “importing” verb, instead focusing on the more familiar notion of “making a CD.” It also clarifies that the CD will be “fake”, as opposed to a real, physical CD. (This is a sufficient description, as the user doesn’t need to know how Boxer handles fake CDs: just that they won’t need to burn a real one.)

However in the quest for brevity, the text no longer indicates a connection between the fake CD and the game itself. The brevity is also deceptive, since the folder label (“DFCD”) could be much longer and would then wrap to a third line anyway. So we can spend a few more words to clear this up:

This is the final window used by the new 20090718-1 beta. We’ll see how long it lasts before being rewritten again.

I welcome our new Bethesda overlords (another beta) Thursday 16th July 2009

Hot on the heels of my previous abortive attempt to make Daggerfall installation easier, here’s Boxer beta 0.86-20090718-1. This time I’ve got it right, I promise.

So without further ado

You can play Daggerfall with Boxer thusly:

  1. Download Boxer and put it wherever you like on your Mac (replace any older copy with it). If this is your first time using Boxer, start it up once to let it set up its stuff.

  2. Download Daggerfall from Bethesda’s website. Once it finishes, doubleclick on the downloaded archive (DFInstall.zip) to extract it, if Safari hasn’t already done so. (It may take you several tries to download–it kept getting cut off halfway for me, leaving me with a broken archive. The final filesize should be 148.7 MB.)

  3. Drag the extracted DFInstall folder onto Boxer’s “Drop games here to install them” droplet. Daggerfall’s installer will now start up.

  4. Tell the installer to install the game to your hard drive, and agree to all the default options. Once the sound-card selection screen comes up, tell it to auto-detect your digital soundcard and then choose ‘MPU-401’ (with the default port) as your MIDI card so that you’ll get music.

  5. Once the game has finished installing, close the DOS window. We could start playing the game already, but we really should patch it first. We’ll get there, I promise.

  6. Boxer will now tidy up the installation, and ask if you’d like it to make the game’s installation files into a fake CD for the game:

    Choose to “Make a fake CD”: this will keep the game happy when it checks for a Daggerfall CD at startup.

Congratulations!

Daggerfall is now fully installed into a nice tidy Daggerfall gamebox in your DOS Games folder. It’s named DFCD right now, but you could rename it to Daggerfall or whatever you like.

That was easy, I hear you thinking. It’s already done, and I still have time to watch TV or do some sewing.

But wait, we’re not quite done yet!

You see, when it was first released, Daggerfall was just a collection of monstrous game-ruining bugs, and it needs updating to be worth playing. Fortunately though, Bethesda have included the latest Daggerfall patch in with the stuff you downloaded. So to update the game:

  1. Right-click on your Daggerfall gamebox and choose "Show package contents": a Finder window will come up, showing you what’s inside the gamebox. Open up the DAGGER folder that you’ll see inside.

  2. In the original Bethesda stuff you downloaded (in the DFInstall/DAGGER folder) you’ll find a program called DAG213.EXE: this is the patch we need. Drag DAG213.EXE into the DAGGER folder inside the gamebox.

  3. Double-click on DAG213.EXE: the patch program will now start up in DOS. Answer yes whenever the patch asks you something.

  4. Once the patch finishes, you can type DAGGER to play the game (or just close the DOS window.)

That’s it (really this time)

Daggerfall is now as up-to-date as it will ever be, and is ready for you to play in earnest. From now on, you can just doubleclick on your Daggerfall gamebox to play the game. The first time you do, Boxer will ask which of the game’s programs you want to run: choose DAGGER.EXE, and Boxer will never bother you again.

Feel free to trash the files you downloaded from Bethesda, as they’re no longer needed. If you like, give the gamebox to your Mac-loving Boxer-having friends so they’ll be able to play Daggerfall too, without needing to install or patch the damn thing themselves.

Have fun assigning those skill points!

Bonus step

Read Bethesda’s 21-step instructions for running Daggerfall in DOSBox. Marvel at all the things you didn’t have to do.

Greetings Daggerfall fans (a new beta) Friday 10th July 2009

Edit: a special not-crashing-at-startup edition is now available! Download 0.86-20090711-1 here.

This beta includes DOSBox 0.73 and has a laundry list of improvements to game installation, compatibility and overall cleverness. Which is fortunate, because Daggerfall was just released for free by Bethesda today, and Boxer 0.85 has drive-space issues that can prevent it from installing.

As intimated in previous posts this version is not related to the 0.9 betas, but is instead a maintenance update to the 0.8x branch. That means there's no shiny Cocoa UI or friendly DOS I'm afraid. 0.9 beta users will probably want to download this anyway though, since DOSBox 0.73 gives significantly improved game performance and compatibility. An update to the 0.9 branch will be along soon hopefully.

This beta is not ready for primetime release, as it still needs localising and a lot of testing. Please report any crashes you find or other bugs you notice, and be sure to mention if a game that was working in 0.85 now isn't.

Design by 40watt.