docker-pd2

bethington/docker-pd2

3.1

If you are the rightful owner of docker-pd2 and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Project Diablo 2 Docker Container provides a comprehensive environment for running Project Diablo 2 with integrated VNC remote access, memory monitoring, and MCP server capabilities for AI assistance.

Tools
1
Resources
0
Prompts
0

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

VariableDefaultDescription
WINEPREFIX/root/.wineWine installation directory
WINEARCHwin32Wine architecture (32-bit)
WINEDEBUG-allDisable Wine debug messages
DISPLAY:1X11 display number

Ports

PortServiceDescription
5901VNCRemote desktop access
8080Web VNCOptional web-based VNC
3000Health CheckContainer health endpoint
8765MCP ServerAI integration endpoint

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.