The Ravenous Bugblatter Beast of Traal
Stupid, but extremely ravenous!

Language Plugin - Version 3.4 - User Guide

Filename: plugin_blatt_language

Offline Manual

You are reading this offline manual for this plugin. The links to the right navigate through the offline information. The links above and to the left link to www.ravenousbugblatterbeast.pwp.blueyonder.co.uk. If you downloaded the plugin from somewhere else, or downloaded it some time ago, I recomend you check for an updated plugin. Note that the on-line manual may have been updated even if the plugin hasn't.

Permanently setting your language

Players can permanently set their language so they don't see the menu on connection by issuing one of the following console commands (or adding the line to their config.cfg):

setinfo lang english
setinfo lang french
setinfo lang francais
setinfo lang german
setinfo lang deutcsh

Information for Plugin Authors

If you wish to make your own plugin compatible with the language plugin you need to do the following:

  1. Include the file language.inc in your plugin.

    #include "language.inc"

  2. Add the following line to your plugin_init function:

    language_init();
    This will allow it to receive announcements from plugin_blatt_language about the language choice each player has made.

  3. Replace all calls to selfmessage, csay,tsay,say,messageex,message and other functions that send a message to the players with calls to language_say and language_sayall. You can also use language_sayf and language_sayallf to send formatted messages. See language.inc for more information on the available functions and their arguments.

  4. In your calls to the various language_say commands you must pass the message in all languages, with the different versions separated by a | character. See language.inc for the correct order of the languages.

  5. language_sayf and language_sayallf work like snprintf except you must include the position of argument in the insertion string after the % character - e.g.

    The weather is %1s and the temperature is %2i
    This allows you to put inserted arguments in a different order in different languages, and to insert the same argument more than once.

  6. Include language.inc with your plugin distribution, and either a link to my site to download plugin_blatt_language, or host a complete copy of my plugin pack with this manual on your site.