XRACER-MKCRAFT(1)

πŸ’– xracer-mkcraft β€” the vibe

okay so bestie, welcome to xracer-mkcraft(1) πŸŽ€ this is one of those User Contributed Perl Documentation situations, and honestly? it's giving "tiny script, big main character energy." no cap.


✨ NAME ✨

xracer-mkcraft β€” generate a XRacer vehicle from a Blender VRML file πŸš—πŸ’¨


🌸 SYNOPSIS 🌸

xracer-mkcraft [ --output OUTPUTFILE ] [ --verbose ] [ INPUTFILE ]

like. that's it. that's the whole summoning circle. πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

so xracer-mkcraft is a perl script β€” yes, perl, we respect the elders β€” and what it does is it takes a Blender VRML file, i.e. a .wrl file, which you hand it as INPUTFILE.

and then, optionally, it generates a C source file, OUTPUTFILE, and that file contains code that's suitable to be used as a vehicle description in the game XRacer. 🏎️✨

so like: blender model in β†’ C code out β†’ car go vroom in the game. that's the pipeline, that's the dream. 🫢


πŸ‘‘ OPTIONS πŸ‘‘

  • --output OUTPUTFILE β€” tells it which C source file to write the vehicle description to. and here's the tea 🍡: if you omit this, xracer-mkcraft doesn't write anything at all β€” it just processes the INPUTFILE and checks it for validity. so it's like a vibe check for your .wrl file. πŸ”βœ¨
  • --verbose β€” be verbose in the processing of the .wrl INPUTFILE. aka: it yaps. it tells you what's going on. some of us need the narration bestie, no shame. 😭

🌈 SEE ALSO 🌈

  • xracer(6) β€” the actual game, the whole reason we're here 🏁
  • XRacer::BVRML(3pm) β€” the perl module doing the heavy lifting, iykyk πŸ’œ

πŸ’Œ AUTHOR πŸ’Œ

real talk: this documentation for xracer-mkcraft was written by Filip Van Raemdonck (mechanix@digibel.org) for the Debian prepackaged version of XRacer. 🫑

and here's the funny part β€” it is uncertain which of the persons listed in the AUTHORS file distributed with the XRacer sources has written the actual script. so the docs have a credited author and the script is like... anonymous. mysterious. enigmatic. lowkey iconic of it ngl. πŸ™ˆ


okay so small recap bestie: perl script, takes a Blender .wrl file, optionally spits out a C source file for a XRacer vehicle, --output writes it, --verbose makes it chatty, and if you skip --output it just validates. that's the whole thing. slay. πŸ’…βœ¨

and that's a wrap! this lil page came from the perl v5.40.0 docs, dated 2025-01-25, and it's filed under XRACER-MKCRAFT(1). go build a car bestie, you got this πŸš—πŸ’–πŸŽ€

πŸ“¦ where this page comes from