diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..e1b055a --- /dev/null +++ b/.env.example @@ -0,0 +1,176 @@ +# Lemontropia-Suite Environment Configuration +# Copy this file to .env and fill in your values +# NEVER commit .env to git - it contains sensitive data + +# ============================================================================= +# APPLICATION MODE +# ============================================================================= +APP_ENV=development +APP_DEBUG=true +APP_VERSION=0.1.0-alpha + +# ============================================================================= +# LICENSE & AUTHENTICATION +# ============================================================================= +# Your registered email address for license verification +LICENSE_EMAIL= + +# Your Invoice ID from purchase (used for license activation) +LICENSE_INVOICE_ID= + +# License verification API endpoint +LICENSE_API_URL=https://api.lemontropia.eu/v1/license/verify + +# Auto-check for updates on startup (true/false) +AUTO_UPDATE_CHECK=true + +# ============================================================================= +# DATABASE CONFIGURATION +# ============================================================================= +# SQLite database file path +DB_PATH=./data/lemontropia.db + +# Backup database path (auto-created) +DB_BACKUP_PATH=./data/backups/ + +# Maximum backup files to keep (rotating) +DB_MAX_BACKUPS=10 + +# ============================================================================= +# ENTROPIA UNIVERSE CLIENT +# ============================================================================= +# Path to Entropia Universe chat.log file +# Windows default: C:\Users\\Documents\Entropia Universe\chat.log +# Linux/Wine: ~/.wine/drive_c/users//Documents/Entropia Universe/chat.log +EU_CHAT_LOG_PATH=./test-data/chat.log + +# Log polling interval (milliseconds) +LOG_POLL_INTERVAL=1000 + +# Maximum log file size before rotation warning (MB) +MAX_LOG_SIZE_MB=100 + +# ============================================================================= +# OCR & SCREEN CAPTURE +# ============================================================================= +# OCR engine: tesseract or paddle +OCR_ENGINE=tesseract + +# Path to Tesseract executable (if not in PATH) +# Windows: C:\Program Files\Tesseract-OCR\tesseract.exe +TESSERACT_PATH=tesseract + +# OCR confidence threshold (0-100) +OCR_CONFIDENCE_THRESHOLD=70 + +# Screenshot capture on high-value loot +AUTO_SCREENSHOT_ENABLED=true + +# PED threshold for auto-sccreenshot +SCREENSHOT_PED_THRESHOLD=50 + +# Screenshot output directory +SCREENSHOT_PATH=./screenshots/ + +# Screenshot format: png, jpg +SCREENSHOT_FORMAT=png + +# ============================================================================= +# HUD / OVERLAY SYSTEM +# ============================================================================= +# Enable transparent overlay HUD +HUD_ENABLED=true + +# Default HUD opacity (0.0 - 1.0) +HUD_OPACITY=0.85 + +# HUD window position (x, y) +HUD_POSITION_X=100 +HUD_POSITION_Y=100 + +# HUD window size (width, height) +HUD_WIDTH=400 +HUD_HEIGHT=300 + +# Always on top (true/false) +HUD_ALWAYS_ON_TOP=true + +# Click-through mode (true/false) +HUD_CLICK_THROUGH=true + +# ============================================================================= +# MODULE TOGGLES +# ============================================================================= +MODULE_HUNTER_TRACKER=true +MODULE_MINING_TRACKER=true +MODULE_CRAFTING_TOOL=true +MODULE_INVENTORY_MANAGER=true + +# ============================================================================= +# HUNTER TRACKER SETTINGS +# ============================================================================= +# Auto-track on global/hof events +HUNTER_AUTO_TRACK=true + +# Damage parser mode: log or ocr +HUNTER_DAMAGE_MODE=log + +# Weapon decay calculation method +HUNTER_DECAY_METHOD=manual + +# ============================================================================= +# MINING TRACKER SETTINGS +# ============================================================================= +# Map file path (if using custom maps) +MINING_MAP_PATH=./maps/ + +# Auto-mark claim locations +MINING_AUTO_MARK=true + +# Probe depth tracking enabled +MINING_DEPTH_TRACKING=true + +# ============================================================================= +# CRAFTING TOOL SETTINGS +# ============================================================================= +# Blueprint database update URL +CRAFTING_BP_DB_URL=https://api.lemontropia.eu/v1/blueprints + +# Market data refresh interval (minutes) +CRAFTING_MARKET_REFRESH=60 + +# ============================================================================= +# INVENTORY MANAGER SETTINGS +# ============================================================================= +# Market API endpoint for price checks +INVENTORY_MARKET_API=https://api.lemontropia.eu/v1/market + +# Auto-sync inventory on game launch +INVENTORY_AUTO_SYNC=false + +# ============================================================================= +# LOGGING +# ============================================================================= +# Application log level: debug, info, warning, error +LOG_LEVEL=debug + +# Log file path +LOG_PATH=./logs/lemontropia.log + +# Max log file size before rotation (MB) +LOG_MAX_SIZE=10 + +# Number of log backups to keep +LOG_BACKUP_COUNT=5 + +# ============================================================================= +# DEVELOPMENT / TESTING +# ============================================================================= +# Use mock data instead of real game client +USE_MOCK_DATA=false + +# Mock data file path (for testing) +MOCK_DATA_PATH=./test-data/mock-chat.log + +# Enable verbose debug output +VERBOSE_DEBUG=false diff --git a/.gitignore b/.gitignore index 2d43242..0cf4888 100644 --- a/.gitignore +++ b/.gitignore @@ -1,6 +1,7 @@ # --- Lemontropia-Suite Secrets & Config --- .env .env.* +!.env.example mcp_servers.json # Ignore your Gitea token if it's in a separate file gitea_token.txt diff --git a/PROJECT_RESUME.md b/PROJECT_RESUME.md new file mode 100644 index 0000000..b5b40e1 --- /dev/null +++ b/PROJECT_RESUME.md @@ -0,0 +1,58 @@ +# PROJECT_RESUME: Lemontropia-Suite + +## Project Metadata +- **Repository:** https://git.lemonlink.eu/impulsivefps/Lemontropia-Suite +- **Local Path:** `/home/impulsivefps/.openclaw/workspace/projects/Lemontropia-Suite` +- **Clone Date:** 2026-02-08 16:20 UTC +- **Last Commit:** 2f29640 - docs: add AI knowledge base with project configuration and MCP server details +- **Status:** Active + +## Project Overview +**Entropia-Tools Suite Replication** - Professional analytics platform for Entropia Universe MMORPG. + +### Core Modules +1. **Hunter Tracker** - Combat performance & ROI analytics +2. **Mining Tracker** - Geospatial resource mapping & probe efficiency +3. **Crafting Tool** - Manufacturing cost/benefit simulation +4. **Inventory Manager** - Asset valuation & market markup tracking + +### Technical Stack (Recommended) +- **Language:** Python (rapid dev) or C#/.NET (Windows native) +- **Database:** SQLite / structured JSON +- **UI:** Modern Dark Mode (PyQt6 or Electron) +- **Data Capture:** Hybrid (Log polling + OCR) +- **Overlay:** Transparent click-through HUD (Always on Top) + +### Key Features +- **Data Principle:** All sessions stored as "Projects" (archivable, comparable) +- **Real-time Log Polling:** `Documents/Entropia Universe/chat.log` +- **OCR:** Tesseract/PaddleOCR for UI element capture +- **Auto-Screenshot:** Trigger on loot > 50 PED +- **License Auth:** Email + Invoice ID verification + +## Development Status +- [x] Repository initialized +- [x] Documentation structure created +- [ ] Core data capture engine +- [ ] HUD overlay system +- [ ] Hunter Tracker module +- [ ] Mining Tracker module +- [ ] Crafting Tool module +- [ ] Inventory Manager module +- [ ] License/auth system +- [ ] Auto-updater + +## Key Files +- `README.md` - Project overview +- `TECHNICAL_SPECS.md` - Implementation details +- `GAME_MECHANICS.md` - Entropia Universe domain knowledge +- `AI_KNOWLEDGE_BASE.md` - MCP server configuration +- `AGENTS.md` - Development agent guidelines + +## Environment Setup +- [x] `.env.example` — Template with all configuration options documented +- [x] `.env` — Development configuration (gitignored) +- [x] Directory structure: `data/`, `screenshots/`, `logs/`, `test-data/`, `maps/` + +## Next Actions +TBD by Lead Architect