Voicepacks.wiki
author Wuzzy
Fri, 27 Nov 2020 13:45:03 +0100
changeset 2200 b285ffef13e0
parent 1988 cf306f6c8af2
permissions -rw-r--r--
Translations: Add TOC
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
568
308ea2972bb1 Short intro on voicepacks
almikes@aol.com
parents:
diff changeset
     1
#summary Short information about the structure and creation of voicepacks
308ea2972bb1 Short intro on voicepacks
almikes@aol.com
parents:
diff changeset
     2
= Voicepacks =
308ea2972bb1 Short intro on voicepacks
almikes@aol.com
parents:
diff changeset
     3
== Introduction ==
308ea2972bb1 Short intro on voicepacks
almikes@aol.com
parents:
diff changeset
     4
Voicepacks are collections of audio files which contain the taunts the hedgehogs say on various events.
308ea2972bb1 Short intro on voicepacks
almikes@aol.com
parents:
diff changeset
     5
308ea2972bb1 Short intro on voicepacks
almikes@aol.com
parents:
diff changeset
     6
== Creating voicepacks ==
308ea2972bb1 Short intro on voicepacks
almikes@aol.com
parents:
diff changeset
     7
1564
d7ffa0f2e78e Voicepacks: Add recommended sample rate
Wuzzy
parents: 1249
diff changeset
     8
A voicepack is a directory in `Data/Sounds/voices` and contains a bunch of audio files which are encoded in the Ogg Vorbis format. All the audio files should have a sample rate of 44100 Hz.
568
308ea2972bb1 Short intro on voicepacks
almikes@aol.com
parents:
diff changeset
     9
1672
41dc5e7910c0 Voicepacks: remove extension note
Wuzzy
parents: 1564
diff changeset
    10
Each audio file represents a single taunt which is played at certain events. Only files with the correct file names will be recognized as taunts, other files will be ignored. For a list of recognized file names, see [Taunts].
973
ce2673c4b8fa Voicepacks: Hint for adding extra-taunts
Wuzzy
parents: 943
diff changeset
    11
1060
7b2cde186c96 Voicepacks: fix typo
Wuzzy
parents: 1059
diff changeset
    12
Important links:
659
7d9bc79b233a Fix typo
Wuzzy
parents: 568
diff changeset
    13
1059
f97cf9eed3c4 Voicepacks: Edited via web interface
Wuzzy
parents: 1058
diff changeset
    14
 * [Taunts]
f97cf9eed3c4 Voicepacks: Edited via web interface
Wuzzy
parents: 1058
diff changeset
    15
 * [https://www.hedgewars.org/node/2132 Recording Voices for Hedgewars] (guide)
568
308ea2972bb1 Short intro on voicepacks
almikes@aol.com
parents:
diff changeset
    16
308ea2972bb1 Short intro on voicepacks
almikes@aol.com
parents:
diff changeset
    17
== Special voicepacks ==
1987
d1f476f458e8 Voicepacks: 1.0.0 update
Wuzzy
parents: 1672
diff changeset
    18
The voicepack “Default” is the English default voice and is used as the ultimate fallback, if a voicepack cannot be found.
568
308ea2972bb1 Short intro on voicepacks
almikes@aol.com
parents:
diff changeset
    19
1988
cf306f6c8af2 Voicepacks: Edited via web interface
Wuzzy
parents: 1987
diff changeset
    20
Voicepacks with a name of the form “`Name_<language>`” (where “Name” can be a name of your liking, and “`<language>`” is a language code) are for specifying a localized version of a voicepack. Voicepacks without the language code are assumed to be in English.
1987
d1f476f458e8 Voicepacks: 1.0.0 update
Wuzzy
parents: 1672
diff changeset
    21
d1f476f458e8 Voicepacks: 1.0.0 update
Wuzzy
parents: 1672
diff changeset
    22
=== In Lua scripting ===
943
8151ecbc40a3 a bit of clarification on localisation
nemo
parents: 798
diff changeset
    23
1987
d1f476f458e8 Voicepacks: 1.0.0 update
Wuzzy
parents: 1672
diff changeset
    24
If in `AddTeam`, you use the special language code `qau`, then Hedgewars will try to play the matching localized version of that voicepack, with respect to the player's language (e.g. `Pirate_de`). If no localized version exists, Hedgewars falls back to the voicepack with no language code (e.g. `Pirate`).
568
308ea2972bb1 Short intro on voicepacks
almikes@aol.com
parents:
diff changeset
    25
1987
d1f476f458e8 Voicepacks: 1.0.0 update
Wuzzy
parents: 1672
diff changeset
    26
For example, if you specify “`Default_qau`” as voice in `AddTeam` in Lua, Hedgewars will play `Default_ru` for Russian players, `Default_pl` for Polish players, `Default` for English players and players with no localized version of `Default` available yet. But if you just specify `Default` in `AddTeam`, the team will always use the English `Default` voicepack for all players.
568
308ea2972bb1 Short intro on voicepacks
almikes@aol.com
parents:
diff changeset
    27
1987
d1f476f458e8 Voicepacks: 1.0.0 update
Wuzzy
parents: 1672
diff changeset
    28
In versions before 1.0.0, the special `qau` code did not exist and the automatic voicepack selection was kinda annoying. Hedgewars tried to force the automatic language selection pretty ruthlessly with no way to avoid it, and it was impossible to e.g. specify the `Default` voice explicitly.
664
cb261c3b1907 Sharing section
Wuzzy
parents: 660
diff changeset
    29
cb261c3b1907 Sharing section
Wuzzy
parents: 660
diff changeset
    30
== Sharing voicepacks ==
cb261c3b1907 Sharing section
Wuzzy
parents: 660
diff changeset
    31
Custom voicepacks (voicepacks which are not part of the official Hedgewars installation) can only be heard by other players (online) if they have the voicepack installed under the same name.
cb261c3b1907 Sharing section
Wuzzy
parents: 660
diff changeset
    32
cb261c3b1907 Sharing section
Wuzzy
parents: 660
diff changeset
    33
In case the other player does not have the custom voicepack installed, the player will hear the default voice instead.
cb261c3b1907 Sharing section
Wuzzy
parents: 660
diff changeset
    34
943
8151ecbc40a3 a bit of clarification on localisation
nemo
parents: 798
diff changeset
    35
You are encouraged to share your voicepacks in the “[https://www.hedgewars.org/forum/19 Content Creations]” forum.