EasyCoding

Foreword

This page is here to document easy to do coding tasks. It is not here to double the feature request database, and should only be filled by people that know the code well enough to juge the difficulty of a given task.

If you are such a person, you should feel free to edit this page.

If you're not, you should post a feature request and discuss your idea on the forum or IRC. A coder with better knowledge of the code might give you the green light to add your feature here.

Anybody should feel free to add "clues" to any tasks, that is entry points, traps to avoid, person to contact to discuss and so on.

If you plan to work on a feature, write your name at the bottom of the feature, with the date. Note that if you are too long at working on a feature I'll "free" it back (that is if you're not working on it. If you have problems implementing it, just tell us....)

--Boucman 20:48, 3 October 2006 (CEST)

Animation related features

Victory animation

an animation to be played by the surviving unit during the death animation of the other unit

this should be fairly easy to do, just duplicate all death animation code, and modify the unit_die function to change the state of both units.

ask Boucman for extra help

• unit_display.cpp
• unit_type.cpp
• unit.cpp
• unit_animation.cpp;

Done! Submitting patch as soon as it can be tested. TheAT 01:53, 17 October 2006 (CEST)

En Guard animation

An animation to replace the standing animation when the unit is next to an ennemy

slightly more tricky than the previous one, you should copy most of the standing code, but beware that this should be invisible to external callers. the call to get_stats should be looked at

ask Boucman for extra help

• unit.cpp
• unit_type.cpp
• unit_animation.cpp

Special tags for Extra_anim

special tags in the animate_unit event to call standard unit animations

one of the big limitation of the extra_animation tags is that you need to modify the unit itself to have the extra anim. Most anims can't be easily called that way. It would be interesting to have special tags that would be recognised to call the standard animations (attack, defense, etc...)

the tricky part is to handle correctly the "offset" parameter, and add all the WML handling to "fill in" the information we won't have available (non-existant filtering criterias)

this is more tricky than the two above, and I would advise doing one of the other two first to understand how it work

ask Boucman for extra help

• unit.cpp
• actions.cpp

Animate flags during a [delay] event

currently, the [event] tag calls SDL_delay() and blocks the game completely. It would be trivial to change it to a loop that would call event::pump() every 10ms to have all animations updated

the tricky part is to make sure the screen is somehow "locked" and that player can't play during that time (should be the case, simple checking is needed)

grep should give you the file to change

Scripting

Campaign Server Signing

Currently, the campaign server will rename uploaded *.py files to *.py.unsigned, so untrusted code cannot get executed. It would be nice to use some sort of signing for .py files (instead of having to log in to the CS and un-rename them).

The change for this would probably be only on the campaign server, and not touch any of the main wesnoth code. Here's the forum post suggesting this, and also the thread has more info: http://www.wesnoth.org/forum/viewtopic.php?p=184504#184504

Restricted Python

Unlike Blender/GIMP/Inkscape and so on, there seems to be one project "Zope" which has restricted Python execution: http://zopewiki.org/PythonScript http://svn.zope.org/Zope3/trunk/src/RestrictedPython/

Maybe this could be adapted to Wesnoth? If you know how Python works, then this is probably easy.. copy over the Zope code (if license permits, that is), adjust so it works outside of Zope, and then modify ai_python.cpp so it uses the restricted execution instead of the full Python interpreter.

Lua Support

Lua might be a nice alternative to Python, since it should be possible to have "safe" scripts, i.e. they should not be able to gain any access outside of Wesnoth, or even to crash Wesnoth.

If you have experience with implementing Lua scripting, then this is probably quite easy to do, can just look how Python was added. Just keep the security aspect in mind from the beginning (but I think in Lua you don't get filesystem access by default, so shouldn't be anything to do here).

WML related features

Side-specific messages

Side-specific [message]s (FR #7427)

Side-specific results

Giving result=defeat or result=victory for specific sides. (FR #4960)

Recall Event

WML event trigger for recalling (the current one triggers on both recalls and recruits) (FR #3622) (please read the comments of the report for a proper description of how this should work)

Advance Unit

Enabling WML-scripted leveling of units. (FR #7426)

Enabling checking of damage dealt in WML

A WML variable should be set when triggering some combat-related events, allowing WML to know the amount of damage being dealt. (FR #7673)

Improving the WML preprocessor

The WML #ifdef should recognize symbols (macros) set using #define. (FR #7893)

Enable scenarios to start at a random time of day

There should be an option in scenario WML (not in the MP game creation UI) for making the starting time of day of a scenario random. (FR #8024)

GUI related features

Theme Changes

• show number of owned villages/total villages (FR: #3135)
• allow custom themes to display values of WML variables (FR #6209)
• hide the hourglass item from the statusbar when there is no timer

Widget Changes

• show side number, name and team association information in the status table
• make games sortable in the lobby (open slots, total number of players, era, XP modifier, gold per village, fog/shroud)
• input history (chat, commands, ..), seek Sapient for more info and tips

Miscellaneous

More powerful village naming

adding mountain names and other features to village names, having a second random name in village names

currently the village naming engine has avery good structure that could allow more powerfull names to be generated. Understanding how it works should be quite easy, and a few usefull imprvements could be added

• currently villages can use lake names and river names, this should be extanded to other features like bridges, swamps, mountains etc...
• it would be nice to have a separate list of "first sylabus" and "last sylabus" for naming. That's not really needed in english, but some translations could use it
• again, it is common to have village with more than one "random" word in them. having a $name2 variable would be nice

Debug Mode

• New debug command functionality (setting status.variables, possibly terrain, WML value display)
• Make it possible to toggle shroud and fog (but take care that this is only possible ib campaigns)