63 lines
1.7 KiB
Markdown
63 lines
1.7 KiB
Markdown
Sentences are the voice-acting backbone of the sound system.
|
||
|
||
The definitions for each games' voice acting are stored inside
|
||
`sound/sentences.txt`.
|
||
|
||
# Syntax {#syntax}
|
||
|
||
Each line is a new sentence group.
|
||
|
||
`GROUPNAME [PARAMETERS] SAMPLES`
|
||
|
||
Real-world example:
|
||
|
||
**`MALETEST`**` attention(p120) male/hello how are you`
|
||
|
||
The above example lists 5 samples that'll get played.
|
||
|
||
If a sample is not in a sub-directory, it'll be assumed to be part of
|
||
the **vox** sub-directory, or the last valid path of a previous sample.
|
||
For example
|
||
|
||
`attention male/hello how are you`
|
||
|
||
plays the following samples:
|
||
|
||
**`vox`**`/attention.wav male/hello.wav male/how.wav male/are.wav male/you.wav`
|
||
|
||
*When parameters are surrounded by spaces, this means they apply to all
|
||
current samples.* They can be overwritten later down the parsing.
|
||
|
||
When a parameter is attached to a sample, e.g.
|
||
|
||
`attention(p120)`
|
||
|
||
Then this parameter only applies to said keyword.
|
||
|
||
Whereas...
|
||
|
||
`(p120) attention everyone alive`
|
||
|
||
Will apply the pitch effect to all three succeeding samples.
|
||
|
||
## Parameters {#parameters}
|
||
|
||
- (pXX) = Pitch. Valid values are from 50 to 150.
|
||
- (vXX) = Volume. Valid values are from 0 to 100.
|
||
- (sXX) = Start point in %. E.g. 10 skips the first 10% of the sample.
|
||
- (eXX) = End point in %. E.g. 75 ends playback 75% into the sample.
|
||
- (tXX) = Time shift/compression in %. 100 is unaltered speed, wheras
|
||
50 plays the sample back in half the time.
|
||
|
||
# Usage {#usage}
|
||
|
||
When an entity, say, a **scripted_sentence** wants to play a sentence,
|
||
it'll prefix it with an exclamation mark ( **!** ). For example:
|
||
|
||
`"sentence" "!GM_SUIT"`
|
||
|
||
Will play:
|
||
|
||
`GM_SUIT gman/gman_suit`
|
||
|
||
[Category: Nuclide Scripting](/Category:_Nuclide_Scripting "wikilink") |