OPie: User Guide

To install OPie, download the latest version, move the OPie folder from the zip archive into your World of Warcraft​\_retail_​\Interface​\AddOns directory, and restart the game client.

Basics

Once you've installed OPie, you can use it immediately, and customize it further within the game. Several rings are automatically created when you install OPie, including the Trade Skills ring (which contains all of the trade skills your character knows), which you can open by holding down ALT-T.

If you've already bound ALT-T to something else, OPie will not override that binding, and the Trade Skills ring will not appear. Skip to the next section to find out how to change OPie bindings.

The ring will remain visible for as long as you hold down the binding used to open it. Select a trade skill by moving your mouse — moving the cursor in the general direction of the icon will suffice; you do not have to hit the icon itself. The color of the inner ring and pointer changes to reflect your selection. When you release the binding, the selected skill will be used.

You can close an OPie ring without performing any actions by right-clicking, pressing Escape, or by releasing the binding while the mouse cursor is in the middle of the ring.

Other rings you can experiment with include the Quest Items ring (ALT-Q), the Raid Markers ring (ALT-R), the World Markers ring (ALT-Y), the Minimap Tracking ring (ALT-F), and, for some classes, class-specific ability rings (generally Mouse Button 4 and Mouse Button 5).

Binding rings

Most of the rings built into OPie specify default bindings, which will only be used if they do not conflict with any existing bindings in your UI. Ring bindings that you explicitly set will be always be used.

You can change or disable the binding used for any OPie ring from the Ring Bindings configuration panel, which you can open by typing /opie bind. If the panel does not show upon using the slash command, OPie was not installed correctly.

To change a ring binding, left-click its binding button and then press the new key binding; to remove a binding, right-click on a binding button. You cannot bind OPie rings to the Left and Right mouse buttons, and it is best to avoid the Middle Mouse Button as well.

Creating your own rings

You can choose which actions appear in OPie rings: you can modify or delete the rings included by default, or create entirely new rings to fit your play style. Type /opie rings to open the Custom Rings configuration panel. From there, either select an existing ring using the dropdown menu, or click "New Ring..." to create an entirely new ring.

The list of actions ("slices") appears to the left of the ring details view. You can click on an action in this list to view and edit details concerning the slice, or drag the icon away from the vertical list to remove the slice from the ring. Add new slices by clicking the smaller plus button at the bottom of the slice list, and browsing to find the desired actions.

OPie rings can contain many different types of slices: abilities, items, mounts, battle pets, macros, custom OPie macros (longer and more awesome than those created using /macro), raid and world markers, DataBroker launchers, and a few more, including the extra action button.

You can add as many slices to a ring as you wish. If you intend to use the ring in combat, it is best not to include more than 8 slices: quickly selecting a specific slice in a larger ring is difficult.

You can use the "Use first slice when opened" checkbox to have the ring activate the first slice immediately when it is opened, instead of displaying it as a regular slice. This allows you to, for example, target or focus the unit the mouse cursor is hovering over when you open the ring, and have other slices perform actions at that target.

Sharing rings

You can share your custom rings with other players. Click the "Share ring" button to generate a snapshot of the ring, which could look something like this:

Given a ring snapshot, the other player can recreate the ring by clicking the "New Ring..." button within the Custom Rings panel, selecting "Import Snapshot", and pasting the snapshot text into the appropriate edit box.

Customizing OPie options

You can customize OPie's appearance and behavior through its options panel, opened by the /opie command. There are a number of behavior options of particular interest:

Center rings at mouse

By default, OPie rings are positioned relative to the center of the screen. If this option is enabled, rings are positioned relative to the mouse pointer when the ring is opened.

Activate on left click

By default, OPie will perform an action and close the ring when you release the ring binding. If this option is enabled, nothing happens when you release the binding: the ring remains open until you select a slice by clicking the left mouse button.

See the Options reference for more details.

Advanced Features

OPie has a large number of options that allow further customization, but are not required to use the addon. This section describes some of the more interesting advanced features.

Custom macros

Macros used through OPie can make use of several advanced features not available to regular macros, and are preprocessed to make it easier for them to adapt to the abilities your character knows.

See the Extended macros guide for more details.

Profiles

Profiles allow you to save OPie options and ring bindings, but not custom rings or their contents. OPie will automatically activate the last profile used by your character's specialization group when you log in or switch active specs.

To create a new profile, open the OPie options panel (/opie) and select the "Create a new profile" option within the "Profile:" dropdown. To switch to a different profile, select the desired profile within the same dropdown.

Per-ring customization of options

You can customize many of OPie's options on a per-ring basis, which can for example be used to enable per-slice bindings for only some rings. Select the desired ring from the right-most dropdown on the OPie options panel to change options for only that ring.

A similar dropdown appears in the bindings panel, allowing you to switch between customizing ring bindings, per-slice bindings (defaults or per-ring per-slice bindings), and other miscellaneous bindings.

Nested rings

You can add OPie rings as slices in other OPie rings. Depending on what is selected in the "Display as:" dropdown, this can achieve several effects:

Display as a nested ring

When you select this option, a single slice of the nested ring will appear within the outer ring; if you select that slice, that action will be performed. When you position the mouse cursor to selected a nested ring slice, the nested ring appears as a smaller sub-ring. You can rotate which slice of this ring appears within the main ring by scrolling the mouse wheel. While a nested ring slice is selected, you can click the middle mouse button to open the nested sub-ring. You may opt to have the sub-ring remember its rotation, reset it after use, or randomize it.

Display a jump slice

A single slice will appear within the outer ring; if you select that slice, the sub-ring will open.

Embed slices in this ring

All slices from the nested ring will appear within the outer ring, allowing them to be selected directly.

You can customize the buttons used to scroll through and open nested rings through the OPie Bindings panel: select "Other Bindings" from the right-most dropdown box.

Conditional bindings

OPie allows you to dynamically change ring bindings depending on the state of Macro conditionals (and extended macro conditionals). Alt-click on a ring binding button to enter a conditional binding. Some examples:

[form:1] BUTTON4

Binds the ring to Mouse Button 4 only when you're in the first stance/form (Bear Form for druids).

[harm] BUTTON4; BUTTON5

Binds the ring to Mouse Button 4 if your target is hostile, and to Mouse Button 5 otherwise.

[@focus,exists,nodead] ALT-H

Binds the ring to ALT-H if your focus target is alive.

[nocombat,outdoor,flyable] 1

Binds the ring to the "1" key if you're currently out-of-combat in an outdoor area where you can fly.

[mod:alt] OPEN; [mod:ctrl] CLOSE; [mod:shift] SEMICOLON

Binds the ring to the "[", "]", and ";" keys when you hold down alt, ctrl, or shift respectively.

Conditional slice visibility

You can control whether particular slices will be shown in custom rings depending on the state of Macro conditionals (and extended macro conditionals), evaluated each time you open the ring. Specify a conditional using the "Visibility conditional" edit box on the slice detail view of the Custom Rings panel; if your conditional evaluates to hide, or if none of its clauses apply, the slice will be hidden. Some examples:

[nocombat][mod]

The slice is shown while you're out of combat, or if you're holding a modifier key (alt, control, or shift), while opening the ring.

[combat,@target,noexists] hide; show

The slice is hidden if you're in combat and do not have a target, and is shown otherwise.

[group]

The slice is shown when you're in any type of party/raid/instance group.

[raid]

The slice is shown when your target is in your group.

When evaluating the [mod] family of macro conditionals, any modifiers that are part of the binding are ignored.