Skip to content
kazourPublic

About

Buff/debuff Flash overlay editor for Age of Conan and more..

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

KazBars

CI Latest release License: GPL-2.0-or-later

Buff/debuff overlay editor for Age of Conan — design icon grids and bars that show your active effects on top of the game, then compile and install them in one click. It also ships live combat HUDs and a handful of in-game extras: a cast timer, a stopwatch, Inspect Target (your target's combat sheet), a buff-ID and cast console, an Onslaught tracker, leaner damage numbers, a real-time deeps meter, and the Ethram-Fal seed timer.

Most of what KazBars builds is set up once and runs on its own after you close the app. Only the two live combat overlays — the deeps meter and the Ethram-Fal seed timer — keep working while KazBars is open.

Upgrading from Kaz Grids? Install over it — no uninstall needed. Your settings and game folder carry over automatically.

Features

KazBars — custom icon overlays arranged in bars or grids that show only the buffs and debuffs you choose to track.

  • Player and Target grids — track effects on you and your current target, at a spot on screen
  • Overhead grids — Friendly and Hostile: icons float over characters' heads, as a fixed box or a band centred over the head
  • Dynamic or Static slots — auto-fill as buffs activate, or pin specific buffs to specific slots
  • Per-class grids — class tabs give each of the twelve classes its own grids, on top of the ones every class gets
  • Timers — digits or a shrinking bar on each icon; Applied by me shows only effects you cast yourself
  • One size, one font — pick an Overlay size and font for everything KazBars draws in game; each grid and panel scales as a percent of it
  • Buff database — map numeric buff IDs to readable names and classify them as Buff, Debuff, or Misc

Cast Timer — an on-screen readout of your and your target's current cast time, ready to sit over the game's cast bars. Off by default

Stopwatch — a draggable Start / Pause / Reset count-up timer that works in fullscreen and never steals focus from the game. Off by default

Inspect Target — an in-game combat sheet for whatever you have targeted. Pick its rows from 112 stats in seven groups (armor, protections, crit, critigation, heal rating, bonus spell damage and more), or keep the default twelve. Player targets add a PvP tab; clear your target and it hides. Off by default

Console — an in-game log of every buff and debuff on you and your target with its buff ID, plus a Casts tab for how casts ended: finished, interrupted or lost. Off by default

Onslaught Tracker — for Skull Gate and Kuthchemes: a board of bosses, skulls, guards and minis with their health, the wave timer, Hylda's health, spawn alerts and AoE warnings. Watches the mobs it knows, plus names you add. Off by default

Damage Numbers — a leaner, faster rewrite of the game's floating combat numbers, with new layout and behavior settings and a choice of typeface. It replaces one stock game file; if the game ever patches, rebuild once to put it back. Off by default

Deeps by Veni — a real-time meter that reads your combat log for DPS out, DPS in, HPS out, HPS in, and ΔHP in.

Ethram-Fal Seed Timer — tracks the Viscous Seed / Lotus Fixation / Syphon cycle so the raid can time scorpion kills.

Utility tools

Default Buff Bars editor — tune the game's own buff-bar HUD from one place: on/off, icon size, spacing, columns, friendly/hostile filter — no XML editing.

Damage number colors — recolor every damage source and pick where each one lands: above the head, in a fixed column, or in the zig-zag stack.

Backup & restore — save your full Age of Conan config plus your KazBars profile and settings to one portable zip, and restore it after a reformat or on a new PC.

Install

  1. Download KazBars.zip from the latest release and extract it anywhere. Upgrading from 3.0.1 or earlier? Extract it over your existing KazBars folder instead — your profile and settings survive. That's the last manual update: from then on KazBars offers new versions itself, one click to download and one to restart.

  2. Run KazBars.exe as Administrator.

  3. The first-run setup window opens. Point it at your Age of Conan folder.

  4. Check Game resolution, then pick how to start: Use Defaults (ready-made grids for common raid buffs and debuffs, sized to your screen), Import Profile (a profile file you or a friend saved), or Start Empty (build your own from scratch).

  5. Click Build & Install. Close the game and the patcher for your first build — it registers KazBars with the game permanently. After that, rebuild anytime and type /reloadui in-game.

  6. Launch the game from its own executable — KazBars offers to create a desktop shortcut (DX10 or DX9) after the first build. Launching this way skips the patcher, which is what keeps your setup registered.

Positioning happens in-game: press Shift+Ctrl+Alt for preview mode and drag grids and panels where you want them. The game remembers positions, collapse states, and the control panel's switches across relogs and full restarts — like any other game window. Overhead grids follow their characters instead; preview shows a sample over your target.

If the game ever patches (it hasn't in years), run the official patcher once, then Game ▸ Repair game install — KazBars re-registers itself and restores your saved positions.

Once you know the flow, make it yours: + Add Grid for your own layouts, then click a grid's preview to pick what it watches (on a static grid, click a slot). A grid holds up to 64 slots (16 for an overhead grid), with no cap across grids. Overhead grids sit against each head by an anchor that depends on your game's field of view — if they look off, nudge Right and Up in Game ▸ Game resolution… and rebuild.

Sharing a layout: File ▸ Export profile… writes one .kazbars.yml file, with any custom buffs it references baked in — the recipient doesn't need those buffs in their own database first. File ▸ Import profile… reads one back, along with .kazbars.json exports from 3.1. To share just some grids, use Export grid… (a grid card's Move… menu), and File ▸ Import grid… to add a grids file to the Grids tab.

KazBars keeps one profile, userdata/profile.yml, and autosaves it. Reset profile to defaults… puts the starter layout back; Revert to session start undoes it, or an import. Updating from 3.1? KazBars takes the profile you were using; your others stay in userdata/profiles, and File ▸ Import profile… opens any of them.

SmartScreen warning: Windows may flag the .exe as unrecognized on first launch. Click More info → Run anyway. Updates KazBars installs on its own don't trigger it. KazBars is unsigned because code signing certificates aren't justified for a hobby project.

Community

Questions, bug reports, and release news live on Discord. Join the Discord.

Requirements

  • Windows 10 or 11
  • Age of Conan installed
  • No Python install needed — ships as a standalone executable

KazBars does not read game memory or inject anything into the game process. Installing writes to the game's UI folder and registers KazBars in two clearly marked blocks in the game's own config files, with pristine .bak backups beside them. It also drops IgnorePatcher.enable — Funcom's own engine flag, whose filename ships inside the game client itself — so launching the game executable directly skips the patcher. This is the same persistence path the community's Aoc.exe launcher has provided for some fifteen years, done less invasively: no registry hooks, no process interception, and everything KazBars adds to the game folder is inspectable. Uninstall restores every changed file byte-for-byte.

Building from source

Developer setup. End users should download a release.

# 1. Clone
git clone https://github.com/kazour/Kazbars.git
cd Kazbars

# 2. Install + enable git hooks (uv recommended; pip works too)
uv sync --extra dev --extra build
# or:  pip install -e ".[dev,build]"
uv run pre-commit install   # one-time per clone (pip users: drop "uv run"); runs ruff lint + pytest on every commit

# 3. Run from source
uv run python -m kazbars

# 4. Tests
uv run pytest

# 5. Lint  (formatting is intentionally not enforced — see .pre-commit-config.yaml)
uv run ruff check src tests

# 6. Build a distributable .exe
uv run pyinstaller kazbars.spec
# Output: dist/KazBars/KazBars.exe + bundled assets

The PyInstaller build is reproducible from the checked-in kazbars.spec and the committed uv.lock (CI installs with uv sync --locked). CI builds the same artifact on every tagged release via .github/workflows/release.yml.

Documentation

See docs/README.md for the full doc map — every doc with its audience and when to update it (changelog, architecture, flows, database changelog, inspect panel stat reference).

The project follows a src/ layout — entry point is python -m kazbars, which loads KazBarsApp from src/kazbars/app.py.

Releasing

Releases are cut by hand with scripts/cut_release.py. It reads [Unreleased] in docs/CHANGELOG.md, picks the bump (### Added present means minor, otherwise patch; --version overrides it and is the only way to a major), dates the changelog section, bumps __version__ in src/kazbars/__init__.py, and writes the What's New block into .github/release-notes.md. --dry-run prints the plan and writes nothing.

Review the What's New block, then commit, tag and push. release.yml builds and publishes KazBars.zip + SHA256 checksum from the tag:

python scripts/cut_release.py --version X.Y.Z
# review the What's New block in .github/release-notes.md, then:
git commit -am "Release vX.Y.Z"
git tag -a vX.Y.Z -m "KazBars vX.Y.Z"
git push origin main
git push origin vX.Y.Z

release-train.yml stays in the repo and runs only when dispatched manually. It applies the same gates: code changed since the last tag (under src/ or kazbars.spec), entries under [Unreleased], and the repository variable RELEASE_HOLD empty. While RELEASE_HOLD is set, it exits without releasing.

License

GPL-2.0-or-later — see LICENSE. Some bundled parts keep their own terms: as2c (a port of MTASC), Funcom's game files, and the Deeps parsers. See THIRD_PARTY.md for the full list.

About

Buff/debuff Flash overlay editor for Age of Conan and more..

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages