git404hub

what is seam-ripper fr?

leonmustdie/seam-ripper — explained in plain English

Analysis updated 2026-05-18

3PythonAudience · developerComplexity · 3/5Setup · moderate

tl;dr

A modding toolkit for the Xbox 360 Naughty Bear games that lets you edit scripts, textures, meshes, audio, and text inside the game's own file format.

vibe map

mindmap
  root((Seam Ripper))
    What it does
      Edit Lua scripts
      Extract textures and meshes
      Extract audio
      Edit localization text
    Tech stack
      Python
      PySide6
      Java for decompiling
    Use cases
      Mod Naughty Bear games
      Extract game assets
      Edit gameplay logic
    Audience
      Game modders
      Retro console fans

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Extract and edit the gameplay Lua scripts inside Naughty Bear game files and reinject them.

VIBE 2

Convert the game's textures and 3D meshes into common formats like PNG, DDS, OBJ, and GLB.

VIBE 3

Edit subtitle and localization text and repack it into the original game containers.

VIBE 4

Bulk dump all assets from Naughty Bear: Panic in Paradise files in one step.

what's the stack?

PythonPySide6PillowJava

how it stacks up fr

leonmustdie/seam-ripper0marildo/imago0xdfi/glm-5.2-1m-4x-dgx-spark
Stars333
LanguagePythonPythonPython
Setup difficultymoderateeasyhard
Complexity3/52/55/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Java for one of the Lua decompiling backends and your own legally dumped game files.

in plain english

Seam Ripper is a modding toolkit for two Xbox 360 games, Naughty Bear and Naughty Bear: Panic in Paradise. It works with these games' own resource container files, called .lu files, letting you read and write them directly. With it you can pull out the Lua scripts that control gameplay, edit them, and put them back into the game files. You can also extract and edit subtitle and localization text, convert the games' textures into common image formats like PNG or DDS, convert 3D meshes into OBJ or GLB files, and pull out sound banks and audio streams. The tool comes as a tabbed graphical program, built on top of a set of separate command line tools that do the actual work. The graphical interface does not duplicate any logic itself, it simply runs the same scripts you could run yourself from a terminal, so both approaches behave identically. Note that the toolkit only works on game files you extract from your own legally owned copy of the games, since no game assets or code are included in this project. The main editing loop works like this: pick a game file, list the Lua script chunks inside it, double click one to see its decompiled code, edit the function bodies, then click Ship to rebuild that chunk. Ship only recompiles the functions you actually changed and leaves everything else untouched, and it refuses to ship a function it cannot decompile reliably rather than risk breaking the game. For Panic in Paradise specifically, the toolkit understands that game's newer container format alongside the older shared archives, and includes a one button bulk export of textures, character models, scripts, audio, localized text, and interface graphics, all verified by the author to work correctly when reinjected into a real retail Xbox 360 console. To run it from source you need Python along with PySide6 and Pillow, and Java is required for one of the Lua decompiling backends. A prebuilt release version bundles Python and its dependencies together so no separate installation is needed, though Java is still required.

prompts (copy fr)

prompt 1
Help me install Seam Ripper from source with PySide6, Pillow, and Java, and explain what each dependency is for.
prompt 2
Walk me through using Seam Ripper's Lua Code tab to decompile, edit, and reship a single function.
prompt 3
Explain how Seam Ripper's Ship feature avoids breaking a game file when it edits a script.
prompt 4
Show me how to use pip_dump.py to bulk extract everything from a Panic in Paradise file.

Frequently asked questions

what is seam-ripper fr?

A modding toolkit for the Xbox 360 Naughty Bear games that lets you edit scripts, textures, meshes, audio, and text inside the game's own file format.

What language is seam-ripper written in?

Mainly Python. The stack also includes Python, PySide6, Pillow.

How hard is seam-ripper to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is seam-ripper for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.