{"id":31556270,"url":"https://github.com/wal33d/vscode-manic-miners","last_synced_at":"2026-05-17T17:02:47.866Z","repository":{"id":305469233,"uuid":"1022927771","full_name":"Wal33D/vscode-manic-miners","owner":"Wal33D","description":"VSCode extension for Manic Miner .dat level files - syntax highlighting, IntelliSense, and development tools","archived":false,"fork":false,"pushed_at":"2025-07-20T21:06:26.000Z","size":3531,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-20T21:10:48.566Z","etag":null,"topics":["game-development","intellisense","level-editor","manic-miner","syntax-highlighting","typescript","vscode-extension"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=waleedjudah.manic-miners-dat","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Wal33D.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-20T06:35:16.000Z","updated_at":"2025-07-20T21:06:30.000Z","dependencies_parsed_at":"2025-07-20T21:11:17.993Z","dependency_job_id":"c4d8721b-2083-407a-990f-54adf0002867","html_url":"https://github.com/Wal33D/vscode-manic-miners","commit_stats":null,"previous_names":["wal33d/manic_vscode_extension","wal33d/vscode-manic-miners"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Wal33D/vscode-manic-miners","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wal33D%2Fvscode-manic-miners","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wal33D%2Fvscode-manic-miners/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wal33D%2Fvscode-manic-miners/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wal33D%2Fvscode-manic-miners/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Wal33D","download_url":"https://codeload.github.com/Wal33D/vscode-manic-miners/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wal33D%2Fvscode-manic-miners/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278386110,"owners_count":25978109,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["game-development","intellisense","level-editor","manic-miner","syntax-highlighting","typescript","vscode-extension"],"created_at":"2025-10-04T22:51:17.688Z","updated_at":"2025-10-04T22:51:18.678Z","avatar_url":"https://github.com/Wal33D.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Manic Miner DAT File Support for Visual Studio Code\n\n[![CI](https://github.com/Wal33D/vscode-manic-miners/actions/workflows/ci.yml/badge.svg)](https://github.com/Wal33D/vscode-manic-miners/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Version](https://img.shields.io/visual-studio-marketplace/v/Wal33D.manic-miners-dat)](https://marketplace.visualstudio.com/items?itemName=Wal33D.manic-miners-dat)\n\nA comprehensive Visual Studio Code extension providing full language support, visual editing tools, and advanced analysis for Manic Miner `.dat` level files. Create, edit, and optimize game levels with professional development tools.\n\n![Manic Miner DAT Map Editor](images/extension-screenshot-example.png)\n\n## Features\n\n### 🎨 Syntax Highlighting\nFull syntax highlighting for all DAT file sections including:\n- `info` - Level metadata and configuration\n- `tiles` - Tile layout data (supports tiles 1-165)\n- `height` - Height map information\n- `resources` - Crystal and ore placement\n- `objectives` - Level goals with multiple types\n- `buildings`, `vehicles`, `creatures`, `miners` - Entity placement\n- `script` - Advanced event-driven scripting with syntax highlighting\n- `blocks` - Visual scripting support\n- And more!\n\n### 💡 IntelliSense Support\n- **Auto-completion** for field names within the `info` section\n- Context-aware suggestions for faster editing\n- Reduces typos and improves productivity\n\n### 📖 Hover Information\n- Detailed descriptions for all `info` section fields\n- Explains what each field controls\n- Special support for camera position components\n\n### 🗺️ Visual Map Preview\n- Real-time visual representation of your level\n- Zoom controls (25% to 400%) and tile information on hover\n- Click tiles to jump to their location in the editor\n- Multi-tile selection with Shift+drag\n- Toggle grid lines and tile IDs\n- Full keyboard navigation and shortcuts\n- Performance optimized for large maps\n\n### ⚡ Quick Actions\n- Convert tiles between normal and reinforced variants\n- Replace tiles with common types\n- Fill areas and replace all instances of a tile type\n- Context-sensitive actions in the tiles section\n- Custom tile sets for frequently used combinations\n- Save and reuse your favorite tile patterns\n- Smart tile suggestions based on surrounding context\n\n### 🎯 Objective Builder\n- Visual interface for creating level objectives\n- Support for all objective types (resources, buildings, discovery, etc.)\n- Real-time preview of objective syntax\n- Parameter validation and helpful examples\n- Analyze existing objectives with detailed reports\n- Convert between objective formats easily\n\n### 🔍 Map Validation\n- Advanced pathfinding analysis\n- Resource accessibility checks\n- Objective validation\n- Real-time diagnostics with inline errors and warnings\n- Auto-fix support for common issues\n- Comprehensive validation reports\n\n### 📝 Map Templates\n- Pre-built templates for common level patterns\n- Create custom templates from selection\n- Manage and organize your template library\n- Quick insertion with customizable parameters\n\n### 🔄 Undo/Redo System\n- Sophisticated undo/redo for map operations\n- Visual preview before applying changes\n- History tracking (50 operations per file)\n- Survives file saves\n- Status bar integration\n\n### 📊 Heat Map Analysis\n- Visualize pathfinding and traffic patterns\n- Identify bottlenecks and optimize routes\n- Multiple analysis modes (traffic, accessibility, chokepoints)\n- Statistical insights and hotspot detection\n\n### 🔒 Version Control\n- Track map changes over time\n- Visual diff between versions\n- Restore previous versions\n- Git-like versioning system\n- Commit messages and history\n\n### ♿ Accessibility Features\n- Full screen reader support\n- High contrast mode\n- Keyboard-only navigation\n- ARIA labels for all UI elements\n- Accessible map descriptions\n\n### 🔧 Language Configuration\n- Comment support (line `//` and block `/* */`)\n- Auto-closing pairs for brackets and quotes\n- Smart indentation\n- Go-to-definition for references\n- Find all references for entities\n\n## Installation\n\n### From VS Code Marketplace\n1. Open VS Code\n2. Press `Ctrl+P` / `Cmd+P` to open the Quick Open dialog\n3. Type `ext install manic-miners.dat`\n4. Click Install\n\n### From VSIX Package\n1. Download the `.vsix` file from [Releases](https://github.com/Wal33D/vscode-manic-miners/releases)\n2. Open VS Code\n3. Press `Ctrl+Shift+P` / `Cmd+Shift+P`\n4. Type \"Install from VSIX\" and select the command\n5. Choose the downloaded `.vsix` file\n\n## Usage\n\n### Basic Usage\n1. Open any `.dat` file in VS Code\n2. The extension automatically activates for Manic Miner level files\n3. Start typing in an `info` block to see auto-completion\n4. Hover over field names to see descriptions\n\n### Example\n```dat\ninfo{\n    rowcount: 25        // Hover to see: \"Number of rows in the map\"\n    colcount: 25        // Hover to see: \"Number of columns in the map\"\n    biome: rock         // Hover to see: \"The biome type of the map\"\n    // Type here to see auto-completion suggestions\n}\n```\n\n## Supported Fields\n\nThe extension currently provides IntelliSense for these `info` section fields:\n\n| Field | Description |\n|-------|-------------|\n| `rowcount` / `colcount` | Map dimensions |\n| `camerapos` | Camera position with Translation, Rotation, and Scale |\n| `biome` | Map biome type (rock, ice, lava) |\n| `creator` | Level creator name |\n| `levelname` | Name of the level |\n| `oxygen` | Oxygen levels |\n| `gravity` | Gravity setting |\n| And many more... |\n\n## Configuration\n\nThis extension works out of the box with no configuration required. Future versions may add customizable settings.\n\n## Documentation\n\n- 📖 [User Guide](docs/USER_GUIDE.md) - Comprehensive guide to all features\n- 🛠️ [Developer Guide](docs/DEVELOPER_GUIDE.md) - Setup and contribution guidelines\n- 📄 [DAT Format Reference](docs/DAT_FORMAT.md) - Complete file format specification\n- 🎮 [Tile Reference](docs/reference/TILE_REFERENCE.md) - All tile IDs and properties\n\n## Documentation\n\n- [DAT File Format Guide](docs/DAT_FORMAT.md) - Complete format reference\n- [Advanced Scripting Guide](docs/ADVANCED_SCRIPTING.md) - In-depth scripting patterns\n- [User Guide](docs/USER_GUIDE.md) - How to use the extension\n- [Developer Guide](docs/DEVELOPER_GUIDE.md) - Contributing and development\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n### Development Setup\n1. Clone the repository\n2. Run `npm install`\n3. Open in VS Code\n4. Press `F5` to run the extension in a new VS Code window\n\nSee the [Developer Guide](docs/DEVELOPER_GUIDE.md) for detailed instructions.\n\n## Known Issues\n\n- Large maps (200x200+) may experience slight performance lag in preview\n- Some advanced script commands may not have full IntelliSense support\n\n## Release Notes\n\nSee [CHANGELOG.md](CHANGELOG.md) for detailed release notes.\n\n### Latest Release\n\nMajor features include:\n- **Visual Map Preview** with zoom, multi-selection, and keyboard controls\n- **Heat Map Analysis** for pathfinding and traffic visualization\n- **Version Control** with visual diff and history tracking\n- **Accessibility Features** including screen reader and high contrast support\n- **Smart Tile Suggestions** based on context analysis\n- **Undo/Redo System** with visual preview\n- **Objective Builder** interface for creating level objectives\n- **Map Validation** with pathfinding analysis and auto-fix\n- **Quick Actions** for tile manipulation and custom tile sets\n- **Map Templates** system with custom template support\n\n### 0.2.5\n\n- Enhanced test coverage\n- Fixed TypeScript and ESLint errors\n- Added game asset images\n- Improved Phase 2 functionality\n\n### 0.0.1\n\nInitial release featuring:\n- Basic syntax highlighting for DAT files\n- IntelliSense for `info` section fields\n- Hover information provider\n- Language configuration\n\n## Roadmap\n\n### Completed ✅\n- Extend IntelliSense to all sections\n- Add validation and diagnostics\n- Implement code snippets\n- Add level preview functionality\n- Support for go-to-definition\n- Heat map visualization\n- Version control integration\n- Accessibility features\n- Smart tile suggestions\n- Undo/redo with preview\n\n### Completed Features ✨\n- 3D terrain preview with height visualization\n- Enhanced script syntax highlighting\n- Level generators for 5 game types\n- Support for all tile IDs (1-165)\n\n### In Development 🚧\n- Resource overlay visualization\n- Tile statistics panel\n- Map diff tool improvements\n- Minimap navigation\n- Performance profiler\n\n### Future Plans 📋\n- Auto-formatting support\n- Map export to image/PDF\n- Collaborative editing\n- AI-powered map generation\n- Tutorial mode\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- Thanks to the Manic Miners community for inspiration\n- Built with the [VS Code Extension API](https://code.visualstudio.com/api)\n\n---\n\n**Enjoy editing your Manic Miner levels!** 🎮⛏️","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwal33d%2Fvscode-manic-miners","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwal33d%2Fvscode-manic-miners","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwal33d%2Fvscode-manic-miners/lists"}