# HueForge 3D Fuel Filament Library

This folder contains the official 3D Fuel filament library for HueForge, providing accurate color and transmissivity data for 127+ 3D Fuel filaments.

## What's Included

- **3d-fuel.json** - Complete filament library with:
  - 127 filament entries from 3D Fuel and 3D Fuel Tough lines
  - Accurate hex color codes
  - Transmissivity values for realistic light simulation
  - Both PLA+ and PCTG material types
  - Unique UUIDs for proper filament identification

## Installation Video Guide

![HueForge Installation Animation](../.images/Hueforge.gif)

## Steps for Adding to Your HueForge

1. **Download the File**
   - Download the `3d-fuel.json` file from this folder

2. **Locate Your HueForge Installation**
   - Navigate to your HueForge application folder
   - Find the `Filaments` subfolder

3. **Navigate to Vendor Libraries**
   - Inside the `Filaments` folder, locate the `Vendor Libraries` subfolder
   - If it doesn't exist, create it

4. **Install the Library**
   - Copy the `3d-fuel.json` file into the `Vendor Libraries` folder
   - The complete path should look like:

     ```text
     [HueForge Install]/Filaments/Vendor Libraries/3d-fuel.json
     ```

5. **Restart HueForge**
   - Close and reopen HueForge
   - The 3D Fuel brand should now appear in your filament selection

## Using the Filaments

Once installed, you'll see "3D-Fuel" and "3D-Fuel Tough" as available brands in HueForge's filament selector. Each filament includes:

- **Accurate Colors**: Real hex color codes from 3D Fuel's specifications
- **Transmissivity Data**: For realistic light transmission in your models
- **Material Types**: Properly categorized as PLA+ or PCTG
- **Complete Range**: From opaques to transparents, metallics to fluorescents

## Filament Highlights

- **Transparent Options**: Clearly Natural, Transparent Ruby Red, Transparent Lime Green
- **Metallics**: Gold, Silver, Copper variations
- **Fluorescents**: High-visibility colors for standout prints
- **Standard Colors**: Complete spectrum of everyday printing colors
- **Specialty Colors**: LulzBot Green, Bitcoin Orange, and more

## Community Integration

This library was created for the 3D Print Meetup community to enhance HueForge projects with accurate 3D Fuel filament data. Perfect for:

- Multi-color lithophanes
- Transparent art pieces
- Color-accurate prototyping
- Community challenge projects

## Support

For questions about this filament library or HueForge integration, contact the 3D Print Meetup organizers or visit our community resources.

---

*Last Updated: October 2025*  
*Source: 3D Fuel Official Shopify Database*