Skip to content

Replanetizer is a Level Editor for the Ratchet & Clank HD collection.

License

Notifications You must be signed in to change notification settings

RatchetModding/Replanetizer

Repository files navigation

Logo

Replanetizer

Level Editor for the Ratchet and Clank Collection on PS3

FeaturesUsageBuildingTechnologyLicensingContributing

Preview

Features

Replanetizer is still in an early state of development. Its feature set entails:

  • Visualization
    • Level objects
    • Collision
    • Splines
    • Triggers
  • Editing
    • Transformation of level objects
    • Manipulation of variables
  • Export
    • Textures (.png, .jpg, .bmp)
    • Rigged models including animations (.gltf, .dae, .obj)
    • Level as a model (.obj)
    • Collision (.obj)
  • Live inspection of a game running in emulator (RPCS3)

Support for Ratchet Deadlocked is available but low priority.

If you are looking for a level editor for the PS2 versions of the games, use Wrench instead.

Binaries

You can find prebuilt binaries of Replanetizer in the releases section:

Usage

First you need to unpack the game's files so that Replanetizer can access it. These files are packed in a file called PS3Arc.psarc. If you have the game installed in RPCS3, you can find the PS3Arc.psarc of Ratchet and Clank 1 (NPEA00385) in [RPCS3 Directory]/dev_hdd0/game/NPEA00385/USRDIR/rc1/ps3data. You can unpack this file using tools like PSArc-cl. It is recommended to not change the folder structure of the PS3Arc.psarc contents after unpacking as Replanetizer may otherwise fail to find certain files.

To load a level, start Replanetizer and use File -> Open, then select a engine.ps3 file inside one of the level folders.

To apply changes to the game, you need to either repack the files into a .psarc file or use an incomplete .psarc file. Any file missing in a .psarc file will be loaded from the correspondent location outside the .psarc file.

You can move around the world with keyboard and mouse:

  • WASD to move camera inside the world. Hold shift to speed up movement
  • Left click items to select them
  • Rotate the camera by holding the right mouse button down and moving your mouse

If your computer has both a dedicated and an onboard GPU, make sure to use the dedicated GPU. On Windows with a dedicated Nvidia GPU, you can do this by right clicking on Replanetizer.exe and selecting "Run with graphics processor" -> "High performance NVIDIA processor".

Building

Dependencies:

  • .NET 6 tooling (dotnet host, runtime, sdk and targeting pack)
  • For Linux (and maybe other Unixes):
    • Zenity (or KDialog if you prefer KDE dialogs)
    • Basic OpenGL dependencies (most of these will be installed if you run any form of GUI).
  • Refer to the READMEs of our NuGet dependencies for more information if you get stuck.

To get started, clone this repository, and execute the following command:

  • dotnet run -p Replanzetier

Alternatively, open Replanetizer.sln in your favourite IDE, and use its tooling instead.

Technology

The project is written in C#, and uses OpenTK4 for rendering. C# bindings for Dear ImGui are used for the UI.

We currently target .NET 6 (net6.0-windows for the Windows builds, net6.0 on anything else). We use SixLabors.ImageSharp instead of System.Drawing for cross-platform compatibility.

OpenGL 3.3 is used for the rendering.

Licensing

Replanetizer is Copyright (C) 2018-2024, The Replanetizer Contributors.

Replanetizer is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. Please see the LICENSE.md file for more details.