LUA ComonPitfalls

This is not a tutorial page. This is the sort of last ressort page, you will visit when you are knee deep into the swamp. Just bookmark it and forget it if you search for a tutorial.

I will also happily answer your questions in moddev or lua irc-channel. Keep your infolog ready when you approach, and a www.pastebin.com of the code in your pocket. Now on to the pitfalls, were many brave programers have come to death.

1. Silent new Declaration: Lua doesent recognize your typo.. instead it takes it for a new declared Variable and fills it with nil, and then it marches on without mercy.

How to avoid: Use Spring.Echo("MyVariableName:", variableName) to print out the Variables value. Use assert(variableName) to check for nils and false booleans. Do not use equals sounding Names. Do not allow typos, even in the coments. (Your autocompletion will pick them up and suggest them to you the next time you type - and they are off).

2. Unknown Function: Unlike Java, Lua expects you to have functions declared ahead (or atleast functionheads to be decleared ahead) otherwise it wont know what to do. This results in a Error-Message, and you will learn to love those, because the real mean errors come like thiefs in the night and murder parts of your programs in silence.

3. Necessary Sleeps: You need a Sleep(TimeIn1000/s) in every loop. These Sleeps are the "extraction" points, were the engine stops simulating your "thread" (which is a scheduled function, so no need to worry for threadsafety) and takes up another thread. So functions called in the UnitScript also need a Sleep in it, for them to work properly.

4. Overcomplex design: If its to big for you to understand (who built it), break it down. Do not copy and paste code. Doing that is wrong, wrong - and wrong. Get code out into special functions only dedicated to checking.

if (boolOne == true and x > 3.14) or (foo==bar) then can be converted into

function checkThem(boolOne,x,foo,bar) if (boolOne == true and x > 3.14) or (foo==bar) then return true else return false end end

Delete unecessary stuff.Do not keep code in your work that has reached its exparation date. Plan ahead, it might sound stupid to draw a sketch of a program, but you will come into sitatuion were you coded yourself into a corner, and 2 hours go to waste. So planning if you have a complex task is never wasted time.

5. Use available tools: You can code Lua Animations by hand. And to learn that, you do good to do that. But if you want to make a whole show, this approach is to slow. You need tools, so get yourself the toolbox and use springposer. It might take some time to setup, but you still will win time in the long run.

6. Step back: Some Ideas are to good to waste, and some will eat your hours for breakfast.. while resulting in mediocre stuff, that could have been done in half a hour (or worser, has been done by someone else). So if you want to implement a idea, look for some forerunners work, get your hands on it, modfiy it, melt it, bend it and mend it, until you got were you wanted to be.

7.

8.More to come.. thats for certain.