361 |
361 |
362 * `teamname`: The name of the team (might be force-changed) |
362 * `teamname`: The name of the team (might be force-changed) |
363 * `color`: Team color, usually a number from -9 to -1 (see below) |
363 * `color`: Team color, usually a number from -9 to -1 (see below) |
364 * `grave`: The name of the team’s grave (equals file name without the suffix) |
364 * `grave`: The name of the team’s grave (equals file name without the suffix) |
365 * `fort`: The name of the team’s fort (equals file name without the suffix and without the letter “L” or “R” before that suffix) |
365 * `fort`: The name of the team’s fort (equals file name without the suffix and without the letter “L” or “R” before that suffix) |
366 * `voicepack`: The name of the team’s voice pack (equals the directory name). Since version 1.0.0, you can append “_qau” so Hedgewars will automatically pick the appropriate language version of the voicepack (e.g. instead of “Default”, use “Default_qau”). This is preferred. |
366 * `voicepack`: The name of the team’s voice pack (equals the directory name). Since version 1.0.0, you can append “_qau” so Hedgewars will automatically pick the appropriate language version of the voicepack (e.g. instead of “Default”, use “Default\_qau”). This is preferred. |
367 * `flag`: Optional argument for the name of the team’s flag (equals the file name case-sensitively without the suffix). If set to `nil` or the flag can not be found on the local computer, the flag “hedgewars” is used. |
367 * `flag`: Optional argument for the name of the team’s flag (equals the file name case-sensitively without the suffix). If set to `nil` or the flag can not be found on the local computer, the flag “hedgewars” is used. |
368 |
368 |
369 Since version 1.0.0, the team name might be force-changed in case of a naming collision. Since version 1.0.0, this function returns two values: `<real team name>, <team index>`. For functions that need the team name as input (lke `DismissTeam`), you must use this returned `<real team name>`. |
369 Since version 1.0.0, the team name might be force-changed in case of a naming collision. Since version 1.0.0, this function returns two values: `<real team name>, <team index>`. For functions that need the team name as input (lke `DismissTeam`), you must use this returned `<real team name>`. |
370 |
370 |
371 ==== Clan color ==== |
371 ==== Clan color ==== |
386 An older (and now discouraged) method of specifying the color is by hardcoding it as an RGB color (i.e. `0xDD0000`). This practice is now strongly discouraged because it will ignore the player-chosen color (which is *bad* for players with color blindness) and in 99% of cases you don't need it anyway. It should be only used for testing and debugging. |
386 An older (and now discouraged) method of specifying the color is by hardcoding it as an RGB color (i.e. `0xDD0000`). This practice is now strongly discouraged because it will ignore the player-chosen color (which is *bad* for players with color blindness) and in 99% of cases you don't need it anyway. It should be only used for testing and debugging. |
387 |
387 |
388 ==== Voicepack language ==== |
388 ==== Voicepack language ==== |
389 [Voicepacks] can be localized. A localized voicepack has the language code in its name after an underscore, e.g. “Default_pl” is the Polish version of “Default”. If you specify the exact name in `voicepack`, Hedgewars uses this exact language version. But if you replace the language suffix with `_qau`, Hedgewars will try to pick the appropriate localized version of that voicepack, depending on the user's language, if a localized version exists. If not, Hedgewars will pick the version of the voicepack without a language suffix (which is English, normally). |
389 [Voicepacks] can be localized. A localized voicepack has the language code in its name after an underscore, e.g. “Default_pl” is the Polish version of “Default”. If you specify the exact name in `voicepack`, Hedgewars uses this exact language version. But if you replace the language suffix with `_qau`, Hedgewars will try to pick the appropriate localized version of that voicepack, depending on the user's language, if a localized version exists. If not, Hedgewars will pick the version of the voicepack without a language suffix (which is English, normally). |
390 |
390 |
391 For example, if `voicepack` is set to “Default_qau”, Hedgewars will pick “Default_pl” if the user language is Polish. If the user language is set to a language for which there is no localize version of the Default voicepack, Hedgewars will pick the “Default” voicepack (which is in English). |
391 For example, if `voicepack` is set to “Default\_qau”, Hedgewars will pick “Default_pl” if the user language is Polish. If the user language is set to a language for which there is no localize version of the Default voicepack, Hedgewars will pick the “Default” voicepack (which is in English). |
392 |
392 |
393 We strongly recommend to always use the “_qau” suffix from version 1.0.0 on, unless you really want to force a particular language. |
393 We strongly recommend to always use the “_qau” suffix from version 1.0.0 on, unless you really want to force a particular language. |
394 |
394 |
395 ==== Example ==== |
395 ==== Example ==== |
396 |
396 |
397 <code language="lua">AddTeam("team 1", -1, "Simple", "Tank", "Default_qau", "hedgewars") |
397 <code language="lua">AddTeam("team 1", -1, "Simple", "Tank", "Default\_qau", "hedgewars") |
398 --[[ Adds a new team with name “team 1”, the first default color (usually red), the grave “Simple”, |
398 --[[ Adds a new team with name “team 1”, the first default color (usually red), the grave “Simple”, |
399 the fort “Tank” the voicepack “Default” (in the appropriate language version) and the flag “hedgewars”. ]]</code> |
399 the fort “Tank” the voicepack “Default” (in the appropriate language version) and the flag “hedgewars”. ]]</code> |
400 |
400 |
401 === <tt>!AddMissionTeam(color)</tt> (1.0.0) === |
401 === <tt>!AddMissionTeam(color)</tt> (1.0.0) === |
402 Adds a new team using the player-chosen team identity when playing a singleplayer mission. Does not work in multiplayer. |
402 Adds a new team using the player-chosen team identity when playing a singleplayer mission. Does not work in multiplayer. |