Instrument token

С v0.42.01 в игре музыкальные инструменты процедурно генерируются для каждого мира, но при необходимости всё ещё можно создать собственные конфигурации в raw-файлах с использованием токенов типа [ITEM_INSTRUMENT]. Как и раньше, может использоваться большинство токенов обычных инструментов, но также появились специальные токены для музыкальных инструментов.

Информация для статьи взята из файла raw/objects/examples and notes/item_instrument_example.txt, который также включает полезные примеры инструментов.

Токен	Аргументы	Описание
PLACED_AS_BUILDING		Делает музыкальный инструмент стационарным.
DOMINANT_MATERIAL_PIECE	деталь инструмента	Деталь музыкального инструмента считается основной его частью.
INSTRUMENT_PIECE	токен токен инструмента ед. ч. мн. ч. STANDARD/ALWAYS_PLURAL/ALWAYS_SINGULAR	Определяет деталь инструмента. Аргумент токен служит идентификатором, по которому другие токены смогут ссылаться на эту деталь инструмента. Аргумент токен инструмента является ссылкой на инструмент, который требуется (и тратится) для создания этой детали. Если у музыкального инструмента не разделён на детали, можно использовать ключевое слово SELF для любого аргумента, где требуется ссылка на инструмент.
VOLUME_mB	мин. макс.	Диапазон громкости инструмента, в миллибелах (100 мБ = 1 дБ).
SOUND_PRODUCTION	различные токены	Определяет, как музыкант может воспроизводить звук при использовании этого инструмента. Можно использовать несколько раз. Допустимые токены и их обязательные дополнительные аргументы: PLUCKED_BY_BP, PLUCKED (требуется два токена; воздействующий затем цель воздействия) BOWED (два токена) STRUCK_BY_BP, STRUCK (два токена) VIBRATE_BP_AGAINST_OPENING BLOW_AGAINST_FIPPLE, BLOW_OVER_OPENING_SIDE, BLOW_OVER_OPENING_END, BLOW_OVER_SINGLE_REED, BLOW_OVER_DOUBLE_REED, BLOW_OVER_FREE_REED STRUCK_TOGETHER, SHAKEN SCRAPED (два токена), FRICTION (два токена) RESONATOR BAG_OVER_REED (два токена), AIR_OVER_REED (два токена), AIR_OVER_FREE_REED (два токена), AIR_AGAINST_FIPPLE (два токена)
PITCH_CHOICE	метод	Определяет, как музыкант может изменять высоту звука. Можно использовать несколько раз. Допустимые методы: MEMBRANE_POSITION SUBPART_CHOICE KEYBOARD STOPPING_FRET (требуется два токена, первый для "strings" второй для "neck" – или к чему бы ни прижимался инструмент), STOPPING_AGAINST_BODY (два токена), STOPPING_HOLE, STOPPING_HOLE_KEY SLIDE HARMONIC_SERIES VALVE_ROUTES_AIR BP_IN_BELL FOOT_PEDALS (два токена, во-первых, это то, что изменяется, например, "strings", второе – это "body" с педалью – или какая-либо деталь, на которую надо наступать)
TUNING	метод деталь инструмента	Можно использовать несколько раз. Допустимые методы: PEGS, ADJUSTABLE_BRIDGES, CROOKS, TIGHTENING, LEVERS.
PITCH_RANGE	мин. высота макс. высота	Цитата из примера: Высота звука в диапазоне <мин>:<макс> в центах, где 0 – среднее C. В октаве 1200 центов. Игра различает значения от -4200 до 4200, но вы можете выйти за эти пределы, если хотите. Генерируемые инструменты обычно остаются в пределах от C0 до C8 (от -4800 до 4800), хотя редкие образцы выходят за пределы. Вы также можете использовать INDEFINITE_PITCH.
INDEFINITE_PITCH		Может служить заменой [PITCH_RANGE].
TIMBRE	любой количество тембров	Допустимые тембры: CLEAR, NOISY, FULL, THIN, ROUND, SHARP, SMOOTH, CHOPPY, STEADY, EVOLVING, STRONG, DELICATE, BRIGHT, GRACEFUL, SPARSE, BREATHY, STRAINED, BROAD, LIGHT, MELLOW, WOBBLING, FOCUSED, EVEN, FLUID, VIBRATING, QUAVERING, EERIE, FRAGILE, BRITTLE, PURE, PIERCING, STRIDENT, WAVERING, HARSH, REEDY, NASAL, BUZZY, ROUGH, WARM, RUGGED, HEAVY, FLAT, DARK, CRISP, SONOROUS, WATERY, GENTLE, SLICING, LIQUID, RAUCOUS, BREEZY, RASPY, WISPY, SHRILL, MUDDY, RICH, DULL, FLOATING, RINGING, RESONANT, SWEET, RIPPLING, SPARKLING.
REGISTER	мин. высота макс. высота любой количество тембров	См. [PITCH_RANGE] и [TIMBRE] для доступных значений. Диапазон высот регистра переопределяет глобальную высоту, но тембры регистра добавляются к глобальным.
MUSIC_SKILL	токен навыка	Какой навык будет развиваться, играя на инструменте. Любой токен навыка подходит, но сгенерированные в игре инструменты используют только PLAY_KEYBOARD_INSTRUMENT, PLAY_STRINGED_INSTRUMENT, PLAY_WIND_INSTRUMENT или PLAY_PERCUSSION_INSTRUMENT. Уровни в этом навыке не имеют никакого влияния на качество производимой музыки. Можно использовать только один раз.
DESCRIPTION	описание	Общее описание сложного инструмента. В одном и том же инструменте можно использовать несколько токенов [DESCRIPTION], каждое будет появляться в новой строке.