# Anvil

An independent Hellion Forge plugin for FINAL FANTASY XIV crafting.

Anvil is a privacy-focused, zero-telemetry crafting helper for Dalamud
(API level 15+). It provides a crafting simulator, a solver wrapper,
recipe bookmarks, and an opt-in Auto-Craft hook.

> Status: **v0.1.0 — early development.** The crafting simulator, solver
> wrapper, macro engine, hooks, IPC provider, bookmark store, and UI
> layers are being built module-by-module under the Anvil clean-room
> pipeline. The Recipe Data layer (module 01) is the first ground-up
> piece.

## Features (planned)

- Crafting Simulator — state machine for FFXIV crafting steps, conditions,
  buffs, and actions, with full Cosmic Exploration schema support.
- Solver Wrapper — bridge to the Raphael Rust solver (bundled binary).
- Recipe Note Overlay — anchors next to FFXIV's recipe-note addon.
- Synth Helper Overlay — live next-action hint during synthesis.
- Macro Editor — compose, replay, export to FFXIV macros and MacroMate.
- Recipe Bookmarks — local list with notes, tags, and quick-open.
- Auto-Craft (opt-in) — `UseAction` hook with explicit warning modal.
- IPC Provider — exposes theme, macros, and crafting status to other
  Hellion Forge plugins.
- Bilingual EN/DE UI with Hellion Anvil-Boutique styling
  (Forge-Bronze on dark surface).

## Privacy

Zero telemetry. No network calls. Everything stays on your machine. See
[PRIVACY.md](PRIVACY.md) for the full statement.

## Attribution

Anvil is a clean-room re-implementation, not a fork. The plugin is
inspired by [Craftimizer](https://github.com/WorkingRobot/Craftimizer)
by Asriel Camora (MIT) — see [NOTICE.md](NOTICE.md) for the goodwill
attribution.

## License

[MIT](LICENSE) — Copyright (c) 2026 Hellion Online Media.

## Install

The custom Dalamud repository URL for Anvil is:

```text
https://gitea.hellion-forge.cloud/JonKazama-Hellion/Anvil/raw/branch/main/repo.json
```

Add this URL under Dalamud → Settings → Experimental → Custom Plugin
Repositories, then install **Anvil** from the plugin installer.