Read Me Bart—k 1.1.1 A Macintosh Composer For Myth:The Fallen Lordsª What Is Bart—k Bart—k is a utility that allows you to manage data files used by Mythª , a video game developed by Bungieª. It can extract tagged data from within the gameÕs monolithic .gor files to use with a number of other editing programs, and it can combine tag files into new .gors. This last feature is the primary purpose of Bart—k. Note that the source of the tagged data does not matterÑtags can come from original .gor files, third-party .gor files, or they can be new ones created by a tag editing utility. Bart—k itself does not allow you to edit the contents of tagsÑwe have written Mythsmith for that purpose. Bart—k has been released as freeware. This means that you donÕt have to pay us for it, although Lucena Systems still owns all rights to the program and its source code, including distribution rights. Contact us at to find out about distributing Bart—k on CD-ROM or via your web page. What Is Mythsmith Mythsmith is an editor being developed by Lucena Systems that allows you to create and edit the data for a game like Myth: The Fallen Lordsª. Unlike other tools that only modify one aspect of the game, Mythsmith is a comprehensive program that handles every aspect of data creation and maintenance. It is The Only Editor You Need. More information about Mythsmith can be found at the Lucena Systems web site at . Using Bart—k Each .gor file is represented by its own window. There can be just one window open for each .gor. On the left side of the window is a list of all currently loaded tag groups. Selecting a tag group from this list will display all currently loaded tags of that group type. Note that ÒloadedÓ in this instance means that a tag is present in the .gor file represented by the window. Information about the .gor file is shown in the ÒGor InfoÓ area of the window. Empty .gor files can be created by selecting ÒNewÓ from the ÒFileÓmenu. Existing .gor files can be opened by selecting ÒOpenÉÓ from the ÒFileÓÊmenu or dragging a .gor file onto Bart—kÕs icon in the Finderª. Selecting a tag file from the right-hand list will cause information about the tag to be displayed in the ÒTag InfoÓ area of the window. It is possible to select multiple tags in the ÒLoaded TagsÓ list by shift-clicking a range or command-clicking non-contiguous tags. This would allow you to perform some operation on more than one tag at a time. Note that if you have multiple tags selected, the only information shown under ÒTag InfoÓ will be the total size of the selected tags. Tags can be added to a .gor using several methods. Selecting ÒAdd TagÉÓ from the ÒFileÓ menu, clicking the ÒAdd TagÉÓ button in a window, dragging tags over from another window, or dragging tag files onto the tag list from the Finderª will cause tags to be added to the .gor file represented by the window being acted upon. Dragging tag files onto the Bart—k icon in the Finderª will cause tags to be added to the .gor file represented by the front-most window. If no windows are open when you add tags, a new .gor file and a corresponding window will be created, and the tags will be added to it. Note that dragging a tag from one Bart—k window to another causes it to be copied, not moved. If a tag being added to a .gor file has the same Tag ID as a tag already present, you will be asked if you wish to replace it. If a file being added is not in the Mythª Tag format, it will be rejected. If it appears to be in the correct format, but cannot be positively identified, it will be added, but you will be warned. Tags can be removed from a .gor by selecting them and clicking the ÒRemoveÓ button or pressing the delete key. Standalone tag files can be created in two ways. To extract some of the tags in a .gor file, select them from the ÒLoaded TagsÓ list and clicking the ÒExtractÉÓ button. You will be asked for a location in which to create the extracted tags folder. To extract all of the tags in a .gor file, select ÒExtract All TagsÓ from the ÒFileÓ menu. Once again, you will be asked for a location in which to create the extracted tags folder. Regardless of the method you use, Bart—k will sort all tags by tag group and put them in separate group folders within the extracted tags folder. Existing folders cannot be replaced, and Bart—k will not merge the contents of two folders. Tags are automatically named based upon their tag IDÕs and tag names, when available. A new .gor file may be created by clicking the ÒBuild .gorÉÓ button in the window or selecting ÒSave AsÉÓ from the ÒFileÓ menu. You may save changes to an existing .gor by selecting ÒSaveÓ from the ÒFileÓ menu. Note that certain file names are reserved for use by Bungieª, and you will be warned if you attempt to use them. Also note that replacing an existing .gor file will require that you have enough free disk space to hold the temporary file created by Bart—kÕs safe saveÑthis is exactly equal to the size of the new .gor file on disk. Technical Info .gor files created by Bart—k will automatically be saved with identifying information supplied by Bungieª. They can be used with the Mac or PC versions of Myth: The Fallen Lordsª. It is recommended, although not required, that .gor names use the DOS 8.3 naming conventionÑthat is, 8 alphanumeric characters followed by Ò.gorÓ. Tag files created by Bart—k use Bungieª file types, and only tag files that use the proper formats and use Bungieª file types will be handled by Bart—k without issuing warnings. A list of these file types is available in Bart—kÕs resource fork, if youÕre curious. Bart—k Support The Lucena Systems support page is at . There you will find FAQÕs and additional support resources, as well as links to updated product information and any software updates we might have released. Version History Bart—k 1.1.1 ¥ synchronized Bart—k code base with Mythsmith ¥ reduced file size by almost 300K ¥ Bart—k can no longer create new windows until the current dialog box is dismissed ¥ fixed a bug introduced in 1.1b1 that causes a crash when the ÒSkipÓ button is clicked in the Replace Duplicate Tag dialog box ¥ removed a ÒDummyÓ menu item that was added in 1.1 Bart—k 1.1 ¥ added a dialog box for adding multiple tags to a .gor file ¥ Òsafe saveÓ is now always invoked unless the save operation is creating a new file on disk ¥ added a test for index files such as Òlocal.gorÓ to prevent them from accidentally being used ¥ simplified tag extraction to greatly ease extraction of many tags at once ¥ added the ability to extract all the tags in a .gor file at once ¥ added progress bars for tag extraction ¥ tag files with a file type of 'TEXT' would always fail to be added to a .gor file unless they happened to be 'text' tags ¥ ÒSaveÓ menu item did not update immediately if the .gor file became dirty ¥ fixed a number of bugs with the Òsafe saveÓ feature relating to saving a given file more than once during a session ¥ Bart—k mistakenly thought it could add tags to the About windowÑÒSilly Bart—k! Tags are for .gors!Ó ¥ fixed a memory initialization bug that could cause Bart—k to crash when writing out a tag file with a bad header Bart—k 1.0.1 ¥ removed an unintentional dependency on the Appearance Manager, which kept Bart—k from running on most pre-Mac OS 8 machines; there's a reason this thing is 387K larger than it needs to be! Bart—k 1.0 ¥ initial public release Known Bugs None. Contact Info Steve Ramsey bartok@lucena.com Lucena Systems ©1998 Lucena Systems All Rights Reserved ÒBungieÓ and ÒMyth:The Fallen LordsÓ are ª Bungie Software, Inc. ÒFinderÓ and ÒMacintoshÓ are © & ª Apple Computer, Inc. Portions of Bart—k are based on information that is ©1995 Bungie Software, Inc.