JonKazama-Hellion
19c7c784f8
Initial Hellion Forge documentation for the Craftimizer fork. - Replace stub README with full project page (badges, fork scope table, tech stack, build instructions, project status, license block, FFXIV disclaimer, Hellion Forge footer) - Add NOTICE.md with acknowledgement to Asriel Camora as the upstream author, direct word on fork intent, scope of changes, contact path, and explicit non-upstreaming rationale - Add COPYRIGHT with dual-holder source code block (Asriel 2023 + Hellion Online Media 2026 for the SDK 15 maintenance), visual asset block (Hellion Forge logo by Florian Eck, all-rights-reserved), and bundled binary attribution (Raphael solver) - Drop in the Hellion Forge logo under docs/images/ LICENSE remains unchanged — Asriel Camora's original MIT notice is mandatory under MIT clause 3.
133 lines
6.1 KiB
Markdown
133 lines
6.1 KiB
Markdown
# Craftimizer (Hellion Fork)
|
||
|
||
[](LICENSE)
|
||
[](https://github.com/goatcorp/Dalamud)
|
||
[](https://dotnet.microsoft.com/)
|
||
[](https://www.finalfantasyxiv.com/)
|
||
[](https://github.com/WorkingRobot/Craftimizer)
|
||
|
||
<p align="center">
|
||
<img src="docs/images/hellion-forge.png" alt="Hellion Forge" width="180" />
|
||
</p>
|
||
|
||
**Version 2.9.1.1 (Hellion fork)** — a maintenance fork of
|
||
[Craftimizer](https://github.com/WorkingRobot/Craftimizer) by
|
||
[Asriel Camora](https://github.com/WorkingRobot), brought back to life on
|
||
Dalamud SDK 15 for FFXIV 7.5+.
|
||
|
||
Upstream Craftimizer received its last update for FFXIV 7.4 in late 2025 and
|
||
has been dormant since. With the Dalamud API jump from level 14 to 15 in
|
||
early 2026, the plugin stopped loading. This fork is a narrow API-compatibility
|
||
cycle that gets it back on its feet for personal and friend-circle use. No
|
||
features added, no design changes, no behavior departures from upstream. If
|
||
Asriel ships an official SDK 15 update upstream, this fork folds back into a
|
||
pure mirror and the recommendation will be to switch back.
|
||
|
||
## Acknowledgements
|
||
|
||
Every line of crafting logic, every solver heuristic, the entire simulator, the
|
||
recipe data layer, the synthesis hooks, and all UI windows are
|
||
**[Asriel Camora](https://github.com/WorkingRobot)**'s work. This fork only
|
||
unblocks the API path. Full acknowledgement in [NOTICE.md](NOTICE.md).
|
||
|
||
This fork is maintained under **Hellion Forge**, the modding and plugin line of
|
||
[Hellion Online Media](https://hellion-media.de).
|
||
|
||
---
|
||
|
||
## What this fork changes
|
||
|
||
| Area | Upstream (last 2.9.1.1) | This fork |
|
||
| ----------------------------------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------- |
|
||
| Dalamud SDK | 14.0.1 | **15.0.0** |
|
||
| Dalamud API Level | 14 (manifest unset, packager-inferred) | **15** (packager-set) |
|
||
| `FFXIVClientStructs.FFXIV.Component.GUI` type | `ValueType` | `AtkValueType` (upstream rename) |
|
||
| `Dalamud.Interface.Utility.Raii.ImRaii` nested | `IEndObject`, `Color` (removed in SDK15) | local `IEndObject` interface in `ImRaii2.cs`; typed `ImRaii.*Disposable` returns |
|
||
| `Settings.TabItem` ref-bool lifetime | `var open = true; TabItem(label, ref open, flags)` (rejected by SDK 15 escape analysis) | `TabItem(label, flags)` overload (no ref) |
|
||
|
||
Diff total: **+23 / −19 lines** across seven files. The change set is
|
||
intentionally minimal so a future upstream merge stays trivial.
|
||
|
||
---
|
||
|
||
## Tech Stack
|
||
|
||
| Category | Technology |
|
||
| ---------- | ----------------------------------------------------- |
|
||
| Platform | Dalamud Plugin (API Level 15) |
|
||
| Language | C# / .NET 10 (`net10.0-windows`) |
|
||
| Build | Dalamud.NET.Sdk 15.0.0 |
|
||
| UI | Dear ImGui via Dalamud bindings |
|
||
| Solver | Raphael (Rust crate, bundled as `raphael_bindings.dll`) |
|
||
| Toolchain | dotnet 10 SDK |
|
||
|
||
---
|
||
|
||
## Build
|
||
|
||
```bash
|
||
git clone ssh://git@gitea.hellion-forge.cloud:2222/JonKazama-Hellion/Craftimizer.git
|
||
cd Craftimizer
|
||
dotnet build Craftimizer.sln -c Release
|
||
```
|
||
|
||
The plugin DLL plus the manifest land in `Craftimizer/bin/x64/Release/`. Point
|
||
Dalamud's **Dev Plugin Locations** at that folder (`/xlsettings` →
|
||
**Experimental**) to load it as a dev plugin.
|
||
|
||
---
|
||
|
||
## Project Status
|
||
|
||
**Experimental Hellion fork — personal-use only.** No distribution channel,
|
||
no custom repo, no release pipeline. This may change if the fork grows beyond
|
||
a single-user maintenance build, but for now: clone, build, dev-load.
|
||
|
||
If upstream resumes active maintenance, this fork archives.
|
||
|
||
---
|
||
|
||
## Community & Support
|
||
|
||
- Bug reports and questions:
|
||
[Gitea Issues](https://gitea.hellion-forge.cloud/JonKazama-Hellion/Craftimizer/issues)
|
||
- Discord DM: `@j.j_kazama`
|
||
- Email (business): <kontakt@hellion-media.de>
|
||
|
||
For anything that relates back to upstream Craftimizer or to attribution, see
|
||
the contact path in [NOTICE.md](NOTICE.md).
|
||
|
||
---
|
||
|
||
## License
|
||
|
||
MIT (same license as upstream Craftimizer). Full text in [LICENSE](LICENSE).
|
||
Copyright details with dual-holder block in [COPYRIGHT](COPYRIGHT). Personal
|
||
acknowledgement to the upstream author in [NOTICE.md](NOTICE.md).
|
||
|
||
© 2023 [Asriel Camora](https://github.com/WorkingRobot) for the original
|
||
Craftimizer plugin. © 2026 Hellion Online Media for the Dalamud SDK 15
|
||
fork-maintenance modifications.
|
||
|
||
### FFXIV Disclaimer
|
||
|
||
FINAL FANTASY XIV © SQUARE ENIX CO., LTD. All rights reserved. Craftimizer
|
||
and this fork are unofficial, fan-made plugins and are not affiliated with,
|
||
supported by, sponsored by, or approved by Square Enix.
|
||
|
||
---
|
||
|
||
## Project Documents
|
||
|
||
| Document | Contents |
|
||
| -------------------------- | -------------------------------------------------------------- |
|
||
| [`LICENSE`](LICENSE) | MIT licence full text (Asriel Camora original notice intact). |
|
||
| [`COPYRIGHT`](COPYRIGHT) | Dual-holder copyright block, visual asset attribution. |
|
||
| [`NOTICE.md`](NOTICE.md) | Acknowledgement to upstream author, scope of fork, contact. |
|
||
|
||
---
|
||
|
||
Maintained under **Hellion Forge**, the modding and plugin line of
|
||
**Hellion Online Media** | Bad Harzburg |
|
||
[hellion-media.de](https://hellion-media.de)
|