English | Deutsch | Русский | Português (Brasil) | Español | Français | Polski

EbonBuilds is a World of Warcraft 3.3.5a client addon for players on ProjectEbonhold private servers. You define a build — echo weights, policies, and autopilot intent — and EbonBuilds scores every echo choice screen (Banish / Reroll / Freeze / Select) on your behalf, records what happened, and turns real run data into reviewable tuning suggestions.

Built for ProjectEbonhold raiders and echo grinders who want consistent automation without giving up control: every action is logged, recommendations require your approval, and Manual Training Mode lets the addon learn from deliberate picks.

Quick install

1. Download EbonBuilds.zip from the latest release.

2. Extract the archive. The folder must be named EbonBuilds (matching EbonBuilds.toc).

3. Copy it to the Project Ebonhold add-ons folder:

   %LocalAppData%\ebonhold\Interface\AddOns\

   On Windows that is typically C:\Users\<you>\AppData\Local\ebonhold\Interface\AddOns\. Do not install into a Blizzard retail _retail_\Interface\AddOns tree — that is a different client and EbonBuilds will not load there.

4. Restart the game or run /reload.

Server requirement: ProjectEbonhold ships its own server addon. Install ProjectEbonhold or ProjectEbonhold Enhanced on the client as provided by your server — EbonBuilds depends on it for echo boards, affix data, and several integration features. Without it, EbonBuilds will not function.

Optional: Details! enables DPS-based weight suggestions and richer stats. Combat DPS logging in the Logbook (v3.84+) works without Details! when enabled under Settings. Auctionator (vendored 2.6.3 for 3.3.5a) adds affix shopping, AH search shortcuts, and buyout price hints when installed alongside EbonBuilds. Details!: Tiny Threat (PE) (Details_TinyThreat.zip when released) is an optional Details! threat plugin for WotLK 3.3.5a — install to %LocalAppData%\ebonhold\Interface\AddOns\Details_TinyThreat alongside Details!; see the doc for folder rename notes when extracting from Details_TinyThreat (2).zip.

Open the addon with /ebb or /ebonbuilds.

Features

Area	What you get
Autopilot	Intent presets (Save charges / Balanced / Chase upgrades), per-echo scoring, run-persistent freeze tracking, and a decision-first Logbook with reasoning and charge usage.
Builds	Per-echo weights (including per-quality ranks), locked/banned slots, character snapshots (talents, glyphs, gear), Tuning Advisor, Manual Training Mode, EchoWishlist (EWL1) export, and plain-text Export (AI) dumps.
Public Builds	Browse community builds, inspect priorities and snapshots, vote, import, and (when the server supports it) save or apply server loadouts.
Affixes	Affix reference panel, bag affix dots (default bags, Bagnon, Combuctor), gear modeling in the Character tab, and optional Auctionator AH search / price hints.
DPS & stats	Optional combat DPS samples attached to runs and shown in the Logbook; Details!-backed DPS tracking and appearance-rate sync when installed and consented. Stats workspace with Summary, Actions, Echoes, and evidence-backed Recommendations.
Locales	Build editor UI in German, Spanish, French, Polish, Brazilian Portuguese, and Russian — auto-detected from the client or overridden via Settings.

Other notable tools: Tome Atlas (community drop locations), Missing Echoes (weighted echoes you have not learned yet), whole-run budget pacing, and optional auto-sell while vendoring.

Screenshots

Build editor — priorities	Build overview & Autopilot

Logbook	Stats — recommendations

More screenshots and a full UI tour live in assets/screenshots/ and on the documentation site.

Documentation & support

Resource	Link
Documentation (Getting Started, Settings, FAQ)	lzra2000.github.io/ProjectEbonHoldBuildAutomation
FAQ	FAQ
Releases & changelog	Releases · CHANGELOG.md
Bug reports & feature requests	Issues
Security	SECURITY.md

When reporting bugs, attach output from Settings → Windows & tools → Error log or Debug log — it is the fastest path to a fix.

Development

Contributions are welcome. See CONTRIBUTING.md for setup, conventions, and the pre-PR checklist.

For local checks, CI parity, and debugging failing Actions runs, see docs/dev-testing.md. Quick entry points:

sh scripts/dev-setup.sh    # one-time toolchain (Debian/Ubuntu; use WSL on Windows)
sh scripts/check.sh        # fast local loop (syntax, tests, .toc, 3.3.5a API lint)
sh scripts/check.sh --full # full suite CI runs before merge
sh scripts/build-dist.sh   # produces dist/EbonBuilds.zip

The repository root is the addon folder (EbonBuilds.toc, core/, modules/ at the top level). Release tags trigger .github/workflows/release.yml, which publishes EbonBuilds.zip on GitHub Releases.

media/minimap_icon.tga, media/vote_icon.tga, media/vote_icon_off.tga, and media/affix_pip.tga have real sources: python3 scripts/generate-media.py (requires Pillow) regenerates them from code — the minimap icon from the same ring geometry as docs/img/logo.svg, the vote chevrons and affix pip from simple vector shapes — so no texture is a hand-edited binary with no way back to its design.

License

See LICENSE. Personal and private-server community use is permitted for unmodified official releases. Redistributing modified versions under the EbonBuilds name, or commercial use, requires prior permission from the copyright holder. Contributions are inbound = outbound under those same terms (see CONTRIBUTING.md). Vendored third-party AddOns under vendor/ keep their original licenses.