1. Download Winetricks Mac Download
2. Download Winetricks Mac Software

These packages enable easy access to a plethora of ported Linux software, including Wine and Winetricks, the key elements to running DM on Mac. This guide uses Macports. To obtain MacPorts, visit the download section at www.macports.org. Download the package (dmg) installer for either Lion or Snow Leopard. Winetricks is a helper script to download and install various redistributable runtime libraries needed to run some programs in Wine. These may include replacements for components of Wine using closed source libraries. Sep 22, 2021 M1 Mac users must register for the Windows Insider Preview program and download the ARM version of Windows 10. Only Parallels supports the ARM version, but it has no trouble configuring your. So once it is installed, type in Terminal: 1) sudo port install winetricks (- this will get you DanKegel's Winetricks) Next step is to update your DirectX dlls: 2) winetricks d3dx936 (- this will install you the dlls for DirectX9). Install the App. Press Command+Space and type Terminal and press enter/return key. And press enter/return key. If you are prompted to enter your Mac's user password, enter it (when you type it, you wont see it on your screen/terminal.app but it would accept the input; this is to ensure no one can see your password on your screen while you type it.

Translations of this page:FrançaisภาษาไทยNederlands (Translators, please see Discussion page.)

What is winetricks?

Winetricks is a helper script to download and install various redistributable runtime libraries needed to run some programs in Wine. These may include replacements for components of Wine using closed source libraries.

Note: Although using winetricks may be very useful for getting some programs working in Wine, doing so may limit your ability to get support though WineHQ. In particular, reporting bugs may not be possible if you've replaced parts of Wine with it. See Reporting bugs after you have used Winetricks below.

Note: Some of the packages listed below may not work well with older versions of Wine. As always we recommend you use the latest version of Wine.

Getting winetricks

The script is maintained by Austin English at https://github.com/Winetricks/winetricks. The latest release is available at https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks. Right-click on that link and use 'Save As' to save a fresh copy.
Alternatively you can get winetricks, using the commandline, with the command:

Also, some winetricks 'packages' require a few external tools to be installed, namely: cabextract, unzip, p7zip, wget (or curl). For GUI support, either zenity or kdialog.
Linux users can usually get these via their distribution's package management system.

Using winetricks

Once you've obtained winetricks you can run it simply by typing sh winetricks at the console. You can also use ./winetricks if you chmod +x winetricks first. If run without parameters, winetricks displays a GUI with a list of available packages. If you know the names of the package(s) you wish to install, you can append them to the winetricks command and it will immediately start the installation process. For example,

will install both the corefonts and vcrun6 packages.

Options

Download Winetricks Mac Download

Version 20200412 help text:

Tip: As with all Wine commands, winetricks knows about the `WINEPREFIX` environment variable. This is useful for using winetricks with different Wine prefix locations. For example,

installs the mfc40 package in the `~/.winetest` prefix.

Tip: Users with more than one version of Wine on their system (for example, an installed package and an uninstalled Wine built from git) can specify which version winetricks should use. For example,

installs the mfc40 package using the Wine in the ~/wine-git directory.

Reporting bugs after you have used Winetricks

Please do not report bugs if you have used winetricks to install native (ie non Wine) files, as we cannot support Microsoft dlls.

Using winetricks to install gecko, mono, and fakeie6 options is acceptable for bug reports - just be sure to mention that's what you've done.

Additionally if you found it necessary to use winetricks for an application please mention it when submitting to the AppDB, mailing lists, and other Wine resources.

Reporting bugs *in* Winetricks

Winetricks has a bug tracking system at https://github.com/Winetricks/winetricks/issues, please use it. If you don't want to get an account there to file a bug, posting on the wine user forum may also eventually get noticed.

How to remove things installed by Winetricks

It's easy to install an entire wineprefix, so by default, winetricks installs each app into its own Wine prefix, and offers an easy way to remove wineprefixes and the menu items they created.

Winetricks does not provide a way to uninstall individual apps or DLLs inside a Wine prefix. This is for several reasons, but mainly because the preferred way to uninstall anything in Wine is to simply install into a fresh Wine prefix. (Yes, it would be nice to have uninstallers for everything, but I don't need it myself. Patches welcome.)

If for some reason, you still don't want to fiddle at all with your Wine prefixes, Wine does offer a built-in Uninstaller program. Like the Windows 'Add/Remove Programs' applet though, it only recognizes programs installed by well-behaved Windows installers that respect the registry, like InstallShield or WISE. There are no guarantees it will work with a program installed by Winetricks or other installers like .msi packages.

Installing winetricks

It's not necessary to install winetricks to use it. You may choose to install winetricks in a global location so you can just type winetricks on the command line. Some Linux distributions include winetricks in their Wine packages, so you don't have to download it separately. You probably do want to follow these steps, if the distributions packaged winetricks version lags behind the current winetricks release (e.g. Debian/Ubuntu users).

To download and install your own copy of winetricks, you can install it manually like this:

To download and install the (separate) BASH completion script for winetricks:

See Also

• http://www.cabextract.org.uk/ -- cabextract is a tool for extracting MS cabinet files under Unix environments.
• http://mike.kronenberg.org/index.php?s=trix (Darwine now comes bundled with trix, a gui that invokes winetricks)

Before you start making your first map, you need to install and set up Zone Builder and get familiar with its interface.

• 1Installation
• 5Interface

Installation

Windows

Download the installer from here and run it. It will automatically install all necessary dependencies.

macOS

It is possible to run Zone Builder on Intel-based Macs using CrossOver Wine (a version of Wine modified to support 64-bit versions of macOS). If you have an ARM-based Mac, you are, sadly, out of luck (for now).

Start by downloading the latest Zone Builder setup executable. Then setup Wine:

1. Download the latest version of Wineskin (on the GitHub release page, it is the download labeled 'Unofficial.Wineskin.Winery.zip'. Extract it and launch 'Unofficial Wineskin Winery.app'.
   1. Install the latest engine and select it (at the time of this writing, the latest engine is WS11WineCS19.0.1-1)
   2. Update the wrapper version (if available)
   3. Select 'Create New Blank Wrapper' and name it 'Zone Builder'. Wait for setup to complete.
2. 'Zone Builder.app' will be created in '$HOME/Applications/WineSkin/'. Right click 'Zone Builder.app' and select 'Show Package Contents.' Open 'Wineskin.app'.
3. Install the necessary Winetricks packages
   Preparing to install the Winetricks packages.
   1. In the Wineskin window, select 'Advanced'. Then select the 'Tools' tab. Click on 'Winetricks'.
   2. Press the 'Update Winetricks' button. Press 'Yes' when it asks you to confirm.
   3. Install the following packages in order: dotnet35 d3dx9 d3dcompiler_43 vcrun2008 gdiplus_winxp win7
      • You can simply check 'Custom...' and copy-paste the above list of packages into the '(arguments)' text box. Then press 'Run'.
      • Wait for the process to complete. This can take several minutes.
   4. Wait for the packages to install.
   5. Close the Winetricks window.
4. Install Zone Builder.
   1. In the Wineskin window, select 'Install Software'.
   2. Select 'Choose Setup Executable' and select the Zone Builder setup executable you downloaded earlier.
   3. Follow the installer (just click 'Next' and use the defaults)
   4. Once the install is finished, it will prompt you to choose Zone Builder's executable. Select 'C:/Program Files/Zone Builder/Builder.exe'
5. Close Zone Builder
6. Install the Winetricks winxp package.

Zone Builder should be installed. You can launch it by clicking 'Test Run' in the Wineskin window or by simply opening 'Zone Builder.app'.

Now you will probably want to configure Zone Builder for Sonic Robo Blast 2:

1. Launch Zone Builder
2. In the Windows menubar, select Tools->Game Configurations...
3. In the sidebar, select 'Sonic Robo Blast 2 - 2.2'
4. Add the game resources.
   1. In the 'Resources' tab, click 'Add resource...'
   2. Select the 'From PK3/PK7' tab.
   3. Click the folder icon. Navigate to and select '/path/to/Sonic Robo Blast 2.app/Contents/Resources/srb2.pk3'.
   4. Press Open/OK to get back to the 'Game Configurations' window.
5. Set up the testing engine.
   Testing engine settings for macOS.
   1. Select the 'Testing' tab
   2. Rename the Engine to something reasonable, e.g. 'Sonic Robo Blast 2'
   3. In the 'Application' field, press the folder icon and navigate to 'Z:bin'. In the file name box type 'zsh'. Press 'Open'
   4. Check the 'Customize parameters' box.
   5. Replace the parameters with: -c 'open -a 'Sonic Robo Blast 2.app' --args -file '$(winepath -u '%F')' $0 $@' -warp %L
   6. Press OK

Zone Builder should now be set up for mapping on (Intel-based) macOS!

Linux

Zone Builder does not have native binaries available for operating systems other than Windows, but it is possible to run it using Wine. Download the latest stable binary for your OS here and install it. Note that the Wine package provided with many distributions, such as Ubuntu and it's derivatives, WILL NOT WORK. You MUST use the one provided by WineHQ's repository. Otherwise Zone Builder will install but will crash on launch. Zone Builder has been confirmed to work on Wine versions 3.19-Staging, 4.0, and 6.0, it should work fine in any release following those. Only the 32-bit installation is necessary.

Unlike on Windows, the dependencies Zone Builder automatically installs are not necessarily sufficient to run itself in Wine. To get around this, you must install these dependencies yourself using using Wine's library installer script, Winetricks. Find the Wine executable you just installed and run it. It should open a command line window showing some basic commands used to operate Wine. Execute the following command to install Zone Builder's dependencies using Winetricks: winetricks dotnet35 d3dx9 d3dcompiler_43 vcrun2008 gdiplus_winxp win7. Winetricks should begin downloading and installing several versions of Microsoft's .NET packages, then DirectX 9, and finally Visual C++ 2008.

Once the installations are complete, Follow the Windows install instructions. It may try to reinstall some dependencies – if so, accept and install them. You should not need to change any of Zone Builder's installation settings. Once complete, you should be able to locate the Builder.exe executable (it is usually located in ~/.<name of your prefix>/drive_c/Program Files/Zone Builder/) and complete the last step in the install instructions and start Builder.exe with Wine.

Setup

First, you need to specify SRB2's IWAD and the executable that is used to run SRB2 when testing your maps. To specify the IWAD, go to Tools → Game Configurations in the menu bar. A window will pop up with a list of configurations. From this list select 'Sonic Robo Blast 2 - 2.2', which should have a tick symbol in the box next to it as shown below:

If running Zone Builder using Wine, you may encounter errors from various SRB2-related configurations, reporting that spaces are not allowed in key names, and you will not be able to select it from the list of configurations. If this occurs, close Zone Builder, locate the erroneous configuration file, copy its contents into a fresh text file, and overwrite it. Relaunch Zone Builder and select 'Sonic Robo Blast 2 - 2.2' as the configuration.

In the Resources tab, click on 'Add resource...' and then on the folder symbol in the window that pops up to select the IWAD. Navigate to your SRB2 folder and select srb2.pk3 as seen below:

To set the testing executable, go to the Testing tab of the Game Configurations window. There, click on the folder symbol next to the Application box, navigate to your SRB2 folder and select srb2win.exe.

If you don't know how to make a shortcut on the desktop, then go into the directory you installed Zone Builder in, right-click Builder.exe and select Send to → Desktop (create shortcut).

Creating a map

To create a new map, select File → New Map in the menu bar or click the button with the blank sheet icon at the top left of the toolbar. A window like this will pop up:

Here you can select the configuration you want to use and the slot that the map will occupy. You can also import additional textures if you want to use them, but for the purpose of this tutorial, you should leave these fields as they are. Make sure 'Sonic Robo Blast 2 - 2.2' is selected as the configuration and click OK.

Important map components

Download Winetricks Mac Software

Before you can start editing the map you just created, you need to understand the basic structure of SRB2 maps. Maps are made up of five main components: vertices, linedefs, sidedefs, sectors and Things. Look at the triangle in the image to the right. This triangle is a sector. It is made up of vertices (the blue dots in the corners) which are connected by linedefs (the white lines between the blue dots).

• Vertices: A vertex is essentially a point in the map where a linedef ends/begins. Thus, vertices make up the corners of sectors. In our example triangle, they are the blue dots in the corners. Since vertices have no other properties aside from their location, you will rarely need to place them directly; instead you will automatically create them along with the linedefs that you draw. However, you will occasionally need to move vertices around in order to change the shape of an already existing sector.
• Linedefs: Linedefs are the lines that connect the vertices, and therefore the edges of a sector. In our example triangle, these are the white lines surrounding it. In the game, linedefs will form the walls of the level. As you can see in the example triangle, Zone Builder displays a small notch in the middle of each linedef. This notch indicates which direction the linedef is facing. It always extends to the right of the linedef, e.g. if the notch goes north, the linedef is facing west.
• Sidedefs: Each linedef consists of two sidedefs. They are literally the sides of the linedef. The side with the notch is the front sidedef. In the example, the front sidedefs all face inward. The sides without the notch are the back sidedefs, which face outward in this example. Some linedefs, such as the ones that make up the map's outer boundaries, only have a front sidedef; they are called one-sided linedefs. The player should never be able to look at these from behind, or errors will occur. Sidedefs are the map components that display textures, i.e. the graphics that will later be visible on the level's walls.
• Sectors: In our example, the sector is the triangle itself. A sector is formed simply by making a closed loop of linedefs. You can't directly place a sector on the map, instead you must form a closed loop of linedefs around where you want your sector to be. Sectors are the map components that display flats, i.e. the graphics that will later be visible on the level's floors and ceilings.
• Things: These are just what the name says: They are things that you place onto the map, such as a starting point for the player, rings, enemies, monitors, obstacles, scenery objects like flowers, and several others. They are independent from the rest of the map structure, so you can place them anywhere you need them.

Interface

Before we start drawing level geometry, we must first take a look at Zone Builder's basic interface. The following is a screenshot of the main window, showing the different parts of the interface:

• Working area: This is where you will create your map. It is overlaid with a grid on which you can draw level geometry. The crosshair indicates the center of the grid.
• Editing modes bar: This bar is where you choose the current editing mode. See below for a list of the most important editing.
• Menu bar: Here you can find menus that give you access to most of Zone Builder's features. To the right of the menus are buttons that give you access to important features for the current editing mode.
• Toolbar: The toolbar includes buttons for the most commonly used features that are independent of the current editing mode.
• Sidebar: This sidebar contains several pop-up panels, including a dialog for undoing/redoing previous actions, a panel where you can set standards drawing settings for the map, a help panel, the tag explorer, and, in some editing modes, panels with additional settings. Hover over one of the tabs to open the corresponding panel.
• Information panel: This panel displays information about the highlighted map component, in this case a linedef. If nothing is highlighted, it displays general information as well as important messages such as warnings or error messages.
• Status bar: The status bar displays status information such as performed actions and information about the current selection. It also displays information about the chosen configuration, the grid size, the zoom level, and the current mouse coordinates. You can click the buttons next to the grid size and the zoom level to open windows where you can change these settings.

Editing modes

This is an overview of the most important editing modes, many of which you will use throughout the tutorial. A few additional editing modes will be introduced later on.

• 1 – Vertices Mode: In this mode, you can place vertices. As explained above, you normally won't place them manually, since vertices are automatically created together with linedefs. However, you can move them around, and insert new vertices into linedefs to split them.
• 2 – Linedefs Mode: This mode is for creating and moving linedefs, as well as editing their properties, which includes the sidedefs. You will use this mode to draw new sectors.
• 3 – Sectors Mode: This mode is for moving sectors around and editing their properties. As explained above, you don't actually use this mode for creating new sectors; that is done by creating a closed loop of linedefs.
• 4 – Things Mode: This mode is for placing and moving Things, as well as editing their properties.
• 5 – Visual Mode: This mode lets you navigate through a 3D preview of your map, which is useful for seeing what your level will look like and finding map errors easily. You can find a more detailed introduction to Visual mode in Chapter 7 of this tutorial.
• 6 – Edit Selection Mode: This mode lets you edit selected map components, for example rotate or resize them. Edit Selection Mode is explained in detail in Chapter 4 of this tutorial.
• 7 – Find and Replace Mode: This mode lets you search for map components and, optionally, replace found elements.
• 8 – Map Analysis Mode: This mode lets you search for errors in your map, such as broken level geometry.

Basic controls

• To select or deselect an object, left-click on it. You don't have to hold Ctrl to select multiple objects; just click on new objects and the old ones will be kept in the selection.
• To quickly select multiple objects, left-click into empty space, hold the mouse button and drag the mouse to draw a box over everything you want to select. This will not deselect any other objects already selected.
• To deselect all selected objects, press C or click into empty space.
• To place a new object, right-click where you want to place it. To edit an existing object, right-click on it.
• When drawing sector geometry, left-click to place a new vertex. Right-click to finish drawing.
• Scroll the mouse wheel to zoom in or zoom out.
• For more controls, select Tools → Preferences in the menu bar and switch to the Controls tab.