An addon that automates rolling for items for vanilla WoW.
Go to file
2025-08-22 00:57:11 +02:00
assets Refactor winners scrollFrame. Add option to set roll type 2025-04-08 04:27:04 +02:00
libs Initial commit 2025-03-30 23:09:58 +02:00
src Refactor keybindings. Add new MC bosses to boss list 2025-08-22 00:57:11 +02:00
.gitignore New options GUI 2025-04-10 04:28:01 +02:00
Bindings.xml Refactor keybindings. Add new MC bosses to boss list 2025-08-22 00:57:11 +02:00
main.lua Refactor keybindings. Add new MC bosses to boss list 2025-08-22 00:57:11 +02:00
README.md Update README.md 2025-04-10 05:05:15 +02:00
RollFor.toc Refactor keybindings. Add new MC bosses to boss list 2025-08-22 00:57:11 +02:00
TODO.md Initial commit 2025-03-30 23:09:58 +02:00

RollFor

A World of Warcraft (1.12.1 and 2.5.2) addon that manages rolling for items.

New in this fork

This version includes the following new features:

  • New option /rf config auto-class-announce Toggle replace normal roll message with classes for items that has class restrictions.
  • New option /rf config auto-tmog Toggle automatically disable tmog roll option on trash loot.
  • New option /rf config loot-frame-cursor Toggle loot frame being positioned at cursor location.
  • New popup to keep track of winners. Shift-click map icon or type /rfw to access.
    • Right click headers to customize filters
    • Click headers to sort the list
    • Right click roll type to change it.
  • Tracks raid trades
  • New options GUI. Ctrl-click map icon or type /rfo to access.
  • Show roll popup for all group/raid members who have the addon installed when loot master starts a roll.
    • Enable with /rf config client show-roll Eligible or Always
    • /rf config client to view additional client options

Demo

NEW

Classic Look

Enable: /rf config classic-look

See the classic-look in action: https://youtu.be/G37j5XXBKxs

Overview

In this example, the addon shows the soft-ressed items in the loot list.
The Master Looter raid-rolls the trash item, then rolls non-SR items.
Then the SR items are rolled.

overview

View better quality (fullscreen): https://youtu.be/f5nY-CxreIM

Tie roll

In this example, the addon automatically detects that the item is soft-reserved by two players.
It restricts rolling for the item to these players only and resolves any tie automatically.
The Master Looter then assigns the item directly to the winner.

soft-res rolling

Two top rolls win

In this example, two identical items drop. When clicked on any of these, the addon selects
both and performs a "two-top-rolls-win" roll. Then the Master Looter is presented with
individual award buttons for each winner.

two top rolls win

Features

Fully SR-integrated loot list

SR-integrated loot list

Automatically enables Master Loot when a boss is targeted

Disable this feature with:

/rf config auto-master-loot

Shows the loot that dropped (and who soft reserved)

Shows dropped loot

Makes Master Loot window pretty and safe

  • one window with players sorted by class
  • adds confirmation window
Pretty Master Loot window

Fully automated

  • Detects if someone rolls too many times and ignores extra rolls.
  • If multiple players roll the same number, it automatically shows it and waits for these players to re-roll.
Tie winners

Soft res integration

  • Integrates with https://raidres.fly.dev (1.12.1).
  • Integrates with https://softres.it (2.5.2) via Gargul Export.
  • Minimap icon shows soft res status and who did not soft res.
  • Fully automated (shows who soft ressed, only accepts rolls from players who SR).

And more

  • Supports "two top rolls win" rolling.
  • Supports raid rolls.
  • Supports offspec rolls (/roll 99).
  • Supports transmog rolls (/roll 98) (1.12.1).
  • Automatically resolves tied rolls.
  • Highly customizable - see /rf config and /rf config help.
Raid roll

See it in action

https://youtu.be/vZdafun0nYo

Usage

Roll item

/rf <item link>

Raid-roll item from your bags

/rr <item link>

Insta Raid-roll item from your bags

/irr <item link>

Roll for 2 items (two top rolls win)

/rf 2x<item link>

Ignore SR and allow everyone to roll

If the item is SRed, the addon will only watch rolls for players who SRed. However, if you want everyone to roll, even if the item is SRed, use /arf instead of /rf. "arf" stands for "All Roll For".


Soft-Res setup

  1. Create a Soft Res list at https://raidres.fly.dev (1.12.1) or https://softres.it (2.5.2).
  2. Ask raiders to add their items.
  3. When ready, lock the raid and click on RollFor export (raidres.fly.dev) or Gargul Export (softes.it) button.
Raidres export
  1. Click on Copy RollFor data to clipboard buton.
Raidres copy to clipboard
  1. Click on the minimap icon or type /sr.
  2. Paste the data into the window.
  3. Click Import!.
softres-import

The addon will tell you the status of SR import.
Hovering over the minimap icon will tell you who did not soft-res.

The minimap icon will be green if everyone in the group is soft-ressing.
The minimap icon will be orange if someone has not soft-ressed.
The minimap icon will be red if you have an outdated soft-res data.
The minimap icon will be white if there is no soft-res data.

To show the SR items type:

/srs

If someone needs to update their items, repeat the process and copy the data again.

Soft-Res data format

The SR data from Raidres is a Base64 encoded JSON. Decode it to see what's inside.


Fixing mistyped player names in SR setup

When using soft-res, the players sometimes mistype their nickname, e.g. Johnny in game will be Jonnhy in the raidres.fly.dev website.
The addon is smart enough to fix simple typos like that for you.
It will also deal with special characters in player names.
However, sometimes there's so many typos and the addon can't match the
player's name - you have to fix it manually.

/sro (stands for SR Override) is the command to do this.


Finish rolls early

/fr

Cancel rolls

/cr

Show soft-ressed items

/srs

Check soft-res status (to see if everyone is soft-ressing)

/src

Clear soft-res data

Click on the minimap icon and click Clear or type:

/sr init

Shoutouts

Thank you to:

  • Turtle WoW devs for amazing content. You cunts should switch to a better client.
  • Itamedruids for Raidres and adding the export function. Love your work.
  • My fellow raiders (there's too many to mention).
  • All bug reporters, testers and feature suggesters.

Need more help?

The best way to contact me is to message me on Discord.
Username: Obszczymucha

My character Jogobobek will no longer be available on Turtle WoW.
I'm switching to Netherwing 3.0, perhaps under a different name :P

Thanks Turtle for fun.