Draft documentation of the clua API


If it doesn't fit anywhere else, it belongs here. Also, come here if you just need to get hammered.

Halls Hopper

Posts: 85

Joined: Thursday, 27th November 2014, 19:12

Post Monday, 9th July 2018, 20:04

Draft documentation of the clua API

Hi friends. It's well known that you can use "Lua magic" in your .crawlrc file to do cool things. But the magic itself comes in whispered fragments from wizards who put forth the work digging through the crawl code to figure out what is available in Lua.

Starting with some existing documentation in the comments of the c source, plus reading elliptic's qw, and Leszczynek's pastebin documenting monster and monster.info, I spent some time compiling a solid API doc. Check it out: http://csclub.uwaterloo.ca/~ebering/crawl/lua/. There are certainly typos, possibly lies, and definitely several references to C header files for enum types, so there's still room for improvement. I'd welcome your feedback and comments.

If you're worried about me nuking this off the face of the internet, don't worry, there's a pull request to land this into the main crawl distribution. Hopefully it will find a home on cdo or some other more permanent crawl webspace in the near future.

For this message the author ebering has received thanks: 8
Airwolf, bel, chequers, Ge0ff, Implojin, Leszczynek, pedritolo, runewalsh

Spider Stomper

Posts: 241

Joined: Thursday, 11th April 2013, 21:07

Post Today, 01:11

Re: Draft documentation of the clua API

I really wish that this had existed back when I was learning Crawl.

Please please please integrate this into the DCSS distributions and keep it maintained.

Return to Crazy Yiuf's Corner

Who is online

Users browsing this forum: No registered users and 6 guests

Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group.
Designed by ST Software for PTF.