TurboRipent

Turbocharged entity ripping

Features

This is a TUI frontend for Ripent and Lazyripent which allow you to extract and import BSP entity data files quickly and easily
Includes a basic entity editor for quick edits:

Extraction and Importing entity (.ent) files
Applying Lazyripent rules (.rule) files
Editor mode

Other Ripent available features such as:

Texture import/export
Print BSP statistics (.chart)
Print BSP extents information (.ext)

To get up to speed how to create a rule file, visit this page to get details on rule file syntax.

Installation

Download the application from the Releases section
Run the exe for initial setup, this will search for your Sven Co-op game install.
Intial setup will save a config file (TurboRipent_conf.json) inside %LOCALAPPDATA%\TurboRipent

The config file is in this structure:

{
  "RipentPath": "C:\\path\\to\\Ripent_x64.exe",
  "LazyripentPath": "C:\\path\\to\\lazyripent.exe",
  "Verbose": false,
    "DefaultEntity": {
    "angles": "0 0 0",
    "classname": "info_null",
    "origin": "0 0 0",
    "spawnflags": "0"
  }
}

If the application is finding trouble finding Ripent and Lazyripent, you can delete this config file and launch the application again to find their location. If the issue persists, try setting the paths manually, making sure to follow the format shown above.

Usage

You can launch the application directly where you will be presented with menu with choices
Dragging BSP files onto the executable file will automatically extract the entity data from them as .ent files.
Dragging ENT files onto the executable file will automatically import the entity data into the corresponding BSP files, if those BSP files exist in the same folder as the ENT files
Dragging a BSP file onto TurboRipent-Editor.cmd will launch the BSP in the editor. You can also run the cmd file as is - TurboRipent will ask for a BSP to edit.

Editor

With the built-in editor, it is possible to make quick entity edits to maps.
All of the entities in the BSP, represented by classnames, will be listed on the left in the entity list. These entities are selectable - when selecting one the entity's keyvalues are displayed in the box on the right and can be edited.
Entity keyvalues are formatted as such

key=value

Under the entity list is a box where you can filter for a key or value, and the list will update to show only the entities that contain any matches to the input.

Buttons:

Create: creates a new entity with the classname new_entity
Clone: makes a copy of the selected entity
Delete: deletes the selected entity
Save : saves changes and exits the editor

When closing the editor, via X, you will be prompted whether you want to confirm changes or not before exiting.

*The editor is a work-in-progress which is why its very primitive and basic with not very many functions. The aim is to replace outdated applications like EntEd or BSPEdit, where entity data is simply displayed in plain text which makes entmapping difficult and error prone. Extensive feedback and testing is required.

Building from Source

Prerequisites

Go toolchain installed (Go 1.25 or newer)
Ripent - Obtained from the Sven Co-op SDK from Steam
Lazyripent2 (not Lazyripent) - If this is missing the application will launch but applying .rules and the editor will not function.

Build Instructions

Download or clone the repository:

git clone https://github.com/Outerbeast/TurboRipent.git
cd TurboRipent

Run the build script:

Double-click build.cmd or run it manually:

build.cmd

The executable will be generated in the current directory.

License

See LICENSE for details.

Feedback & Issues

If you have feedback or encounter issues, please open an issue on GitHub Issues.

Thank you for using TurboRipent!

Credits

Outerbeast - Author
Garompa - Testing and feedback

Special thanks to Zode for creating Lazyripent

Outerbeast/TurboRipent