AMP Lab

Baldur's Gate 3 party, build, and inventory analysis tool focused on real save data, physical item ownership, canonical game/mod facts, mechanic interactions, DRS, and fail-closed recommendations.

Current development checkpoint

AMP Lab v8.0.0 — CP09 Canonical Product Preview

Status: Development Preview — not yet the final product-complete release

The current build has moved away from the old multi-tab scoring/benchmark design. The product now centers on one canonical pipeline and three primary player-facing surfaces: Dashboard, Party Forge, and Item Hunt, with About and Verification as secondary views.

Latest audited build metadata:

• File: AMP_Lab.exe
• SHA-256: 13c0ae4cf17cc685919f1bea40f502538a8220f20c710466b18c1b59afe90469
• Size: 42,660,401 bytes
• Embedded source commit: 1a69979065746b90dcfe5db2268966c5c0278e49
• Product context schema: amp.cp09.canonical-product-context.v2

Windows binaries are distributed through GitHub Releases. See CP09 Canonical Product Preview release notes for the current audited build status and known limitations.

Product architecture

AMP Lab now follows one shared authority chain:

SAVE + PHYSICAL INVENTORY + RULESET
                ↓
CANONICAL ITEM / SPELL / CLASS / FEATURE FACTS
                ↓
BUILD REALITY
                ↓
COMBAT EXECUTION / DRS
                ↓
SHARED EVALUATOR
                ↓
COUNTERFACTUAL
                ↓
FRONTIER / CERTIFIED REPRESENTATIVE
                ↓
CanonicalProductContext
                ↓
Dashboard / Party Forge / Item Hunt

NO NEW SCORING · FAIL CLOSED

Legacy data/code may still provide parsing, identity mappings, names, icons, tooltips, raw facts, and diagnostic candidate discovery. It is not allowed to become final recommendation authority.

Current product surfaces

Dashboard

• Party summary and important findings.
• Arsenal for useful alternatives, low-value / no-current-use equipment, and unresolved inventory identities.
• Archetypes discovered from owned-item mechanics and action-loop relations.
• Consider Playing... candidate directions when the canonical mechanic evidence supports a playable path.

Party Forge

• Four-character BG3-style party presentation.
• Physical item allocation with unique UUID ownership preserved.
• Main Hand / Off Hand / Ranged Weapon plus armor/accessory slots.
• Canonical representative equipment state.
• Exact legal/contextual spell connections where supported.
• Build-matched Shard evidence.
• Level-aware and selectable-choice surfaces remain fail-closed where their required authority is incomplete.

Item Hunt

• Removes already-owned item identities from the canonical item universe.
• Finds mechanic-relevant missing items.
• Supports virtual ADD_ITEM / counterfactual analysis.
• Groups AMP hunt targets by Void Capsule source where verified.
• Planar Coin / Void Capsule membership is a random reward-pool relationship, not a guaranteed drop.

About

Human-readable explanation of the canonical pipeline, DRS, evidence states, Party Forge, Archetypes, Item Hunt, and ruleset separation.

Verification

Exposes ruleset/source profile, canonical fingerprints, provenance, limitations, and the reason a result is PROVEN, PARTIAL, or UNRESOLVED.

DRS — Deterministic Resolution Semantics

AMP Lab follows causal mechanic chains instead of treating matching keywords as automatic synergy.

Example:

Attack
  ↓
State applied
  ↓
Trigger enabled
  ↓
Damage / effect rider
  ↓
Secondary response

Unsupported links remain unresolved instead of becoming hidden bonus value.

Ruleset separation

Vanilla and D&D 5.5e & Beyond remain explicit, separate semantic universes.

• Vanilla does not consume D&D2024 / pycy semantic modifications.
• D&D2024 / compatibility-patch semantics are 5.5e-only.
• Void Capsules are base AMP content and may exist in both Vanilla and 5.5e.

Current known product gaps

The current CP09 preview is intentionally honest about incomplete authority. The following are still product-completion work rather than finished recommendation systems:

• Equipment legality authority still needs a canonical proficiency / exact slot-hand projection for fully actionable Item Hunt placement.
• Item Hunt actionability must support proven dominance / PROVEN BETTER without requiring a fake scalar percentage.
• Choice / Progression Authority for Feats, ASI, Metamagic, Invocations, Maneuvers, Fighting Styles, Expertise, and similar selectable choices is not yet complete.
• Canonical Respec is not yet a full rebuilt-Build-Reality → reallocation → evaluator → counterfactual consumer.
• Shard recommendations remain compatibility/build-match evidence unless the Shard's effect semantics are evaluator-bound.
• Exact multiclass splits use source evidence where available and must remain manually confirmed when the save cannot prove the split.
• A certified representative is not automatically a proven unique best party state.

See the in-app Verification surface for exact limitations in a loaded save.

Public-test / development safety

• AMP Lab is read-only with respect to BG3 saves.
• Physical item UUIDs are preserved; one physical item cannot be assigned to multiple characters at once.
• Missing canonical evidence fails closed rather than falling back to a hidden score.
• Vanilla and 5.5e semantic data are kept separate.
• Technical provenance belongs in Verification rather than the normal player-facing UI.

Reporting feedback

When reporting an issue, please include:

1. The selected / detected ruleset.
2. The character/build involved.
3. The Dashboard, Party Forge, or Item Hunt surface involved.
4. A screenshot of the result or error.
5. What you expected to happen.
6. Any evidence label shown (PROVEN, PARTIAL, UNRESOLVED).

Especially useful reports include incorrect item/mechanic interpretations, wrong receiver/slot legality, unreasonable archetypes, missing icons/tooltips, spell/choice/Shard recommendation issues, Void Capsule mapping problems, crashes, and confusing evidence states.

Release model

Development/public-test and stable Windows binaries are distributed through GitHub Releases. The repository tracks release metadata, checksums, documentation, and recovery/validation tooling. Large third-party source inputs, saves, runtime snapshots, and mod packages are not committed.

Free project & supporting the creators

AMP Lab is free to download and use, and it is intended to remain free.

AMP Lab does not ask for or accept donations. If you would like to financially support the ecosystem that makes this project possible, please donate only to the original mod and community-resource creators through official support links they choose to provide.

Credits & Acknowledgements

AMP Lab is an independent community project and is not an official project of the mod creators or community resources it supports.

Special thanks and full credit to:

• Paramonov / Paramonov95 — Ancient Mega Pack (AMP)
• Paramonov — Ancient Mega Pack Plus (AMP+)
• Paramonov — Ancient Mega Pack + DnD 5.5e BEYOND compatibility patch
• Yoonmoonsik — DnD 5.5e All-in-One BEYOND
• Tazliel — AMPIS item database / reference resource

AMP Lab does not claim ownership of their mods, assets, databases, data, item designs, or ruleset implementations. See CREDITS.md for full attribution and links to the original projects.

Security

Never commit .env files, API keys, local save data, runtime snapshots, machine-specific configuration, or private paths.