POE2 How To Craft

A powerful application that calculates optimal crafting paths for Path of Exile 2 items. Find the most efficient way to craft your dream items using advanced algorithms and probability calculations.

🌐 Web Application

Try it now at poe2htc.com - No installation required!

If you find this tool helpful, consider supporting its development!

Join us on Discord.

📑 Table of Contents

• ✨ Features
• 🚀 Quick Start
• 👤 About Me & the Project
• 📖 How Does It Work?
• 💻 Development
• 🤝 Contributing
• 📝 API Documentation
• 🐛 Known Issues
• 🗺️ Roadmap
• 📄 License
• 🙏 Acknowledgments
• 📞 Contact

✨ Features

• 🎯 Optimal Crafting Paths - Find the best sequence of currencies to craft your desired item
• 📊 Probability Calculations - See exact success rates for each crafting step
• ⚡ Fast Computation - Multithreaded beam search algorithm for quick results
• 🌐 Web App - Access instantly at poe2htc.com
• 🖥️ Desktop App - Also available as an Electron desktop application

🚀 Quick Start

Web Application (Recommended)

Visit poe2htc.com - Start crafting immediately with no installation!

Desktop Application

Windows Users

Download the installer:

1. Go to Releases
2. Download POE2HTC-Setup-X.X.X.exe
3. Run the installer
4. Launch POE2 HTC from your Start Menu or Desktop

⚠️ Important: The application is currently not signed (I'm working on getting a code signing certificate). Windows will show a security warning when you run the installer. You'll need to click "More info" and then "Run anyway" to proceed with the installation. This is normal for unsigned applications and doesn't indicate any security risk. You can review the source code on GitHub if you have any concerns.

• The installer includes everything you need!

Linux/macOS Users

Prerequisites: Java 17+, Node.js 20+, Maven 3.8+

# Clone and setup
git clone https://github.com/Dboire9/POE2_HTC.git
cd POE2_HTC
npm install --legacy-peer-deps

# Run the Electron desktop app
npm run electron:dev

---

👤 About Me & the Project

Hi! I'm Dorian, a third-year computer science student at 42 Paris.

I built this project while (still) actively searching for an internship, both to strengthen my skills and to add a meaningful, technical project to my portfolio. As someone passionate about both gaming and software development, combining Path of Exile 2's complex crafting system with algorithm optimization was the perfect challenge.

Why this project?

• 🎓 Demonstrates full-stack development skills (Java, React, TypeScript, Electron)
• 🧠 Showcases algorithm design and optimization (Beam Search, multithreading)
• 🎮 Solves a real problem for the PoE2 community
• 📈 Continuous learning through community feedback

Looking for opportunities:
I'm currently seeking an internship or freelance opportunities — a required step for completing my diploma at 42. If you appreciate my work or think my skills could be useful to your team, feel free to reach out!

📘 For more about my journey, motivation, and project philosophy, see About Me & the Project.

---

📖 How Does It Work?

This tool simulates Path of Exile 2 crafting to find the most efficient paths to your desired item:

1. Select your base item type and desired modifiers (prefixes/suffixes)
2. Simulate using the Beam Search algorithm to explore millions of crafting sequences
3. Review ranked paths with step-by-step instructions and success probabilities
4. Craft in-game following the optimal currency sequence

The simulation accounts for item rarity transitions, modifier weights, currency behaviors, family conflicts, and slot limitations to provide accurate probability calculations.

📘 For detailed usage instructions with screenshots and examples, see the User Guide.

---

💻 Development

Quick Start:

# Clone and install dependencies
git clone https://github.com/Dboire9/POE2_HTC.git
cd POE2_HTC
npm install --legacy-peer-deps

# Run development environment (starts both backend and frontend)
npm run electron:dev

Architecture:

• Frontend: React 19 + TypeScript + Vite + Electron
• Backend: Java 17 + Maven, REST API on port 8080
• Algorithm: Beam Search with heuristic scoring and multithreading

📘 For detailed setup instructions, project structure, and contribution guidelines, see the Development Guide.

Beam Search Algorithm

The crafting optimizer uses a modified Beam Search algorithm to find optimal crafting sequences. It explores millions of possible paths while pruning low-probability outcomes, achieving near-optimal results in seconds even for complex 6-modifier crafts.

Key features:

• Parallel state exploration with intelligent pruning
• Heuristic-guided path selection
• Exact probability calculations for each step
• Multithreaded execution for sub-10-second results

📖 Read the full algorithm explanation →

---

🤝 Contributing

We welcome contributions! Here's how you can help:

1. Report Bugs - Open an issue with reproduction steps
2. Suggest Features - Share your ideas for improvements
3. Submit Pull Requests - Fix bugs or add features
4. Update Data - Help keep modifier data current with game patches

📘 For detailed contribution guidelines, development setup, and code style, see the Contributing Guide.

---

📝 API Documentation

See API_EXAMPLES.md for detailed API usage and examples.

🐛 Known Issues

• Some rare edge cases with essence combinations may not be fully optimized

See the Issues page for a complete list.

🗺️ Roadmap

Completed

• Desktop application with Electron
• Auto-update system
• Multi-platform support (Windows, Linux)

Short-Term (Next Release)

• Omen of Greater Exaltation support
• Belt item type support
• Add crafting cost estimation
• Crafting simulator with step-by-step execution

Long-Term

• Integration with trade API for cost optimization

📄 License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0) - see the LICENSE file for details.

🙏 Acknowledgments

• Grinding Gear Games for creating Path of Exile 2
• The PoE community and POE2db for modifier data and crafting knowledge
• @fZpHr for the help and advices.
• farmer for giving me this idea through his streams and his discord (Modikin, Bad Architect).

📞 Contact

• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

Note: This is a third-party tool and is not affiliated with or endorsed by Grinding Gear Games.