Leaderboard

Please see the official GitHub repo to get support and find updates: https://github.com/OldRepublicDevs/NCSDecomp NCSDecomp - Turn Your Compiled KOTOR Scripts Back Into Readable Code! Ever wanted to see what's inside those compiled .ncs script files from KOTOR? Or maybe you found a mod with scripts you want to understand or modify? NCSDecomp can take those compiled script files and turn them back into readable source code that you can actually understand and edit! What does it do? Simply put, NCSDecomp converts compiled KOTOR scripts (.ncs files) back into source code (.nss files). It's like having a translator that converts the game's internal script format back into human-readable code. Works with both KOTOR 1 and KOTOR 2! How to use: There are two ways to use NCSDecomp - a simple graphical program (GUI) or command-line tools. Most users will want the GUI version! Option 1: The Easy Way (GUI - Recommended!) 1. Download the NCSDecomp folder 2. Double-click NCSDecomp.exe (Windows) or NCSDecomp.app (Mac) 3. That's it! No Java installation needed - everything is included! Once it opens: Drag and drop any .ncs file onto the window to decompile it Or use File → Open to browse for files The decompiled code will appear with syntax highlighting (color-coded keywords, functions, etc.) You can edit the code right there if you want Press Ctrl+S (or Cmd+S on Mac) to save your changes Open multiple files at once - each gets its own tab The program supports both KOTOR 1 and 2 (configurable in the settings) and attempts to unify most nwnnsscomp.exe variants, but has mainly been tested with kotorscript and ktool's variants. Option 2: Command Line (For Advanced Users) If you prefer using the command line or want to automate tasks: Windows: .\NCSDecompCLI.exe -i "script.ncs" -o "script.nss" --k2 Mac/Linux: ./NCSDecompCLI -i "script.ncs" -o "script.nss" --k2 This reads script.ncs and creates script.nss with the decompiled code. Use --k1 for KOTOR 1 scripts, or --k2 for KOTOR 2 scripts. Decompile an entire folder: .\NCSDecompCLI.exe -i "scripts_folder" -r --k2 -O "output_folder" This processes all .ncs files in the folder (including subfolders) and saves the results to your output folder. Features: Works with both KOTOR 1 and KOTOR 2/TSL scripts Beautiful graphical interface with syntax highlighting Edit decompiled scripts and compile them back Round-trip verification - see if your edited code compiles correctly Batch process entire folders of scripts at once View bytecode if you're curious about the low-level details Self-contained - no Java installation needed! Cross-platform - works on Windows, Mac, and Linux What can you do with it? Decompile .ncs files to see the original source code Understand how game scripts work Edit scripts and recompile them for mods Analyze scripts from your favorite mods Batch process entire script folders quickly Troubleshooting: "Error: nwscript file not found" Make sure you haven't deleted or moved the tools folder that came with the download The program should find everything automatically, but if you get this error, check that the tools folder is in the same directory as the executable "Program won't start" (Windows) Windows might be blocking it. Right-click NCSDecomp.exe → Properties → Check "Unblock" → Apply Try running as Administrator if you get permission errors "Program won't start" (Mac) You may need to allow the app in System Preferences → Security & Privacy Right-click the app and select "Open" the first time "Program won't start" (Linux) Make sure the executable has permission to run: Make sure the executable has permission to run: chmod +x NCSDecompCLI/NCSDecompCLI For more help: Run .\NCSDecompCLI.exe --help (Windows) or ./NCSDecompCLI --help (Mac/Linux) to see all available options Check the included README files for detailed documentation Source code and more info: https://github.com/bolabaden https://bolabaden.org Credits: Original Developers (The Foundation): JdNoa - Created the original script decompiler engine Dashus - Created the original GUI These developers did the hard foundational work that made this tool possible. The original DeNCS was an internal tool used by TSLRP (The Sith Lords Restoration Project) and was released to the public "as is" with no warranty. Current Maintainer: th3w1zard1 - Complete rewrite and modernization This version represents a near-complete rewrite and modernization of the original DeNCS tool. While based on the original developers' foundational work, the current version has been extensively revamped with a new GUI, modernized codebase, cross-platform support, and many new features. The core decompilation concepts from the original work remain, but the implementation has been significantly rewritten for modern development practices. License: This software is provided under the Business Source License 1.1 (BSL 1.1). See LICENSE.txt in the download for full license information. Enjoy decompiling! 🎮✨ NCSDecomp-v1.0.2-Windows.zip

How was that problem solved for ROR?

From Bioware's own TLK documentation: For languages other than english where conversational or other text differs depending on the gender of the speaker or the person being spoken to, there are two talk table files, dialog.tlk and dialogf.tlk. Both tlk files contain text for the all the StrRefs in the game and for gender-neutral strings, the two tlk files actually contain the exact same text. However, if a given StrRef refers to text that has a two different translations depending on gender of the player character, then dialog.tlk will contain the masculine form of the text and dialogf.tlk will contain the feminine form of the text. Personally, I convert the TLK to and from XML using Xoreos Tools (tlk2xml / xml2tlk). But there are also other tools around that convert to/from various text formats.

Hello, please do one for converting whole modules as well, and for extracting models from a module and inserting it in another one (a shuttle for example) ! Will be much easier with a video ! Thanks !

I was thinking of something like pulling modules and textured game models into Blender and then rig and animate them from scratch. Hell, making these things from scratch may be the only option. After all these years, AI upscaled scenes can't be the only option. If there's some folks out there that want to work on this too, please contact me. Otherwise, I'm fully prepared to tackle this myself. I have. I just don't care for them. I don't think they fit the mise en scene of the original Star Wars films, which KOTOR draws heavy inspiration from, and that of the first game itself. It's too polished, too flashy. I don't believe they integrate with the base game very well. I want something that stays truer to the intent of the original game.

NCSDecomp is my attempt at replacing DeNCS with a modern alternative.

For reasons I can't explain, ever since I played TSL for the first time far longer ago than I care to admit, I've always wanted to have the interior doors in the Ebon Hawk in the first game. I noticed nobody else had added this feature in as of yet, so I decided to take a crack at doing it myself: All of the doors are added in and working, but obviously once they've opened, they stay that way. This feels like it makes the mod a bit pointless, so I'm currently working on a way to have each door automatically close once you move a certain distance away from it. I originally planned to use an OnHeartbeat script attached to each door to close it once you move a certain distance away, but it didn’t come out as well as I’d hoped: It’s a bit janky and doesn’t always seem to work as intended, so I’m not sold on this method. I did try using a trigger instead, having the doors open/close using the OnEnter and OnExit scripts instead and it’s a LOT smoother, so I think I’m gonna switch to that. Setting all those triggers isn’t going to be the quickest process in the world though so… that’ll be fun! As you can see, since the doors were originally intended to only be seen from one side in TSL, so once you pass through, you can see some of the door geometry poking out the wall on the other side. I'm not too bothered with that though, since it's unlikely anyone is going to be stopping and turning around to look up every time they walk through a door. I did show it at the end off the video though, just as a point of interest. I’ll hopefully get all of the triggers set tomorrow, give it a thorough test and then maybe put up a new test video before I create an installer and package it up for release.

The triggers have been placed in the game and I think the effect is about as smooth as I'm going to get it: Much happier with this iteration of the mod than I was the previous one, so I think this going to be the approach I go with for the final product. I've done a little play-testing to make sure cutscenes aren't broken by the doors stopping NPC's moving etc and it all seems to be ok. The triggers all work as they should. There might be the odd bit of jank with NPC's getting lost for a second and turning on the spot while they wait for a door to open, but other than that, it's all good. Not that there are many proper cutscenes aboard the Ebon Hawk, anyway. At least not in ebo_m12aa, which is the only module I've added the doors to. The other stunt modules, I've left alone. I was mainly concerned that this would interfere with things like Sasha leaving the ship, but she just acts as above. Some of the doors go a little nuts if you try to follow her directly, as multiple creatures are entering/exiting the trigger areas at once, but don't do that it's fine. Well, here it is!