OCX Tools

OCX Lua Tools

Commands

• "/ocx <window>" opens a window (see the About tab for the list); "left-control, left-shift, f12" shows/hides the OCX icon, which opens the settings window

Changelog

3.0.5 - 25 Oct 2026

• Fixed: the Timers, Tracking, Combat and Settings windows would not open ("style justifyContent: expected ...") because of an invalid tab-row style value.

3.0.4 - 18 Oct 2026

• New: a Pin button (a pin icon in the top-right corner of each window except XP and DPS). A pinned window stays open when you press Esc; its X button still closes it. Which windows are pinned is remembered between sessions.
• Internal: the small icons now come from a single sprite sheet, which keeps the package under the store's picture limit.

3.0.3 - 9 Oct 2026

• Fixed: Reset icon position put the OCX icon off screen or too low on large or windowed displays (the game positions HUD frames in its own units, not pixels). The icon is now placed using the measured unit size.
• Fixed: Daily gold did not start counting until the Daily tab was first opened. The starting gold is now taken as soon as the game reports it.

3.0.2 - 4 Oct 2026

• New: the Japanese client's combat log is understood, so the DPS, Attacks, Details and Kills windows and the heal totals work there too (loot, harvest and the other trackers are still English only). Thanks to Chromenf for the parser and for tracking down the MoonSharp quirk that breaks Lua patterns on Japanese text.

3.0.1 - 3 Oct 2026

• Fixed: on a fresh install the saves failed ("could not open ... for writing") because they went into a folder the game never creates. They are now saved directly in the Lua folder as ocx-*.dat; saves from 3.0.0 are copied over automatically.
• New: Settings has a "Reset icon position" button that puts the OCX icon back at the right edge of the screen (for when a resolution change leaves it stranded).

3.0.0 - 3 Oct 2026

Every window has been rebuilt on the game's newer UI (real tables, dropdowns, sliders, progress bars) and the old windows are gone. Needs a client with Lua API 12 or newer. Your saved harvest, kills, loot, daily, farming and XP data carry over. It now installs as a package folder: put it in Lua/ocx-tools/ and delete the old Lua/ocx-tools.lua (and the old Lua/ocx/images and Lua/ocx/require folders).

• New: click the OCX icon (middle of the right edge of the screen, drag it anywhere) to open Settings and the list of windows. Left-ctrl + left-shift + F12 shows/hides the icon. Windows open with "/ocx <name>" (timers, tracking, xp, dps, combat, settings) or a key you bind in the add-on manager, and the windows that were open come back when you log in.
• Timers: three timers with a slider for the length, a cooldown sweep over the icon, a message when one finishes (even with the window closed), and a "Mini" button that turns a timer into a small icon-and-time window.
• Tracking window (tabs): Harvest, Kills (sortable, with a filter), Farming (dropdowns), Loot (pick a list from a dropdown), Daily and Crafting (exceptional / normal / failed counts and shares, now kept between sessions; replaces !craftstats).
• Daily gold is now read straight from the game (gold now minus the gold you had when the day began), so vendor sales and anything else that never showed up in the loot log are counted, and spending shows as a negative. A day already in progress is carried over automatically.
• XP and DPS are small windows (the title bar appears when you hover). XP has a Level button that shows your progress to the next level; DPS bars are real progress bars relative to the top attacker.
• Combat window (tabs): Attacks (your damage and healing totals), Details (damage given and taken by attack type, for you or anyone else) and Resist.
• Settings window: the friend-online popup on/off and filter, and the lists of friends, chat keywords and loot patterns (these used to be chat commands: !onlinemode, !addfriend, !addkeyword, !addloot, ... are gone). The popups are now movable. An About tab lists the window commands.
• Removed: the toolbar, the health/focus (FSH) window, the S/M/L scale settings, "!ocxhelp", "!tools", "!dpsrealtime" and the old Ctrl+Shift window hotkeys (except F12). "!craftstats" and "!resetcraftstats" are replaced by the Crafting tab.

2.2.0 - 14 Jul 2026

• New window: Farming Calculator (ctrl-shift-G, or the "Farm Calc" button on the toolbar) — pick a seed speed and where you planted it, press Start, and it tells you when your 3rd and 4th watering windows open and close, and when the crop can be harvested. It remembers what you planted across a relog; press "R" to clear it and track something else.
• The toolbar is now two rows of buttons instead of one long row

Known Issues

• When playing in a party, the loot tracker isn't accurate for items that you must roll for. The logs only show that you won, but they don't say how many you won (for example, you might receive some corpse wax. All the logs show is that you won corpse wax. It might be 1, 2, 3, etc. I have no way of knowing).
• If you play across the day boundary, it doesn't reset the daily loot. You must log out and back in.
• If you exit to menu and come back as a different player, it doesn't pick up the new player's name and continues tracking stats as the old player. You must log out and back in.
• Sometimes after harvesting, no logs with show up, and thus the items don't get tracked. The only fix i've found is to relog.

Previous Changelogs

2.1.0 - 6 Jul 2026

Community features contributed by that_shawn_guy (adopted from his v2.1.0 fork), plus fixes and a new desktop test harness. Type !ocxhelp in the lua console to see every command.

• "Who's online" popup can now be filtered: !onlinemode all|whitelist|blacklist, managed with !addfriend / !removefriend / !blockfriend / !unblockfriend / !listfriends
• Keyword chat alerts: !addkeyword <word> pops an alert when that word appears in chat (!removekeyword, !listkeywords)
• Wildcard loot tracking: !addloot *Fragment auto-tracks any item matching the pattern (!removeloot, !listloot)
• Crafting stats: !craftstats shows total / normal / exceptional / failure counts (!resetcraftstats)
• DPS realtime mode: !dpsrealtime updates the DPS window every second instead of every few seconds
• bug fix: the xp timer no longer jumps back to ~59:00 when you pass the 1-hour mark
• bug fix: picking up over 1,000 gold in a single loot is now counted correctly (the comma no longer breaks it)
• more robust log handling: a single unparseable log line can no longer wedge or crash the message queue
• (dev) added a desktop test harness so the addon can be run and unit-tested outside the game

2.0.3 - 23 Apr 2022

• New window: FSH - show health/focus bars (ALT-SHIFT-F)

2.0.1 - 3 Dec 2021

• Complete rewrite, using new UI components

1.4.1 - 26 Oct 2021

• toggle between 1hr xp / total xp since reset on xp window
• you can now add negative gold (for purchases). ex: !addgold -1800
• bug fix: picking up over 1,000 gold would only add 1 (ignored after the comma)

1.4.0 - 29 Jul 2021

• added attenuation icon to the xp window
• fix the mac ui (now behaves the same as the windows ui)

1.3.9 - 1 Jul 2021

• added !level command to show how much xp to the next level
• added popup to show when friends come online
• added wood stats to the harvest window
• added timer since last reset on hourly xp window
• hourly xp no longer affected if skills are training

1.3.8 - 20 Mar 2021

• bug fix: xp window opened via toolbar caused error
• bug fix: unable to reset harvest via reset button
• bug fix: harvest window didn't stay closed if closed via toolbar
• better error handling when loading kills window
• bug fix: allow ctrl-shift-[ and ctrl-shift-] movement on stats detail if opened via toolbar

1.3.7 - 2 Mar 2021

• New Window: Kills (ctrl-shift-K)

1.3.6 - 26 Jan 2021

• Harvest window fix for tin/nickel percentages

1.3.5 - 10 Jan 2021

• Fix for over 1.000 gold for those who use periods instead of commas as numeric dividers
• New window: Harvest (ctrl-shift-H)

1.3.3 - 8 Aug 2020

• Fix for the magic resist stats
• Fix where sometimes adding a comma to a number resulted in a null exception
• Fix for xp calculation sometimes causing an exception
• Fix if over 1,000 gold was picked up in a single loot it wouldn't properly count the value in your daily gold stats

1.3.2 - 18 Apr 2020

• DPS - now with PETS!
• Healing stats on the attack stats window
• enlarge text area for daily stats
• bugfix for 30m DPS not working

1.3.1 - 8 Apr 2020

• OCX Tools support for Mac (the operating system, not the player) :)
• X xp
• timer (no mac support at this time)
• M resist
• L loot (with '[' and ']' for prev/next tab)
• P dps
• D daily
• S attack stats
• T attack details (with '[' and ']' for prev/next attacker)
• A about

1.3.0 - 28 Mar 2020

• ui cleanup
• bug fixes for loot and daily windows

1.2.9 - 15 Mar 2020

• Rework the loot window
• multiple tabs
• time since last reset
• 2x scaling support for those running crazy high resolutions!
• add adventure and producer xp to daily stats
• headless mode

1.2.8 - 8 Feb 2020

• performance improvements
• rework the ui on attack details to show everything in aligned columns
• new command: !resetdaily (reset daily counts; same as the "R" button on the window)
• new command: !resetxp (reset the xp tracker; same as the "R" button on the window)
• added an about window

1.2.7 - 26 Jan 2020

• increase text size of xp window (12 to 14)
• enhance damage detail window stats to further break up crit vs non crit damage
• allow timers to be shown/hidden individually
• can now manually reset daily counts
• ensure windows aren't offscreen
• on xp, rather than show % of attenuation (which is going away), show how much xp gained in the last hour
• bug fix with the loot windown when in party mode

1.2.6 - 15 Jan 2020

• enhanced the DPS window to allow changing the sliding window time. you can now select 30 seconds, 5 minutes (the default), 30 minutes, or 1 hour
• new command, "!ocxhelp" will show the commands in the lua console
• removed a debug message which was cluttering the lua tab
• bug fix: some looted items (those with parenthesis, like supply bundles) would not work in the loot tracker
• increased the width of the loot window by 20px to show a few more characters on long loot names

1.2.5 - 12 Jan 2020

• You can now set the title of the timers, via the "!renametimer" command
• show toolbar by default (otherwise new users see nothing when first loading the script)
• change the images directory to be underneath "ocx". the old ocximages directory may be safely deleted
• bug fix: if your player name had two or more substates, it wouldn't find the name correctly and config files wouldn't load. ('Feldon[PVP][AFK]', for example)

1.2.4 - 4 Jan 2020

• added a stopwatch toggle to the timers so they can either count up or down
• bug fix: farmed items weren't being tracked by the loot window

1.2.3 - 30 Dec 2019

• replaced the virtues window (which is no longer supported by Catnip) with a set of timer windows

1.2.2 - 24 Dec 2019

• persist attenuation information between sessions
• use avatar name in persisted files so that multiple accounts on the same machine can play without clobbering each other
• NEW: installer zip!

1.2.1 - 18 Dec 2019

• fixed another issue with attack details so it's more performant
• added attenuation calculation (rev 1) to XP window - will show percent complete, and show attenuation icon if attenuated
• split standard deviation to crit vs non crit columns on attack details

1.2.0 - 15 Dec 2019

• added the toolbar
• enhanced the attack details window so it doesn't slow down the game while it's being displayed
• all windows can now be moved
• all windows retain position/visibility between sessions
• the only keystroke you need to remember is ctrl-shift-f12 to toggle the toolbar
• lua filenames have changed. remove all the old files, since there are some that no longer exist in the new version and they will conflict.

1.1.5 - 5 Dec 2019

• fixed a minor UI issue with the loot window when there were only none or very few items
• fixed a bug where the loot window's position wasn't saving correctly
• all windows can now be moved

1.1.4 - 4 Dec 2019

• moved extended stats windows off of the chararcter sheet and onto their own window. character sheet was reporting strange x/y values depending on screen resolution.
• moved all the data files into a subfolder called ocx. you will need to create this folder. lua can't do it for you without adding a heavy file io library!
• added the ability to move the loot window. to move, click the mouse button (not click and hold), move the window, and then click the mouse button again to stop moving.

1.1.0 - 3 Dec 2019

• fixed a divide by zero error on standard deviation if only 1 attack of a certain type has occurred
• fixed a loot bug when in party mode that was counting other's loot as your own
• display the current xp pools below the character sheet
• display the effective magic resist values to the right of the character sheet

1.0.9 - 30 Nov 2019

• on attacks which don't (shouldn't) crit (such as Rend and Poisoned Weapon), do not count them against your aggregate crit%
• show current virtue values (truth/lova/courage) when displaying your character sheet
• add in standard deviation on aggregate attack damage

1.0.7 / 1.0.8 - 29 Nov 2019

• truncate long values in the loot table & long 'poison' names in the attack stats
• can now cycle the aggregate stats window using the left/right arrows

1.0.6 - 28 Nov 2019

• enhanced the aggregate attack/damage stats window to perform much better
• added average damage per attack type on the attack/damage stats window
• added loot tracking. "left-shift, left-control, L" to toggle the ui (!ocx will also toggle this in case ctrl-shift-L isn't working for you)
• added the "!addloot [name]" command
• added the "!removeloot [name]" command
• added the "!resetloot [all|name]" command
• added the "!dmg" command in case ctrl-shift-f10 isn't working for you

1.0.5 - 26 Nov 2019

• added a new stats window showing aggregate attack/damage stats for current player. hotkey to toggle: ctrl-shift-f10

1.0.4 - 24 Nov 2019

• added the "!addgold [amount]" command
• added ctrl-shift-f11 to reset attack stats

1.0.3 - 24 Nov 2019

Normalize ShroudGetPlayerName() returning name[PVP] and name[AFK] or name, etc so that stats don't go away when you go into/out of PVP zones.

1.0.0 - 1.0.2

Initial release and alpha phase bug fixes