/Replanetizer

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

Primary LanguageC#GNU General Public License v3.0GPL-3.0

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

Support for Ratchet Deadlocked is available but low priority.

Usage

Extract a .psarc file from a game using seperate tools (PSArcTool.exe for example). Use File -> Open, and select a engine.ps3 file inside a level folder. It is recommended to keep the folder structure present in the .psarc file.

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

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-2023, 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.