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

For those who are hungry for updates, thanks for all the kind words and support. As holidays are around the corner, my free-time has been a bit taxed lately as I strike the balance between KotOR things and spending time with my and my fiance's family. (Not to mention keeping up with my real job 😬) However, I did spend some time formalizing some of the various "wishlist" features, as well as other pending investigations within the repository issues view. Most upcoming work on my radar for this project is of the unexciting sort. I want to adjust the way I'm modelling game objects in the patching framework to better reflect the underlying inheritance in the base game (i.e. Functions that take a CSWCObject can accept a CSWCCreature, which is derivative, as valid input, etc). I also want to improve/expand the address database system. Right now, they're being stored in plain-text TOML format, which is fine at the current scale, but as this project has grown, this system is already becoming unwieldy. I'm looking to swap to using SQLIte, such that we can have efficient, live, swappable local databases that we can just dump address data directly out Ghidra into. Finally, kotor 2 reverse engineering just needs more work. Kotor 1 is in a great place, such that if we were only targeting that game, I could really accelerate this project. But since I'm endeavoring to provide a solid framework for both games, some TL&C is required to get kotor 2 at least somewhat up to speed. I likley will be giving DarthOuroboros's GhidraMCP suggestion a shot to see if that can accelerate things more here. As a lot of the work to be done is mostly comparative reverse engineering, which I hope falls into the low-complexity class of problem that AI typically excels at. As always let me know if there are any questions or suggestions! P.S. @ajdrenter Galaxy map stuff would be pretty interesting, I've added an issue for me to investigate that at some point in the future. Thanks for the suggestion!

Hello. I request permission to publish textures using elements from your mod. Example:

@Salk This ended up being super quick and easy:

As I said on the DS Discord, it's literally a nothingburger. It's pure concept art at this stage. The developer is a company started by Hudson earlier this year. Come back in 2030 and it might have a release date.

Hello, Lane. One thing I would like to see happen, if possible at all, is to extend the numerical display for replies in dialogue files. The way it is now if you have more than 9 alternatives to choose among, the next ones have a "-" rather than the next number. It does not look good. Perhaps something can be done about it? There are not many such situations. The replies are very often limited to a number that is lower than 10, but it does happen in few cases. Example: in the Temple of the Ancient on Lehon. The file unk_comp.dlg contains an entry node with 11 replies. Cheers!

https://deadlystream.com/topic/11840-looking-for-this-female-character/#comments

I got it now. Been able to extract and install it with the help of 7-zip. Thanks

Late answer, but this could be a possibility ye depending on how much content in introduced in my mod. However, it would require a lot of balancing for the enemies. Raising to 30 could already be pretty cool. We'll see how things go as time goes by

Oh and one thing I'd personally love to see fixed at the engine level would be to introduce alternate start in the Pazaak mini game! That has always bothered me immensely and it's actually fixed in K2. In the original game the AI has an unfair advantage as the Player starts each new round, making it statistically more difficult to avoid the so called "bust". I have produced a small mod that aims to make the mini game better overall but the best improvement would Indeed be this, if you could pull it off.

Ran a quick test, porting Revan's lightsaber over to KotOR from TOR. May look at putting a little mod together which makes this the lightsaber you get on Dantooine at the end of your training, rather than the generic one. Could always deposit the other crystals elsewhere too, for those who like some variety and don't want to stick with their class colour.

If it messes with timers, then I imagine anything related to OnHeartbeat events for placeables/modules/user defines would experience the sort of issues described.

Hi @Salk I know what your talking about! The load behavior of a main menu load, a hard load (load game menu in game), an autosave load, and a quick load all have subtle but important differences. This has actually come up in the speedrun world a few times. For example, the effect duration glitch (in which they last a long time) only happens if you have previously loaded a hard save in this session (as that messes up the global timers). There's a variety of other small differences, between these functions; most of which I haven't dug too deeply into. But I'm unsurprised you've run into this before. If you could provide an example of a specific script related issue that performs differently for different loads (to use as a reference point), I'd be happy to mount a bit of an investigation into it when I get the time. As mentioned above, it's a busy time of year so this may be backlogged a bit. I'd also be happy to field any other questions! Thanks, Lane

So... how are we all feeling about the Star Wars: Fate of the Old Republic announcement? Methinks they're using it as a testing ground for the reception to the potential remakes.

I agree, it's the weak point of the games, how immensely dead and empty the areas are, but i do think TSL takes the cake. I am working on my game right now, but i will get back to modding when i'm sick of it lol

I would like to mention my favorite project in this regard. It's unfortunately still far from being complete, but it has much going for itself already. I'm talking of redrob41's upscale. He's released a K2 version, too.

I used mostly Blender, photoshop and kotor tools. I joined my mask with someoneelse's mask since IDK how to rig. I'm learning right now and thank you

Hello there everyone! As always, i'm in the middle of thousand different projects for the mod, but I felt like providing an update for the current WIP lower city and hidden bek base The new hidden bek appearances The lower city The hidden bek base The project goes further and further! Not as fast as i'd hope, but still we are very slowly getting there! 😅 For the people interested, i've created a discord channel dedicated to the project. It is not very active at the moment, but i post some screenshots or videos here and there so if you want to be up to date with some work in progress you can see it in there. You can also directly provide some feedback. It'll be way more active once i'll release the alpha build obviously! My discord for the project See ya next time! 👀

I really like the new reskin, specially the stone and lightning textures. I would add a little more color in the hallways, but that is just my personal opinion. I also like that you made Assasins have lightsabers, perhaps you could diversify them further if some of them had dual sabers (even one normal length and one short). And I still think some rooms could have more placeables (like the antechambers to the training room in front of the archives), or some placeables shuffled from the Dantooine enclave layout (for example, I think the dorm room with the lockboxes is the exact same one as the one in the Jedi Enclave, that could be changed to be more distinct), although I don't know if that is in the scope of the mod.