Просмотр кода страницы Audio

{{Modding}}

''Dwarf Fortress'' содержит музыкальные треки, которые играют в различные моменты игры, включая тему главного меню. Некоторые типы аудио кажется, активируются событиями, в то время как другие проигрываются случайным образом при выполнении определенных условий. К ним, по-видимому, относятся некоторые звуки [[weather|погоды]], дикая атмосфера, звуки строительства, река и т. д.

По словам Тарна, для каждого трека существуют различные настройки. Один зависит от открытия пещер, другой играет только после второго года, один - трек первого года. Музыка "Strike the Earth" играет, когда вы первоначально высаживаетесь, а затем смешивается с другими после этого. И так далее; для этого существует сырой формат, чтобы вы могли изменить его по своему усмотрению. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8403423#msg8403423]

Настройки звука игры можно регулировать в меню [[Settings#Audio|настроек]].

== Моддинг== 
{{main|Modding}}

Все звуковые и [[Soundtrack|музыкальные]] файлы, используемые в ''Dwarf Fortress'', хранятся в формате [https://en.wikipedia.org/wiki/Ogg .ogg] в подпапках <code>[[Game folder|<Dwarf Fortress>]]/data/sound/</code>. Вы можете заменить существующие файлы ogg другими. Это необходимо делать вручную и фактически не поддерживается игрой. Вы также можете изменить некоторые определения того, когда проигрываются определенные музыкальные сигналы, используя доступные токены музыки и звука в файле [[raw file]]s, найденных в <code>[[Game folder|<Dwarf Fortress>]]\data\vanilla\vanilla_music</code>. Вы можете добавлять новую музыку и звуки с помощью файлов raw в папке звуков, отформатированных следующим образом:

==Идентификаторы==

Чтобы позволить игре последовательно читать аудиофайлы, им имеется присваивать идентификатор. Идентификаторы могут быть любой произвольной строкой, так же как и любой другой объект raw.

Файлы идентификаторов хранятся в директории <code>sound/</code> мода (не в директории <code>objects/</code>, где хранится логика их воспроизведения), и их название должно начинаться с <code>sound_file_</code> или <code>music_file_</code>.

Их первая строка должна содержать имя файла, за которым следует <code> [OBJECT:SOUND_FILE]</code> или <code>[OBJECT:MUSIC_FILE]</code> соответственно.

 sound_file_example
 [OBJECT:SOUND_FILE]
 [SOUND_FILE:<identifier>]
     [FILE:file name]

 music_file_example
 [OBJECT:MUSIC_FILE]
 [MUSIC_FILE:<identifier>]
     [FILE:file name]
     [AUTHOR:author name]
     [LOOPS] optional
     [TITLE:piece title]

{| {{prettytable}}
|- bgcolor="#dddddd"
!Token
!Arguments
!Extra Information
|-
| {{text anchor|FILE}}
|
* path to audio
| (Required) Usually stored as <code>sound/...ogg</code>.
|-
| {{text anchor|AUTHOR}}
|
* string
| (Music only) Displays as the song author on pause menu.
|-
| {{text anchor|LOOPS}}
| 
| (Music only) If set, should play continuously until interrupted.{{verify}}
|-
| {{text anchor|TITLE}}
|
* string
| (Music only) Displays as track title on pause menu.
|}

==Звуковые эффекты==

Все стандартные токены звуков находятся в файле <code>objects/sound_standard.txt</code>. Все определения звуковых raw'ов должны начинаться с <code>sound_</code>, за которым следует токен <code>[OBJECT:SOUND]</code>, указывающий игре, что файл содержит определения звуков.

 [SOUND:<identifier>]
     [FILE:<[[Audio#Identifiers|file identifier]]>]
     [ANNOUNCEMENT:<announcement>]
     ...
     [ANNOUNCEMENT:<announcement n>]

{| {{prettytable}}
|- bgcolor="#dddddd"
!Token
!Arguments
!Extra Information
|-
| {{text anchor|FILE}}
|
* [[Audio#Identifiers|sound file]]
| (Required) [[Audio#Identifiers|File identifiers]] can be any of various hardcoded sounds (all present in the vanilla raws) or custom [SOUND_FILE] objects.
|-
| {{text anchor|ANNOUNCEMENT}}
|
* [[Announcements.txt|announcement(s)]]
| Trigger condition, can use more than one announcement in the list.
|-
| {{text anchor|SAVAGE_AREA}}
| 
| Played randomly in a [[Surroundings#Savage|savage]] area.
|}

==Музыкальные треки==
Все стандартные токены музыки находятся в файле <code>objects/music_standard.txt</code>. Все определения музыкальной логики должны начинаться с <code>music_</code>, за которым следует токен <code>[OBJECT:MUSIC]</code>, сообщающий игре, что файл содержит определения музыки.

 [MUSIC:TRACK_02]
 	[FILE:EXPANSIVE_CAVERN]
 		[CARD:EXPANSIVE_CAVERN_CARD_1] for the shuffled deck of short bits
 		[CARD:EXPANSIVE_CAVERN_CARD_2]
 		[CARD:EXPANSIVE_CAVERN_CARD_3]
 		[CARD:EXPANSIVE_CAVERN_CARD_4]
 	[EVENT:FIRST_CAVERN_OPENED]
 	[CONTEXT:CAVERNS_OPENED]
 	[FREQUENCY:UNCOMMON]

{| {{prettytable}}
|- bgcolor="#dddddd"
!Token
!Arguments
!Extra Information
|-
| {{text anchor|FILE}}
|
* [[Audio#Identifiers|music file]]
| (Required) Can be any of the many hardcoded [[Audio#Identifiers|files]] for the [[soundtrack]], or it can be a custom [MUSIC_FILE] object.
|-
| {{text anchor|CARD}}
|
* [[Audio#Identifiers|music file(s)]]
| Mostly unexplored, listed as a "shuffled deck of short bits." Appears to be played only if no song is currently playing? Before the song proper starts, the game will play a few of these in random order.
|-
| {{text anchor|CONTEXT}}
| [[Audio#Contexts|context(s)]]
| This song can randomly play if any of the contexts are met.
|-
| {{text anchor|EVENT}}
| [[Audio#Events|event(s)]]
| When the chosen event occurs, this song automatically plays and overrides the current song. If multiple songs match the event, a random song will be played from among them.
|-
| {{text anchor|FREQUENCY}}
|
* UNCOMMON or RARE
| Can be set to 'UNCOMMON' to set the frequency half as often as the other candidates or 'RARE' to make it 1/5 as often as other candidates.
|}

; Contexts
{| {{prettytable}}
|- bgcolor="#dddddd"
!Token
!Extra Information
|-
| {{text anchor|ANY}}
| Can play at any time, including in menus.
|-
| {{text anchor|MAIN}}
| The gamemode is [[Fortress Mode]].
|-
| {{text anchor|FIRST_YEAR}}
| You are controlling a fortress that is less than one year old.
|-
| {{text anchor|SECOND_YEAR_PLUS}}
| Your fortress has been around for more than one year.
|-
| {{text anchor|CAVERNS_OPENED}}
| Your fortress has access to the [[cavern]]s.
|-
| {{text anchor|SPRING}}
| The current season is [[spring]]. Appears to also be played in Legends mode and the main menu.
|-
| {{text anchor|SUMMER}}
| The current season is [[summer]]. Appears to also be played in Legends mode and the main menu.
|-
| {{text anchor|AUTUMN}}
| The current season is [[autumn]]. Appears to also be played in Legends mode and the main menu.
|-
| {{text anchor|WINTER}}
| The current season is [[winter]].
|}

; Events
{| {{prettytable}}
|- bgcolor="#dddddd"
!Token
!Extra Information
|-
| {{text anchor|JUST_EMBARKED}}
| Plays when [[embark|founding]] a new fortress.
|-
| {{text anchor|SIEGE}}
| A [[siege]] is announced.
|-
| {{text anchor|FIRST_CAVERN_OPENED}}
| A new cave layer is discovered {{verify}}
|-
| {{text anchor|MEGABEAST_ATTACK}}
| Plays when a [[megabeast]]'s arrival is announced. It is unknown if it is also relevant for [[Semi-megabeast|semi-megabeasts]] or [[Titan|titans]].
|-
| {{text anchor|FORGOTTEN_BEAST_ATTACK}}
| Plays when a [[forgotten beast]]'s arrival is announced.
|-
| {{text anchor|DEATH_SPIRAL}}
| Many citizen deaths have occurred in short succession.
|-
| {{text anchor|TAVERN_MUSIC_PRESENT}}
| Many units have gathered to perform or watch a [[Performer#Music|musical form]].
|-
| {{text anchor|TAVERN_DANCE_PRESENT}}
| Many units have gathered to perform or watch a [[Performer#Dance|dance]].
|-
| {{text anchor|LOST_FORT}}
| Ending a game: a fortress has just been [[Reclaim fortress mode|abandoned or retired]] or your [[adventurer]] has died.
|}

== Смотрите также== 
* [[Soundtrack|Саундтрек]] 
* [https://www.youtube.com/watch?v=mJyMhgadpcQ ambiences and music snippets]
* [[Soundsense]]
* [https://github.com/Putnam3145/dwarf-fortress-example-sound-mod Example sound mod] by [[:en:User:Putnam3145|Putnam]]

[[Category:game]]