README

A comprehensive fuel management system for EVE Online corporation structures in SeAT. Track fuel consumption, monitor reserves, predict refuel schedules, and optimize logistics across all your Upwell structures.

📸 See screenshots in the Wiki →

Features

🔥 Real-Time Fuel Tracking

Hourly automated tracking of fuel bay levels and consumption rates
Dual tracking method: Primary fuel bay monitoring with days-remaining fallback
Automatic refuel detection when fuel is added to structures
Historical consumption analysis with anomaly detection

📊 Advanced Analytics

Accurate consumption calculations based on actual online services
Service-specific fuel rates with proper structure bonuses
Consumption trend analysis to detect service changes
Predictive fuel requirements for logistics planning

🏭 Multi-Structure Support

Citadels (Astrahus, Fortizar, Keepstar)
Engineering Complexes (Raitaru, Azbel, Sotiyo)
Refineries (Athanor, Tatara)
Navigation Structures (Ansiblex, Pharolux, Tenebrex)

📦 Reserve Management

CorpSAG hangar tracking for staged fuel blocks
Nested Office container support for reserve detection
Refuel event logging when fuel moves from reserves to bay
Custom division name display for organized fuel storage
Reserve recommendations based on consumption patterns

🚨 Critical Alerts

Priority-based warnings (Critical < 7 days, Warning < 14 days)
Fuel bay status monitoring separate from total reserves
System-grouped alerts for efficient logistics
Real-time dashboard widget for quick overview

🚚 Logistics Planning

System-based fuel requirements with 30/60/90-day projections
Hauling volume calculations with trip estimates
Reserve vs. bay fuel breakdown for refuel planning
Export functionality for external logistics tools

🎨 Enhanced User Interface

Dark theme optimized with improved contrast and readability
Responsive design for mobile and desktop
Interactive charts for consumption visualization
Clean, modern layout matching SeAT 5.x design language

Installation

composer require mattfalahe/structure-manager

After installation, run:

php artisan migrate
php artisan structure-manager:setup

What's New in v1.0.4

🐛 Critical Bug Fix: Service-to-Module Calculation

Fixed fuel consumption calculation for multi-service modules

Previously, the plugin calculated fuel consumption per service instead of per module
This caused structures with modules that provide multiple services to show incorrect fuel consumption rates

Example Issue (Now Fixed):

Standup Research Lab I provides 3 services:
- Blueprint Copying
- Material Efficiency Research
- Time Efficiency Research
OLD BUG: Calculated as 3 separate modules = 27 blocks/hour (incorrect!)
NOW FIXED: Correctly calculated as 1 module = 9 blocks/hour ✓

Impact:

Raitaru with Research Lab + Invention Lab:
- Before: ~36 blocks/hour (incorrect)
- After: 18 blocks/hour (correct) ✓
Azbel with Manufacturing Plant + Capital Shipyard:
- Before: ~18 blocks/hour (incorrect)
- After: 27 blocks/hour (correct) ✓

Technical Changes:

Added SERVICE_TO_MODULE_MAP constant mapping services to their source modules
Implemented proper module grouping to count each unique module only once
Updated calculateFromActiveServices() to group services by module before calculating fuel
Service names now use exact case-sensitive matching from EVE API

This fix ensures accurate fuel consumption calculations for all structures, especially those using Research Labs, Manufacturing Plants, and other multi-service modules.

Previous Updates

v1.0.3

Fixed migration issues for cleaner installation process

v1.0.2

🐛 Critical Fuel Calculation Fixes

Fixed Moon Drill fuel consumption: Now correctly uses 120 blocks/day (5/hour) on ALL refineries
- Previously incorrectly applied 20% Athanor bonus (96 blocks/day)
- Previously incorrectly applied 25% Tatara bonus (90 blocks/day)
Corrected fuel reduction bonuses: Only apply to Reprocessing and Reaction service modules
- Athanor: 20% reduction (96 blocks/day for reprocessing/reactions)
- Tatara: 25% reduction (90 blocks/day for reprocessing/reactions)
- Moon Drill: NO reduction (always 120 blocks/day)

🎨 UI/UX Improvements

Dark theme optimization: Better contrast and color schemes for dark mode users
Improved readability: Enhanced text colors and backgrounds
Better visual hierarchy: Clearer distinction between sections
Responsive tables: Better mobile experience for logistics reports

⚡ Performance Enhancements

Optimized fuel bay tracking: More efficient database queries
Improved nested Office detection: Better handling of fuel in Office containers
Reduced API call overhead: Smarter caching strategies

📊 Enhanced Analytics

More accurate consumption predictions: Uses actual service data when available
Better anomaly detection: Identifies service activation/deactivation events
Improved refuel event logging: Tracks both bay refuels and reserve movements

Usage

Dashboard Overview

Access Structure Manager from the main SeAT sidebar. The main dashboard shows:

All corporation structures with fuel status
Color-coded alerts (Red: Critical, Yellow: Warning, Green: Normal)
Real-time consumption rates
Days remaining until refuel needed

Fuel Status View

Monitor all your structures in one place:

Filter by corporation and fuel status
See active services and their fuel consumption
View estimated blocks remaining
Track hourly/daily/weekly consumption rates

Fuel Reserves Management

Track staged fuel blocks across your structures:

View reserves by system and structure
See which CorpSAG divisions contain fuel
Monitor reserve movements and refuel events
Get recommendations for moving reserves to fuel bay

Critical Alerts

Stay on top of urgent fuel needs:

Structures with less than 14 days of fuel
Sorted by urgency (most critical first)
Quick-view fuel requirements
One-click navigation to structure details

Logistics Report

Plan your fuel hauling operations:

Fuel requirements grouped by solar system
30/60/90-day projections for each structure
Total volume and hauler trip calculations
Export data for external planning tools

Structure Details

Deep dive into individual structure fuel data:

Complete fuel history with consumption graphs
Service module breakdown
Refuel event timeline
Reserve status and recommendations

EVE Online Fuel Mechanics

Service Module Consumption Rates

Citadel Services

Clone Bay: 10 blocks/hour base, 7.5/hour on Citadels (-25%)
Market Hub: 40 blocks/hour base, 30/hour on Citadels (-25%)

Engineering Complex Services

Manufacturing/Research/Invention: 12 blocks/hour base, 9/hour on Engineering (-25%)
Capital Shipyard: 24 blocks/hour base, 18/hour on Engineering (-25%)
Supercapital Shipyard: 36 blocks/hour base, 27/hour on Engineering (-25%)

Refinery Services

Reprocessing: 10 blocks/hour base, 8/hour on Athanor (-20%), 7.5/hour on Tatara (-25%)
Moon Drill: 5 blocks/hour (120/day) - NO BONUSES on any structure
Reactions (All Types): 15 blocks/hour base, 12/hour on Athanor (-20%), 11.25/hour on Tatara (-25%)

Navigation Structures

Ansiblex Jump Gate: 30 blocks/hour
Pharolux Cyno Beacon: 15 blocks/hour
Tenebrex Cyno Jammer: 40 blocks/hour

Important Notes

Upwell structures themselves consume ZERO fuel
Only online service modules consume fuel blocks
Fuel reduction bonuses apply ONLY to Reprocessing and Reaction services
Moon Drills ALWAYS use 120 blocks/day regardless of structure type

Permissions

Structure Manager uses SeAT's permission system:

structure-manager.view: View structure fuel data
structure-manager.admin: Administrative functions
structure-manager.export: Export logistics reports

Assign permissions via SeAT's Settings → Access Management.

Automated Tasks

The plugin runs three scheduled jobs:

Fuel Tracking (structure-manager:track-fuel)
- Runs hourly at :15 past the hour
- Tracks fuel bay levels and consumption
- Detects refuel events
Consumption Analysis (structure-manager:analyze-consumption)
- Runs hourly at :30 past the hour
- Analyzes consumption patterns
- Generates recommendations
History Cleanup (structure-manager:cleanup-history)
- Runs daily at 3:00 AM
- Removes old history records (6+ months)
- Keeps reserve data for 3 months

Manual Commands

# Track fuel for all structures
php artisan structure-manager:track-fuel

# Analyze consumption for specific structure
php artisan structure-manager:analyze-consumption --structure=STRUCTURE_ID

# Analyze by corporation
php artisan structure-manager:analyze-consumption --corporation=CORP_ID

# Clean up old history
php artisan structure-manager:cleanup-history --days=180

Requirements

SeAT 5.x
PHP 8.1 or higher
MySQL/MariaDB
Corporation structures tracked by SeAT
Corporation asset data (for fuel bay and reserve tracking)

Troubleshooting

No fuel data showing

Ensure your corporation's ESI tokens have the required scopes
Wait for SeAT to complete initial corporation asset sync
Check that structures have fuel_expires timestamps
Run php artisan structure-manager:track-fuel manually

Inaccurate consumption rates

Allow 24-48 hours for initial data collection
Ensure services are properly online in game
Check for recent service changes or structure states
Verify fuel blocks are tracked in corporation assets

Reserves not detected

Fuel must be in structure's CorpSAG hangars (1-7)
Or in Office containers inside the structure
Must be one of the four fuel block types (4051, 4246, 4247, 4312)
Corporation asset data must be up to date

Support & Contributing

Issues: GitHub Issues
Discussions: GitHub Discussions
Pull Requests: Always welcome!

License

This project is licensed under the GNU General Public License v2.0 - see the LICENSE file for details.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Credits

Author: Matt Falahe
Version: 1.0.2
SeAT Compatibility: 5.x

Built for the EVE Online community. Special thanks to the SeAT development team and all contributors.

EVE Online and the EVE logo are the registered trademarks of CCP hf. All rights are reserved worldwide. All other trademarks are the property of their respective owners. EVE Online, the EVE logo, EVE and all associated logos and designs are the intellectual property of CCP hf. All artwork, screenshots, characters, vehicles, storylines, world facts or other recognizable features of the intellectual property relating to these trademarks are likewise the intellectual property of CCP hf.

mattfalahe / structure-manager

Maintainers

Details