A powerful level editor for Diablo II that allows creation and modification of game maps (.ds1 files) with comprehensive tileset support and systematic validation tools.
# Clone or download the project
cd DS1Edit
# Build the project
build.bat debug
# Run DS1Edit
bin\win_ds1edit_debug.exe- DS1 File Editing: Create and modify Diablo II level files
- Multi-Act Support: Full support for Acts 1-5 including Expansion content
- Tileset Management: Comprehensive tileset validation and organization
- Visual Editor: Graphical interface for map editing
- Asset Management: Organized handling of game assets and resources
- Systematic Testing: Individual DS1 file validation with error reporting
- Automated INI Generation: Python scripts for configuration file creation
- Batch Processing: Scripts for bulk operations and testing
- Debug Mode: Enhanced logging and error checking capabilities
- Act 1: Cave, Catacombs, Monastery areas
- Act 2: Desert, Tomb, Maggot Lair areas
- Act 3: Jungle, Kurast, Spider, Temple, Mephisto areas
- Act 4: Mesa, Lava, Fortress, Diablo areas
- Act 5: Siege, Barricade, Ice Cave areas
- Operating System: Windows 10/11
- Compiler: Microsoft Visual Studio 2019+ or MSVC Build Tools
- Dependencies: Allegro 4.4.3.1 (included)
- Optional: Python 3.x for utility scripts
-
Clone the Repository
git clone [repository-url] cd DS1Edit -
Build the Project
# Debug build (recommended for development) build.bat debug # Release build (optimized) build.bat release
-
Verify Installation
# Check if build was successful bin\win_ds1edit_debug.exe --version
-
Launch DS1Edit
bin\win_ds1edit_debug.exe [mapfile.ds1] [tileset] [def_value] -
Load a Map
- Use File → Open to load existing .ds1 files
- Navigate to
assets/tiles/for example maps
-
Edit Maps
- Use the tile palette to place tiles
- Modify layers (floor, wall, shadow, etc.)
- Save changes with File → Save
-
Test Individual Areas
# Test Act 3 clearing areas scripts\batch\test_clearing_lines.bat # Test Act 4 mesa areas scripts\batch\test_mesa_lines.bat
-
Generate Configuration Files
python scripts\python\generate_level_inis.py
- Main Config:
config/Ds1edit.ini- Primary DS1Edit settings - Area Configs:
assets/*.ini- DS1 file lists for each game area - Tilesets: Organized by Act in
assets/tiles/
DS1Edit/
├── 📁 assets/ # Game assets and DS1 configuration files
│ ├── excel/ # Game data (LvlPrest.txt)
│ ├── tiles/ # DS1 files organized by Act
│ └── *.ini # Area configuration files
├── 📁 bin/ # Compiled executables
├── 📁 build/ # Build artifacts
├── 📁 config/ # Configuration files
├── 📁 docs/ # Comprehensive documentation
├── 📁 logs/ # Debug output and error logs
├── 📁 media/ # Screenshots and graphics
├── 📁 scripts/ # Development and utility scripts
├── 📁 Sources/ # C/C++ source code
└── 📁 third_party/ # External libraries (Allegro)
-
Setup Development Environment
- Install Visual Studio 2019+ with C++ support
- Ensure Windows SDK is available
- Python 3.x for utility scripts (optional)
-
Build Configuration
# Debug build with full logging build.bat debug # Release build optimized build.bat release # Clean all build artifacts scripts\batch\clean.bat
-
Testing Framework
# Test all areas systematically scripts\batch\test_*_lines.bat # Generate test reports python scripts\python\test_ini.py
- Core Editor:
Sources/- Main DS1Edit application code - MPQ Support:
Sources/mpq/- Archive file handling - Build System:
scripts/batch/- Build and test scripts - Utilities:
scripts/python/- File generation and management
- Make Changes: Edit source files in
Sources/ - Build: Run
build.bat debug - Test: Use test scripts to validate changes
- Debug: Check
logs/for error output - Commit: Use organized git structure
- 📖 Getting Started - Installation and first steps
- 🎓 Tutorials - Step-by-step guides
- 🔧 Advanced Guides - In-depth topics
- 💡 Examples - Sample projects and maps
- 📋 API Reference - Technical documentation
- Individual file testing with error classification
- Exit code analysis (0=success, 1/3=various errors)
- Automated generation of working file lists
- Comprehensive error reporting
- Act 1: Tileset 2 (Cave), 4 (Catacombs), 5 (Monastery)
- Act 2: Tileset 18 (Maggot), 10 (Desert), 12 (Tomb)
- Act 3: Tileset 21 (Jungle), 20 (Town), 22 (Temple), 23 (Spider)
- Act 4: Tileset 27 (Mesa), 28 (Lava), 29 (Diablo)
- Act 5: Tileset 30 (Siege), 31 (Barricade), 35 (Ice)
- Act 2 Maggot: 2/40 files compatible (act number issues)
- Act 3 Clearing: 90/90 files working (100% success)
- Act 3 Kurast: 85 files covering urban areas
- Act 3 Mephisto: 55 files for boss encounters
- Act 4 Mesa: 42/145 files working (core areas functional)
- Act 4 Lava: 43/45 files working (95.6% success)
- Act 5 Siege: 15/55 files working (core strips functional)
- Fork the Repository
- Create Feature Branch:
git checkout -b feature/new-feature - Make Changes: Follow existing code style
- Test Changes: Run test scripts to validate
- Update Documentation: Add/update relevant docs
- Submit Pull Request: Include description of changes
- Use descriptive commit messages
- Test all changes with validation scripts
- Update documentation for new features
- Follow existing project organization
This project is open source. Please refer to the LICENSE file for details.
- Built using Allegro 4.4.3.1 game development library
- Based on Diablo II file format specifications
- Community contributions for tileset validation and testing
DS1Edit - Professional Diablo II Level Editor with Comprehensive Validation and Multi-Act Support