RybaGameLevelEditor is a Unity-based level editor that allows creating game levels by drawing the map as a pixel-based image. Each pixel represents a single tile, and its color (RGBA) encodes the tile type, rotation, and power.

This editor is designed to provide:

• an intuitive level creation workflow,
• editable maps both within the editor and in standard image editors,
• a clear, lossless level data format.

Overview

• Level = Texture2D
• 1 pixel = 1 map tile
• RGB channels → tile type
• Alpha channel → additional data (rotation and power)

The editor can generate a level from the drawn image, save it as a project, and export the map in formats readable by the game.

Features

Tools

• Brush – draw tiles with a selected type, power, and rotation
• Eraser – remove tiles and reset to default
• Displacer – move sections of the map
• Pipette – sample tile data from the map

Navigation

• zoom in/out with mouse scroll
• move the map using mouse drag or scroll
• automatic fit-to-view scaling

Editing

• visible grid overlay
• pixel pointer indicator
• real-time tile info display (position, type, power, rotation)

Undo/Redo

• full history support for all actions
• multi-pixel operations supported
• displacer movement correctly handled in history

Project & Map Saving

Map Export

Supported image formats:

• PNG
• QOI

Use lossless formats only to ensure exact color data. Avoid anti-aliasing, color correction, and lossy compression.

Project Save (.lep)

The editor provides a binary project format which stores:

• map dimensions
• only modified tiles (optimized storage)
• metadata (date, editor version, format version)
• file integrity check using magic bytes

Project files allow:

• resuming work safely
• versioned compatibility checks
• fast loading and saving of large maps

The detailed documentation for project file format is available here:

LEP File Format (.lep)

Level Data Encoding (RGBA)

The detailed documentation for tile encoding is available here:

Level Data Storage Using Colors (RGBA)

Summary:

• RGB channels: tile ID (Tile Type)

• Alpha channel (8 bits):

  • 6 bits → power (0–63, inverted logic)
  • 2 bits → rotation (0–3, 90° increments)

This ensures:

• visually readable levels,
• precise and unambiguous data,
• editable levels in external image editors.

Release Info & Tags

Release: v1.0.5

Release Notes:

• Added tool keybindings
• Added undo and redo shortcuts
• Added tooltips
• Added different pointer indicators for tools
• Fixed bug with non-rectangular maps
• Fixed bug when reading rotation from project files
• Introduced project format v3 (smaller files with backward compatibility)

Tags: Unity, Tool, Level Editor, Tile Map, Tile Map Editor, Pixel Art, Game Development, QOI

Technologies

• Unity
• C#
• Texture2D for pixel-perfect rendering
• Unity UI for interactions
• Command pattern for undo/redo system

Used Libraries

This project uses the following third-party libraries:

• PoiPoiTooltip – provides lightweight, contextual tooltips used throughout the editor UI.
• DOTween (HOTween v2) – a fast and flexible tweening engine used for UI animations and smooth transitions.
• NaughtyAttributes – adds useful attributes that enhance the Unity Inspector and simplify editor scripting.
• UI Number Input - provides numeric input fields with validation, increment/decrement controls, and improved usability.
• UnityStandaloneFileBrowser – enables native file open and save dialogs across supported platforms.
• UnityNativeDialog – used for displaying native system message dialogs (alerts, confirmations, errors).
• Unity.QOI – used for exporting maps to the lossless QOI image format.

File Format Documentations

• LEP File Format (.lep)
• Level Data Storage Using Colors (RGBA)

Notes

• Tile colors must be exact, without interpolation or lossy compression.
• Using a prepared color palette for designers is recommended.
• The editor and format are designed for further extensibility.