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

How can you import a model from KOTOR 1 to KOTOR 2 and vice-versa? I understand that you need to use MDLOPs or MDLEdit, and then a 3d model software like blender with the add-ons available for download on this site, but I don't understand what steps actually need to be taken to make the model files from one game readable by the other game.

Don't Break It Again, Admiral.zip

But then I look at Twin Suns less

Cool beans! I love stuff like this, that just gives you those little upgrades that KotOR really needs. EDIT: Actually, maybe I'm stupid, but there's now no menu music or background music on the Endar Spire. I just drag and drop the files and replace when prompted, right?

Happy Birthday, SH! Here's to another year. 🍻

I reckon 99% of texture mods are compatible with K1R (the first restored content mod for Kotor I) and the RC-K1CP mod (the second restored content mod that was made for the K1 Community Patch which is a massive bug fix mod for the game) so there shouldn't be any worries there Define "collection". There are large texture pack mods that covers thousands of textures including NPCs, UI, areas, weapons, icons, and such. The problem with large texture packs like this is what makes them so rare, so here are the problems: 1) File Size: A single super-mega texture pack that covers everything is going to either take up gigabytes or terabytes on your hard drive. I personally wouldn't want to download such a large mod and so I would avoid said mod in favor of smaller, individual texture mods. As a modder, I wouldn't want players to avoid my mod due to the file size and I certainly wouldn't want to have to wait hours zipping a 50 gigabyte texture mod so I'd opt to make my texture mods separate from one another. 2) Biases: We all wouldn't download a texture mod if we didn't like the design of said texture mod. Let's say if I were to make a single super-mega texture pack and every NPC looked like this and you didn't like this design then you aren't going to download and play my mod. This is another reason why modders don't usually compile all of their textures into one big mod because if my single super-mega texture pack contained A, B, C, X, Y, and Z and you didn't like C and Y then you aren't downloading the mod. What you'll usually see is modders uploading texture mods that cover a specific area and it becomes up to you, the player, to pick and choose what textures you want. Have I mentioned AI? As AI has become a widely available tool, you'll notice how some mods are now utilizing AI to make new textures from scratch whether it be using AI to upscale the low-res textures or feeding the textures into an AI to "reinterpret" them. Whatever you think of AI can also make or break a specific texture mod for you, and I assure you there are entire collections like what you're looking for that are made using AI. The modder Dark Hope is a popular texture artist who does exactly what you want. The only downside is that you have to go to her page and manually download her mods to get the full package. If you do download all of her mods and install them, however, you'll be given a seamless and consistent upgrade for much of the base game's graphics. This is the person who makes the ultra-HD ultra-realistic textures for NPCs, armors, and other textures, if you were to install them all than about 70% of the NPCs shall be in this consistent new design. Her work is still ongoing, and so she is still working on textures that'll be released in the future. Do note that her first language is Russian, that is why many of her mod names are weird as she's translating them directly from Russian. The Ultimate Character Overhaul is an AI upscaled texture pack that upscales all of the textures into a higher resolution. Unlike Dark Hope's mods, this mod maintains the Kotor aesthetic whilst improving the texture quality of the NPCs giving them a fresh/crisp look. Vurt's KotOR Visual Resurgence is probably as close as you're going to get to one big single super-mega texture pack mod that is one download and one install, however, all of the problems I listed above apply. It's a 2 gigabyte download and it'll be even bigger when you extract it and it's made by using AI to reinterpret the textures. If you are fine with both of those, this can be the mod for you. But as I said, players usually download smaller mods and use them side by side. You can download Vurt's KotOR Visual Resurgence, install it, and then replace his textures with textures from smaller mods so that, in the end, you are using 20% of Vurt's mods whilst the remaining 80% is made up of a variety of different mods. Personally, I like to install Dak's Endar Spire Retexture and then pick out and add ONLY the animated textures from the ENDAR SPIRE Complete Overhaul on top of it. Though the idea of mixing texture mods is a bit risky, especially for a noobie, so I wouldn't recommend it. The point being is that no two players are going to agree on what is good, what is bad, what is right, and what is wrong, and sometimes the big single super-mega texture pack mod isn't the answer if you disagree with the design the author was going for. You should check out the the Mod Builds that is maintained by one of our Admins. The mods on this list for both games are highly tested and are compatible with one another, this can serve as a sort of catalogue as to what mods exist without going through Deadlystream's and NexusMod's entire library of mods.

Today's little demo: This patch was originally put together by @LanguageWriter123 (see here). He and I worked together to see what it would take to port this over, and today I decided to give it a shot, and I'm very pleased with the results! cc @darthbdaman as you asked about level caps earlier

Thank you to everyone who commented on this thread. I never would have been able to put this together without y'all's help.

The author still doesn't follow this thread! You're better off sending them a PM. Or tag them. Hey @DarthRevan101, read the last few posts.

Amazing work! You managed to break down so much limitations... This is extremely exciting :)

What do you mean by "future skill checks"? There are already skill checks in dialogue that add more skill based dialogue responses should said skill be a certain level. So this is the Loganverse team's latest rebrand I take it? As SH has already said, they seldom collaborate with others or share their own assets with modders. I had no idea who this is, I tried searching for them on YouTube and the only thing that came up was a Let's Play channel. The thing about Kotor Machiminas is that what you see on screen isn't as deep or as complex as the scene itself depicts. You might see an awesome scene with combat and the like but in reality what's going on behind the scenes is that NPCs are being directed to do things via JC's Toolbox and what you might think is an epic cutscene might actually be 5 separate choppy in-game cutscenes that were recorded and edited together to look like one scene when in reality they aren't. When it comes to any sort of animation, what isn't seen on screen doesn't need to be animated - this is especially true with 3D animation. I say this because something that might look cool in a Machimina might not actually work properly in-game as a mod. Remember how Revan and Kreia used Darth Malak's Lightsaber pose? In-game the ability to use blasters, the ability to use security on a door, or dialogue animations might be broken as those were never seen in the movie and thus could be left broken. Even if you ignore the fact that SWST and Varkor take their time making VO, there only value as voice actors for the ROR mod is for the character Revan and we aren't even up to writing that character's dialogue let alone finalizing his script. There will definitely be voice acted characters before Revan, so why would we want famous examples like SWST and Varkor for those characters when we can have unsung actors play these roles and do a good job at those roles (and not take 3-5 years to produce the lines for those roles too). And should by some miracle we do finish the entire mod and get to voicing Revan should these two be unable, unwilling, or no longer be here to voice the character we will inevitably have to look for different people. We are working on Episode Two and the patch for Episode One, though SH is right in saying that a collaboration at this stage is very very unlikely. I can assure you, work for Episode Two is well underway and it is going well without a major collaboration at this present time.

CapitaineSpoque, how about integrating LevelCapMod (50) into your mod? I mean this: https://deadlystream.com/topic/11814-kotor-1-level-cap-mod-to-level-50 It seems to me that given the expected character balance changes/new abilities in your mod, synchronizing these improvements with possible larger-scale upgrades (up to level 50) could give KotOR a fundamentally new gaming experience.

02 - [TUTORIAL] - Creating a Merchant - TSL 03 - [ADDITIONAL] - Using ERFEdit 04 - [ADDITIONAL] - Picking an NPC to place in your level - TSL 05 - [ADDITIONAL] - Picking Placeables to fill your level with - TSL 06 - [ADDITIONAL] - Picking Alien Voice Over Dialog for your level - TSL 07 - [ADDITIONAL] - Placement & Rotation 08 - [TUTORIAL] - Waypoint Markers 09 - [TUTORIAL] - Scripting Basics 10 - [EXAMPLE SCRIPT] - Spawning NPC's on Enter 11 - [EXAMPLE SCRIPT] - Making NPC's Hostile! 12 - [EXAMPLE SCRIPT] - Trigger talking to an NPC! 13 - [EXAMPLE SCRIPT] - Make an NPC walk randomly 14 - [EXAMPLE SCRIPT] - Place a dead NPC 15 - [EXAMPLE SCRIPTS] - Starting Conditionals 16 - [TUTORIAL] - Companion Vendor 17 - [TUTORIAL] - Upgradeable Items 18 - [ADDITIONAL] - Door Gallery 19 - [ADDITIONAL] - Main Menu Details 20 - [ADDITIONAL] - UI Customization 21 - [ADDITIONAL] - Recolouring Textures 22 - [ADDITIONAL] - Recolouring the .GUI Files and Textures 23 - [ADDITIONAL] - Different Camera Modes & Dynamically Spawned Grid Of Placeables 24 - [ADVANCED] - Hard Coded GUI Elements 25 - One Line Dialogs 26 - Writing a changes.ini for HoloPatcher 27 - [MOBILE] - Android & iOS Modding 28 - Hard Coded Class Selection Values 99 - [REQUESTS] - Submit a tutorial idea! I will continue to provide examples that I think might be useful to people, these are all for TSL so far. I hope these tutorials and any others I write will help people continue to make mods for KotOR 1 & 2. These tutorials are getting shorter and less detailed, I may or may not go back and re-write them at some point but if anyone struggles with anything feel free to message me and let me know what I haven't covered very well. Feel free to join the Discord for my project if you need help with anything related to KotOR modding and I will do my best to assist. Discord : https://discord.gg/S3YyfTjMV8 Base Game Scripts & How To Use Them KotOR Modding - Crash Course This 2 hour stream covers the basics of KotOR modding and some of the programs involved, I also regularly stream development of my mod project on Twitch/YouTube. Not all of this covers KotOR modding, there is about 10-20 minutes during the first hour where I get distracted and the second hour of it is mostly me playing games. These are the testing rooms but for K1 the room is lacking a texture but I find this just makes it easier to look through the characters. If anything in any of my short tutorials isn't clear or you don't understand for some reason then let me know and I will do what I can to help. ADVANCED TUTORIALS Utilising the following batch scripts and suggestions might take a while to get to grips with for some users but I would always advise doing so, it's very handy to have the ability to quickly generate a file list or compare things in various ways utilising the power of batch scripting. Comparing Level Contents Let's say you have two levels and you need to compare the differences of the contents. Extract everything from the original level to a folder called "level-a" and the modified folder to "level-b" Run the following batch script inside the "level-a" folder. file-list.bat Then delete or move the .bat file and move "file-list.txt" that it just created outside of the folder. You can also use this script to check that all the files exist. check-if-file-exists-from-file-list.bat You will have to move the file-list.txt and this script inside the folder to run the script. Now run this script at the same location as "file-list.txt" to run a file check against the contents of both folders. compare-files-from-file-list.bat Hopefully this might help someone, where I recently had to transfer all of my changes from manual installs to a TSLPatcher changes.ini file, I found this process helped speed the process up a little bit. From here, you should know which files differ and you can then use ChangeEdit.exe that comes with TSLPatcher in order to generate the differences between GFF files. Compiling Scripts If you have made it this far into the tutorial, you should already be familiar with compiling scripts, however for large projects you might need to recompile a lot of scripts at once, so here is a batch script that I used to do it. compile.bat Simply edit the script so that it points to the location of nwnnsscomp.exe for you and then you will be able to put the script into any folder that you need to compile a lot of scripts in and use it to do it all at once. If the scripts don't work for you, you might need to edit them and read them a bit in order to understand them and then to make sure that you have all of the right files in the right places. Thor110