https://github.com/cleder/map-yaac-2-brkrs
https://github.com/cleder/map-yaac-2-brkrs
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/cleder/map-yaac-2-brkrs
- Owner: cleder
- License: mit
- Created: 2025-11-27T16:46:03.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-12-07T15:23:30.000Z (6 months ago)
- Last Synced: 2026-02-13T09:02:56.220Z (4 months ago)
- Language: Rust
- Size: 85.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Map Converter
This project contains a tool to convert the custom binary map format `map100.map` into a human-readable RON (Rusty Object Notation) file.
## Prerequisites
- [Rust](https://www.rust-lang.org/tools/install) (latest stable version)
## Usage
1. Navigate to the `map_parser` directory:
```sh
cd map_parser
```
2. Run the converter with the input file as an argument:
```sh
cargo run --
```
Example:
```sh
cargo run -- ../map100.map
```
This will read `../map100.map` and generate `../map100.map.ron`.
The output filename is automatically derived by appending `.ron` to the input filename.
## Input Format (Binary)
The input file is a binary format with the following structure:
### File Header
- **Magic**: 4 bytes (e.g., "MAP\0")
- **Count**: `u32` (Little Endian) - number of levels in the file
### Level Entry (432 bytes each)
Repeated `Count` times.
- **Name Length**: `u8` (length of the name string)
- **Name**: String bytes (`Name Length` bytes)
- **Padding**: Skips to byte offset 16 (relative to start of entry)
- **Width**: `u32` (Little Endian)
- **Height**: `u32` (Little Endian)
- **Area**: `u32` (Little Endian)
- **ID**: `u32` (Little Endian)
- **Data**: 400 bytes (20x20 grid, row-major)
## Output Format
Each level is stored as a separate RON file.
These files are named `level_001.ron`, `level_002.ron`, etc.
The output files are stored in the `levels` directory.
Fields
- `number: u32` — level index/identifier must match the filename `level_{:03}.ron`.
- `gravity: Option<(f32,f32,f32)>` — optional gravity override for the level (X, Y, Z). The Z component is always 0. Levels with Light Gravity (5G) have gravity (2.0, 0.0, 0.0). Levels with Normal Gravity (10G) have gravity (10.0, 0.0, 0.0). Levels with heavy gravity (20G) have gravity (20.0, 0.0, 0.0). Levels with Queer Gravity have gravity (-1.0, -0.5, 0.0). Levels with Zero Gravity have gravity (0.0, 0.0, 0.0).
- `matrix: Vec>` — the tile grid, encoded as rows of byte values.
- `description: Option` — level design documentation, here always `YAAC ` followed by the level name and the gravity description.
- `author: Option` — contributor attribution here always `Christian Ledermann`.
```ron
LevelDefinition(
number: 1,
description: Some("YAAC - {name} - {gravity}"),
author: Some("Christian Ledermann"),
gravity: Some((10.0, 0.0, 0.0)),
matrix: [
// 20 rows of 20 u8 values each (outer vector = rows)
[0,0,0,...],
...
],
)
```