dormant Paused ยท Guild testing and verification · 1 log entry

HexMaster

A powerful Discord bot and an intelligent logistics coordinator for Foxhole groups.

HexMaster

Objective

Enable seamless stockpile management and intelligent supply chain coordination for large-scale logistics operations.

Project Overview

HexMaster is a powerful Discord bot designed for Foxhole logistics groups. It enables seamless stockpile management, cross-map item discovery, and intelligent supply chain comparison using OCR and real-time game data.

The bot follows a snapshot-based storage model, preserving full historical data of every stockpile update without ever overwriting.

Roadmap & Development Phases

The project progresses through the following logistics and bot engineering milestones:

Phase 4 Paused · 6 Development Milestones · Logistics Automation Track
Phase 1 Complete

Foundation & Core Architecture

Implemented snapshot-based storage model using PostgreSQL and SQLAlchemy for non-destructive historical tracking.

Phase 2 Complete

OCR Ingestion & Stockpile Reporting

Integrated computer vision OCR pipelines to transcribe in-game stockpile screenshots into structured records via /report.

Phase 3 Complete

Supply Chain Algorithms & Hex Math

Developed requisition algorithms with 4x Seaport multipliers and custom Cartesian-Staggered hex math for accurate distance sorting.

Phase 4 · Current Milestone Dormant

Guild Testing & Verification

Paused at live testing with Foxhole logistics regiments, covering OCR edge cases, command response latency, and database concurrency.

Phase 5 Planned

Production Containerization

Fully Dockerized cloud deployment with automated Postgres health checks, volume backups, and zero-downtime restarts.

Phase 6 Stretch

Threat Mapping & WarAPI Live Alerts

Live WarAPI dynamic map integration to overlay frontline contested roads, driver hazard routing, and automated supply drop pings.

Core Features

  • Intelligence Reporting: Users file reports by uploading stockpile screenshots via /report. The bot uses OCR to transcribe item codes, quantities, and crate statuses. Every import creates a time-stamped record for trend analysis.
  • Requisition Orders: Compare a Shipping Hub against a Receiving Town with automatic Seaport/Warehouse detection (4x multiplier), crate-standardized units, and priority sorting by mission-critical importance.
  • Strategic Reconnaissance: Global item search across the entire World Conquest map using custom Cartesian-Staggered hex math for accurate distance sorting. Syncs 918+ town locations from WarAPI.

Technical Architecture

  • Discord Bot: Built with discord.py and SQLAlchemy
  • Database: PostgreSQL with asyncpg for high-performance async queries
  • Sync Logic: Standalone Python scripts for seeding regions and syncing with WarAPI
  • Deployment: Fully Dockerized for consistent execution across environments

Project Log

1 entry
  • 2026-02-09 #hexmaster

    HexMaster: Entering the Testing Phase

    I am excited to announce that HexMaster has officially entered its active testing phase! HexMaster is a powerful Discord bot designed for Foxhole logistics groups, enabling seamless stockpile management, cross-map it...
← All projects