Search the Community
Showing results for tags 'nwscript'.
Found 6 results
-
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.0-Windows.zip
-
I put my original mod on hold since someone else is making it. And, wow, does it look good! So, on to the most neglected project: a new DeNCS. It's currently able to interpret op codes and arguments, so the next step is the higher-level control flow. Here's where you can help: Byte Code - I obtained a list of op codes from here. I need to make sure it's complete and correct. NWScript - I am compiling a list of operators, punctuators, and keywords from here, and here. I need to make sure it's complete and correct. Mapping - This is the big one, making sure script converts to byte code, and vice versa. 100% identical conversion, every time. No pressure. DOT Diagram - I need a program that can make diagrams from DOT DOT Generator - I can generate the DOT from my code, but it would be helpful if something could do this for me, as well. Name - Right now, it's called DeNCS 2020. Narrowly edging out NewNCS. Please, give it a good name. A couple of things I want to address. DeNCS sometimes reports a partial-byte mismatch. At first, I ignored this just like every other modder. However, while testing this tool I compared the output of an NCS file straight from the game to the output DeNCS generated... Well, it looks like DeNCS attempts to convert the NCS to source code, then attempts to convert the source code back to an NCS file. Then, it compares the original NCS to the new one. And, if they don't match? Partial-byte mismatch. I don't know why DeNCS doesn't always perform a perfect conversion, but it's something to investigate. Particularly, since there are reports that even NCS files generated by Bioware and Obsidian had bugs in them. Troubleshooting the NCS files will make this longer since I have no way of knowing what the original files should have looked like. (But, I can guess just like DeNCS seems to do.) This is command-line only. There was never any intention to make this a stand-alone tool. However, development will take longer than I expected, which means a GUI is the least of my priorities. At some point, I want to merge this into a toolset, maybe even the one up above. So, no GUI. (That also means the stand-alone tool won't be around for very long.) Got any feedback? Thanks! Edit: I just downloaded Graphviz, so I am covered with DOT diagrams. I think the included library will allow me to generate DOT, too.
-
View File KotOR Scripting Tool - 2021 About Kotor Scripting Tool Kotor Scripting Tool is my attempt at a scripting interface for nwnnsscomp.exe. I originally designed this tool to aid me in my scripting efforts back in the day. My desire was to create a scripting tool with some of the creature comforts that today's coders have come to expect. The core features that were important for me were the ability to have NWScript function name Auto Completion and Syntax Highlighting. If anyone is interested in helping to extend its functionality be sure to check out the link to the GItHub repo below. Anyways that's enough rambling for now! Happy Modding! Features include: Compile .nss Scripts Syntax highlighting AutoComplete Suggestions (Beta) Tabbed Text Editor Advanced Find & Replace Browsable nwscript function list Browsable nwscript constants list Zip Archive Download and extract the zip file. Once extracted navigate to the directory and run Kotor Scripting Tool.exe This program was compiled in C# with version 4.0 of the .NET Framework if you do not already have it downloaded you will need to download it [here]. The source code has been released on my GitHub account https://github.com/KobaltBlu/KotOR-Scripting-Tool. Submitter Blue Submitted 07/09/2012 Category Modding Tools
-
Version v0.1.5.0
3,429 downloads
About Kotor Scripting Tool Kotor Scripting Tool is my attempt at a scripting interface for nwnnsscomp.exe. I originally designed this tool to aid me in my scripting efforts back in the day. My desire was to create a scripting tool with some of the creature comforts that today's coders have come to expect. The core features that were important for me were the ability to have NWScript function name Auto Completion and Syntax Highlighting. If anyone is interested in helping to extend its functionality be sure to check out the link to the GItHub repo below. Anyways that's enough rambling for now! Happy Modding! Features include: Compile .nss Scripts Syntax highlighting AutoComplete Suggestions (Beta) Tabbed Text Editor Advanced Find & Replace Browsable nwscript function list Browsable nwscript constants list Zip Archive Download and extract the zip file. Once extracted navigate to the directory and run Kotor Scripting Tool.exe This program was compiled in C# with version 4.0 of the .NET Framework if you do not already have it downloaded you will need to download it [here]. The source code has been released on my GitHub account https://github.com/KobaltBlu/KotOR-Scripting-Tool. -
Greetings, fellow Jedi. May the Force be with you. In k_inc_utility there's a UserDefined events called HOSTILE_RETREAT which I was told it refers to UT_ReturnToBase that also belongs to the aforementioned script. I'm in an attempt on reconstructing one, that is part of k_punk_restrig and wanted to ask if this script seems legit or does the opposite - [Oops, the script has been removed as the wrong one was posted and the right one has been lost in eternity.] Details are commented on the script My concern is; the nwnnsscomp does compile the script, but to see if it's working or not is kind of hard to produce [and I haven't actually seeing it]. The relevant roaming Rakata which is unk42_rakbreed01 rarely moves towards the exit of trigger's geometry. So I'm down to a guessing game and that is not convincing. Many thanks for considering this. ____________________________________________ Update: oof, after countless of trial-and-errors and insightful thoughts from @DarthParametric on #mod_development at Discord, I finally able to come to a resolve. First of all, scrap the above script - my modification to UT_ReturnToBase was all garbage, and is nowhere near working, lol! The idea on having oExiting replacing the role of OBJECT_SELF was all wrong. In short, it should have fired by the creature's OUD itself. Therefore, in the end I'm using this with the k_punk_restrig - and having each creatures their own customized ScriptUserDefine to have something like this - By then, the script worked as intended. Eureka!
-
Over at xoreos.org I wrote a blog post about Disassembling NWScript Bytecode. This is basically a progress report of me writing an NWScript disassembler, which might be extended into a full-fledged decompiler. It might be of interest to people here.
