...is now on the Wiki.

After looking at this thread, I had a look around the existing tutorials, and realised that most of them were spread across the wiki, the forums, and a few external sites, and that pretty much all of them were using tdf and BOS/COB rather than the newer lua. So I wrote my own.

Hope this helps someone somewhere. It still needs neatening up a bit, though; does anyone know how to get source code to show up properly?

One quick note - COB is not parsed back into lua by Spring, and is not necessarily any slower than LUS.

im gonna use it for sure <3

Thanks a lot! It's so coooooooool!
You could write source code in <code> tags. For more info, please read the wiki manual.

Great stuff!!
I'm right in the middle of learning this stuff, And this is very close to what i think would have been very helpful when i started. And since i don't know everything i need yet, i'm sure it'll still be helpful.

I think the commentary in the scripts is an especially good idea. I think a lot of people get stuck there, scripting i mean. I certainly was for quite some time.

I did notice a reclaim-button for the builder ingame, but no such tag in the Unit-file. (CanReclaim or CanReclamate).
(also open to this kind of feedback?)

Very nice stuff...! Thanks a lot :D

Now I will give creating my own game a try.


Very useful! Big deal! :D

Jipppiiie :D

From UnitDefHandler.cpp:



i.e. Reclaim and other 'nano' abilities default to true for builders.

I thought the builder did not execute its reclaim order when ordered to, and thought it might have something to do with a missing tag.

After checking the builder again the reclaim action is visually hidden...until the reclaimed object is disappeared.

So i stand corrected. apologies for my mistake.

Thanks for the responses, guys!

What I really need now is as much feedback as possible.
People familiar with the engine, please point out all the factual errors (I've fixed the COB lua one, but I'm sure there are plenty more).
People less familiar with the engine, please point out things that are unclear or don't explain things properly.

Everyone, what other things are worth saying? Is it worth adding a bit more about how to write Gadgets, or using GIMP, or CEGs, or LUPS? Or is the whole thing too long already and needs trimming down? What do you think?

where did my post go?
anyway, very nice guide :)
you could maybe chop it into more "chapters" and link them add the top:
1.8 Putting the Unit in a Mod
1.8.1 UnitDef
1.8.2 Animation Script
1.8.3 Weapon

Maybe also briefly say that Lua is a scripting language also used outside spring and that FBI files came from TA (i think)
And mention the #moddev #lua channels on lobby.

If you need more stuff to write about, I would like something about CEG (using .lua files)
http://springrts.com/wiki/CEG This explains some tags and things but some (commentated) examples maybe even with pictures would be cool.