Oxeye

Description

This is a Discord bot + Minecraft Mod + backend service combo to track who's on your Minecraft server. The Minecraft mod is written in Java (obviously) for Fabric 1.21.11 for now. I'll look into writing other types of mods if there's interest. I'll also see if I can automate porting the mod to different versions (since the functionality is basic and shouldn't change).

The backend is built with Rust (Axum for HTTP + Poise for Discord) and is available as an OCI image in the GitHub Packages registry for both AMD64 and ARM64 architectures.

Features

• Real-time player tracking - See who's online on your Minecraft server from Discord
• Visual player list - Shows Minecraft skin heads for each online player in Discord embeds
• Automatic skin detection - Detects when players change their skins and updates automatically
• Time online tracking - Shows how long each player has been online
• Multi-server support - Link multiple Minecraft servers to different Discord servers
• Self-healing - Automatically recovers state after backend restarts
• Optimized bandwidth - Smart caching reduces network overhead by 67x
• Fast in-memory tracking - Uses hybrid storage (SQLite + RAM) for performance

Documentation

Setup

Quick Start with Docker

Pre-built OCI images are available in GitHub Packages for AMD64 and ARM64:

docker pull ghcr.io/adhi-thirumala/oxeye-backend:latest-amd64
# or
docker pull ghcr.io/adhi-thirumala/oxeye-backend:latest-arm64

Or use Docker Compose:

version: '3.8'
services:
  oxeye:
    image: ghcr.io/adhi-thirumala/oxeye-backend:latest-amd64
    ports:
      - "3000:3000"
    environment:
      - DISCORD_TOKEN=your_token_here
      - PUBLIC_URL=http://your-server-ip:3000  # Important for image serving
      - DATABASE_PATH=/data/oxeye.db
    volumes:
      - oxeye-data:/data
volumes:
  oxeye-data:

Server Owners

Invite the bot to your Discord server. Then run `/oxeye connect` to gen