PHPackages mattfalahe/mining-manager - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. mattfalahe/mining-manager ActiveSeat-plugin mattfalahe/mining-manager ========================= Comprehensive mining management plugin for SeAT - Track mining activities, manage moon extractions, calculate taxes, and generate detailed reports 1877↓22.2%PHP Since Oct 13Pushed 1mo agoCompare [ Source](https://github.com/MattFalahe/Mining-Manager)[ Packagist](https://packagist.org/packages/mattfalahe/mining-manager)[ RSS](/packages/mattfalahe-mining-manager/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (9)Used By (0) Mining Manager for SeAT ======================= [](#mining-manager-for-seat) [![Latest Version](https://camo.githubusercontent.com/e8372fd2065a5ca53fe72dbb6356d8cc6f0239aa503a64fb610548fcd7727c9e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d61747466616c6168652f6d696e696e672d6d616e616765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mattfalahe/mining-manager)[![License](https://camo.githubusercontent.com/37c9aa11511cabae70647d9c92694be2a286bd25c284de636a228b0ecff380ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c2d2d322e302d626c75652e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![SeAT](https://camo.githubusercontent.com/e8c0f12080cad134d9c2b4c6e85627cb440853a57a7ec4a5ad270446a988f0ee/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f536541542d352e782d626c75652e7376673f7374796c653d666c61742d737175617265)](https://github.com/eveseat/seat) A comprehensive mining management plugin for SeAT. Track mining operations, manage moon extractions, calculate taxes, and generate detailed analytics for your corporation's mining activities. 📸 **[See screenshots in the Wiki →](https://github.com/MattFalahe/Mining-Manager/wiki)** Features -------- [](#features) ### ⛏️ Mining Activity Tracking [](#️-mining-activity-tracking) - **Automated ledger processing** from character mining data - **Real-time mining event management** with participant tracking - **Individual and corporation-wide statistics** for performance monitoring - **Mining event leaderboards** with quantity tracking and bonuses ### 🌕 Moon Mining Operations [](#-moon-mining-operations) - **Moon extraction tracking** with automated notifications - **Ore composition analysis** and value calculations - **Extraction calendar** for scheduling and planning - **Ready-to-fracture alerts** for timely moon pops - **Historical extraction data** and performance metrics ### 💰 Tax Management System [](#-tax-management-system) - **Automated monthly tax calculation** based on mining activity - **Tax invoice generation** via EVE contracts - **Smart payment verification** with tax code matching - **Automated payment tracking** from wallet transactions - **Reminder system** for unpaid taxes - **Flexible tax rates** per ore type or flat percentage ### 📊 Analytics & Reporting [](#-analytics--reporting) - **Customizable mining reports** (daily, weekly, monthly) - **Mining activity trends** and performance charts - **Character contribution analysis** for payouts - **Export capabilities** (CSV, JSON) for external tools - **Dashboard metrics** for quick overview ### 🤖 Full Automation [](#-full-automation) - **Event-driven data processing** for real-time updates - **Scheduled task automation** for background jobs - **Market price caching** for accurate ISK calculations - **Wallet and contract monitoring** for payment tracking - **Automatic event participant updates** as mining happens Installation ------------ [](#installation) ``` composer require mattfalahe/mining-manager ``` Usage ----- [](#usage) ### Dashboard [](#dashboard) Access Mining Manager from the main SeAT sidebar. The dashboard shows: - Recent mining activity and event status - Quick stats for active mining operations - Unpaid tax overview - Upcoming moon extractions ### Mining Ledger [](#mining-ledger) Track all mining activity: - Character-by-character mining records - Filter by date range, ore type, or solar system - View quantities mined and estimated values - Export data for analysis ### Mining Events [](#mining-events) Manage corporation mining operations: - Create and schedule mining events - Track participant contributions in real-time - Set bonus percentages for event participation - View event leaderboards and statistics - Automatic ore tracking during events ### Moon Mining [](#moon-mining) Monitor moon extraction operations: - View active and scheduled extractions - Track extraction progress and timelines - Ore composition and estimated values - Automatic notifications when ready to fracture - Historical extraction records ### Tax Management [](#tax-management) Handle mining taxes efficiently: - Automated monthly tax calculations - View unpaid, paid, and overdue taxes - Generate and send tax invoices as contracts - Track payments automatically via tax codes - Send reminder notifications - Manual payment verification tools ### Reports & Analytics [](#reports--analytics) Generate detailed mining reports: - Performance trends over time - Top miners and contributors - System and ore type breakdowns - Tax collection statistics - Custom date ranges and filters Permissions ----------- [](#permissions) Mining Manager uses SeAT's permission system: - `mining-manager.view`: View mining data and reports - `mining-manager.manage_events`: Create and manage mining events - `mining-manager.manage_taxes`: Calculate and manage taxes - `mining-manager.admin`: Full administrative access Assign permissions via SeAT's Settings → Access Management. Automated Tasks --------------- [](#automated-tasks) The plugin runs nine scheduled jobs for full automation: ### High-Frequency Tasks [](#high-frequency-tasks) - **Cache Market Prices** - Every 15 minutes - **Update Moon Extractions** - Every 30 minutes ### Hourly Tasks [](#hourly-tasks) - **Process Mining Ledger** - :05 past each hour - **Update Mining Events** - :15 past each hour - **Verify Wallet Payments** - :35 past each hour ### Daily Tasks [](#daily-tasks) - **Send Tax Reminders** - 10:00 AM daily - **Generate Reports** - 4:00 AM daily ### Monthly Tasks [](#monthly-tasks) - **Calculate Monthly Taxes** - 1st of month at 2:00 AM - **Generate Tax Invoices** - 2nd of month at 3:00 AM ### Manual Commands [](#manual-commands) ``` # Process mining ledger manually php artisan mining-manager:process-ledger # Update mining events php artisan mining-manager:update-events # Calculate taxes for specific month php artisan mining-manager:calculate-taxes # Generate tax invoices php artisan mining-manager:generate-invoices # Verify wallet payments php artisan mining-manager:verify-payments # Send tax reminders php artisan mining-manager:send-reminders # Update moon extractions php artisan mining-manager:update-extractions # Cache market prices php artisan mining-manager:cache-prices # Generate reports php artisan mining-manager:generate-reports ``` Requirements ------------ [](#requirements) - SeAT 5.x - PHP 8.0 or higher - MySQL/MariaDB - Character mining ledger data tracked by SeAT - Corporation structure data (for moon mining) - Wallet and contract tracking (for tax automation) Troubleshooting --------------- [](#troubleshooting) ### No mining data showing [](#no-mining-data-showing) 1. Ensure character ESI tokens have the required scopes 2. Wait for SeAT to complete initial character mining ledger sync 3. Run `php artisan mining-manager:process-ledger` manually 4. Check Laravel logs for any errors ### Tax payments not auto-matching [](#tax-payments-not-auto-matching) 1. Verify wallet journal tracking is enabled in SeAT 2. Ensure tax code is included in payment description (e.g., "TAX-ABC123") 3. Check that `mining-manager.tax.auto_match_payments` config is enabled 4. Run `php artisan mining-manager:verify-payments` manually ### Moon extractions not updating [](#moon-extractions-not-updating) 1. Ensure corporation structures are tracked by SeAT 2. Verify structure ESI scopes are correct 3. Check that extraction data is present in SeAT database 4. Run `php artisan mining-manager:update-extractions` manually ### Events not tracking participant mining [](#events-not-tracking-participant-mining) 1. Verify event has correct solar system set (if filtering by system) 2. Ensure event time range covers mining activity 3. Check that characters are mining during event period 4. Event listener must be registered (automatic after installation) Support & Contributing -------------------------- [](#support--contributing) - **Issues**: [GitHub Issues](https://github.com/MattFalahe/Mining-Manager/issues) - **Discussions**: [GitHub Discussions](https://github.com/MattFalahe/Mining-Manager/discussions) - **Wiki**: [Full documentation](https://github.com/MattFalahe/Mining-Manager/wiki) - **Pull Requests**: Always welcome! License ------- [](#license) This project is licensed under the GNU General Public License v2.0 - see the [LICENSE](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 ------- [](#credits) **Author**: Matt Falahe **Version**: 2.0-dev **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 relating to these trademarks are likewise 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.* ### Health Score 28 — LowBetter than 54% of packages Maintenance60 Regular maintenance activity Popularity21 Limited adoption so far Community6 Small or concentrated contributor base Maturity20 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/f0a1dd29a419ebc176eeb45fbf4ab22e388fa624f99c4ecc94976b73cb50d6ca?d=identicon)[MattFalahe](/maintainers/MattFalahe) --- Top Contributors [![MattFalahe](https://avatars.githubusercontent.com/u/47831385?v=4)](https://github.com/MattFalahe "MattFalahe (5 commits)") ### Embed Badge ![Health badge](/badges/mattfalahe-mining-manager/health.svg) ``` [![Health](https://phpackages.com/badges/mattfalahe-mining-manager/health.svg)](https://phpackages.com/packages/mattfalahe-mining-manager) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)