HexMaster

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

Mission 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.

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

Future Roadmap

Logistics Threat Mapping: Overlay “Front Line” map data to warn drivers about contested territory
Supply Drop Alerts: Automated pings when frontline bases run low on critical supplies
Trend Charts: Visual graphs of stockpile changes over time for strategic planning

Project Log

2026-02-09
HexMaster: Entering the Testing Phase

#hexmaster #foxhole #logistics

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 item discovery, and intelligent supply chain comparison. Using a snapshot-based storage model, it preserves full historical data of every stockpile update, ensuring no information is ever lost.

Read More...

Timeline

Phase 1: Foundation

Core Architecture

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

Phase 2: Intelligence

OCR & Reporting

Integrated OCR services to transcribe stockpile screenshots into structured data via /report commands.

Phase 3: Logistics

Supply Chain Logic

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

Phase 4: Testing

Bot Testing

Deployed the trading bot to a production environment.

Phase 5: Deployment

Bot Deployment