# EU-Utility Feature Pack

Three high-value plugins for EU-Utility that enhance your Entropia Universe gameplay experience.

## 📦 Features Included

1. **Session Exporter** - Export hunting/mining sessions to CSV/JSON
2. **Price Alerts** - Monitor Nexus API prices with smart alerts
3. **Auto-Screenshot** - Capture screenshots on Global/HOF automatically

---

## 📊 Session Exporter

Automatically track and export your hunting, mining, or crafting sessions.

### Features

- **Automatic Tracking**: Captures loot, skills, globals, and HOFs in real-time
- **Export Formats**: CSV for spreadsheets, JSON for advanced analysis
- **Session Statistics**: Track totals, unique items, damage dealt/received
- **Auto-Export**: Automatically save sessions at configurable intervals
- **Hotkey Support**: `Ctrl+Shift+E` to start/stop sessions

### Usage

1. Open the overlay and navigate to "Session Exporter"
2. Click "Start New" to begin tracking (or use hotkey)
3. Play normally - all events are captured automatically
4. Click "Export CSV" or "Export JSON" when done
5. Files are saved to `Documents/EU-Sessions/` by default

### Data Captured

| Event Type | Data Captured |
|------------|---------------|
| Loot | Mob name, items received, TT value, position |
| Skill Gain | Skill name, new value, gain amount |
| Global/HOF | Player name, achievement type, value, item |
| Damage | Amount dealt/received (in session stats) |

### File Formats

**JSON Export:**
```json
{
  "export_info": {
    "version": "1.0.0",
    "exported_at": "2025-02-14T10:30:00"
  },
  "session": {
    "start_time": "2025-02-14T09:00:00",
    "summary": { "total_loot_tt": 150.50, ... },
    "entries": [...]
  }
}
```

**CSV Export:**
```csv
timestamp,event_type,description,value,details
2025-02-14T09:05:00,Loot,"From Daikiba: Animal Oil",0.05,{...}
2025-02-14T09:10:00,Skill,"Rifle +0.01",0.01,{...}
```

---

## 🔔 Price Alerts

Monitor Entropia Nexus market prices and get notified when items hit your targets.

### Features

- **Smart Monitoring**: Check prices at configurable intervals (1-60 minutes)
- **Flexible Alerts**: Set "below" alerts for buying, "above" for selling
- **Nexus Integration**: Direct API access to real-time market data
- **Price History**: Track price trends over time
- **Notifications**: Visual + sound alerts when conditions are met
- **Hotkey Support**: `Ctrl+Shift+P` to trigger manual price check

### Usage

1. Open "Price Alerts" from the overlay
2. Search for items using the search tab
3. Click "+ Alert" next to an item
4. Set condition (Price Below/Above) and target percentage
5. Wait for notifications when prices hit your targets!

### Alert Types

| Type | Use Case | Example |
|------|----------|---------|
| **Below** | Buy opportunities | Alert when ArMatrix LP-35 drops below 120% |
| **Above** | Sell opportunities | Alert when your loot rises above 150% |

### Settings

- **Check Interval**: How often to query Nexus API (default: 5 minutes)
- **Notifications**: Toast notifications on price triggers
- **Sound**: Audio alert when conditions are met
- **History**: Keep 7 days of price history for trend analysis

### Tips

- Set alerts for items you frequently buy/sell
- Use "below" alerts to stock up when prices dip
- Use "above" alerts to know when to sell your loot
- Check the status bar for next scheduled price check

---

## 📸 Auto-Screenshot

Never miss capturing your big wins! Automatically takes screenshots on Global, HOF, and more.

### Features

- **Event Detection**: Global, HOF, ATH, Discovery, high-value loot, skill gains
- **Smart Delay**: Configurable delay to hide overlay before capture
- **Custom Naming**: Filename patterns with variables
- **Organized Storage**: Automatic folder creation by event type
- **Notifications**: Optional sound and visual confirmation
- **Hotkey Support**: `Ctrl+Shift+C` for manual screenshot

### Usage

1. Enable "Auto-Screenshot" in the plugin settings
2. Configure which events trigger screenshots
3. Set your preferred save location
4. Play normally - screenshots are captured automatically!

### Capture Rules

| Rule | Trigger | Default |
|------|---------|---------|
| **Global** | Any global announcement | ✅ Enabled |
| **HOF** | Hall of Fame (50+ PED) | ✅ Enabled |
| **ATH** | All-Time High | ✅ Enabled |
| **Discovery** | New discovery announced | ✅ Enabled |
| **High Loot** | Loot above threshold | ❌ Disabled |
| **Skill Gain** | Large skill gains | ❌ Disabled |

### Filename Patterns

Use variables to customize screenshot names:

```
{timestamp}    - Date/time (20250214_143022)
{event_type}   - Type of event (GLOBAL, HOF, ATH)
{player}       - Player name
{value}        - PED value
```

**Examples:**
- `{event_type}_{timestamp}` → `HOF_20250214_143022.png`
- `{player}_{event_type}_{value}` → `PlayerName_GLOBAL_150PED.png`

### Settings

- **Capture Delay**: Time to hide overlay before capture (0-5000ms)
- **Save Location**: Default is `Documents/Entropia Universe/Screenshots/Globals/`
- **Play Sound**: Audio confirmation on capture
- **Show Notification**: Visual confirmation with filename

### Manual Capture

Press `Ctrl+Shift+C` at any time to take a manual screenshot.

---

## 🔧 Installation

1. Copy the three plugin folders to `EU-Utility/plugins/`:
   ```
   plugins/
   ├── session_exporter/
   │   ├── __init__.py
   │   └── plugin.py
   ├── price_alerts/
   │   ├── __init__.py
   │   └── plugin.py
   └── auto_screenshot/
       ├── __init__.py
       └── plugin.py
   ```

2. Restart EU-Utility

3. The plugins will appear in your overlay automatically

---

## ⌨️ Hotkeys

| Plugin | Hotkey | Action |
|--------|--------|--------|
| Session Exporter | `Ctrl+Shift+E` | Start/Stop session |
| Price Alerts | `Ctrl+Shift+P` | Check prices now |
| Auto-Screenshot | `Ctrl+Shift+C` | Manual screenshot |

---

## 📝 Data Storage

All plugins use the EU-Utility DataStore for persistent storage:

- **Session Exporter**: `data/plugins/session_exporter.json`
- **Price Alerts**: `data/plugins/price_alerts.json`
- **Auto-Screenshot**: `data/plugins/auto_screenshot.json`

---

## 🐛 Troubleshooting

### Session Exporter

**Q: No events are being captured**
- Ensure EU chat.log is being written
- Check that the session is started (green status)

**Q: Export fails**
- Verify the export directory exists and is writable
- Check available disk space

### Price Alerts

**Q: Prices not updating**
- Check internet connection
- Verify Nexus API is accessible
- Try manual refresh with hotkey

**Q: Alerts not triggering**
- Ensure alert is enabled (checkmark in table)
- Verify current price is available
- Check notification settings

### Auto-Screenshot

**Q: Screenshots not being taken**
- Enable the plugin (master toggle)
- Verify capture rules are enabled
- Check save directory permissions

**Q: Overlay appears in screenshots**
- Increase capture delay (500-1000ms recommended)

---

## 🔗 API Integration

These plugins use the following EU-Utility core services:

- **Event Bus**: For real-time game event capture
- **Nexus API**: For market price data
- **Screenshot Service**: For screen capture
- **DataStore**: For persistent settings
- **Notification Service**: For user alerts

---

## 📄 License

Part of EU-Utility - Entropia Universe Tool Suite

---

## 🙏 Credits

Developed for EU-Utility by the Feature Developer Agent
Data provided by [Entropia Nexus](https://entropianexus.com)