SDFH/README.md

Stella Deus Fuse Helper (SDFH)

Interactive CLI to browse items and compute fusion plans with cost analysis.

What’s included

• sdfh.js: single-file CLI
• sdfh_item_data.json: item database

Run

• node sdfh.js
• Or use the SEA executables in dist/ (no Node required)

Search examples

• katana r7
• battle axe
• battle axe r7
• golden apple r5 --full

What does r7 mean?

• r7 (or rank 7) is a rank filter. It limits matches to items of rank 7.
• With a type word (e.g., "katana r7"), it finds all items of that type and rank.
• With an exact item name + rank (e.g., "battle axe r7"), it searches within that item’s family/type.

Types vs item names

• You can search by type/category (e.g., "katana", "axe", "bow", "glove", "robe", etc.) to browse groups.
• You can search by exact item name (e.g., "Battle Axe").
• For rank filters:
  • Type + rank is required unless you give an exact full item name.
  • Examples:
    • OK: "axe r5" → all axes of rank 5
    • OK: "battle axe r5" → rank 5 items in the Battle Axe line/type
    • Not OK: "battle r5" (ambiguous; add a type or full name)

Partial and typos

• The search is typo-tolerant and token-aware. "bttle axe" or "btl ax" can still find "Battle Axe".
• Suggestions show the top matches; add --full to see more.

Fusion and pricing

• golden apple --fuse Show default recipe’s fusion tree
• golden apple --fuse 2 Use recipe index 2
• golden apple --fuse --depth 3 Resolve to leaves with rank <= 3
• golden apple --fuse --store 3 Stop at purchasable leaves in store 3; show prices and total
• golden apple --fuse --depth 3 --store 3 Treat non-buyable leaves as owned; price the rest

Options

• --full Show up to 50 suggestions instead of 5
• --fuse [N] Enter fusion mode; optional N is recipe index (1-based)
• --recipe [N] Alias of --fuse [N]
• --depth N Alias of --fuse-rank N; leaves must be rank <= N
• --fuse-rank N Leaves must be rank <= N
• --store N Price analysis at store level N (1..5)

Notes

• Types derive from guide sections; rank filters require explicit type or exact item name
• Data file is discovered beside the executable or in data/, then SEA-embedded asset

Platform notes

• macOS first run (ad‑hoc signing and quarantine removal):
  • For Apple Silicon use sdfh-sea-macos-arm64, for Intel use sdfh-sea-macos-x64.
  • Then run:

    xattr -p com.apple.quarantine ./sdfh-sea-macos-arm64 || true
    xattr -dr com.apple.quarantine ./sdfh-sea-macos-arm64
    codesign --force --sign - ./sdfh-sea-macos-arm64
    

  • If Finder blocks: System Settings → Privacy & Security → Allow Anyway, then Control‑click → Open.
• Windows on Wine: ensure Wine prefix reports Windows 10+ via winecfg so the exe launches by double‑click.

License MIT

Acknowledgments

• Data and fusion references are derived from community guides on GameFAQs:
  • Dragen’s Fusion/Item FAQ: link
  • Gundam4fun’s Fusion FAQ: link
• While those guides are copyrighted, the factual data about in-game items and recipes is available to anyone who plays the game.
• Many thanks to the authors for their meticulous work collecting and presenting the data. This project acknowledges that processing the raw facts into a comprehensive, searchable format and building this fuse-helper app is a separate effort built on top of their contributions.