bethington/docker-pd2

Project Diablo 2 Docker Container

This Docker container provides a complete environment for running Project Diablo 2 with VNC remote access, memory monitoring, and MCP server integration for AI assistance.

Features

• Headless Gaming: Runs Project Diablo 2 in a virtual X11 display
• Remote Access: VNC server for remote desktop connection
• AI Integration: MCP server for Claude Desktop integration
• Memory Monitoring: Real-time game state monitoring
• Custom Resolution: Optimized 1068x600 resolution for container environment
• 3dfx Support: Enhanced graphics rendering with 3dfx emulation

Prerequisites

• Docker and Docker Compose installed
• Project Diablo 2 game files in pd2/ directory
• VNC client (optional, for remote access)

Quick Start

1. Build and run the container:

   docker-compose up --build
   

2. Connect via VNC:

   • Host: localhost
   • Port: 5901
   • No password required

3. Access services:

   • VNC: localhost:5901
   • MCP Server: localhost:8765
   • Health Check: localhost:3000

Directory Structure

Diablo2/
├── Dockerfile              # Container definition
├── docker-compose.yml      # Service orchestration
├── README.md               # This documentation file
├── INSTALL.md              # Installation and setup guide
├── start_diablo2.sh        # Main startup script (executable)
├── diablo2_monitor.py      # Memory monitoring service
├── diablo2_mcp_server.py   # MCP server for AI integration
├── screenshots/            # Directory for game screenshots
├── memory_dumps/           # Directory for memory analysis dumps
└── pd2/                    # Project Diablo 2 game files (user provided)
    ├── Base Game Files (Root Level):
    ├── D2.LNG              # Language file
    ├── d2char.mpq          # Base character data
    ├── d2data.mpq          # Base game data
    ├── d2exp.mpq           # Expansion pack data
    ├── d2music.mpq         # Base music files
    ├── d2sfx.mpq           # Base sound effects
    ├── d2speech.mpq        # Base voice files
    ├── d2video.mpq         # Base video files
    ├── D2xMusic.mpq        # Expansion music
    ├── d2xtalk.mpq         # Expansion voice files
    ├── D2xVideo.mpq        # Expansion videos
    ├── Patch_D2.mpq        # Base game patches
    ├── Save/               # Save Directory
    │
    └── ProjectD2/          # Project D2 mod directory
        ├── Executables:
        ├── Game.exe        # Main game executable
        ├── Diablo II.exe   # Original Diablo 2 executable
        ├── PD2Launcher.exe # Project D2 launcher
        ├── D2VidTst.exe    # Video test utility
        │
        ├── Core Game Libraries:
        ├── D2Client.dll    # Client library
        ├── D2Common.dll    # Common game functions
        ├── D2Game.dll      # Core game library
        ├── D2gfx.dll       # Graphics library
        ├── D2Lang.dll      # Language support
        ├── D2Launch.dll    # Game launcher
        ├── D2Net.dll       # Network functionality
        ├── D2sound.dll     # Audio system
        ├── D2Win.dll       # Windows interface
        ├── D2CMP.dll       # Compression library
        ├── D2Multi.dll     # Multiplayer support
        ├── D2MCPClient.dll # Battle.net client
        ├── Fog.dll         # Blizzard utility library
        ├── Storm.dll       # Blizzard core library
        │
        ├── Graphics & Display:
        ├── D2DDraw.dll     # DirectDraw wrapper
        ├── D2Direct3D.dll  # Direct3D wrapper
        ├── D2Gdi.dll       # GDI graphics
        ├── D2Glide.dll     # 3dfx Glide wrapper
        ├── D2HD.dll        # HD graphics support
        ├── ddraw.dll       # DirectDraw implementation
        ├── glide3x.dll     # 3dfx Glide library
        ├── SGD2FreeRes.dll # Resolution mod library
        ├── SGD2FreeDisplayFix.dll # Display fix library
        │
        ├── Media & Codec Libraries:
        ├── binkw32.dll     # Bink video codec
        ├── SmackW32.dll    # Smacker video codec
        ├── ijl11.dll       # Intel JPEG library
        ├── sciter.dll      # HTML/CSS engine
        ├── WebView2Loader.dll # Modern web integration
        ├── libcrypto-1_1.dll # Cryptography library
        │
        ├── Project D2 Mods:
        ├── ProjectDiablo.dll # Main Project D2 modifications
        ├── PD2_EXT.dll     # Project D2 extensions
        ├── BH.dll          # BH maphack integration
        ├── Bnclient.dll    # Battle.net client mod
        ├── StormLib.dll    # MPQ archive library
        │
        ├── Game Data Archives:
        ├── d2gl.mpq        # D2GL graphics mod
        ├── D2MultiRes.mpq  # Multi-resolution support
        ├── patch_d2.mpq    # Game patches
        ├── pd2assets.mpq   # Project D2 assets
        ├── pd2data.mpq     # Project D2 data
        ├── pd2maps.mpq     # Project D2 maps
        ├── SGD2FreeRes.mpq # Resolution mod data
        ├── SlashDiabloHD.mpq # HD graphics pack
        ├── ver-IX86-1.mpq  # Version-specific data
        │
        ├── Configuration Files:
        ├── BH.json         # BH maphack settings
        ├── BH.json.bak     # BH settings backup
        ├── d2gl.json       # D2GL graphics settings
        ├── d2gl.yaml       # D2GL YAML config
        ├── ddraw.ini       # DirectDraw settings
        ├── D2HD.ini        # HD graphics settings
        ├── default.filter  # Default item filter
        ├── loot.filter     # Loot filter settings
        ├── local_metadata.json # File integrity checksums
        ├── ProjectDiablo.cfg # Project D2 configuration
        ├── ProjectDiablo.json # Project D2 JSON config
        ├── ProjectDiablo.json.bak # Config backup
        ├── SGD2FreeResolution.json # Resolution settings
        ├── SGD2FreeRes.json # Resolution config
        └── UI.ini          # UI positioning configuration

File Categories

Essential Game Files

Base Diablo 2 Installation (in pd2/):

• *.mpq files - Original game data archives
• D2.LNG - Language support file

Project D2 Mod (in pd2/ProjectD2/):

• Game.exe - Modified game executable
• D2*.dll - Core game libraries
• ProjectDiablo.dll - Main mod functionality
• Modified *.mpq files - Mod-specific content

Enhancement Files

• BH.dll - BH maphack integration
• SGD2FreeRes.mpq + SGD2FreeResolution.json - Resolution mod
• WebView2Loader.dll - Modern web integration

Configuration Files

• UI.ini - Interface positioning
• SGD2FreeResolution.json - Display settings

Environment Variables

Ports

Game Launch Parameters

The game is launched with the following parameters:

wine Game.exe -ns -3dfx

• -ns: No splash screen
• -3dfx: Enable 3dfx graphics acceleration

Desktop Integration

The container creates desktop shortcuts and menu entries:

• Desktop Shortcut: /root/Desktop/Diablo2.desktop
• Fluxbox Menu: Right-click desktop to access game launcher
• Applications Menu: Available in /root/.local/share/applications/

Troubleshooting

Common Issues

1. Game won't start:

   • Check if game files exist in pd2/ProjectD2/
   • Verify Wine initialization completed successfully
   • Check container logs for error messages

2. VNC connection failed:

   • Ensure port 5901 is not blocked by firewall
   • Try connecting to 0.0.0.0:5901 instead of localhost:5901

3. Resolution issues:

   • Modify SGD2FreeResolution.json for different resolutions
   • Adjust Xvfb resolution in start_diablo2.sh

4. Performance issues:

   • Try different Wine D3D renderer settings
   • Adjust container resource limits in docker-compose.yml

Debug Commands

Access the running container:

docker exec -it diablo2_container /bin/bash

Check running processes:

docker exec diablo2_container ps aux

View logs:

docker-compose logs diablo2

Development

Adding New Features

1. Memory Monitoring: Extend diablo2_monitor.py
2. MCP Server: Modify diablo2_mcp_server.py
3. Game Configuration: Update config files in pd2/ProjectD2/

Custom Resolutions

To use different resolutions:

1. Update SGD2FreeResolution.json:

   "Ingame Resolutions": ["1920x1080"]
   

2. Modify Xvfb in start_diablo2.sh:

   Xvfb $DISPLAY -screen 0 1920x1080x16 &
   

Security Notes

• VNC server runs without password (suitable for local development only)
• Container runs as root (consider non-root user for production)
• All ports are exposed (restrict in production environments)

License

This container setup is for educational and development purposes. Ensure you own legitimate copies of all game files.