ThpsQScriptEd

ThpsQScripted is meant to be a fast and lightweight qScript editor. Main goal for this project is to fully support the original Neversoft qScript syntax with some quality of life improvements.

Keep in mind that this project focuses on THPS3, you can try it with other games, but don't really expect it to work due to newer unimplemented opcodes (refer to compatibility page below).

Disclaimer: This tool is not ready for production. Do not edit important files without a backup. This tool is provided as is and there are no any guarantees given. Use this tool at your own risk.

• Understanding qScript
• qScript syntax reference
• Interface
• Settings
• Compatibility
• Opcode reference

Project trivia

Core code was written back in 2016-2018, tracing back to even earlier attempts in Delphi and C#. More recent changes were made to aid LevelMod patching during the COVID-19 days.

Be aware that the codebase is messy, contains bits of older implementations and even 2 separate qb parsing classes - i don't really remember if both are used now and if you can safely throw one of them away.

There are some unfinished ideas too with random bits of code and files here and there.

Bug reports

Use issues to report bugs if found any, but please make sure it's the actual tool bug and not something like a missing closing bracket. Provide a minimum viable script to reproduce the problem along with your report.

Cheers to

• vadru for awesome thps modding stuff. (https://github.com/Vadru93)
• inoX for writing THQBEditor (assisted by vadru)
• TnT for bringing attention to THPS 2003 BAK files (https://tnthps.us/)
• everyone who ever contributed to the QB format research