xesf / ray1map

Ray1Map

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				Currently only supports cutscene maps, localization & block exports
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 2020.3.19f1 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:

• BinarySerializer (Assets\Scripts\Libraries\BinarySerializer)
• BinarySerializer.Audio (Assets\Scripts\Libraries\BinarySerializer.Audio)
• BinarySerializer.Image (Assets\Scripts\Libraries\BinarySerializer.Image)
• BinarySerializer.Ray1 (Assets\Scripts\Libraries\BinarySerializer.Ray1)
• BinarySerializer.Klonoa (Assets\Scripts\Libraries\BinarySerializer.Klonoa)
• BinarySerializer.GBA (Assets\Scripts\Libraries\BinarySerializer.GBA)
• BinarySerializer.GBA.Audio (Assets\Scripts\Libraries\BinarySerializer.GBA.Audio)
• BinarySerializer.PS1 (Assets\Scripts\Libraries\BinarySerializer.PS1)
• BinarySerializer.PS2 (Assets\Scripts\Libraries\BinarySerializer.PS2)

Screenshots

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.