ucxt(1)

💖 ucxt(1) — the usecode disassembler, bestie edition 💖

okay so first things first: this is ucxt, a General Commands Manual page, and it's literally the Ultima 7/8 usecode disassembler. if that sentence made zero sense to you, don't panic, we're getting there. 🫶

✨ NAME ✨

ucxt — Ultima 7/8 usecode disassembler.

🌸 SYNOPSIS 🌸

ucxt [OPTIONS] -a
       prints all the functions

ucxt [OPTIONS] <hex_function_number>
       disassembles a single function to stdout

🦋 DESCRIPTION 🦋

so the games that Exult supports (Ultima 7, for example) are made up in large part of usecode. and Exult? it basically implements a virtual machine, and the machine language of that virtual machine is usecode. that's the whole vibe. 🧚

and the ucxt command is the thing that lets you disassemble usecode. that's it, that's the job, and it eats. 💅

💜 OPTIONS 💜

🎀 Misc Flags (any/all of these, mix and match, go feral)

• -nc — don't go looking for exult's .xml config file
• -v — turns on verbose output mode
• -ofile — output to the specified file
• -ifile — load the usecode file specified by the filename
• -ro — output the raw opcodes in addition to the -f format
• -ac — output automatically generated comments
• -uc — output automatically generated 'useless' comments
• -b — only do 'basic' optimisations
• -dbg — output debugging information if present in usecode
• -ext32 — convert function to ext32 format if not already

🍓 Game Specifier Flags (pick exactly ONE, no greedy behaviour bestie)

• -bg — select the black gate usecode file
• -si — select the serpent isle usecode file
• -u8 — select the ultima 8/pagan usecode file (experimental 👀)

ngl, -u8 is marked experimental in the original, so treat it accordingly. no cap.

🌈 Output Format Flags (again: only one of these, choose wisely)

• -fl — output using brief "list" format
• -fa — output using "assembler" format (default)
• -fs — output using "exult script" format
• -fz — output using "exult script" format
• -ftt — output using the translation table xml format
• -ff — outputs all flags referenced in the usecode file, sorted both by "flags within a function" and "functions using flag"

yes, -fs and -fz both say "exult script" format. that's what the page says. i'm not editing the source material, i'm just the messenger. 🙈

👑 SEE ALSO 👑

• exult(6)

and that's the whole page, you're so smart for reading it all, main character energy fr fr 💖

this was pulled from the General Commands Manual, dated August 2006 — go forth and disassemble, bestie, slay ✨🎀🦋