Skip to content

BinarySerializer/Ray1Map

Repository files navigation

Ray1Map

Logo

Ray1Map is a map viewer/editor by RayCarrot, Droolie, Ryemanni and Adsolution with special thanks to PluMGMK for helping out with the project. The goal of the project is to support map viewing for all tile-based Rayman games, with focus on the Rayman 1 games.

View maps in the web version of Ray1Map directly in your browser: https://raym.app/maps_r1/

Features

  • Tile viewing and editing
  • Collision viewing and editing
  • Object viewing and editing, including animations, object states and hitboxes
  • Object linking viewing and editing
  • Game tools for exporting assets
  • Memory loading, for allowing real-time editing while the game is running

Supported Games (Rayman 1)

Game Variants Map Viewing Object Adding Saving Notes
Rayman 1 (PS1 - US)
Rayman 1 (PS1 - EU)
Rayman 1 (PS1 - JP)
Rayman 1 (PS1 - JP Demo Vol3)
Rayman 1 (PS1 - JP Demo Vol6)
Rayman 1 (PS1 - EU Demo)
Rayman 1 (PS1 - US Demo)
Rayman 1 (Saturn) US, EU, JP, US Demo
Rayman 1 (Saturn - Prototype)
Rayman 1 (PC) 1.00, 1.10, 1.12, 1.20, 1.21, 1.21 JP, Demo1, Demo2
Rayman Gold (PC - Demo)
Rayman Designer (PC)
Rayman Mapper (PC)
Rayman by his Fans (PC)
Rayman 60 Levels (PC)
Rayman Educational (PC) EDU, QUIZ
Rayman Educational (PS1)
Rayman Ultimate (Pocket PC)
Rayman Classic (Mobile)
Rayman 1 (GBA) EU, US, EU Beta
Rayman 1 (DSi)
Rayman 2 (PS1 - Demo)

Supported Games (Rayman 1 Jaguar)

Game Variants Map Viewing Object Adding Saving Notes
Rayman 1 (Jaguar)
Rayman 1 (Jaguar - Prototype)
Rayman 1 (Jaguar - Demo)

Supported Games (SNES)

Game Variants Map Viewing Object Adding Saving Notes
Rayman (SNES - Prototype)

Supported Games (GBC)

Game Variants Map Viewing Object Adding Saving Notes
Rayman 1 (GBC) EU/US, JP
Rayman 1 (PalmOS) Color, Greyscale, Color Demo, Greyscale Demo
Rayman 1 (PocketPC) Portrait, Landscape, IPAQ, Portrait Demo, Landscape Demo, IPAQ Demo
Rayman 2 (GBC) EU, US
Donald Duck Goin' Quackers (GBC) EU, US
Mowgli's Wild Adventure (GBC) EU/US

Supported Games (GBA)

Game Variants Map Viewing Object Adding Saving Notes
Donald Duck Advance (GBA) EU, US
Crouching Tiger Hidden Dragon (GBA) EU, US, US Beta
Tom Clancy's Rainbow Six: Rogue Spear (GBA) EU, US
The Mummy (GBA) EU, US
Tomb Raider: The Prophecy (GBA) EU, US
Batman Vengeance (GBA) EU, US
Sabrina the Teenage Witch: Potion Commotion (GBA) EU, US
Rayman 3 (GBA) EU, US, EU Beta
Rayman 3 (GBA - US Prototype)
Rayman 3 (N-Gage)
Rayman 3 (DigiBlast)
Rayman 3 Mad Trax (GBA) EU, US
Splinter Cell (GBA) EU, US, EU Beta
Splinter Cell (N-Gage)
Prince of Persia: The Sands of Time (GBA) EU, US
Batman: Rise of Sin Tzu (GBA) US
Splinter Cell: Pandora Tomorrow (GBA) EU, US
Star Wars Trilogy: Apprentice of the Force (GBA) EU, US
Star Wars Episode III: Revenge of the Sith (GBA) EU, US
King Kong (GBA) EU, US
Open Season (GBA) EU 1, EU 2, US
TMNT (GBA) EU, US
Surf's Up (GBA) EU 1, EU 2, US

Supported Games (Isometric GBA)

Game Variants Map Viewing Object Adding Saving Notes
Spyro: Season of Ice (GBA) EU, US, JP Not all objects show, not all sprites have palettes
Spyro 2: Season of Flame (GBA) EU, US
Spyro: Attack of the Rhynocs (GBA) EU, US
TRON 2.0: Killer App (GBA) EU, US Obj type graphics have not been assigned
Rayman Hoodlums' Revenge (GBA) EU, US

Supported Games (RRR GBA)

Game Variants Map Viewing Object Adding Saving Notes
Rayman Raving Rabbids (GBA) EU, US

Supported Games (GBA Vicarious Visions)

Game Variants Map Viewing Object Adding Saving Notes
Crash Bandicoot: The Huge Adventure (GBA) EU, US, JP
The Powerpuff Girls: Him and Seek (GBA) EU, US Obj type graphics have not been assigned
Frogger Advance: The Great Quest (GBA) EU, US Obj type graphics have not been assigned
SpongeBob SquarePants: Revenge of the Flying Dutchman (GBA) EU/US, US Beta Obj type graphics have not been assigned
The Muppets: On with the Show! (GBA) EU/US
Spy Muppets: License to Croak (GBA) EU/US
Crash Bandicoot 2: N-Tranced (GBA) EU, US, JP
Bruce Lee: Return of the Legend (GBA) EU, US Obj type graphics have not been assigned
X2: Wolverine's Revenge (GBA) EU/US Obj type graphics have not been assigned
Finding Nemo (GBA) EU/US, JP Obj type graphics have not been assigned
The Lion King 1 ½ (GBA) EU, US Obj type graphics have not been assigned
Brother Bear (GBA) EU, US Obj type graphics have not been assigned
SpongeBob SquarePants: Battle for Bikini Bottom (GBA) EU, US Obj type graphics have not been assigned
Crash Nitro Kart (GBA) EU, US, JP
Crash Nitro Kart (N-Gage)
Crash Bandicoot Purple: Ripto's Rampage (GBA) EU, US, JP
Spyro Orange: The Cortex Conspiracy (GBA) EU, US 1, US 2, JP
Shark Tale (GBA) EU/US, JP
That's so Raven (GBA) EU/US
Shrek 2 (GBA) EU/US Obj type graphics have not been assigned
Shrek 2: Beg for Mercy (GBA) EU/US
Codename: Kids Next Door - Operation S.O.D.A. (GBA) US Obj type graphics have not been assigned
Madagascar (GBA) EU, US, JP
Batman Begins (GBA) EU/US
Ultimate Spider-Man (GBA) EU, US
Madagascar: Operation Penguin (GBA) EU/US
Over the Hedge (GBA) EU, US Obj type graphics have not been assigned
Over the Hedge: Hammy Goes Nuts! (GBA) EU, US Obj type graphics have not been assigned
Spider-Man 3 (GBA) EU, US
Shrek the Third (GBA) EU, US Obj type graphics have not been assigned

Supported Games (Gameloft)

Game Map Viewing Object Adding Saving Notes
Rayman Raving Rabbids (Mobile)
Rayman Kart (Mobile)

Supported Games (GBA Klonoa)

Game Map Viewing Object Adding Saving Notes
Klonoa: Empire of Dreams (GBA)
Klonoa 2: Dream Champ Tournament (GBA)
Klonoa Heroes: Densetsu no Star Medal (GBA)

Supported Games (PS Klonoa)

Game Map Viewing Object Adding Saving Notes
Klonoa: Door to Phantomile (PS1 - Prototype 1997/07/17)
Klonoa: Door to Phantomile (PS1 - US)

Get Started

NOTE: This project is currently in its early stages and may be unstable. Saving edits may corrupt your files for certain games, so make sure to back up your files first!

  • Clone or download the repo.
  • Open the project with Unity (through Unity Hub). Version 2022.3.7f1 is recommended.
  • Open the Ray1Map settings from the toolbar and fill out the game directories.
  • Select the game mode and level.
  • Open the MapViewer scene.
  • Press play in Unity.

Editor tutorial (Rayman 1): https://github.com/Adsolution/Ray1Map/wiki/Editor-(tutorial)

If you download the repo as a zip folder the sub-modules won't be included, causing the project not to compile. To solve this, download the sub-module repos as well and place them in the specified folders:

Screenshots

Screenshot1 Screenshot2 Screenshot1

Attributions

For finding pointers in EXE files for memory loading, Ray1Map uses BinaryTools.Elf, Copyright (c) 2019 Filip Jeremic under the MIT Licence, and PE, Copyright (c) 2017 Kittyfisto under the MIT Licence.