# Введение **Sanny Builder** - это среда разработки новых миссий и скриптов для серии игр GTA 3D. В комплект входит дизассемблер, который переводит игровые скрипты в текстовый формат; компилятор, который переводит скрипт в формат, читаемый игрой, и удобный редактор со множеством [вспомогательных функций](/ru/editor/features), таких как подсветка синтаксиса, чтение координат игрока в игре, быстрое перемещение по участкам кода и многое другое. Добавьте к этому быструю скорость работы и настраиваемый синтаксис кода (через [классы](/ru/coding/classes) и [ключевые слова](/ru/coding/keywords)) и вы получите представление о программе. ## Установка и обновление Запустите инсталлятор и следуйте его инструкциям. Во время установки вы можете дополнительно указать папку с игрой, с которой будете работать, ассоциировать файлы с расширением `.scm` с Sanny Builder, установить [библиотеку CLEO](https://cleo.li/ru). Все эти [опции](/ru/editor/options) вы можете потом изменить в самой программе. Для полного удаления программы запустите файл `unins000.exe` в директории программы. Свежие версии и обновления программы всегда можно найти на официальном сайте [sannybuilder.com](https://sannybuilder.com/) ## Контактная информация [Discord](https://sannybuilder.com/discord)\ [Sanny Builder на GitHub](https://github.com/sannybuilder/dev/issues)\ [Sanny Builder в **𝕏**](https://twitter.com/SannyBuilderDev) Используйте программу на свой страх и риск. Делайте резервные копии всех редактируемых файлов. © 2005-2023 Seemann # Благодарности ## Участники проекта Автор и разработчик **Sanny Builder** - [Seemann](https://github.com/x87). Проекту также помогали: Alexander Blade, Barton Waterduck, BG\_ASM, Capushon, CyQ, Demarest, JernejL, Hammer83, koPPP, listener, MatiDragon, Midnightz, OrionSR, pdescobar, PLPynton, San'OK, Sergey81, spaceeinstein, Silent, Vital, wmysterio, XMDS, Y\_Less, ZAZ, и многие другие. **Особая благодарность за помощь выражается yelmi и Xieon.** ## Авторы переводов Y\_Less, tomworld10, -Shadow-Link, Mordecki, Silent, WordsBG, FunGt, Wesser, Mobster, Jost\_Vice, Thomazu, Balint, Ridvan and Tuna (RT), Mega GTAшnik, SHooZ, Yi Yangyijk, VCT team, Alex5526, Marek Simsa, Syping/Hulkkiller, IMasterFX, MINE, MatiDragon, wmysterio, forms55, XMDS, NicusorN5, Sdas50, Bloodriver the Conqueror. ## Программы и компоненты Delphi 7 © Borland Software Corp\ [http://www.borland.com](http://www.borland.com/) SynEdit © Команда разработчиков SynEdit\ [http://synedit.sourceforge.net](http://synedit.sourceforge.net/) Inno Setup © Jordan Russell, Martijn Laan\ # История изменений ## v. 4.0.0 - 04.08.2024 * [functions support](https://docs.sannybuilder.com/language/functions) (`function..end`) * [CLEO 5 modules](https://docs.sannybuilder.com/language/import-export) support * [new SBL edit modes](/ru/edit-modes#available-modes) * [debugger](https://docs.sannybuilder.com/editor/scm-debugger) for main.scm scripts * [`switch..end`](https://docs.sannybuilder.com/language/control-flow/switch) * binary number format (`0b101010`) * new tabs * other improvements and fixes See the [complete list of changes](https://github.com/sannybuilder/dev/issues/277). Visit [SannyBuilder Discord](https://sannybuilder.com/discord) for additional information and support. {% hint style="info" %} This release won't be possible without great feedback and testing from Sanny Builder community as well as support from my [Patreon](https://www.patreon.com/seemann). {% endhint %} ## v. 3.9.1 - 18.09.2023 * имя массива в выражениях без опкодов может быть константой [#250](https://github.com/sannybuilder/dev/issues/250) * декомпилятор использует Alloc для глобальных переменных, если они отличаются от CustomVariables.ini [#251](https://github.com/sannybuilder/dev/issues/251) * опция "[Регистр букв](/ru/editor/options/formats#registr-bukv)" по умолчанию установлена в "Как есть" [#256](https://github.com/sannybuilder/dev/issues/256) * исправлена ошибка, возникающая при компиляции опкода 0B17 [#254](https://github.com/sannybuilder/dev/issues/254) * исправлена ошибка, из-за которой редактор не предлагал использовать исходный код скрипта [#258](https://github.com/sannybuilder/dev/issues/258) * исправлены некоторые проблемы, связанные с объявлением строковых переменных [#259](https://github.com/sannybuilder/dev/issues/259), [#265](https://github.com/sannybuilder/dev/issues/265) ## v. 3.9.0 - 09.09.2023 * названия команд, используемые в JSON файлах [Sanny Builder Library](https://library.sannybuilder.com), могут использоваться в качестве [ключевых слов](/ru/coding/keywords) * улучшения [HEX..END](/ru/coding/hex..end#byte-repetition) (многократное повторение байтов, подключение бинарных файлов) * упрощенное объявление [констант](/ru/coding/constants#obyavlenie-konstant) и [переменных](/ru/coding/variables#declaring-a-variable-type) (`const x = 1, y = 2`, `float x, y, z`) * новые [операторы](/ru/coding/operators#pobitovye-operacii) (побитовые, `=@`, `=#`) * [директива](/ru/coding/directives) `{$INCLUDE_ONCE}` * новые [режимы редактирования](/ru/edit-modes) могут быть добавлены простым копированием в папку `data`, файла `modes.xml` больше нет * исправления ошибок и другие улучшения 👏 Спасибо всем, кто помогал и участвовал в этом релизе, а так же большое спасибо тем, кто поддерживает меня на [Patreon](https://patreon.com/seemann). {% hint style="info" %} Некоторый ошибочный код, который компилировался в предыдущих версиях, теперь будет вызывать ошибку. См. примеры такого кода [тут](https://github.com/sannybuilder/dev/issues/231#issuecomment-1627984136). {% endhint %} [Полный список изменений](https://github.com/sannybuilder/dev/issues/231) ## v. 3.8.5 - 22.02.2023 * исправлен баг [#216](https://github.com/sannybuilder/dev/issues/216) ## v. 3.8.4 - 17.02.2023 * при запуске программы с файлом (опция Открыть с помощью...) ранее открытые файлы должны быть доступны [#151](https://github.com/sannybuilder/dev/issues/151) * [новая опция](/ru/editor/cli#decompile) командной строки `--decompile` * исправлены баги [#212](https://github.com/sannybuilder/dev/issues/212), [#213](https://github.com/sannybuilder/dev/issues/213), [#180](https://github.com/sannybuilder/dev/issues/180) * исправлены некоторые проблемы компиляции классов с аргументами в виде строковых литералов ## v. 3.8.3 - 08.01.2023 * исправлены баги [#210](https://github.com/sannybuilder/dev/issues/210), [#204](https://github.com/sannybuilder/dev/issues/204), [#168](https://github.com/sannybuilder/dev/issues/168) * исправлен [баг](https://github.com/sannybuilder/GetObjectID/issues/1) в поиске моделей * плагин CLEO+ обновлен до [1.1.3](https://github.com/JuniorDjjr/CLEOPlus/releases/tag/v1.1.3) ## v. 3.8.2 - 08.09.2022 * исправлены баги [#200](https://github.com/sannybuilder/dev/issues/200), [#187](https://github.com/sannybuilder/dev/issues/187) ## v. 3.8.1 - 01.09.2022 * добавлена поддержка большего количества команд, завершающих выражение с несколькими условиями [#133](https://github.com/sannybuilder/dev/issues/133) ``` if and 0AB0: is_key_pressed 9 0AB0: is_key_pressed 10 0AA0: gosub_if_false @label // раньше не работало, теперь компилируется ``` * новые и обновленные [переводы](https://github.com/sannybuilder/translations) (испанский, украинский, румынский, армянский языки) * [новые темы оформления](https://github.com/sannybuilder/themes), созданные и присланные пользователями * [большое обновление](https://github.com/MatiDragon-YT/help-system) локальных справочных материалов * новый [режим редактирования](/ru/edit-modes) для GTA SA PS2 с поддержкой команд PS2 CLEO * обновлены файлы [CLEO](https://cleo.li/) и плагины: * CLEO для San Andreas 4.4.1 * CLEO для GTA III и Vice City 2.0.0.6 * плагин [CLEO+ 1.1.2](https://github.com/JuniorDjjr/CLEOPlus/releases/tag/v1.1.2) * исправлены баги [#172](https://github.com/sannybuilder/dev/issues/172), [#189](https://github.com/sannybuilder/dev/issues/189) 👏 Спасибо тем, кто участвовал в создании этой версии: [NicusorN5](https://github.com/NicusorN5), [Junior\_Djjr](https://github.com/JuniorDjjr), [wmysterio](https://github.com/wmysterio), [MatiDragon](https://github.com/MatiDragon-YT), [DanielSant0s](https://github.com/DanielSant0s), [JaggerJam69](https://github.com/JaggerJam69), [Vital](https://github.com/VitalRus95), [Sdas50](https://github.com/Sdas50), [nick7](https://github.com/nick7) [Полный список изменений](https://github.com/sannybuilder/dev/issues/182) ## v. 3.8.0 - 04.08.2021 * [интеграция с Sanny Builder Library](/ru/editor/features#integration-with-sanny-builder-library): новым порталом с документацией по всем известным опкодам * добавлено 16 [новых тем оформления](https://github.com/sannybuilder/themes) * дизассемблер теперь выводит содержимое блока `hex..end` как строку, если оно является последовательностью ASCII символов, завершающейся нулевым байтом [#33](https://github.com/sannybuilder/dev/issues/33) * [новая отладочная опция](/ru/editor/console#skip_extra_info), которая позволяет дизассемблеру игнорировать блок с доп. информацией в конце скрипта * [новый параметр командной строки](/ru/editor/cli#option) для запуска Sanny Builder с определенными настройками * [пользовательские шаблоны кода](/ru/edit-modes/code-templates#adding-a-new-template) теперь сохраняются в отдельный файл, чтобы обновления их не перезаписывали * сочетания [горячих клавиш](/ru/editor/hotkeys), которые использовали цифровую клавиатуру (Numpad), были изменены (Размер текста: Ctrl + +/- and Переход к метке и обратно: Alt + Right/Left) * плагин [CLEO+](https://github.com/JuniorDjjr/CLEOPlus) обновлен до версии 1.0.8 * обновлены переводы на венгерский, испанский, украинский и китайский языки * [исправлено 16 багов](https://github.com/sannybuilder/dev/issues/130#issue-805022048) 👏 Спасибо тем, кто помогал с этим релизом: [forms55](https://github.com/forms55), [MatiDragon](https://github.com/MatiDragon-YT), [Vital](https://github.com/VitalRus95), [wmysterio](https://github.com/wmysterio), [XMDS](https://github.com/XMDS) [Полный список изменений](https://github.com/sannybuilder/dev/issues/130) ## v. 3.7.0 - 30.01.2021 * объявленные [константы](/ru/coding/constants) теперь подсвечиваются ([#28](https://github.com/sannybuilder/dev/issues/28)) * список автодополнения показывает объявленные константы ([#40](https://github.com/sannybuilder/dev/issues/40)) * для каждой вкладки в редакторе можно выбирать свой [режим редактирования](/ru/edit-modes) ([#87](https://github.com/sannybuilder/dev/issues/87)) * новый режим VC Mobile с опкодами CLEO Android ([sannybuilder/data#11](https://github.com/sannybuilder/data/pull/11)) * в режим VC PC добавлены опкоды из [Opcode Restoration project](https://github.com/cleolibrary/opcodes-restoration-project) (автор spaceeinstein) * сообщения об ошибке теперь содержат ссылку на переведенную документацию, если таковая имеется ([#101](https://github.com/sannybuilder/dev/issues/101)) * конфигурация [внешних приложений](/ru/editor/features#menyu-vneshnikh-prilozhenii) поддерживает переменные **@sb:** и **@game:** ([#72](https://github.com/sannybuilder/dev/issues/72)) * плагин [CLEO+](https://github.com/JuniorDjjr/CLEOPlus) обновлен до версии 1.0.7 * исправлены баги: [#103](https://github.com/sannybuilder/dev/issues/103) [#114](https://github.com/sannybuilder/dev/issues/114) [#120](https://github.com/sannybuilder/dev/issues/120) {% hint style="info" %} Узнать больше о подсветке констант можно в статье [Языковая служба](/ru/editor/language-service). {% endhint %} [Полный список изменений](https://github.com/sannybuilder/dev/issues/90) 👏 Спасибо [XMDS](https://github.com/XMDS) за вклад в этот релиз. ## v. 3.6.2 - 29.11.2020 * исправлен баг с метками, отсутствующими в дизассемблированных CLEO скриптах [#99](https://github.com/sannybuilder/dev/issues/99) ## v. 3.6.1 - 27.11.2020 * обновлен перевод на украинский язык * обновлен плагин CLEO+ до версии 1.0.4 * обновлены описания и ключевые слова для CLEO опкодов [#95](https://github.com/sannybuilder/dev/issues/95) * исправлены баги в компиляторе [#96](https://github.com/sannybuilder/dev/issues/96), [#98](https://github.com/sannybuilder/dev/issues/98) * небольшие изменения и исправления (см. [полный список](https://github.com/sannybuilder/dev/issues/91)) 👏 Спасибо [wmysterio](https://github.com/wmysterio/) и [XMDS](https://github.com/XMDS) за их вклад в это обновление. ## v. 3.6.0 - 11.11.2020 * поддержка [перечисляемых типов](/ru/coding/classes#class-constants) в классах * новые [типы](/ru/edit-modes/opcodes-list-scm.ini#parameter-types) параметров опкодов: [`m%`](https://github.com/sannybuilder/dev/issues/10) and [`k%`](https://github.com/sannybuilder/dev/issues/21) * начальная поддержка [расширений](/ru/edit-modes/extensions) * улучшена интеграция с библиотекой CLEO: * обновлены пакеты в папке `tools`: * CLEO v4.4 * SCRLog v2020.2 * добавлен [плагин CLEO+](https://github.com/sannybuilder/dev/issues/71) для GTA SA с 250+ новыми опкодами * скомпилированные скрипты для CLEO Android (`*.csa`, `*.csi`) теперь [распознаются](https://github.com/sannybuilder/dev/issues/64) * компилятор использует CLEO опкоды `0A9E`, `0A9F`, `0A90`, `0A91` [в определенных выражениях без опкода](https://github.com/sannybuilder/dev/issues/58#issuecomment-723376464) * унифицированы описания и кейворды для CLEO опкодов среди различных режимов редактирования * добавлены [кейворды](/ru/coding/keywords) для всех опкодов в режиме GTA SA SCR * слово *thread* было заменено на *script* в описаниях опкодов и кейвордах ([см. почему](https://gtamods.com/wiki/Talk:Script#Thread-%3EScript%29.)) * обновления IDE: * директория игры теперь не является обязательной для запуска компиляции ([#48](https://github.com/sannybuilder/dev/issues/48)) * папка для "Компилировать и сделать копию" теперь конфигурируется ([#9](https://github.com/sannybuilder/dev/issues/9)) * обновлены переводы на испанский и итальянский языки * добавлена возможность ассоциировать Sanny Builder с расширениями `*.csa` и `*.csi` (скрипты для CLEO Android). [Полный список изменений и исправлений](https://github.com/sannybuilder/dev/issues/61) 👏 Спасибо [MatiDragon](https://github.com/MatiDragon-YT) и [Wesser](https://gtaforums.com/profile/172776-wesser/) за обновленные переводы. ## v. 3.5.1 - 21.08.2020 * исправлен баг с компиляцией скриптов LCS и VCS ([#56](https://github.com/sannybuilder/dev/issues/56)) * массивы в LCS and VCS теперь получают собственные имена из файлов `CustomVariables.ini` и `CustomArrays.ini` ([#53](https://github.com/sannybuilder/dev/issues/53)) 👏 Спасибо [darkdraggy](https://gtaforums.com/profile/1097463-darkdraggy/) за обнаружение первого бага и помощь в тестировании. ## v. 3.5.0 - 18.08.2020 * изменения в [интерфейсе командной строки](/ru/editor/cli) * Unix-подобный синтаксис с дефисами ([#42](https://github.com/sannybuilder/dev/issues/42)) * новые опции [`-x`](/ru/editor/cli#x), [`--game`](/ru/editor/cli#game), [`--mode`](/ru/editor/cli#mode) * улучшения [режимов редактирования](/ru/edit-modes) * `games.xml` переименован в `modes.xml`, обновлена [внутренняя структура](/ru/edit-modes#format-faila) * режимы могут [наследовать](/ru/edit-modes#extends) свойства других режимов (полезно для поддержки различных версий одной игры) * новый режим для SA v2.0 (использует [`CustomLabels_v2.ini`](/ru/edit-modes/customlabels.ini)) * раздельные режимы для VCS PSP и VCS PS2 ([#41](https://github.com/sannybuilder/dev/issues/41)) * поддержка [собственных IDE/DAT файлов](/ru/edit-modes#ide) * "горячая" перезагрузка режимов редактирования ([#15](https://github.com/sannybuilder/dev/issues/15)) * увеличено пространство для имени режима в углу экрана ([#8](https://github.com/sannybuilder/dev/issues/8)) * обновлены описания опкодов LCS/VCS\* * убран конвертер синтаксиса SAMB в SB ([#27](https://github.com/sannybuilder/dev/issues/27)) * исправлена [привязка файловых расширений](/ru/editor/options/general#privyazka-failovykh-rasshirenii) к Sanny Builder ([#43](https://github.com/sannybuilder/dev/issues/43#issuecomment-670219723)) * исправлен баг с компиляцией скриптов LCS и VCS ([#49](https://github.com/sannybuilder/dev/issues/49), [#0053](http://bugs.sannybuilder.com/view.php?id=53), [#0064](http://bugs.sannybuilder.com/view.php?id=64)) * исправлена проблема, при которой окно [Opcode Search Tool](/ru/editor/opcode-search-tool) было недоступно после сворачивания ([#35](https://github.com/sannybuilder/dev/issues/35)) {% hint style="warning" %} Новые описания опкодов для GTA LCS и GTA VCS несовместимы с предыдущими версиями. Вы должны заново дизассемблировать `main.scm` этих игр прежде чем делать какие-то изменения. {% endhint %} 👏 Спасибо [marcelo\_20xx](https://gtaforums.com/profile/95582-marcelo_20xx/) и [fastman92](https://gtaforums.com/profile/423631-fastman92/) за их вклад в этот релиз. ## v. 3.4.1 - 06.08.2020 * исправлено неверное количество параметров у опкода `04E3` в `VCSSCM.INI` * исправлена проблема в дизассемблере, которая приводила к игнорированию опции "Писать опкоды" и генерации невалидного кода ## v. 3.4.0 - 04.08.2020 * добавлена поддержка компиляции `SCM` в GTA: Vice City Stories ([#2](https://github.com/sannybuilder/dev/issues/2)) * добавлена возможность [объявлять](/ru/coding/variables#korotkaya-forma-obyavleniya-peremennykh) локальные переменные с собственными именами ([#32](https://github.com/sannybuilder/dev/issues/32)) * добавлен упрощенный синтаксис для вызова подпрограмм, используя [имя метки](/ru/coding/data-types#metki): если после имени метки стоит `()` это представляет команду`gosub` * больше конфигураций для [режимов редактирования](/ru/edit-modes): * путь к `GXT` файлу, который использует дизассемблер ([#7](https://github.com/sannybuilder/dev/issues/7)) * путь к `opcodes.txt` ([#5](https://github.com/sannybuilder/dev/issues/5)) * эксклюзивные [шаблоны кода](/ru/edit-modes/code-templates) * добавлен новый туториал о высокоуровневых конструкциях в языке Sanny Builder (на английском), лежит в папке `help\examples` * обновления IDE: * `Запуск San Andreas` из меню теперь проверяет наличие файла `gta-sa.exe` (Steam) * новый пункт меню для быстрого создания CLEO скрипта (см. примечание внизу статьи [Шаблоны кода](/ru/edit-modes/code-templates)) * ссылки на новый портал с документацией в меню и сообщениях об ошибках * небольшие изменения: * обновлены определения некоторых опкодов (player money += в SA, award\_achievement в SA Mobile, `0479` в VCS) * в файле `CustomVariables.ini` для GTA III переменные `script_controlled_player` и `flag_player_on_mission` переименованы в `PLAYER_ACTOR` и `ONMISSION` соответственно ([#3](https://github.com/sannybuilder/data/issues/3)) * возвращена старая версия файлов в папке `help\GXT Strings` ([#25](https://github.com/sannybuilder/dev/issues/25)) * файл `macroes.txt` переименован `templates.txt` * [обновления переводов](https://github.com/sannybuilder/translations/milestone/1) 👏 Спасибо [OrionSR](https://gtaforums.com/profile/213525-orionsr/), [ZAZ](https://gtaforums.com/profile/67506-zaz/), [XMDS](https://gtaforums.com/profile/1034872-xmds), и [Wesser](https://gtaforums.com/profile/172776-wesser/) за их вклад в этот релиз. ## v. 3.3.3 - 20.10.2019 * исправлен [баг](http://bugs.sannybuilder.com/view.php?id=52), вызывавший неправильную компиляцию внешних скриптов ## v. 3.3.2 - 19.10.2019 * исправлены баги [#0036](http://bugs.sannybuilder.com/view.php?id=36), [#0050](http://bugs.sannybuilder.com/view.php?id=50) * исправлен опкод `059C` в режиме `Vice City` ## v. 3.3.1 - 14.09.2019 * исправлен баг [#0048](http://bugs.sannybuilder.com/view.php?id=48) * добавлен файл `constants.txt,` который отсутствовал для режима `GTA SA` ## v. 3.3.0 - 08.09.2019 * добавлена поддержка для компиляции `SCM` Liberty City Stories * добавлены алиасы для [переменных-таймеров](/ru/coding/variables#peremennye-taimery): TIMERA and TIMERB * опция [Проверка переменных](/ru/editor/options/general#proverka-peremennykh) теперь применяется и к глобальным переменным ## v. 3.2.4 - 04.08.2019 * исправлены баги [#0031](http://bugs.sannybuilder.com/view.php?id=31), [#0032](http://bugs.sannybuilder.com/view.php?id=32), [#0033](http://bugs.sannybuilder.com/view.php?id=33), [#0040](http://bugs.sannybuilder.com/view.php?id=40), [#0044](http://bugs.sannybuilder.com/view.php?id=44) * исправлен дефект предыдущей версии, когда CHM справка не открывалась * обновлены описания опкодов для GTA 3 и Vice City * в IDE добавлена поддержка CLEO 2.0 для III и VC ## v. 3.2.3 - 07.07.2019 * улучшена поддержка версии GTA San Andreas для WinStore, Xbox 360 и PS3 * исправлена ошибка с неправильной декомпиляцией опкодов `09A4` и `0A18` в режиме `SA_Mobile` ## v. 3.2.2 - 05.07.2014 * добавлен перевод на корейский язык (спасибо MINE) * улучшена работа конструкции [HEX..END](/ru/coding/hex..end) * исправлен баг [#0000028](http://bugs.sannybuilder.com/view.php?id=28) ## v. 3.2.1 - 04.05.2014 * добавлен перевод на индонезийский язык (спасибо IMasterFX) * обновлены CLEO для GTA III и CLEO для Vice City (спасибо Silent) * исправлены баги [#0000026](http://bugs.sannybuilder.com/view.php?id=26), [#0000027](http://bugs.sannybuilder.com/view.php?id=27) ## v. 3.2.0 - 22.03.2014 * добавление собственных [режимов редактирования](/ru/edit-modes) возможно путем изменения файла `games.xml` * новый режим редактирования `GTA SA SCR` * переменные [могут быть объявлены](/ru/coding/variables#korotkaya-forma-obyavleniya-peremennykh) при помощи указания типа перед именем переменной * CLEO обновлена до версии 4.3.16 * добавлен [моментальный поиск](/ru/editor/features#momentalnyi-poisk) в тексте (ранее эта возможность называлась "переход к метке") * [оригинальные названия миссий](/ru/editor/features#ispolzovanie-originalnykh-imen-missii) могут быть изменены через файл missions.txt * улучшена [ассоциация](/ru/editor/options/general#associaciya-failovykh-rasshirenii) расширений скриптовых файлов с Sanny Builder * при указании директории игры Sanny Builder проверяет только существование этой директории и не проверяет наличие дополнительных файлов в ней * небольшие улучшения в функции проверки обновлений * изменена иконка Sanny Builder и иконки в меню * исправлен баг [#0000024](http://bugs.sannybuilder.com/view.php?id=24) ## v. 3.1.4 - 22.02.2014 * CLEO обновлена до версии 4.3.14 * исправлены некоторые ошибки в интерфейсе на высоких разрешениях экрана * обновлены переводы на немецкий, польский, китайский, украинский языки ## v. 3.1.3 - 22.12.2013 * добавлена [поддержка](/ru/edit-modes) iOS и Android версий GTA: San Andreas * значение [глубины просмотра](/ru/editor/options/editor#glubina-prosmotra-koda) теперь используется при построении списка констант * обновлены переводы на китайский и немецкий языки ## v. 3.1.2 - 06.10.2013 * добавлен перевод на чешкий язык * добавлены [опции](/ru/editor/options/general#associaciya-failovykh-rasshirenii) ассоциации файлов `.cs` и `.cm` с Sanny Builder. * исправлены баги [#0000011](http://bugs.sannybuilder.com/view.php?id=11), [#0000020](http://bugs.sannybuilder.com/view.php?id=20) ## v. 3.1.1 - 22.09.2013 * добавлена новая директива [$OPCODE](/ru/coding/directives#usdopcode) для регистрации нового опкода через скрипт * скорректировано поведение директивы [$INCLUDE](/ru/coding/directives#usdinclude) при поиске файла * исправлены баги [#0000005](http://bugs.sannybuilder.com/view.php?id=5), [#0000019](http://bugs.sannybuilder.com/view.php?id=19) ## v. 3.1.0 - 14.09.2013 * в `VCSCM.ini` добавлены опкоды из мобильной версии GTA VC и отмечены неподдерживаемые опкоды * при включенной опции [Добавлять доп. информацию в SCM](/ru/editor/options/general#dobavlyat-dopolnitelnuyu-informaciyu-v-scm), Sanny Builder запоминает игру, для которой был скомпилирован скрипт, чтобы включить нужный [режим редактирования](/ru/edit-modes) при декомпиляции * при включенной опции `Добавлять доп. информацию в SCM`, Sanny Builder добавляет исходный код в тело скрипта (только при наличии директивы [$EXTERNAL](/ru/coding/directives#usdexternal) или [$CLEO](/ru/coding/directives#usdcleo)) * добавлена новая директива [$NOSOURCE](/ru/coding/directives#usdnosource), чтобы запретить добавление исходного кода в тело скрипта * некоторые горячие клавиши могут быть изменены [в опциях](/ru/editor/options/hotkeys) * добавлена возможность автоматически проверять наличие обновления при запуске программы * директивы [$VERSION](/ru/coding/directives#usdversion) и [$VERSION\_RESTORE](/ru/coding/directives#usdversion_restore) устарели (компилируются, но не имеют эффекта) * обновлены перевод на испанский и китайский языки * [Менеджер координат](/ru/editor/features#izmenenie-koordinat-i-ugla-razvorota-igroka) может изменять угол поворота игрока в GTA VC * в комплектацию Sanny Builder добавлен [CLEO плагин SCRLog](http://www.gtagarage.com/mods/show.php?id=23846) от LINK/2012 (можно найти в папке tools) * исправлены баги [#0000010](http://bugs.sannybuilder.com/view.php?id=10), [#0000014](http://bugs.sannybuilder.com/view.php?id=14), [#0000015](http://bugs.sannybuilder.com/view.php?id=15), [#0000016](http://bugs.sannybuilder.com/view.php?id=16) ## v. 3.09 - 28.07.2013 * в Sanny Builder добавлено лицензионное соглашение вида Freeware/Donationware * добавлена возможность сообщать о найденных багах в [официальный баг-трекер](http://bugs.sannybuilder.com/) * добавлена возможность проверять наличие обновления для Sanny Builder * [Менеджер координат](/ru/editor/features#izmenenie-koordinat-i-ugla-razvorota-igroka) теперь поддерживает все известные версии GTA3, VC и SA (спасибо Silent) * добавлена обновленная версия перевода на китайский язык * исправлены баги [#0000002](http://bugs.sannybuilder.com/view.php?id=2), [#0000003](http://bugs.sannybuilder.com/view.php?id=3), [#0000004](http://bugs.sannybuilder.com/view.php?id=4), [#0000006](http://bugs.sannybuilder.com/view.php?id=6), [#0000009](http://bugs.sannybuilder.com/view.php?id=9) * небольшие изменения дизайна ## v. 3.08 - 05.07.2013 * добавлен [Silent's ASI Loader](http://www.gtagarage.com/mods/show.php?id=21709) v1.1 для CLEO 3 и CLEO 4 * добавлен перевод на китайский язык * добавлены классы `File` и `Audiostream` для обратной совместимости с CLEO 4 от Alien {% hint style="info" %} `File.Open`, `Audiostream.Load`, `Audiostream.Load3D` были [методами](/ru/coding/classes#metody) в CLEO 4. Теперь они [свойства](/ru/coding/classes#svoistva). Это означает, что если вы получаете ошибку при компиляции старых скриптов, где использовались эти команды, измените их синтаксис следующим образом: ``` переменная = File.Open(имя_файла, режим_открытия) переменная = Audiostream.Load(имя_файла) переменная = Audiostream.Load3D(имя_файла) ``` {% endhint %} * компилятор теперь может принимать строковую константу в качестве параметра в свойстве класса {% hint style="info" %} Существует [ограничение](/ru/coding/classes#svoistva) на использование пробелов в таком параметре. {% endhint %} * компилятор больше не компилирует строки без начальной кавычки, например `text1"text2"` или `text1'text2'` * компилятор может компилировать символы комментария внутри строки `"{text1}text2"` * точка с запятой `;` больше не может использоваться для закомментирования строки * изменен синтаксис параметра [\debug](/ru#parametry-komandnoi-stroki) * добавлены иконки флагов для доступных языков перевода в [опциях](/ru/editor/options/general#yazyk-interfeisa) * исправлены некоторые ошибки в декомпиляции для VCS ## v. 3.06 - 17.06.2013 * добавлены [новые операторы ++ и --](/ru/coding/built-in-commands) * добавлена поддержка [блочных комментариев](/ru/editor/features#kommentirovanie-koda) /\* \*/ * `SASCM.INI` обновлен при помощи [базы GTAG](https://gtagmodding.com/opcode-database/) * [свойства](/ru/coding/classes#svoistva) `Actor.Armour` и `Actor.Car` заменены на корректные версии `Actor.AddArmour`, `Actor.MissionCar` * добавлено новое свойство `Actor.CurrentCar` для опкода `03C0` в скриптовых классах для игр SA и VC * добавлены [новые комбинации клавиш](/ru/editor/hotkeys) `Ctrl+Num+` и `Ctrl+Num-` для быстрого изменения размера шрифта в редакторе * Sanny Builder запоминает число закрытых файлов для опции [Открывать все закрытые файлы](/ru/editor/options/editor#nastroiki) * исправлена ошибка при компиляции скрипта с большим числом вставок [HEX..END](/ru/coding/hex..end) * исправлена ошибка версии 3.05, когда программа зависала при запуске, пытаясь открыть файл, переданный в качестве параметра ## v. 3.05 - 05.06.2013 * добавлены новые языки перевода (финский, польский, венгерский, украинский, турецкий) * библиотека CLEO обновлена до версии 4.1.1.30f (CLEO 4 от Alien) * добавлена возможность установить CLEO для GTA III и для Vice City (автор - Alien) * [файлы опкодов](/ru/edit-modes/opcodes-list-scm.ini) (\*\*SCM.ini, opcodes.txt) замененены на файлы из комплекта CLEO 4. * добавлен новый параметр запуска программы [\nosplash](/ru#parametry-komandnoi-stroki) ## v. 3.04 - 04.08.2008 * в редактор кода добавлены возможности конвертации чисел из 16-чной системы счисления в 10-чную и наоборот (`Ctrl+H`), а также конвертировать имя модели в ID и обратно (`Ctrl+Alt+H`) * убрано сообщение о невозможности изменить `script.img` при компиляции CLEO-скриптов * отчет о компиляции показывает размер CLEO-скрипта (пункт `Largest Script`) * исправлена ошибка при компиляции массива с числовыми индексами * инсталлятор не требует прав администратора ## v. 3.03 - 17.11.2007 * предыдущая версия CLEO была с ошибкой * мелкие исправления (положение панели инструментов теперь сохраняется) ## v. 3.02 - 16.11.2007 * новая версия CLEO * панель инструментов можно передвигать * `F7` при компиляции `SCM` без заголовка (c директивами [$E](/ru/coding/directives#usdexternal), [$CLEO](/ru/coding/directives#usdcleo)) не делает копию * при компиляции файла с директивой `$CLEO` нажатием `F6` файл создается в той же папке, нажатием `F7` дополнительно создается копия в папке CLEO (по аналогии с компиляцией `main.scm`) * новый язык перевода - итальянский, португальский ## v. 3.01 - 06.08.2007 * обновление, исправляющее некоторые ошибки ## v. 3.00 - 04.08.2007 * интегрирована библиотека [CLEO 3](https://cleo.li/ru) * возможность декомпиляции `main.scm` Vice City Stories * поддержка [констант](/ru/coding/constants) * новые директивы [$INCLUDE](/ru/coding/directives#usdinclude), [$EXTERNAL](/ru/coding/directives#usdexternal), [$CLEO](/ru/coding/directives#usdcleo) * запись [дополнительной информации](/ru/editor/options/general#dobavlyat-dopolnitelnuyu-informaciyu-v-scm) в конец `main.scm` * задание [собственных массивов](/ru/editor/options/formats#sobstvennye-imena) при декомпиляции * [возможность декомпилировать](/ru/editor/console#skip_scm_header) файлы `main.scm` без заголовка * можно использовать внешний скрипт с именем AAA * новый [параметр командной строки](/ru#parametry-komandnoi-stroki) `\compile` * в цикле [FOR](/ru/coding/loops#for-end) можно использовать дробные значения счетчика * команды `WriteMem` и `ReadMem` больше не поддерживаются * поддержка поиска по тексту с использованием регулярных выражений * возможность сохранять исходник в формат RTF или HTML * возможность [пропускать заставки](/ru/editor/options/general#bystraya-zagruzka-igry) при запуске San Andreas * новая комбинация клавиш: [Ctrl+Enter](/ru/editor/hotkeys) * обновленный [SASCM.INI](/ru/edit-modes/opcodes-list-scm.ini) ## v. 2.99e - 01.01.2007 * справлена ошибка с пропаданием части кода при декомпиляции в режиме отладки внутри конструкции [HEX..END](/ru/coding/hex..end) * конструкция HEX..END может принимать [тип aDMA](/ru/coding/hex..end#ispolzovanie-tipa-adma) для записи чисел и [строки](/ru/coding/data-types#strokovye-literaly) * к цикле [FOR](/ru/coding/loops#for-end) можно использовать имена моделей в качестве значений счетчика ## v. 2.99d - 03.12.2006 * убран Memory Hacker (он стал [отдельной программой](http://sannybuilder.com/downloads)) * исправлена одна ошибка в декомпиляторе ## v. 2.99c - 30.11.2006 * добавлен плагин Memory Hacker * возможность декомпиляции main.scm Liberty City Stories * поддержка [числовых констант в качестве индекса](/ru/editor/console#constant_indexes) глобального массива * при декомпиляции переменные заменяются на тип [ADMA](/ru/coding/data-types#peremennye), если не делятся на `4` * при компиляции при отсутствии заголовка выставляются значения по умолчанию * возможность открывать файлы в редакторе методом Drag\&Drop * новые препроцессорные директивы: [{$VERSION}](/ru/coding/directives#usdversion), [{$VERSION\_RESTORE}](/ru/coding/directives#usdversion_restore) {% hint style="info" %} Если при компиляции вы получаете сообщение об ошибке в заголовке (`Неизвестная команда DEFINE OBJECTS`) переместите строку `{$VERSION xxxx}` в любое место после заголовка, например перед комментарием `//-------------MAIN---------------` {% endhint %} ## v. 2.99 - 27.09.2006 * добавлены две новые команды WriteMem и ReadMem * поддержка чисел в шестнадцатиричном формате * конструкция [HEX..END](/ru/coding/hex..end) может принимать значения меток и глобальных переменных * поддержка типа данных & для [массивов](/ru/coding/arrays), а также в выражениях без опкодов: `&57 += &120(&231,4i)` * возможность давать [собственные имена меткам](/ru/editor/options/formats#sobstvennye-imena) * возможность [выбирать регистр букв](/ru/editor/options/formats#registr-bukv) для собственных имен меток и переменных, а также стринговых переменных * добавлена [консоль](/ru/editor/console) для специальных опций SB * поддержка `GXT` файлов GTA III, GTA VC * [поддержка символьных констант](/ru/coding/data-types#strokovye-literaly) в длинных строках * информация об авторе и версии [INI](/ru/edit-modes/opcodes-list-scm.ini) файла * поддержка классами `INI` с оригинальным порядком следования параметров (как SASCM.INI от PLPynton) * [опция](/ru/editor/options/editor#nastroiki) подтверждения выхода * возможность быстро переключать режим редактирования * конвертация отдельного, выделенного участка кода * возможность передавать во [внешнее приложение](/ru/editor/features#menyu-vneshnikh-prilozhenii) в качестве параметра имя текущего открытого файла * исправлены некоторые ошибки в конфигурационных файлах * убрана автоматическая конвертация числа в тип `Float`, если переменная была объявлена как `Float`, а в нее записывалось целое число. Теперь опкод выбирается только в зависимости от типа числа * чтение/изменение Z\_angle игрока в [Coord Manager](/ru/editor/features#izmenenie-koordinat-i-ugla-razvorota-igroka); возможность вставки значения угла в скрипт нажатием `Ctrl+Shift+E` (для SA) ## v. 2.98 - 04.08.2006 * Sanny Builder полностью [русифицирован](/ru/editor/options/general#yazyk-interfeisa) * добавлено [меню внешних приложений](/ru/editor/features#menyu-vneshnikh-prilozhenii) * в SB встроена специальная версия [Opcode Search Tool](/ru/editor/opcode-search-tool) * проверка математических выражений при декомпиляции с выключенной опцией [Писать опкоды](/ru/editor/options/general#ispolzovat-opkody) * возможность выбирать `IMG` файл самостоятельно, если таковой не найден в папке с `main.scm`(опция [Ручной выбор IMG-файла](/ru/editor/options/general#ruchnoi-vybor-img-faila)) * возможность добавлять новые [фрагменты кода](/ru/editor/features#pereispolzovanie-fragmentov-koda) прямо из редактора; добавлены описания макросов * список моделей можно сортировать по алфавиту/по значению (`Alt+S`, когда активен список) * минорные исправления и изменения ## v. 2.97 - 11.06.2006 * новый [тип данных](/ru/coding/data-types#peremennye): `&` * минорные изменения ## v. 2.96 - 01.04.2006 * расширена [опция прохода по меткам](/ru/editor/features#momentalnyi-poisk) * добавлена возможность вызвать список [фрагментов кода](/ru/editor/features#pereispolzovanie-fragmentov-koda) * добавлена [опция замены](/ru/editor/options/general#zamenyat-nomera-missii) номеров миссий на их имена * исправлены некоторые ошибки ## v. 2.9f - 18.02.2006 * новые модели автоматически добавляются в список `DEFINE OBJECTS` (этот список можно вообще не использовать) * добавлены блочные комментарии: `{}` * добавлена запись [макросов](/ru/editor/features#zapis-i-vosproizvedenie-nazhatii-knopok) * минорные исправления и добавления ## v. 2.9 - 15.12.2005 * добавлены [дополнительные команды](/ru/coding/built-in-commands) * добавлен оператор `IN` * добавлена конструкция [IF..THEN..ELSE..END](/ru/coding/conditions#vysokourovnevye-konstrukcii) * добавлены [циклы](/ru/coding/loops) `WHILE`, `REPEAT`; добавлена возможность использования вложенных циклов * добавлена команда [ALLOC](/ru/coding/built-in-commands#alloc) * новый стиль комментариев: `//` * позиции маркеров и курсора запоминаются для закрытых файлов ## v. 2.6 - 05.11.2005 * добавлена поддержка форматов Vice City и GTA3 * добавлена возможность [объявления](/ru/coding/classes#obyavlenie-ekzemplyarov-klassa) переменных и массивов как экземпляров класса * добавлен показ списка переменных и меток * добавлена поддержка циклов ( оператор [FOR](/ru/coding/loops#for-end) ) * миссии можно запускать по их имени (`start_mission MYMISSION`), где `MYMISSION` - это имя стартовой метки (`DEFINE MISSION 100 at @MYMISSION` ) * доступен список импортируемых моделей (`DEFINE OBJECTS`) по `Ctrl+пробел` * новый [оператор](/ru/coding/conditions#operatory-sravneniya) `<>` * если при декомпиляции не найден `script.img`, используется оригинальный файл * для [массивов](/ru/coding/arrays) добавлен тип `handle` * возможность отключения предупреждения об использовании `IMG` игрой ## v. 2.5 - 10.10.2005 * добавлена поддержка [свойств](/ru/coding/classes#svoistva) классов * добавлена поддержка [фрагментов кода](/ru/editor/features#pereispolzovanie-fragmentov-koda) * добавлена конструкция [VAR..END](/ru/coding/variables#konstrukciya-var-end) для эффективного управления переменными * описаны все возможные математические опкоды: `0004..008B` * новые операторы `<` и `<=` * добавлена возможность автоподбора необходимого значения для оператора `IF` * добавлена поддержка [текстовых названий](/ru/coding/classes#konstanty-klassa) параметров * добавлен показ списка моделей * минорные добавления и исправления ## v. 2.0 - 18.09.2005 * добавлена поддержка [классов](/ru/coding/classes) * добавлена поддержка [ключевых слов](/ru/coding/keywords) * добавлена возможность писать некоторые математические команды без опкодов * для опкода `00D6` по умолчанию устанавливается параметр `0`, если иное не установлено (`if` = `if 0`) * добавлена [опция выбора](/ru/editor/options/formats#imena-metok) различных видов меток * добавлены [константы](/ru/coding/constants) `True` и `False`, которые обозначают `1` и `0` соответственно * добавлена конструкция [HEX..END](/ru/coding/hex..end) для записи шестнадцатиричных значений прямо в `SCM` ## v. 1.1 - 07.09.2005 * добавлен [Coord Manager](/ru/editor/features#izmenenie-koordinat-i-ugla-razvorota-igroka) * исправлены некоторые ошибки ## v. 1.0 - 04.09.2005 * новый формат [меток](/ru/coding/data-types#metki) * добавлен конвертор из синтаксиса BW's SA Mission Builder * при декомпиляции в исходник добавляются названия моделей и содержимое `american.gxt` * добавлены новые опции * пофиксены некоторые ошибки ## v. 0.8 - 20.08.2005 * добавлена возможность ассоциировать `SCM` файлы с программой * теперь при декомпиляции имя выходного файла изменяется, если такой файл уже существует (например, если уже существует `main.scm.txt`, то имя нового файла будет `main.scm[0].txt`) * сообщения об ошибках стали более информативными * добавлена проверка на дублирование [меток](/ru/coding/data-types#metki) * пофиксены некоторые ошибки ## v. 0.7 - 10.08.2005 * увеличено число опций для работы с текстом * добавлена возможность работать с несколькими файлами одновременно * добавлена функция поиска опкодов через `F1` (beta) ## v. 0.6 - 04.08.2005 * полная декомпиляция `SCM` файлов San Andreas * компиляция скриптов в `SCM` файл (SA) и `IMG`файл * доступны минимальные опции работы с текстом # Типы данных Код разделен на отдельные элементы, каждый из которых обозначается по-своему и играет свою роль в скрипте. ## Переменные Если перед именем переменной (комбинация букв, цифр, и `_`) стоит знак `$` - это [глобальная переменная](/ru/coding/variables#globalnye-peremennye). ``` 0004: $MyVar = 100 ``` Именем [локальной переменной](/ru/coding/variables#lokalnye-peremennye) может быть только число, после которого стоит `@`. Это число является индексом в списке локальных переменных, [выделенных](/ru/scm-documentation/gta-limits) для текущего скрипта или миссии. ``` 0006: 100@ = 10 ``` Переменная `ADMA` (**A**dvanced **D**irect **M**emory **A**ccess, усовершенствованный доступ к памяти) - это указатель на определенный адрес внутри файла `main.scm`. Они используются так же как глобальные переменные, но в отличие от них `ADMA` могут читать и писать значения по любому адресу в пределах `main.scm`. ``` $myVar = &0 // прочитать первые 4 байта main.scm и записать значение в $myVar &57 += &120(&231,4i) // также могут использоваться как элементы массива ``` `ADMA` переменные не влияют на размер буфера для глобальных переменных, выделенного в заголовке `main.scm`. ## Метки Метки указывают на определенную строку кода и используются в условных (опкод `004D`) и безусловных переходах (опкоды `0002`, `0050`). Имя метки состоит из букв, цифр и `_` и всегда начинается с `:` ``` :MyLabel ``` Чтобы использовать такую метку в опкоде замените `:` на `@` ``` 0002: jump @MyLabel ``` Если имя метки написано как самостоятельное выражение с парой скобок в конце, это представляет собой вызов подпрограммы командой `gosub`: ``` // следующие выражения эквивалентны MyLabel() gosub @MyLabel ``` ## Строковые литералы Текст, обрамленный одинарными кавычками `' '`, - это короткий строковый литерал (до `15` символов). ``` 03A4: script_name 'MAIN' ``` Текст, обрамленный двойными кавычками `" "`, - это длинный строковый литерал (максимальная длина определяется опкодом). Если внутри литерала используется кавычка, она должна быть заэкранирована при помощи обратного слэша`\` ``` 0662: write_debug_message "Hello, \"world\"! \n 'Here we go!'" ``` Допускается использование пустых строк `''` или `""`. ## Строковые переменные Глобальные переменные, содержащие короткий строковый литерал, начинаются с `s$`. ``` 05A9: s$MyString = 'GLOBAL' ``` Локальные переменные, содержащие короткий строковый литерал, заканчиваются на `@s`. ``` 05AA: 1@s = 'LOCAL' ``` Глобальные переменные, содержащие длинный строковый литерал, начинаются с `v$`. ``` 06D1: v$MyString = "LONG_GLOBAL" ``` Локальные переменные, содержащие длинный строковый литерал, заканчиваются на `@v`. ``` 06D2: 1@v = "LONG_LOCAL" ``` ## Имена моделей Вместо ID моделей из `.ide` файлов могут использоваться их имена, перед которыми стоит `#` ``` 0247: request_model #CELLPHONE ``` ## Числа в 16-ричном формате `0x` - число в шестнадцатиричном формате\ `-0x` - отрицательное число в шестнадцатиричном формате ``` 0004: $var = -0xBB08 ``` Разрешенный диапазон шестнадцатиричных чисел лежит между `-80000000` и `7FFFFFFF`. # Константы **Константа** представляет собой имя, которому соответствует определенное значение. Имя переменной должно быть уникальным в текущем контексте компилирования (основной файл и все [подключенные](/ru/coding/directives#usdinclude) файлы). При компиляции имя константы заменяется на то значение, которое ей было присвоено, например число или строку. В отличие от переменных значение константы не может меняться. Костанты объявляются статически или динамически. Каждый [режим редактирования](/ru/edit-modes) может загрузить статические определения констант из внешнего файла при помощи параметра `` в `modes.xml`. Динамические определения создаются в скрипте при помощи синтаксиса, описанного ниже. ## Объявление констант Чтобы объявить в коде новую константу, используйте ключевое слово `const`: ```pascal const <имя константы> = <значение> ``` Именем константы может быть любая комбинация букв, цифр и `_`, которая не повторяет зарезервированные компилятором имена, такие как `Continue`, `Break`, `And` (см. файл `compiler.ini`). \ \ Значением константы может быть число (а также [имя модели](/ru/coding/data-types#imena-modelei) или [метка](/ru/coding/data-types#metki)), [строковый литерал](/ru/coding/data-types#strokovye-literaly), [переменная](/ru/coding/variables) (а также [свойство класса](/ru/coding/classes#svoistva)), другая константа. Например, ```pascal const x = 5 ``` Чтобы объявить несколько констант сразу, разделите определения запятой: ```pascal const a = 1, b = 2, c = 3 ``` Если вы предпочитаете многострочные определения, используйте конструкцию `CONST..END`: ```pascal const a = 1 b = 2 c = 3 end ``` Более сложный пример: ```pascal var $PLAYER_CHAR: Player end const MoneyRequired = 30 PlayerMoney = $PLAYER_CHAR.Money end if PlayerMoney > MoneyRequired then PlayerMoney += -1 end ``` Во время компиляции константа `MoneyRequired` будет заменена на число `30`, а `PlayerMoney` на `$PLAYER_CHAR.Money`. Если [языковая служба](/ru/editor/language-service) включена, список констант можно увидеть при нажатии `Ctrl+пробел`. # Переменные Переменная - это именованная область памяти со значением, которое может быть многократно прочитано и/или изменено. Существует два вида переменных - *глобальные* и *локальные*. ## Глобальные переменные Глобальная переменная начинается со знака `$`, после которого следует комбинация латинских букв, цифр и `_`: `$variable1`\ `$100`\ `$____` Значения глобальных переменных доступны из любого места в коде. ### **Сохраняемые переменные** Сохраняемые переменные - это особый вид глобальных переменных, добавленный в `LCS` и `VCS` [режимах](/ru/edit-modes). Перед их именем стоит `$_`, например `$_var`. Значение такой переменной восстанавливается при загрузке сохраненной игры. Глобальные переменные, которые начинаются только с `$` (например, `$var`), не сохраняют свое значение и обнуляются при загрузке сохранения в LCS или VCS. ### DMA переменные Во время компиляции имена переменных заменяются на числа. Эти числа являются индексами в специальном массиве, который используется игрой для хранения значений глобальных переменных. Индекс является уникальным числом, присваиваемым конкретной переменной. Глобальная переменная, чье имя состоит из цифр, называется`DMA`-переменная (**D**irect **M**emory **A**ddress - прямой доступ к памяти). Это имя и будет индексом, который использует игра. См. [Alloc](/ru/coding/built-in-commands#alloc). ## Локальные переменные Именем локальной переменной служит число, после которого стоит знак `@`. ```pascal 0@ 999@ 56@ ``` Значения локальных переменных доступны только в пределах текущего скрипта или миссии. {% hint style="warning" %} Количество локальных переменных в одном скрипте/миссии строго [ограничено](/ru/scm-documentation/gta-limits). {% endhint %} ### Переменные-таймеры Каждый скрипт или миссия также имеют две особые локальные переменные, которые называются `TIMERA` и `TIMERB`. Значение переменной-таймера постоянно увеличивается с ходом игры, поэтому они обычно используются, чтобы измерять время, пройденное с определенного момента (сброса таймера). ```pascal 0006: TIMERA = 0 // сброс таймера :WAIT_2S 0001: wait 0 ms 00D6: if 0019: TIMERA > 2000 // если таймер увеличился до 2000, т.е. прошло 2 секунды 004D: jump_if_false @WAIT_2S 0662: printstring "2 seconds has passed" // показать текст ``` {% hint style="info" %} Имена `TIMERA`и`TIMERB`доступны начиная с Sanny Builder v3.3.0. В более ранних скриптах таймеры использовались как обычные локальные переменные `16@, 17@` (в GTA3 и VC) либо `32@, 33@` (SA). {% endhint %} ## Объявление типа переменной Переменные обычно используются в арифметических или условных выражениях. Если в выражении правая часть является числом, опкод указывать не обязательно: ```pascal $var = 0 $myarray($index, 10i) >= 150 ``` Если же обе части выражения являются переменными, компилятор не сможет подобрать нужный опкод, т.к. типы переменных неизвестны. Например, существует два опкода, которые складывают значения двух переменных: `0058` для целых чисел и `0059` для дробных. ```pascal 0058: $Var1 += $Var2 // (целые числа) 0059: $Var1 += $Var2 // (дробные числа) ``` Если убрать опкод, как скомпилировать такое выражение? ```pascal $Var1 += $Var2 // ?? ``` Чтобы сообщить компилятору тип переменной, используется ключевое слово `var`. ```pascal var <переменная>: <тип> ``` `Переменная` - это любая допустимая глобальная или локальная переменная (см. выше). `Тип` может быть одним из нижеперечисленных значений: * `Integer`, `Int` - целые числа * `Float` - дробные числа * `String`, `ShortString` - переменная, содержащая [короткий строковый литерал](/ru/coding/data-types#strokovye-literaly) (используется только при объявлении массивов, для одиночных переменных используются префикс `s$` или суффикс `@s`) * `LongString` - переменная, содержащая [длинный строковый литерал](/ru/coding/data-types#strokovye-literaly) (используется только при объявлении массивов, для одиночных переменных используются префикс `v$` или суффикс `@v`) * `<Имя класса>` - переменная или массив переменных [членов класса](/ru/coding/classes#chleny-klassa) Пример: ```pascal var $size: integer ``` Можно объявить несколько переменных в одной строке, разделяя их запятой: ```pascal var $x: float, $y: float, $z: float ``` Если вы предпочитаете многострочные определения, используйте конструкцию `VAR..END`: ```pascal var $x: float $y: float $z: float end ``` Когда обе переменные имеют известный компилятору тип, выражение компилируется без опкода: ```pascal var $Var1 : Integer $Var2 : Integer end $Var1 += $Var2 // здесь будет опкод 0058 ``` {% hint style="info" %} Как только тип переменной объявлен, он используется везде ниже по коду. Тип переменной может быть изменен, если она используется по-другому: ``` script_name 'Food' var 10@ : Float $Var : Float end $var = 1 10@ = $Var end_thread thread 'Loop' var 10@ : Int $Var : Int end $var = 1 10@ = $Var end_thread ``` В скрипте`'Food'` `10@` является дробной переменной. В скрипте`'Loop'` `10@` уже целочисленная переменная. Тип переменной может быть переобъявлен многократно. {% endhint %} ## Короткая форма объявления переменных Начиная с версии 3.2.0 можно объявлять переменные, используя только имя типа (доступно для типов `Int`, `Float`, `String`, `LongString`). Синтаксис: ```pascal ``` Пример: 
int 0@ // 0@ объявлена как целочисленная переменная
Начиная с версии 3.4.0 появилась возможность объявить переменную с собственным именем: ```pascal int a float distance string name a = 1 distance = 15.5 name = 'CJ' ``` Одновременно с объявлением такой переменной можно присвоить ей начальное значение, чтобы уменьшить количество строк кода: ```pascal int a = 1 float distance = 15.5 string name = 'CJ' ``` Компилятор связывает каждое имя с новой локальной переменной. В примере выше код будет скомпилирован примерно следующим образом: ```pascal 0006: 0@ = 1 0007: 1@ = 15.5 05AA: 2@ = 'CJ' ``` {% hint style="info" %} Из-за [архитектурных ограничений](https://github.com/sannybuilder/dev/issues/32) эта возможность доступна только в CLEO скриптах. {% endhint %} ## Начальное значение переменной Одновременно с объявлением переменной можно задать ей начальное значение. Для этого напишите `=` и значение: ```pascal var $fVar: float = 1.0 ``` или ```pascal float $fVar = 1.0 ``` Теперь переменная `$fVar` объявлена как `Float`, и компилятор добавит в скрипт опкод `0005`: ```pascal 0005: $fVar = 1.0 ``` Инициализация доступна только для переменных, но не массивов. # Массивы **Массивы** представляют собой последовательный набор элементов одного типа (тип массива). К каждому элементу массива можно обратиться используя его индекс (порядковый номер элемента в массиве). Нумерация элементов начинается с нуля. Массивы доступны в San Andreas, LCS и VCS. ## Общий синтаксис San Andreas: ```pascal <имя массива>(<индекс>,<размер><тип>) ``` `<имя массива>`: локальная или глобальная [переменная](/ru/coding/variables)\ `<индекс>`: локальная или глобальная переменная, содержащая индекс элемента, который нужно прочитать или изменить\ `<размер>`: целое число от 1 до 255 (включительно)\ `<тип>`: одна из букв `i` `f` `s` `v`: | Буква | Тип элемента | Размер элемента (в байтах) | | ----- | ----------------- | -------------------------- | | i | целое число | 4 | | f | дробное число | 4 | | s | строковый литерал | 8 | | v | строковый литерал | 16 | Пример: ```pascal $index = 0 $array($index,10i) = 1 ``` Liberty City Stories, Vice City Stories: ```pascal <имя массива>(<индекс>,<размер>) ``` В LCS и VCS длина элементов массивов может быть только 4 байта. Поэтому нет необходимости указывать тип массива при обращении к его элементам. Пример: ```pascal $index = 0 $array($index,10) = 1 ``` ## Объявление массивов Массивы, как и отдельные [переменные](/ru/coding/variables), могут быть объявлены при помощи ключевого слова `var`: ```pascal var <имя массива>: array <размер> of <тип> ``` Пример: ```pascal var $FloatArray: array 10 of Float ``` Массивы с элементами примитивного типа могут быть объявлены при помощи короткой записи вида: ```pascal <тип> <имя массива>[<размер>] ``` Допустимыми типами в таком объявлении являются `Int`, `Float`, `String`, `LongString`: ```pascal int intArray[10] float floatArray[10] string stringArray[10] longstring longStringArray[10] ``` ### Обращение к элементам массива после объявления После объявления массива можно обращаться к его элементам, используя квадратные скобки: ```pascal var $FloatArray: array 10 of Float $index = 0 // увеличить значение первого элемента на 100 $FloatArray[$index] += 100.0 // аналогично $FloatArray[0] += 100.0 ``` С массивами, содержащими [строковые литералы](/ru/coding/data-types#strokovye-literaly), можно работать используя [строковые переменные](/ru/coding/data-types#strokovye-peremennye): ```pascal // задаем значения для первых трех элементов массива $strings s$strings[0] = 'str1' s$strings[1] = 'str2' s$strings[2] = 'str3' ``` Массив может быть объявлен как коллекция [экземпляров класса](/ru/coding/classes#ekzemplyary-klassa), его методы будут доступны для каждого элемента: ```pascal var $players: array 2 of Player $players[0].Build ``` {% hint style="info" %} По умолчанию в [режиме](/ru/edit-modes) `GTA SA` дизассемблер выводит элементы массива с целочисленными константами. В LCS и VCS эта возможность присутствует, но по умолчанию выключена. [Отладочная опция](/ru/editor/console#constant_indexes) `CONSTANT_INDEXES` позволяет включить или выключить эту возможность. {% endhint %} # Операторы Sanny Builder поддерживает запись многих стандартных операций без опкодов. Компилятор анализирует обе стороны выражения и оператор между ними, чтобы подобрать правильный опкод. В связи с особенностями языка, разные типы данных требуют разных опкодов. Например, в операции сложения двух целых чисел используется опкод, отличный от аналогичной операции с дробными числами. В некоторых случаях это требует предварительного [объявления типа](/ru/coding/variables#declaring-a-variable-type) переменных, участвующих в выражении. Большинство поддерживаемых операций в Sanny Builder используют лишь два операнда: один слева от оператора (**LHS**), и один - справа (**RHS**). ### Присваивание * `LHS = RHS` - операция присваивания. `RHS` - число, переменная или строка. В присваивании `LHS` всегда является переменной. * `LHS += RHS` - операция сложения с присваиванием. `LHS` и `RHS` должны быть одного типа, целого или дробного. Значение `LHS` увеличивается на соответствующее значение `RHS`. * `LHS -= RHS` - операция вычитания с присваиванием * `LHS *= RHS` - операция умножения с присваиванием * `LHS /= RHS` - операция деления с присваиванием Нижеперечисленные операции требуют [расширения](/ru/edit-modes/extensions) CLEO (`{$USE CLEO}` или `{$CLEO}`). * `LHS = value1 + value2` - сложить два целых числа и записать результат в `LHS` * `LHS = value1 - value2` - вычесть одно целое число из другого и записать результат в `LHS` * `LHS = value1 * value2` - перемножить два целых числа и записать результат в `LHS` * `LHS = value1 / value2` - разделить одно целое число на другое и записать результат в `LHS` ### Сравнение * `LHS == RHS` - операция "равно". Стороны должны иметь одинаковое значение, чтобы результат был истиной (true). * `LHS > RHS` - операция "больше чем" * `LHS >= RHS` - операция "больше либо равно" * `LHS < RHS` - операция "меньше чем" * `LHS <= RHS` - операция "меньше либо равно" * `LHS <> RHS` - операция "не равно". Стороны должны иметь разные значения, чтобы результат был истиной (true). {% hint style="info" %} В языке нет отдельного типа Boolean. Результат каждого сравнения имеет значение только в пределах текущего [условного выражения](/ru/coding/conditions). {% endhint %} ### Побитовые операции Игра не поддерживает побитовые операции, поэтому для их использования нужен особый [плагин CLEO](https://library.sannybuilder.com/#/sa/bitwise). Кроме того, в исходном коде при помощи директивы `{$USE bitwise}` должно быть подключено соответствующее [расширение](/ru/edit-modes/extensions). | Операция | Опкод | Пример | | ----------------------------- | ----- | ------------- | | AND | 0B10 | 0@ = 1@ & 2@ | | OR | 0B11 | 0@ = 1@ \| 2@ | | XOR | 0B12 | 0@ = 1@ ^ 2@ | | NOT | 0B13 | 0@ = \~1@ | | MOD | 0B14 | 0@ = 1@ % 2@ | | Shift Right | 0B15 | 0@ = 1@ >> 2@ | | Shift Left | 0B16 | 0@ = 1@ << 2@ | | AND (с присваиванием) | 0B17 | 0@ &= 1@ | | OR (с присваиванием) | 0B18 | 0@ \|= 1@ | | XOR (с присваиванием) | 0B19 | 0@ ^= 1@ | | NOT (унарный) | 0B1A | \~0@ | | MOD (с присваиванием) | 0B1B | 0@ %= 1@ | | Shift Right (с присваиванием) | 0B1C | 0@ >>= 1@ | | Shift Left (с присваиванием) | 0B1D | 0@ <<= 1@ | ### FPS-независимое сложение и вычитание Игра поддерживает операции сложения и вычитания, которые не зависят от FPS. Прочитайте [статью](https://gtamods.com/wiki/SCM_language#Operators) на GTAMods.com чтобы узнать больше. | Команда | Опкод | Пример | | ------------------------------------------ | ----- | --------------- | | ADD\_TIMED\_VAL\_TO\_FLOAT\_VAR | 0078 | $var +=@ 5.0 | | ADD\_TIMED\_VAL\_TO\_FLOAT\_LVAR | 0079 | 0@ +=@ 5.0 | | ADD\_TIMED\_FLOAT\_VAR\_TO\_FLOAT\_VAR | 007A | $var1 +=@ $var2 | | ADD\_TIMED\_FLOAT\_LVAR\_TO\_FLOAT\_LVAR | 007B | 0@ +=@ 1@ | | ADD\_TIMED\_FLOAT\_VAR\_TO\_FLOAT\_LVAR | 007C | 0@ +=@ $var | | ADD\_TIMED\_FLOAT\_LVAR\_TO\_FLOAT\_VAR | 007D | $var +=@ 1@ | | SUB\_TIMED\_VAL\_FROM\_FLOAT\_VAR | 007E | $var -=@ 5.0 | | SUB\_TIMED\_VAL\_FROM\_FLOAT\_LVAR | 007F | 0@ -=@ 5.0 | | SUB\_TIMED\_FLOAT\_VAR\_FROM\_FLOAT\_VAR | 0080 | $var1 -=@ $var2 | | SUB\_TIMED\_FLOAT\_LVAR\_FROM\_FLOAT\_LVAR | 0081 | 0@ -=@ 1@ | | SUB\_TIMED\_FLOAT\_VAR\_FROM\_FLOAT\_LVAR | 0082 | 0@ -=@ $var | | SUB\_TIMED\_FLOAT\_LVAR\_FROM\_FLOAT\_VAR | 0083 | $var -=@ 1@ | ### Конвертация типов Некоторые значения могут быть сконвертированы в другой тип. Игра поддерживает перевод между типами `Integer` и `Float`. {% hint style="info" %} Использование оператора `=#` требует, чтобы тип обеих переменных был [объявлен](/ru/coding/variables#declaring-a-variable-type) заранее. {% endhint %} | Команда | Опкод | Пример | | -------------------------------- | ----- | -------- | | CSET\_VAR\_INT\_TO\_VAR\_FLOAT | 008C | $i =# $f | | CSET\_VAR\_FLOAT\_TO\_VAR\_INT | 008D | $f =# $i | | CSET\_LVAR\_INT\_TO\_VAR\_FLOAT | 008E | 0@ =# $f | | CSET\_LVAR\_FLOAT\_TO\_VAR\_INT | 008F | 1@ =# $i | | CSET\_VAR\_INT\_TO\_LVAR\_FLOAT | 0090 | $i =# 1@ | | CSET\_VAR\_FLOAT\_TO\_LVAR\_INT | 0091 | $f =# 0@ | | CSET\_LVAR\_INT\_TO\_LVAR\_FLOAT | 0092 | 0@ =# 1@ | | CSET\_LVAR\_FLOAT\_TO\_LVAR\_INT | 0093 | 1@ =# 0@ | # Условия Оператор `IF` объединяет одно или несколько условий и создает новое ветвление в коде. ## Общий синтаксис условных выражений `00D6: if `\ `<условие 1>`\ `<условие 2>`\ `...`\ `<условие N+1>`\ `004D: jump_if_false <метка>` `N` означает общее кол-во условий внутри выражения `IF` и логическую связь между ними: | N | Кол-во условий | Логический оператор | | ------ | -------------- | ---------------------------------------------------------------------------------- | | 0 | 1 | нет (выражение истинно, если условие в нем истинно) | | 1..7 | 2..8 | `И` (все условия должны быть истинны, чтобы все выражение было истинно) | | 21..27 | 2..8 | `ИЛИ` (хотя бы одно условие должен быть истинно, чтобы все выражение было истинно) | {% hint style="info" %} В одном выражении `IF` может объединяться до 8 условий. {% endhint %} {% hint style="info" %} Sanny Builder позволяет не указывать`0` после `IF. IF 0` и `IF` эквивалентны. {% endhint %} `<метка>`- имя [метки](/ru/coding/data-types#metki), на которую переходит скрипт, если выражение `IF` ложно.\ `<условие>` - любой условный опкод, который возвращает `true` или `false` Если [опция](/ru/editor/options/general#proverka-uslovii) `Проверка условий` включена, после `IF` можно писать ключевые слова `AND` или `OR`. Компилятор будет рассчитывать правильное значение самостоятельно: ``` if and $var > 0 $var2 == 10.0 jf @anywhere ``` В данном примере компилятор запишет вместо `and` число `1`. `IF AND` - условия, объединенные логическим оператором `И` (замена `if 1..7`)\ `IF OR` - условия, объединенные логическим оператором `ИЛИ` (замена `if 21..27`) ## Высокоуровневые конструкции Для облегчения работы с условными выражениями существуют высокоуровневые конструкции, для которых не нужны дополнительные метки в коде: `IF /AND/OR`\ `<условие 1>`\ `<условие 2>`\ `...`\ `<условие N+1>`\ `THEN`\ `<команды при истинности условия>`\ `END` `IF /AND/OR`\ `<условие 1>`\ `<условие 2>`\ `...`\ `<условие N+1>`\ `THEN`\ `<команды при истинности условия>`\ `ELSE`\ `<команды при ложности условия>`\ `END` Условное выражение создается по [общим правилам](/ru/coding/conditions#obshii-sintaksis-uslovnykh-vyrazhenii). После ключевого слова `THEN` указываются опкоды, которые должны выполняться, если условие истинно. После `ELSE` указываются опкоды, которые выполняются, если условие ложно. Выражение `IF` завершается ключевым словом `END`. ``` if $var == 5 then Inc($var) else Dec($var) end ``` {% hint style="info" %} [Опция](/ru/editor/options/general#proverka-uslovii) `Проверка условий` должна быть включена. {% endhint %} {% hint style="info" %} Допускаются конструкции IF, вложенные друг в друга. {% endhint %} ## Операторы сравнения * a **`==`** b - a равно b * a**`>=`** b - a больше либо равно b * a **`>`** b - a больше b * a **`<`** b - a меньше b * a **`<=`** b - a меньше либо равно b * a **`<>`** b - a не равно b `a` и `b` называются операндами. Компилятор может самостоятельно определить нужный опкод, если один из операндов является числовой константой, [строковым литералом](/ru/coding/data-types#strokovye-literaly) или [тип](/ru/coding/variables#konstrukciya-var-end) обеих переменных известен. # Циклы **Цикл** - это конструкция, позволяющая выполнять последовательность команд неоднократно. Sanny Builder поддерживает несколько видов циклов: [for](/ru/coding/loops#for-end), [while](/ru/coding/loops#while-end), [repeat](/ru/coding/loops#repeat-until). ## FOR..END В цикле `FOR` количество повторений (итераций) определено заранее. Синтаксис:\ `FOR <имя переменной> = <начальное значение> TO/DOWNTO <конечное значение> [шаг = 1]`\ `<тело цикла>`\ `END` `имя переменной` - [переменная](/ru/coding/variables), которая используется для подсчета количества итераций (счетчик)\ `начальное значение` - значение счетчика перед первой итерацией (любое число, включая [имя модели](/ru/coding/data-types#imena-modelei))\ `TO` или `DOWNTO` - указывает на то, увеличивается или уменьшается значение счетчика после каждой итерации\ `конечное значение` - значение счетчика, при котором цикл завершается (любое число, включая [имя модели](/ru/coding/data-types#imena-modelei))\ `шаг` - необязательный параметр, который определяет на сколько изменяется значение счетчика после каждой итерации. По умолчанию равен `1`\ `тело цикла` - команды, которые выполняются при каждой итерации цикла; тело цикла может отсутствовать ``` var $value: int = 0 $final: int = 100 end FOR $MyCounter = 1 to $final step 2 $value += $mycounter end ``` Если тип счетчика не был [объявлен](/ru/coding/variables#konstrukciya-var-end) ранее, счетчик приобретает тип `Integer`. Если `начальное значение`, `конечное значение` или `шаг` цикла указаны в виде переменных, эти переменные будут автоматически объявлены с тем же типом, который есть у переменной цикла. Для использования дробных чисел для счетчика итераций, счетчик должен иметь тип `Float`. ``` var $MyCounter: float end FOR $MyCounter = 1.0 to $final step 2.0 end // переменные $MyCounter и $final имеют тип Float ``` ## WHILE..END Синтаксис:\ `WHILE <условие цикла>`\ `<тело цикла>`\ `END` `условие цикла` - любой условный опкод\ `тело цикла` - команды, которые выполняются при каждой итерации цикла; тело цикла может отсутствовать ``` while not #AK47.Available wait 0 end ``` Цикл `WHILE` работает до тех пор, пока условие цикла истинно. Условие цикла проверяется до первой итерации цикла. Поэтому если условие изначально ложно, цикл не отработает ни разу. ``` $var = 10 while $var > 11 inc($var) end // условие цикла ложно, поэтому команда inc($var) никогда не выполнится ``` [Константы](/ru/coding/constants) `True` и `False` могут использоваться в качестве условия цикла. ``` while true <тело цикла> end ``` Такой цикл будет выполняться бесконечно, пока в теле не выполнится команда`Break`. ``` while false end ``` Такой цикл игнорируется компилятором, т.к. условие изначально ложно. {% hint style="warning" %} В текущей версии допускается только один опкод в качестве условия цикла. Если нужно скомбинировать несколько проверок, их можно поместить в начало цикла и использовать команды `Break` и `Continue` ``` while true if and $var >= 0 $var <= 100 then Break end // цикл выполняется, пока значение переменной $var // находится в интервале [0...100] <тело цикла> end ``` {% endhint %} ## REPEAT..UNTIL Синтаксис:\ `REPEAT`\ `<тело цикла>`\ `UNTIL <условие цикла>` `тело цикла` - команды, которые выполняются при каждой итерации цикла; тело цикла может отсутствовать\ `условие цикла` - любой условный опкод Цикл `REPEAT..UNTIL` работает, пока условие цикла не будет истинно. Условие проверяется в конце итерации цикла, поэтому данный цикл будет иметь минимум одну итерацию. Константы `True` и `False` могут быть использованы в качестве условия цикла. ``` repeat // цикл с одной итерацией until true ``` ``` repeat // цикл работает бесконечно, пока не остановлен командой Break until false ``` {% hint style="warning" %} В текущей версии допускается только один опкод в качестве условия цикла. Если нужно скомбинировать несколько проверок, их можно поместить в конец цикла и использовать команды `Break` и `Continue` ``` repeat <тело цикла> if and $var >= 0 $var <= 100 then Break end // цикл выполняется, пока значение переменной $var // находится в интервале [0...100] until false ``` {% endhint %} ## Команды Continue и Break Если необходимо пропустить текущую итерацию цикла и перейти к следующей, используйте команду `Continue`. Команда `Break` завершает цикл и передает управление на команду, следующую за завершающим `end`. Обе эти команды могут быть использованы как параметр в опкоде (например, `jf Continue`) или как отдельная команда. ``` while true if not $actor.dead jf Break // завершить цикл if $actor.dead then Continue // перейти на следующую итерацию end end ``` # Классы **Класс** - это группа команд, относящихся к какой-либо сущности в игре: игрокам, актерам, машинам и т.д. Например, класс `Player` объединяет опкоды, которые выполняются над игровым персонажем. ## Общий синтаксис Синтаксис:\ `<имя класса>.<член класса>(параметры)` `Имя класса` - название группы опкодов, которая определена в файле `classes.db` для текущего [режима редактирования](/ru/edit-modes)\ `Член класса` - одна из команд, входящих в класс\ `Параметры` - 0 и более [параметров](/ru/coding/data-types), разделенных запятой ``` Player.SetMinWantedLevel($PLAYER_CHAR, 2) ``` `Player` - имя класса\ `SetMinWantedLevel` - член класса \ `$PLAYER_CHAR, 2` - два параметра для команды `SetMinWantedLevel` Существует 3 вида членов класса: * условия * методы * свойства ### Условия Условные команды в списке, вызываемом нажатием `Ctrl+пробел`, обозначаются словом `Check`. Они используются в [условных выражениях](/ru/coding/conditions): ``` if Player.Defined($PLAYER_CHAR) jf @anywhere ``` ### Методы Команды, которые используются для выполнения одиночного действия над экземплярами класса, называются методами. Например, перемещение объекта, взрыв машины и т.п.: ``` Object.PutAt($crate, 10.0, -25.5, 12.2) Car.Destroy($car) ``` В списке членов класса они обозначаются словом `proc`. Особый вид методов - это конструктор. Конструктор создает новый экземпляр класса и сохраняет указатель на него в переменную. Sanny Builder допускает два эквивалентных друг другу варианта написать конструктор: ``` Player.Create($PLAYER_CHAR, #NULL, 2488.5601, -1666.84, 13.38) ``` ``` $PLAYER_CHAR = Player.Create(#NULL, 2488.5601, -1666.84, 13.38) ``` ### Свойства Свойства служат для чтения или изменения отдельных атрибутов экземпляра класса. Например, свойство `.Money` класса `Player` позволяет работать с количеством денег у игрока: ``` Player($PLAYER_CHAR).Money += 1000000 // добавить деньги Player($PLAYER_CHAR).Money > 461@ // проверить счет игрока 4@ = Player($PLAYER_CHAR).Money // записать текущую сумму денег в переменную ``` {% hint style="warning" %} В текущей версии существует ограничение на использование пробелов в [строковых литералах](/ru/coding/data-types#strokovye-literaly) в параметрах свойств. Компилятор игнорирует такие пробелы: ``` 0@ = File.Open("file name","wb") ``` будет скомпилировано как: ``` 0@ = File.Open("filename","wb") ``` {% endhint %} ## Экземпляры класса Большинство классов в качестве первого параметра принимают переменную, которая хранит указатель на экземпляр класса - ту сущность в игре, над которой выполняется эта команда: ``` Player.Build($PLAYER_CHAR) ``` `$PLAYER_CHAR` - экземпляр класса. При этом некоторые внутриигровые элементы существуют в единственном экземпляре. Например, камера, которая определяет поле зрения игрока. Члены классов для таких сущностей не требуют экземпляра класса: ``` Camera.SetBehindPlayer() ``` ### Объявление экземпляров класса Переменные можно [объявлять](/ru/coding/variables#konstrukciya-var-end) с типом - именем класса: ``` var $PLAYER_CHAR: Player end ``` Это указывает компилятору на то, что переменная `$PLAYER_CHAR` является экземпляром класса `Player`. Такую переменную можно использовать вместо имени класса: ``` if $PLAYER_CHAR.Defined jf @anywhere ``` {% hint style="warning" %} Если переменная используется вместо имени класса, она также компилируется как первый параметр, поэтому дублировать её в списке параметров не нужно: ``` $PLAYER_CHAR.SetClothes("PLAYER_FACE", "HEAD", Head) ``` эквивалентно: ``` Player.SetClothes($PLAYER_CHAR, "PLAYER_FACE", "HEAD", Head) ``` {% endhint %} Переменные - экземпляры класса могут быть переобъявлены с другим типом. ### Класс `Model` [Имена моделей](/ru/coding/data-types#imena-modelei) являются экземплярами класса `Model`: ``` #AK47.Load :loop wait 0 if #AK47.Available jf @loop ``` эквивалентно: ``` Model.Load(#AK47) :loop wait 0 if Model.Available(#AK47) jf @loop ``` ## Константы класса Некоторые параметры в членах классов могут задаваться в виде [перечисляемого типа](/ru/edit-modes/enums.txt) (или перечисления). Это делает код более читаемым: ``` Player.SetClothes($PLAYER_CHAR, "VEST", "VEST", BodyPart.Torso) ``` Последний параметр (`BodyPart.Torso`) - это значение перечисления `BodyPart`, которое будет заменено на `0` при компиляции. Перечисления и их значения определены в [файле](/ru/edit-modes/enums.txt) `enums.txt`. #### Константы класса (устаревшее) Sanny Builder до версии 3.6 определял специальные константы для классов в файле `classes.db` . Такие параметры назывались `Extended`. Один член класса не мог иметь более одного параметра такого типа. Начиная с версии 3.6 классы могут использовать [перечисления](/ru/edit-modes/enums.txt) в качестве типов параметров, при этом допускается использование разных перечислений для разных параметров. Определенные ранее в файле `classes.db` параметры типа `Extended` были заменены на перечисления и перемещены в раздел `DEPRECATED_ENUMS` для поддержания обратной совместимости с существующими скриптами. # Ключевые слова **Ключевое слово** - это замена номеру опкода. Например, ключевое слово `WAIT` заменяет опкод `0001`. Таким образом, ``` wait 0 ``` и ``` 0001: 0 ``` представляют собой идентичный код. Список ключевых слов содержится в файле `keywords.txt` (свой для каждого [режима редактирования](/ru/edit-modes)). В редакторе его можно вызвать нажатием `Ctrl+пробел`. # Дополнительные команды В компилятор встроено несколько дополнительных команд, которые позволяют [упростить](https://ru.wikipedia.org/wiki/%D0%A1%D0%B8%D0%BD%D1%82%D0%B0%D0%BA%D1%81%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D0%B9_%D1%81%D0%B0%D1%85%D0%B0%D1%80) некоторые конструкции. ## INC Прибавляет к значению [переменной](/ru/coding/variables) (первый параметр) число (второй параметр): ``` Inc($IntVariable, $Value) = $IntVariable += $Value ``` Второй параметр по умолчанию равен `1`. ``` Inc(1@) = 1@ += 1 ``` Начиная с версии 3.06 можно использовать оператор инкремента `++`. Он пишется после имени переменной и увеличивает ее значение на `1`. ``` $var++ = $var += 1 ``` ## DEC Вычитает из значения [переменной](/ru/coding/variables) (первый параметр) число (второй параметр): ``` Dec($IntVariable, $Value) = $IntVariable -= $Value ``` Второй параметр по умолчанию равен `1`. ``` Dec(1@) = 1@ -= 1 ``` Начиная с версии 3.06 можно использовать оператор декремента `--`. Он пишется после имени переменной и уменьшает ее значение на `1`. ``` $var-- = $var -= 1 ``` ## MUL Умножает значение [переменной](/ru/coding/variables) (первый параметр) на число (второй параметр): ``` Mul($IntVariable, $Value) = $IntVariable = $IntVariable * $Value ``` Второй параметр по умолчанию равен `2`. ``` Mul(1@) = 1@ = 1@ * 2 ``` ## DIV Делит значение [переменной](/ru/coding/variables) (первый параметр) на число (второй параметр): ``` Div($IntVariable, $Value) = $IntVariable = $IntVariable / $Value ``` Второй параметр по умолчанию равен `2`. ``` Div(1@) = 1@ = 1@ / 2 ``` ## ALLOC Эта функция задает адрес для [глобальной переменной](/ru/coding/variables#globalnye-peremennye), по которому она будет хранить свое значение. Значения переменных хранятся в начале файла `main.scm`. Применять эту команду следует только к переменным с текстовым именем (например, `$text`). Для переменных с числовым именем (т.н. [`DMA`-переменные](/ru/coding/variables#globalnye-peremennye)) их адрес определяется самим этим числом. Например, переменная `$40` хранит свое значение по смещению `160` (40\*4). Первый параметр должен быть глобальной переменной, второй - целым числом больше либо равным нулю. ``` Alloc($MyVar, 40) - переменная $MyVar будет скомпилирована как $40 ``` {% hint style="info" %} См. также `help\examples\alloc.txt` {% endhint %} ## SQR Умножает переменную на саму себя ``` sqr($var) = $var *= $var ``` {% hint style="info" %} Тип переменной должен быть [объявлен](/ru/coding/variables#konstrukciya-var-end). {% endhint %} ## RANDOM Эта функция возвращает случайное число в заданном интервале: ``` $rnd = random(1, $high) ``` Может использоваться как для целых, так и для дробных чисел. Конечный опкод зависит от [типа](/ru/coding/variables#konstrukciya-var-end) переменной, в которую записывается результат (`$rnd`). # HEX..END Sanny Builder поддерживает запись произвольных значений в выходной файл без какой-либо обработки и проверки. {% hint style="warning" %} Используйте эту возможность только в том случае, если вы знаете, что делаете. Любые ошибки могут повредить файл и его невозможно будет прочитать в игре или в скриптовом редакторе. {% endhint %} ## Синтаксис `hex`\ `<последовательность байтов>`\ `end` `последовательность байтов` - одна или несколько пар цифр в [шестнадцатиричном формате](/ru/coding/data-types#hex-numbers). Каждая пара представляет собой один байт, который будет записан в файл. Все пробелы игнорируются. Если число символов в последовательности нечетное, к последнему значению слева дописывается `0`: ```pascal hex 04 00 02 0800 04 1 end ``` Эта последовательность является бинарным представлением команды `0004: $2 = 1`. Игра сможет прочитать его и установит значение переменной `$2` в `1`. В конструкции `HEX..END` также можно использовать [строковые литералы](/ru/coding/data-types#strokovye-literaly), [метки](/ru/coding/data-types#metki), [глобальные переменные](/ru/coding/variables#globalnye-peremennye), [имена моделей](/ru/coding/data-types#imena-modelei). Они компилируются без предшествующего байта, указывающего на тип данных. ```pascal :get_offset hex 04 00 02 $PLAYER_CHAR 01 @get_offset end ``` Это эквивалентно команде `0004: $PLAYER_CHAR = @get_offset` Строковые литералы, заключенные в двойные скобки, компилируются как последовательность символов: ```pascal hex "This is a string" end ``` ## Экранированные последовательности В строках допускается использование следующих управляющих символов: | Имя | Последовательность | Вывод в файл | | ---------------------------- | ------------------ | ------------ | | пустой символ | \0 | 00 | | возврат на один шаг | \b | 08 | | табуляция | \t | 09 | | перевод каретки | \n | 0A | | возврат каретки | \r | 0D | | запись произвольного байта | \x`nn` | `nn` | | запись произвольного символа | \\`символ` | `символ` | ``` hex "\0\b\t\n\r\xDD" end ``` В файл будет записана последовательность байтов `00 08 09 0A 0D DD`. {% hint style="info" %} В настоящее время несколько подряд идущих пробелов в строке конвертируются в один пробел. Например, строка `"This is a string"` будет сконвертирована в `"This is a string"`. Используйте символ `\` чтобы добавить дополнительные пробелы в строку: `"This \ \ \ is \ a \ \ \ \ string"`. {% endhint %} ## Ввод больших чисел Для удобства записи больших чисел поставьте в начале знак `&`. Число после знака `&` может быть как положительным, так и отрицательным, в десятичном или шестнадцатиричном форматах. ```pascal hex &1000 &-0xA33500 end ``` В файл будет записана последовательность байтов `E8 03 00 CB 5C FF`. ## Повторение байтов В случае, если один байт повторяется много раз, например, для создания пустого буфера, заполненного нулями, кол-во повторений можно задать, добавив `(n)` после байта, где `n` - это целое положительное число: ```pascal hex 00(10 end ``` Это будет эквивалентно: ```pascal hex 00 00 00 00 00 00 00 00 00 00 end ``` Повторения байтов можно использовать несколько раз в одном блоке, так же можно задать кол-во при помощи константы: ```pascal const n = 25 hex 00(n) 01(3) 02(4) end ``` ## Добавление бинарных файлов `hex..end` позволяет использовать директиву `{$INCLUDE}` для вставки содержимого бинарного файла в тело скрипта. Используется следующий синтаксис: ``` hex {$INCLUDE } end ``` Путь к файлу определяется по правилам [директивы](/ru/coding/directives#usdinclude) `{$INCLUDE}`. # Директивы Препроцессорные **директивы** - это специальные слова, которые указывают компилятору на необходимое поведение в процессе компиляции. Они начинаются с символа `$` и заключены в фигурные скобки `{}`. ## $INCLUDE Подключает внешний текстовый файл к исходнику. Когда компилятор находит указанную директиву, он открывает файл по пути, переданному в качестве параметра директивы и продолжает компиляцию того кода, который записан во внешнем файле. Когда компилятор достигает конца данного файла, он возвращается обратно в предыдущий файл. Синтаксис: ```pascal {$INCLUDE путь\к\файлу} ``` ```pascal {$INCLUDE loadwav.txt} {$INCLUDE C:\dev\getarrayindex.txt} ``` Если указан относительный путь, компилятор ищет файл в следующем порядке: 1. папка, где находится файл, содержащий данную директиву 2. папка `data` для текущего режима редактирования 3. корневая папка Sanny Builder 4. корневая папка игры Если компилятор не может найти файл относительно ни одной из указанных папок это вызовет ошибку. Вы можете использовать данную директиву неограниченное число раз. Вкладываемые файлы могут также содержать в себе данную директиву. {% hint style="info" %} Короткая форма этой директивы `$I`. {% endhint %} ## $INCLUDE\_ONCE Действует как `{$INCLUDE}` с тем единственным отличием, что если файл уже был подключен, он не будет подключен еще раз, и директива будет проигнорирована. ## $EXTERNAL Заставляет скомпилировать файл как внешний скрипт. Получившийся файл будет без заголовка и с локальными [метками](/ru/coding/data-types#metki) как `.scm` файл из `script.img`. Использование данной директивы подразумевает, что в файле содержится только один скрипт или одна миссия. Аналогом использования данной директивы является [опция](/ru/editor/console#skip_scm_header) `SKIP_SCM_HEADER`. Данную опцию также можно переключить на главной панели инструментов. Синтаксис: ```pascal {$EXTERNAL} ``` {% hint style="info" %} Короткая форма этой директивы `$E`. {% endhint %} ## $CLEO Является аналогом директивы `$E`, однако полученный файл автоматически копируется в директорию `игра\CLEO`, и получает расширение, указанное в директиве. Синтаксис: ```pascal {$CLEO <расширение файла>} ``` `расширение файла` - опциональный параметр, который определяет какое расширение получит скомпилированный файл. Начинается с `.`. По умолчанию равен `.cs`. ```pascal {$CLEO .cm} // файл получит расширение .cm {$CLEO} // файл получит расширение по умолчанию .cs ``` Эта директива предназначена максимально упростить создание CLEO скриптов. {% hint style="info" %} `{$CLEO}` включает в себя `{$USE CLEO}` {% endhint %} ## $NOSOURCE Запрещает компилятору добавлять в конечный файл исходный код скрипта. Если эта директива отсутствует, то при наличии директив `$EXTERNAL` или `$CLEO` и при включенной [опции](/ru/editor/options/general#dobavlyat-dopolnitelnuyu-informaciyu-v-scm) `Добавлять доп. информацию в SCM`, Sanny Builder добавит исходный код в конец файла для последующего использования при дизассемблировании. Синтаксис: ```pascal {$NOSOURCE} ``` ## $OPCODE Регистрирует новый опкод. Обычно описания всех опкодов содержатся в [специальном файле](/ru/edit-modes/opcodes-list-scm.ini), по одному для каждой игры. Но иногда необходимо добавить новый опкод для использования в текущем скрипте. Директива `$OPCODE` делает это возможным без редактирования оригинального списка опкодов. Синтаксис: ```pascal {$OPCODE <описание опкода>} ``` либо ```pascal {$OPCODE <путь к файлу с описанием>} ``` либо ```pascal {$OPCODE} ``` `описание опкода` - директива принимает описание опкода в том же [формате](/ru/edit-modes/opcodes-list-scm.ini#opkody), что и файл INI: ```pascal {$OPCODE 0CCC=1,my_new_opcode %1d%} ``` `путь к файлу с описанием` - директива также принимает путь к файлу в качестве параметра. Этот файл должен содержать в себе только описания опкодов, которые будут загружены компилятором. Если указан относительный путь, компилятор ищет файл по тем же правилам, что и в директиве `$INCLUDE`. ```pascal {$OPCODE additional_opcodes.ini} ``` Если директива использована без какого-либо параметра, это ведет к загрузке оригинального списка опкодов и отмене всех сделанных изменений. ```pascal {$OPCODE} ``` {% hint style="info" %} Короткая форма этой директивы `$O`. {% endhint %} ## $USE Разрешает компилятору использовать [дополнительный набор инструкций](/ru/edit-modes/extensions). ```pascal {$USE CLEO+} ``` Допускается перечисление нескольких имен, разделяемых запятыми. ```pascal {$USE ini, bitwise, CLEO+} ``` ## $VERSION {% hint style="warning" %} Эта директива не используется начиная с версии v3.1.0 {% endhint %} Устанавливает какая версия [опкодов](/ru/edit-modes/opcodes-list-scm.ini) будет использована во время компиляции. Синтаксис: ```pascal {$VERSION x.y.zzzz} ``` * `X`- ID [режима редактирования](/ru/edit-modes) * `y` - порядок параметров * `0` - оригинальный, все параметры идут последовательно 0, 1, 2 и т.д. * `1` - модифицированный порядок, некоторые параметры переставлены * `zzzz` - номер ревизии По умолчанию компилятор загружает версию `<текущий режим>.1.0000` ## $VERSION\_RESTORE {% hint style="warning" %} Эта директива не используется начиная с версии v3.1.0 {% endhint %} Восстанавливает версию, которая использовалась до директивы `$VERSION`. Синтаксис: ```pascal {$VERSION_RESTORE} ``` # Комментарии Комментарии обозначаются в коде двумя слэшами `//`. Все, что идет после `//` до конца строки, игнорируется компилятором. Для того чтобы закомментировать несколько строк сразу либо только часть строки (например в середине или начале), используйте блочные комментарии `{}` ``` 0001: wait {это игнорируется} 0 ms ``` Начиная с версии 3.06 Sanny Builder поддерживает C++-подобные комментарии `/* */`. ``` 0001: wait /* комментарий */ 0 ms ``` Также вы можете закомментировать несколько строк, выделив их и нажав `Ctrl+Q` (это сочетание клавиш можно изменить в [опциях](/ru/editor/options/hotkeys)). Для раскоментирования выделите текст и нажмите `Ctrl+Q` еще раз. # Возможности Sanny Builder как среда программирования предоставляет пользователю следующие возможности. ## Интеграция с Sanny Builder Library Sanny Builder Library - это портал, наполняемый сообществом, который ставит перед собой задачу задокументировать все известные скриптовые команды, используемые в GTA III, Vice City и San Andreas. Вы можете найти его по адресу . Начиная с версии 3.8.0 Sanny Builder использует файлы библиотеки, чтобы дополнить функцию [Показ различной информации об опкоде](/ru/editor/features#pokaz-razlichnoi-informacii-o-tekushem-opkode) кратким описанием того, что делает этот опкод. Пути к файлам библиотеки контролируются новым параметром `` в [конфигурации режима редактирования](/ru/edit-modes#library). Если выбранный режим редактирования использует документацию из библиотеки, в нижней панели будет отображаться её версия , например `SBL v0.119`. Версия может отличаться в разных режимах. ![](/files/-MgEMCcgZ5iZtOfqPzdl) При клике по версии в нижней панели будет показано всплывающее меню, из которого можно проверить наличие новых обновлений и скачать их. Если включить опцию `Обновлять автоматически при запуске`, Sanny Builder будет проверять обновления и скачивать их автоматически при каждом запуске. ## Темы оформления Внешний вид Sanny Builder может быть изменен при помощи тем оформления. Они задают цвета и стиль элементов интерфейса и правила подсветки синтаксиса. Текущую тему можно сменить в [опциях](/ru/editor/options/editor#tema-oformleniya) программы. {% hint style="info" %} Если запустить Sanny Builder v3.8.0 с файлом `settings.ini` из предыдущей версии программы, настройки подсветки синтаксиса будут сконвертированы в пользовательскую тему оформления (файл `themes\custom.ini`). {% endhint %} Также в Sanny Builder имеется [встроенный редактор](/ru/editor/options/theme-editor) для быстрой модификации существующих тем. ## Быстрый переход по тексту Текущую строку можно запомнить, если поставить закладку нажатием `Ctrl+Shift+0..9`, а затем вернуться к ней нажатием `Ctrl+0..9`. \ Удалить все закладки можно через меню `Правка -> Удалить закладки`. Также можно перейти к строке по ее номеру через опцию `Перейти...`. Она вызывается комбинацией `Ctrl+G`. Введите порядковый номер нужной строки, и редактор быстро переместит Вас к ней. ## Переход к определению Редактор позволяет быстро переходить к определенным участкам кода без вызова диалога поиска. Чтобы перейти к строке, обозначенной меткой (например, `:MyLabel`), поместите курсор на ссылку на эту метку (`@MyLabel`) и нажмите `Alt+Вправо`. Если такая метка существует, редактор немедленно переместит на неё курсор. Похожим образом можно перейти к началу функции или миссии, если нажать `Alt+Вправо` на имени функции или миссии. Чтобы вернуться обратно, нажмите `Alt+Влево`. Продолжайте нажимать, если переходов было несколько. Сочетания клавиш для этой функции можно изменить в [настройках](/ru/editor/options/hotkeys). ## Показ различной информации о текущем опкоде При включенной [опции](/ru/editor/options/editor#nastroiki) `Показывать информацию об опкодах` в нижней панели редактора выводится: * количество параметров для опкода; * ID модели, когда курсор находится над [ее именем](/ru/coding/data-types#imena-modelei) и `IDE` файлы для текущего [режима редактирования](/ru/edit-modes#ide) загружены; * значение [константы](/ru/coding/constants), когда курсор находится над именем константы и [языковая служба](/ru/editor/language-service) включена; * краткое описание того, что делает эта команда (из [Sanny Builder Library](/ru/editor/features#integration-with-sanny-builder-library)). ## Поиск нужного опкода Используйте программу [поиска опкодов](/ru/editor/opcode-search-tool), чтобы найти нужный опкод. ## Изменение координат и угла разворота игрока Нажмите `Ctrl+Alt+1`, когда запущена игра, и появится окно менеджера. Здесь вы можете установить новые координаты и угол разворота игрока и скопировать текущие. В верхнем поле ввода вы можете указать сразу 3 координаты, разделив их пробелом или `,`. Также вы можете быстро вставить координаты игрока в редакторе комбинацией `Ctrl+Shift+C`. Вставка угла разворота (`z_angle`) в редакторе производится нажатием `Ctrl+Shift+E`. ## Запись и воспроизведение нажатий кнопок Можно записывать последовательность нажатия клавиш (макрос) и воспроизводить ее позднее. Например, есть следующий код: ``` $Actor = Actor.Create(CivMale, #MALE01, 100.0, 100.0, 10.0) $ActorWithGun = Actor.Create(CivMale, #MALE01, 110.0, 100.0, 20.0) $Gang01 = Actor.Create(CivMale, #MALE01, 120.0, 100.0, 30.0) $Gang02 = Actor.Create(CivMale, #MALE01, 130.0, 100.0, 40.0) $Killer = Actor.Create(CivMale, #MALE01, 140.0, 100.0, 50.0) $ActorWithoutGun = Actor.Create(CivMale, #MALE01, 150.0, 100.0, 60.0) ``` Допустим, нужно обменять переменные в каждой паре строк (поставить вместо `$Actor` `$ActorWithGun`, а вместо `$ActorWithGun` - `$Actor` и т.д.). Поставьте курсор на первую строку и нажмите `Ctrl+M`. С этого момента редактор запоминает все нажатия клавиш, так что будьте осторожны. 1. Зажмите `Ctrl` и нажмите один раз `стрелку вправо`. `Ctrl` нужен так как строки разной длины. 2. Теперь нажмите `Shift+Home` и `Ctrl+Ins`. 3. Нажмите `стрелку вниз`. Курсор должен оказаться на второй строке, при этом глобальная переменная будет в буфере обмена. 4. Нажмите `Ctrl+стрелка вправо` и `Shift+Ins`. 5. Нажмите `Ctrl+стрелка влево`, `Shift+Home`, `Ctrl+Ins` и кнопку `Delete` 6. Нажмите `стрелку вверх` 7. Нажмите `Ctrl+Shift+стрелка вправо` и `Shift+Ins` 8. Нажмите кнопку `Home`. Теперь первые две строки выглядят так: ``` $ActorWithGun = Actor.Create(CivMale, 100.0, 100.0, 10.0) $Actor = Actor.Create(CivMale, 110.0, 100.0, 20.0) ``` и курсор стоит в начале первой строки. Теперь нажмите `Ctrl+M`. Макрос записан. Теперь можно воспроизводить записанную последовательность комбинацией `Ctrl+P`. Установите курсор на третью строку, нажмите `Ctrl+P`, и переменные `$Gang01` и `$Gang02` поменяются местами. Во время записи макроса можно поставить/снять запись на паузу нажатием `Ctrl+P`. ## Замена номеров миссий на их названия Sanny Builder допускает использовать имя миссии в команде `start_mission`. Именем миссии явлется ее метка, которая определена в блоке `DEFINE MISSION`. Например, у вас есть ``` DEFINE MISSION 10 AT @MYMISSION ``` Вы можете использовать вместо `start_mission 10` команду `start_mission MYMISSION`. Также существует [опция](/ru/editor/options/general#zamenyat-nomera-missii) `Заменять номера миссий`. Когда она включена, дизассемблер автоматически заменяет все номера миссий в коде на их имена. Эта опция дает возможность безболезненно удалять миссии, не заботясь о переименовывании номеров в коде. Для дополнительного удобства после команды `start_mission` можно вызвать список имен миссий нажатием `Ctrl+пробел`. См. также [Быстрый переход к миссии](/ru/editor/features#navigate-to-symbol). ## Использование оригинальных имен миссий Начиная с версии 3.2.0 Sanny Builder поддерживает оригинальные названия миссий для каждого [режима редактирования](/ru/edit-modes). Названия содержатся в файле `missions.txt`. Этот файл используется при дизассемблировании, чтобы добавить название миссии как комментарий рядом командой определения (`DEFINE MISSION`) или вызова миссии (`start_mission`). При дизассемблировании `main.scm` с измененными миссиями, отредактируйте соответствующий файл `missions.txt`, чтобы названий миссий соответствовали скрипту. ## Многоязычный интерфейс Sanny Builder обладает интерфейсом, переведенным на 15 языков. Переключить язык можно в [опциях](/ru/editor/options/general#yazyk-interfeisa) (`F10`). Информацию по созданию или изменению переводов можно найти на [sannybuilder/translations](https://github.com/sannybuilder/translations). ## Меню внешних приложений

Интерфейс настройки внешних приложений

Вы можете добавить в меню `Инструменты` до `9` внешних приложений и запускать по мере необходимости. Каждому приложению можно присвоить комбинацию горячих клавиш и параметры, необходимые для запуска. Для передачи в запускаемое приложение пути к открытому в редакторе файлу используйте специальное слово: `$SB_FileName`. Начиная с версии 3.7.0 также можно использовать переменные `@sb:` и `@game:`, которые представляют директорию Sanny Builder и директорию текущей игры соответственно, в параметрах вызываемого приложения: ``` Параметры: --cwd=@sb: --game-dir=@game: ``` ## Проверка обновлений Sanny Builder может проверить, доступна ли новая версия программы. Чтобы использовать эту возможность, пройдите в меню `Справка->Проверить обновления...`. Программа подключится к серверу обновлений и предложит скачать и установить обновление, если оно найдено. Sanny Builder может автоматически проверять наличие обновления при запуске, если вы включите соответствующую опцию в окне меню обновлений. # Опции программы Окно опций можно вызвать нажатием `F10`. Это окно разделено на 5 вкладок, каждая из которых содержит определенный вид настроек. По умолчанию открывается вкладка [общих настроек](/ru/editor/options/general). # Общие настройки Данная вкладка содержит общие настройки программы. ![](/files/-MgCsql-98iMo0cOSTII) ## Директория игры ![](/files/-M4Weq0Y-Od-JVl5ijkD) Путь к папке, где установлена игра для текущего [режима редактирования](/ru/edit-modes). Путь можно ввести вручную или выбрать через диалог, появляющийся при нажатии кнопки. ## Язык интерфейса ![](/files/-MQhVNRbKdvpQ8VEYI_M) Список доступных языков для интерфейса программы. Сами переводы находится в папке `lang`. Информацию о создании новых переводов можно найти на [sannybuilder/translations](https://github.com/sannybuilder/translations). ## Привязка файловых расширений ![](/files/-MQhUlQisxU8jc0Y3N8T) Файлы с отмеченными расширениями по умолчанию открываются в Sanny Builder. Для отмены ассоциации, снимите галочку. ## Настройки ![](/files/-M4Wf3LJG3Fwa3SOfYw4) ### Перезапись выходного файла Перезаписывать файл с результатом дизассемблирования, если файл с таким именем уже существует. Если опция не выбрана, дизассемблер создаст новый файл, добавив к нему индекс (например, `main[0].txt`). ### Показывать прогресс Отображать текущий прогресс при работе дизассемблера или компилятора. Без этой опции в статусбаре будут слова `Пожалуйста ждите…`. Показ прогресса немного замедляет процесс (де)компиляции. ### Показывать отчет Отображать диалоговое окно с различной информацией о скомпилированном файле. ### Показывать предупреждение Данная опция имеет значение только при компиляции скриптов San Andreas. Если игра запущена ко время компиляции, то файл `script.img`, содержащий часть скриптов, не может быть изменен, поскольку игра использует его. Компилятор покажет об этом предупреждение. Вы можете отключить показ предупреждения, выбрав данную опцию. ### Ручной выбор IMG-файла При дизассемблировании `main.scm` в режиме `GTA SA` программа ищет файл `script.img`, содержащий часть игровых скриптов. Если файл не найден в одной папке с `main.scm` или в папке игры, то будет показана ошибка. Однако при выборе данной опции вы сможете выбрать `script.img` вручную. ### Быстрая загрузка игры Sanny Builder способен пропускать начальные заставки при запуске San Andreas (`F8`). Если данная возможность вызывает ошибку в вашей версии игры, отключите данную опцию. ### Проверка условий Данная опция имеет 2 значения. При дизассемблировании скриптов программа заменяет [количество условий](/ru/coding/conditions#obshii-sintaksis-uslovnykh-vyrazhenii) в `IF` на слова `AND` и `OR`. При компиляции появляется поддержка конструкции `IF..END`, а также возможность компилировать `IF` со словами `AND` и `OR`. ### Проверка переменных Количество используемых глобальных и локальных [переменных](/ru/coding/variables) имеет свои [лимиты](/ru/scm-documentation/gta-limits). При включении данной опции компилятор будет проверять правильность их использования. ### Использовать опкоды При выключении этой опции дизассемблер использует [классы](/ru/coding/classes) и [ключевые слова](/ru/coding/keywords), заменяя ими опкоды. Также не будут записываться опкоды для некоторых простых математических выражений. При включении данной опции все опкоды будут записываться в исходник. ### Заменять номера миссий При включении данной опции дизассемблер [заменяет](/ru/editor/features#zamena-nomerov-missii-na-ikh-nazvaniya) номера миссий в `start_mission` на их имена. Например, `start_mission INITIAL`. Имя миссии определяется по имени метки в заголовке файла. Еe также можно использовать для [быстрого перехода](/ru/editor/features#bystryi-perekhod-po-tekstu) к началу миссии. ### Вставлять оригинальные имена миссий Когда данная опция включена, декомпилятор добавляет заранее определенные [имена миссий](/ru/editor/features#ispolzovanie-originalnykh-imen-missii) как комментарии к `start_mission`, а также к строке `DEFINE MISSION` в заголовке файла. ### Добавлять дополнительную информацию в SCM При включении данной опции компилятор сохраняет информацию о скрипте в теле скомпилированного файла. Эта информация используется в дальнейшем при дизассемблировании для достижения максимального соответствия оригиналу: * адреса конструкций [HEX..END](/ru/coding/hex..end) * имена [глобальных переменных](/ru/coding/variables#globalnye-peremennye) * оригинальный исходный код (см. также [$NOSOURCE](/ru/coding/directives#usdnosource)) * [режим редактирования](/ru/edit-modes) {% hint style="info" %} Скрипт, скомпилированный с дополнительной информацией, нельзя открыть в версиях Sanny Builder ранее v3.0 (кроме случая включения [опции](/ru/editor/console#ignore_unknown) `ignore_unknown`). Начиная с версии 3.8.0, дизассемблер может [игнорировать дополнительную информацию](/ru/editor/console#skip_extra_info). {% endhint %} # Форматирование На данной вкладке вы можете настроить имена для выходных файлов, форматы меток, регистры строковых литералов и т.д. ![](/files/-MgCtByfbztZV-FNkJhj) ## Имена файлов Настройка для имен файлов, получаемых после дизассемблирования и компиляции. ![](/files/-M4b900bDhGcodyO5rE4) В верхнем поле указывается формат для текстового файла, в который записывается содержимое дизассемблированого скрипта. В нижних двух – форматы для бинарных файлов `SCM` и `IMG` (в [режиме](/ru/edit-modes) `GTA SA`), содержащих скомпилированные скрипты. Все поля имеют общий синтаксис. Можно использовать специальные слова, которые представляют часть имени исходного файла: `$dir` – путь к исходному файлу \ `$name` – имя исходного файла\ `$ext` – расширение исходного файла Например, если вы дизассемблируете файл `C:\MyDir\main.scm`, то `$dir` это `C:\MyDir` \ `$name` это `main` \ `$ext` это `.scm` Если в верхнем поле указано `$dir\$name.txt`, то текстовый файл будет сохранен как `C:\MyDir\main.txt` ## Имена меток Формат меток, который используется при дизассемблировании скриптов. ![](/files/-MQiKsmStrY2LybISHi_) ### Смещение от начала файла Имена меток представляют собой адрес этих меток в исходном файле, например `@12345`. ### Имя скрипта+Смещение от его начала Имена меток состоят из имени скрипта, в котором они находятся (определяется командой `name_thread`) и смещения от начала скрипта. Например, `@MAIN_12`. ### Имя скрипта+Смещение от начала файла Имена меток состоят из имени скрипта, в котором они находятся (определяется командой `script_name`) и смещения от начала исходного файла. Например, `@MAIN_12345`. {% hint style="info" %} Для вывода смещений в 16-ричном формате, поставьте нижнюю галочку. {% endhint %} ## Собственные имена Опции, которые указывают дизассемблеру использовать имена, определенные пользователем во внешних файлах. ![](/files/-M4b98-sgdenDbDORoy5) Имена меток содержатся в файле [`CustomLabels.ini`](/ru/edit-modes/customlabels.ini). Файл представляет собой список имен меток и их смещений от начала файла. Если данная опция выбрана, дизассемблер при соответствии позиции метки в исходном файле одной из позиций в данном списке, назовет метку так, как указано в списке. Имена глобальных [переменных](/ru/coding/variables#globalnye-peremennye) содержатся в файле `CustomVariables.ini`.Файл представляет собой список оригинальных числовых имен глобальных переменных (`DMA`) и их текстовые эквиваленты. При включении данной опции дизассемблер будет называть переменные указанными именами. Имена массивов содержатся в файле `CustomArrays.ini`. Формат файла следующий: первым числом на строке стоит оригинальное имя переменной – начало массива, затем через пробел количество элементов в массиве – размер, затем текстовое имя. Данная опция предназначена для того, чтобы дизассемблер распознавал [элементы массива](/ru/coding/arrays#ispolzovanie-celochislennykh-konstant). {% hint style="info" %} Содержимое файлов `CustomLabels.ini`, `CustomVariables.ini`, `CustomArrays.ini` в комплекте Sanny Builder составлено для оригинального`main.scm` версии 1.0 {% endhint %} ## Регистр букв ![](/files/-M4b9AXE5CZavwCzz_Oh) Эта опция имеет 2 значения. Дизассемблер, используя данную опцию, будет именовать [глобальные переменные](/ru/coding/variables#globalnye-peremennye), [метки](/ru/coding/data-types#metki), [массивы ](/ru/coding/arrays)в указанном регистре букв. Компилятор будет записывать [строковые литералы](/ru/coding/data-types#strokovye-literaly) также в указанном регистре. # Редактор На данной вкладке вы можете изменить настройки IDE. ![](/files/-MgCtUl1njwnHv8TtH2E) ## Тема оформления ![](/files/-MgCthDgoKUKMqZAvRIq) Здесь вы можете выбрать одну из готовых тем оформления, изменяющих внешний вид программы и правила подсветки синтаксиса. Кнопка Изменить запускает [Редактор тем](/ru/editor/options/theme-editor). ## Глубина просмотра кода ![](/files/-M4k8K1myJoL1r6Th7zK) Значение глубины просмотра используется при построении списка [констант](/ru/coding/constants), [меток](/ru/coding/data-types#metki) и [переменных](/ru/coding/variables) после нажатия комбинации `Ctrl+пробел`. Это значение говорит редактору, как много строк кода нужно просмотреть в обе стороны от текущей строки. Если указано значение `0`, программа будет искать указанные элементы по всему файлу. Если галочка внизу поставлена, список меток, моделей и переменных будет появляться автоматически после набора `@`, `$`, `#`. ## Шрифт ![](/files/-M4k8NBDygh2YPjFjSeZ) Здесь вы можете выбрать шрифт и его настройки для редактора. Sanny Builder поддерживает только [моноширинные шрифты](https://ru.wikipedia.org/wiki/%D0%9C%D0%BE%D0%BD%D0%BE%D1%88%D0%B8%D1%80%D0%B8%D0%BD%D0%BD%D1%8B%D0%B9_%D1%88%D1%80%D0%B8%D1%84%D1%82). Строка `AaBbCcDd` отражает текущие настройки. ## Настройки ![](/files/-MgCtvUvyG_ErlEqN8UM) `Показывать главную панель` – показать/спрятать панель с кнопками в главном окне редактора\ `Показывать информацию об опкодах` – отображать [различную информацию](/ru/editor/features#pokaz-razlichnoi-informacii-o-tekushem-opkode) в статусной строке внизу экрана \ `Показывать номера строк` – отображать номера строк в отступе в левой части редактора \ `Показывать границу отступа` – показать границу для отступа в левой части редактора. Отключите данную опцию, чтобы визуально увеличить пространство редактора\ `Открывать при запуске последний файл` – открывать при запуске программы последний закрытый файл, если таковой существует\ `Открывать все закрытые файлы` – открывать разом все закрытые файлы при запуске. Данная опция может быть выбрана только вместе с `Открывать при запуске последний файл`\ `Подтверждать выход` – включить подтверждение для закрытия программы. Полезно для предотвращения случайного выхода\ `Включить языковую службу` – управление [языковой службой](/ru/editor/language-service). При выключенной службе становится недоступной опция подсветки констант. Выключение службы не влияет на уже открытый файл.\ `Семантическая подсветка` – применять к константам такие же правила подсветки, как к их значениям. Правило для подсветки констант, заданное в [теме оформления](/ru/editor/options/theme-editor#code-elements), будет проигнорировано. # Редактор тем оформления **Редактор тем** - это встроенная утилита, которая заменяет вкладку настроек подсветки синтаксиса. Он может быть запущен из вкладки [Редактор](/ru/editor/options/editor#tema-oformleniya). ![](/files/-MgCzLQ8ER0ltdOVycqV) Для кастомизации доступны цвета и стили некоторых элементов интерфейса и кода. У таких элементов можно изменить 3 свойства: `Цвет`, `Фон`, `Стиль`. Некоторые свойства могут быть недоступны для определенных элементов. Для комбинирования между собой доступны 3 варианта `стиля`: **B** – полужирный, **I** – курсив, **U** – подчеркнутый. ### Элементы интерфейса * **Поле редактора** – цвет текста и фон основной области редактирования * **Активная строка** – фон строки, на которой находится курсор * **Отступ** – цвет текста и фон области слева от редактора * **Нижняя панель** – цвет текста и фон панели под редактором * **Граница нижней панели** – цвет границ отдельных секций в нижней панели ### Элементы кода * [Комментарии](/ru/coding/comments) – текст после `//`, а также между `{}` или `/* */` * [Метки](/ru/coding/data-types#metki) – идентификаторы, начинающиеся с `@` * [Переменные](/ru/coding/variables) – идентификаторы, начинающиеся с `$` (глобальные переменные), или заканчивающиеся на `@` (локальные переменные)\ Тип [aDMA](/ru/coding/data-types#peremennye) (начинается с `&`) и [массивы](/ru/coding/arrays) подсвечиваются как переменные. * [Ключевые слова](/ru/coding/keywords) – специальные слова, записанные в файле `keywords.ini` (один для всех [режимов редактирования](/ru/edit-modes)) и `keywords.txt` (свой для каждого режима) * Числа – целые и дробные числа * Строковые литералы – текст между двойными `" "` или одинарными `' '` кавычками * Модели – идентификаторы, начинающиеся с `#` * [Классы](/ru/coding/classes) – имена классов (идентификатор перед `.`) * Команды – члены класса (идентификатор после `.`), а также [функции](/ru/coding/data-types#metki) * [Директивы ](/ru/coding/directives)– текст после комбинации символов `{$` * [Константы](/ru/coding/constants) - идентификаторы, объявленные внутри конструкции `CONST..END`. См. также [Семантическая подсветка](/ru/editor/options/editor#nastroiki). {% hint style="info" %} Правила подсветки используются также при сохранении кода в формат `RTF` или `HTML`. {% endhint %} # Горячие клавиши ![](/files/-MgCuDcxdEO9cAl-bDGW) Некоторые [горячие клавиши](/ru/editor/hotkeys) могут быть изменены для вашего удобства. Вы можете установить новые сочетания кнопок для вызова инструментов, действий редактора и некоторых других возможностей. # Консоль **Консоль** служит инструментом для переключения отладочных опций Sanny Builder. Многие из них относятся к возможностям дизассемблера и влияют на его работу. Окно консоли открывается нажатием `Ctrl+~`. Для запуска команды введите ее в верхнем поле и нажмите `Enter`. Консоль покажет результат. ## Доступные команды Все команды являются регистронезависимыми. `help` – показать справку о консоли\ `clear` – очистить консоль\ `list` – показать список доступных команд\ `list options` – вывести все доступные отладочные опции\ `toggle <имя опции> [on/off]` – переключить [отладочную опцию](/ru/editor/console#otladochnye-opcii) Команда `toggle` заканчивается либо словом `ON` (опция будет включена), `OFF` (опция будет выключена), или ни тем ни другим (опция будет переключена с `ON` на `OFF` или с `OFF` на `ON`). {% hint style="info" %} Перед включением отладочных опций включите общий режим отладки командой`toggle debug_mode ON` {% endhint %} ## Отладочные опции ### CODE\_OFFSETS Дизассемблер выводит для каждой команды ее адрес в файле (смещение от начала). ### VAR\_COUNTER После компиляции в консоли содержится список [глобальных переменных](/ru/coding/variables#globalnye-peremennye), которые были использованы только один раз (неиспользуемые переменные, которые можно удалить или заменить на [локальные переменные](/ru/coding/variables#lokalnye-peremennye)). ### IGNORE\_UNKNOWN Дизассемблер игнорирует ошибки в исходном коде (неизвестные опкоды, неверные типы данных, нарушения формата файла). Это помогает открыть большинство скриптов, которые были скомпилированы некорректно. ### CONSTANT\_INDEXES Выводит элементы массива как глобальные переменные с индексом. Доступно для режимов `GTA SA`, `LCS`, `VCS`. Например, если в исходном файл был массив из трех элементов, начинающийся с `$10`, то при переключении этой опции переменные в дизассемблированном файле будут выглядеть следующим образом: | `Без CONSTANT_INDEXES` | С `CONSTANT_INDEXES` | | ---------------------- | -------------------- | | $10 | $10\[0] | | $11 | $10\[1] | | $12 | $10\[2] | ### SKIP\_SCM\_HEADER Дизассемблер пропускает чтение заголовка `.scm` файла. Это позволяет открывать скрипты в которых заголовка нет (например, скрипты из файла `script.img` или CLEO скрипты). Также при включении этой опции Sanny Builder компилирует `.scm` файлы без заголовка (альтернативно использованию [директивы](/ru/coding/directives#usdexternal) `{$EXTERNAL}`). ### SKIP\_EXTRA\_INFO Дизассемблер игнорирует секцию с [дополнительной информацией](/ru/editor/options/general#dobavlyat-dopolnitelnuyu-informaciyu-v-scm) в конце скрипта. Эта секция будет рассматриваться как набор SCM инструкций, поэтому рекомендуется дополнительно включить опцию `IGNORE_UNKNOWN`. ## Альтернативные способы включения Sanny Builder предлагает несколько способов для переключения отладочных опций за пределами консоли. Эти способы могут быть полезны в определенных случаях. ### Запуск с параметром --`debug` Запуск программы через командную строку с [параметром](/ru/editor/cli#debug) `--debug` является способом одновременно переключить несколько опций. Запустите `sanny.exe` с параметром `--debug X`, где `X` это последовательность `0` и `1`. Каждая цифра в последовательности означает определенную опцию: | Индекс | Отладочная опция | | ------ | ----------------- | | 1 | CODE\_OFFSETS | | 2 | IGNORE\_UNKNOWN | | 3 | VAR\_COUNTER | | 4 | CONSTANT\_INDEXES | | 5 | SKIP\_SCM\_HEADER | | 6 | SKIP\_EXTRA\_INFO | ``` sanny.exe --debug 110000 ``` Первая `1` включит опцию `CODE_OFFSETS`, вторая `1` включит режим `IGNORE_UNKNOWN`. Оставшиеся опции будут отключены. ### Использование интерфейса программы Клик по самой правой кнопке на панели инструментов открывает выпадающее меню со списком опций:
Каждый элемент списка переключает одну из опций. Изменение будет сразу доступно для использования. # Горячие клавиши Sanny Builder поддерживает стандартные сочетания клавиш для операций с файлами и текстом (`Ctrl+N`, `Ctrl+Z`, и т.д.), а также собственные комбинации. Сочетания, отмеченные `*`, могут быть изменены в [настройках](/ru/editor/options/hotkeys). | Клавиша/Комбинация | Действие | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Главное меню** | | | `Ctrl`+`N` | Создать новый файл | | `Ctrl`+`O` | Открыть файл | | `Ctrl`+`W` | Закрыть текущий файл | | `Ctrl`+`Shift`+`T` | Открыть последний закрытый файл | | `F5`\* | открыть файл как скрипт и дизассемблировать его | | `F6`\* | скомпилировать текст в редакторе в скриптовый файл | | `F7`\* | скомпилировать текст в редакторе в скриптовый файл, а затем скопировать его в директорию скриптов для [выбранной игры](/ru/editor/options/general#direktoriya-igry) | | `F8`\* | запустить игру для текущего [режима редактирования](/ru/edit-modes) | | `F10` | открыть [окно опций](/ru/editor/options) | | `F12` | открыть документацию | | **Текст** | | | `TAB`, `Shift`+`TAB` | двигать выделенный блок текста влево/вправо | |

Ctrl+Alt+A

Ctrl+Alt+D

| двигать выделенный блок текста влево/вправо (на один символ) | |

Ctrl+Alt+B

Ctrl+Alt+N

Ctrl+Alt+M

| различные режимы выделения текста: Обычный, По столбцам (аналог - выделение с зажатым `Alt`), По строкам | |

Ctrl+Shift+U

Ctrl+Shift+L

| перевод выделенного слова в верхний/нижний регистр | | `Ctrl`+`+` | увеличить размер шрифта в редакторе | | `Ctrl`+`-` | уменьшить размер шрифта в редакторе | | `Ctrl`+`T` | удалить слово | | `Ctrl`+`Y` | удалить строку | | `Ctrl`+`Shift`+`Y` | очистить строку | | `Ctrl`+`/`\* | [закомментировать / раскомментировать](/ru/coding/comments) строку | | **Навигация** | | | `Ctrl`+`Shift`+`B` | перемещение между скобками: `{}`, `()`, `<>`, `[]` | |

Ctrl+Вверх

Ctrl+Вниз

| прокрутить страницу на одну строку вверх/вниз | | `Ctrl`+`колесо мыши вверх/вниз` | страница вверх/вниз | | `Ctrl`+`Shift`+`0..9` | добавить [закладку](/ru/editor/features#bookmarks-quick-jump) | | `Ctrl`+`0..9` | перейти на строку с [закладкой](/ru/editor/features#bookmarks-quick-jump) | | `Ctrl`+`G`\* | переход к строке с номером | | `Alt`+`Вправо`\* | [переход к определению](/ru/editor/features#navigate-to-symbol) под курсором (метка, начало миссии или функции) | | `Alt`+`Влево`\* | вернуть курсор на предыдущую позицию (откуда был вызван [переход к определению](/ru/editor/features#navigate-to-symbol)) | | `Ctrl`+`Enter` | открыть файл по имени под курсором (см. очередность открытия [относительных путей](/ru/coding/directives#usdinclude)) | | **Код** | | | `Ctrl`+`пробел` | показать список классов / свойств / моделей / меток / переменных / миссий | | `Ctrl`+`Shift`+`пробел` | показать подсказку для текущей команды класса | | `Ctrl`+`Shift`+`C`\* | вставить [текущие координаты игрока](/ru/editor/features#izmenenie-koordinat-i-ugla-razvorota-igroka) | | `Ctrl`+`Shift`+`E`\* | вставить [текущий угол поворота игрока](/ru/editor/features#izmenenie-koordinat-i-ugla-razvorota-igroka) | | `F1` | искать опкод со словом под курсором (без учета `_` и `.`) | | `Ctrl`+`F1` | искать опкод со словом под курсором (с учетом `_` и `.`) | | `F2` | развернуть слово под курсором в [шаблон кода](/ru/edit-modes/code-templates) с таким названием | | `Ctrl`+`J` | показать список доступных [шаблонов кода](/ru/edit-modes/code-templates) | | `Ctrl`+`M` | запись [последовательности нажатия клавиш](/ru/editor/features#zapis-i-vosproizvedenie-nazhatii-knopok) / остановка записи | | `Ctrl`+`P` | воспроизведение записанной [последовательности](/ru/editor/features#zapis-i-vosproizvedenie-nazhatii-knopok) / пауза во время записи | | `Ctrl`+`H`\* | конвертировать число под курсором из десятичного формата в шестнадцатиричный (0x) и обратно | | `Ctrl`+`B`\* | конвертировать число под курсором из десятичного формата в двоичный (0b) и обратно | | `Ctrl`+`Alt`+`H`\* | конвертировать [имя модели](/ru/coding/data-types#imena-modelei) под курсором в ID и наоборот | | **Разное** | | | `Ctrl`+`~` | открыть [консоль](/ru/editor/console) | | `Alt`+`S` | (когда активен список моделей) - пересортировать список | # Поиск опкодов Вызвать поиск опкодов можно нажатием `Ctrl+Alt+2` или выбрав меню `Сервис->Инструменты->Поиск опкодов`. ![](/files/-M1Hc_IPktY-wc4g49Eh) Чтобы найти нужный опкод, впишите в верхнем поле слова, соответствующие ему, например `actor car`. В списке останутся команды, содержащие эти слова. Вписывайте уточняющие слова, пока нужный опкод не будет найден. При поиске можно пользоваться специальными операторами (подробнее о них ниже). Если при открытии окна поиска в редакторе был выделен текст, он будет автоматически вставлен в строку поиска. ## Копирование результатов Чтобы скопировать опкод в буфер обмена, выберите его и нажмите `Enter`.\ Чтобы добавить опкод к содержимому буфера обмена, нажмите `Shift+Enter`.\ Чтобы скопировать весь список опкодов, нажмите `F2`. ## Горячие клавиши `Enter` - скопировать выбранный опкод в буфер обмена\ `Shift+Enter` - добавить выбранный опкод к содержимому буфера обмена\ `F1` - показать справочную информацию\ `F2` - скопировать весь список опкодов в буфер обмена\ `F3` - сортировать список по опкодам\ `F4` - сортировать список по алфавиту\ `F11` - очистить поле поиска, показать все опкоды\ `ESC` - закрыть программу ## Поисковые выражения ### Оператор И Одиночный пробел между словами служит оператором `И`: ``` @ player ``` Найдет опкоды, в которых есть `@` и `player`. ### Оператор ИЛИ Символ `|` служит оператором `ИЛИ`: ``` @ | player ``` Найдет опкоды, в которых есть `@` или `player`. Если `|` стоит первым символом в поле поиска, программа применит оператор `ИЛИ` ко всем последующим словам: ``` | actor player car ``` Найдет опкоды, в которых есть хотя бы одно из слов `actor`, `player`, `car`. ### Оператор НЕ Два дефиса перед словом исключают опкоды с этим словом: ``` car --actor ``` Найдет опкоды со словом `car`, но без `actor`. Одиночный дефис может использоваться как оператор `НЕ` перед словами, либо перед `$` или `@`, но не перед числами: ``` -10 -@ -car ---1 ``` Найдет опкоды с числом `-10`, но без `@`, `car`, `-1` ### Поиск среди условных опкодов `^` - показать только условные опкоды\ `^word` - ищет `word` в условных опкодах: ``` ^car == ``` Найдет условные опкоды со словами `car` и `==`. `-^` - исключить условные опкоды из результата: ``` player -^ ``` Найдет все неусловные опкоды со словом `player`. `-^word` - исключить условные опкоды со словом `word`: ``` player -^actor ``` Найдет опкоды со словом `player`, исключив условные опкоды со словом `actor`. ### Учет порядка слов `%` - ищет опкоды с учетом заданного порядка слов: ``` % @ = @ ``` Найдет опкоды, в которых символы `@` `=` `@` следуют в указанном порядке (между ними могут быть другие слова). # Интерфейс командной строки ## --compile `--compile <путь к исходному файлу> [путь к конечному файлу]` - скомпилировать `исходный файл` и закрыть программу ``` sanny.exe --compile C:\myscm.txt C:\myscm.scm ``` {% hint style="info" %} Если `путь к конечному файлу` пропущен, компилятор использует [настройки форматирования](/ru/editor/options/formats#imena-failov). {% endhint %} {% hint style="info" %} Ошибки, возникшие во время компиляции, записываются в файл `compile.log`. {% endhint %} Краткая форма: `-c` ## --decompile `--decompile <путь к исходному файлу> [путь к конечному файлу]` - декомпилировать `исходный файл` и закрыть программу ``` sanny.exe --decompile C:\myscm.scm C:\myscm.txt ``` {% hint style="info" %} Если `путь к конечному файлу` пропущен, компилятор использует [настройки форматирования](/ru/editor/options/formats#imena-failov). {% endhint %} {% hint style="info" %} Ошибки, возникшие во время декомпиляции, записываются в файл `compile.log`. {% endhint %} Краткая форма: `-d` **--use-source** - опциональный аргумент, который указывает на необходимость использования исходного кода в теле скрипта (если он есть). По умолчанию декомпилятор игнорирует его. ``` sanny.exe --decompile C:\1.cs --use-source ``` ## --debug `--debug` - переключает [отладочные опции](/ru/editor/console#otladochnye-opcii) ``` sanny.exe --debug 110000 ``` ## --game `--game ` - выбирает [режим редактирования по умолчанию](/ru/edit-modes#type) для выбранной игры. Допустимые значения `game`: * `gta3` * `vc` * `sa` * `lcs` * `vcs` * `vc_mobile` * `sa_mobile` Краткая форма: `-g` ``` sanny.exe --game sa ``` ## --mode `--mode ` - выбирает режим редактирования с заданным [`id`](/ru/edit-modes#id). `id` режима можно узнать в соответствующем файле `mode.xml`. Краткая форма: `-m` ``` sanny.exe --mode vcs_psp ``` ## --no-splash `--no-splash` - запускает Sanny Builder без загрузочного экрана ``` sanny.exe --no-splash ``` ## -x `-x` - перезагружает настройки [режимов редактирования](/ru/edit-modes) (полезно при тестировании изменений этих настроек) ```sh sanny.exe -x ``` ## --option {% hint style="info" %} Доступно, начиная с v3.8.0 {% endhint %} `--option <имя опции> <значение>` - устанавливает значение определенной [опции](/ru/editor/options). Чтобы установить несколько опций сразу, перечислите их друг за другом: `--option <имя 1й опции> <значение 1й опции> --option <имя 2й опции> <значение 2й опции> ... --option <имя N опции> <значение N опции>` Имя опции может принимать одно из следующих значений: {% hint style="warning" %} Данный список не окончательный и может меняться. {% endhint %} | Имя | Допустимые значения | Вкладка в настройках | | ------------------------------------------------------------------------------------------------------- | ------------------- | -------------------- | | [Editor::ShowPanel](/ru/editor/options/editor#nastroiki) | 0, 1 | Редактор | | [Editor::ShowOpcodeInfo](/ru/editor/options/editor#nastroiki) | 0, 1 | Редактор | | [Editor::ShowLineNumbers](/ru/editor/options/editor#nastroiki) | 0, 1 | Редактор | | [Editor::ShowGutterBorder](/ru/editor/options/editor#nastroiki) | 0, 1 | Редактор | | [Editor::OpenLastFile](/ru/editor/options/editor#nastroiki) | 0, 1 | Редактор | | [Editor::OpenAllClosedFiles](/ru/editor/options/editor#nastroiki) | 0, 1 | Редактор | | [Editor::ConfirmExit](/ru/editor/options/editor#nastroiki) | 0, 1 | Редактор | | [Editor::LanguageService](/ru/editor/options/editor#nastroiki) | 0, 1 | Редактор | | [Editor::SemanticConstHighlighting](/ru/editor/options/editor#nastroiki) | 0, 1 | Редактор | | [Editor::IdentifiersListAuto](/ru/editor/options/editor#glubina-prosmotra-koda) | 0, 1 | Редактор | | [Editor::ScanDistance](/ru/editor/options/editor#glubina-prosmotra-koda) | 0..65535 | Редактор | | [Editor::Lang](/ru/editor/options/general#yazyk-interfeisa) | номер локали | Общие | | [Editor::QuickGameLoading](/ru/editor/options/general#bystraya-zagruzka-igry) | 0, 1 | Общие | | [Editor::ShowProgress](/ru/editor/options/general#pokazyvat-progress) | 0, 1 | Общие | | [Editor::ShowReport](/ru/editor/options/general#pokazyvat-otchet) | 0, 1 | Общие | | [Decompiler::OverwriteOutputFile](/ru/editor/options/general#perezapis-vykhodnogo-faila) | 0, 1 | Общие | | [Decompiler::ManualIMGOpening](/ru/editor/options/general#ruchnoi-vybor-img-faila) | 0, 1 | Общие | | [Decompiler::HexadimalOffsets](/ru/editor/options/formats#imena-metok) | 0, 1 | Общие | | [Decompiler::LabelsFormat](/ru/editor/options/formats#imena-metok) | 0, 1, 2 | Общие | | [Decompiler::AlwaysWriteOpcodes](/ru/editor/options/general#ispolzovat-opkody) | 0, 1 | Общие | | [Decompiler::ReplaceMissionNumbers](/ru/editor/options/general#zamenyat-nomera-missii) | 0, 1 | Общие | | [Decompiler::InsertOriginalMissionNames](/ru/editor/options/general#vstavlyat-originalnye-imena-missii) | 0, 1 | Общие | | [Compiler::ShowIMGWarning](/ru/editor/options/general#pokazyvat-preduprezhdenie) | 0, 1 | Общие | | [Compiler::CheckConditions](/ru/editor/options/general#proverka-uslovii) | 0, 1 | Общие | | [Compiler::CheckLocalVariables](/ru/editor/options/general#proverka-peremennykh) | 0, 1 | Общие | | [Compiler::AddExtraInfo](/ru/editor/options/general#dobavlyat-dopolnitelnuyu-informaciyu-v-scm) | 0, 1 | Общие | | [CustomNames::UseCustomLabels](/ru/editor/options/formats#sobstvennye-imena) | 0, 1 | Форматирование | | [CustomNames::UseCustomVariables](/ru/editor/options/formats#sobstvennye-imena) | 0, 1 | Форматирование | | [CustomNames::UseCustomArrays](/ru/editor/options/formats#sobstvennye-imena) | 0, 1 | Форматирование | | [CustomNames::Format](/ru/editor/options/formats#registr-bukv) | 0, 1, 2 | Форматирование | {% hint style="info" %} Опции, измененные через командную строку, не являются постоянными и применяются только в текущей сессии. После перезапуска Sanny Builder будет использовать значения из файла `settings.ini`. {% endhint %} Краткая форма: `-o` ``` sanny.exe -o Compiler::CheckConditions 0 -o Editor::LanguageService 1 ``` # Языковая служба **Языковая служба** - это часть функционала Sanny Builder, обеспечивающего комфортную работу пользователей. Она ответственна за постоянный сбор данных в текущем открытом документе и всех импортируемых файлах. Сбор информации происходит в отдельном потоке и реагирует на изменения в файле с определенной задержкой. В зависимости от конфигурации службы и объема текста для сканирования эта задержка может быть значительной. Если, по разным причинам, это мешает вам работать со скриптами, или вы не удовлетворены производительностью службы, ее можно отключить в [настройках](/ru/editor/options/editor#nastroiki) программы. Для лучшей производительности языковая служба сканирует документ частично, а не весь файл целиком. Это управляется значением [глубины сканирования](/ru/editor/options/editor#glubina-prosmotra-koda) в настройках редактора. Чем выше значение, тем больше символов находит служба, но это также увеличивает время, необходимое на то, чтобы редактор отреагировал на изменения в документе. Если ваш компьютер недостаточно производителен, используйте значение по умолчанию `250` строк. Начиная с версии 3.7.0 языковая служба способна находить [объявленные константы](/ru/coding/constants#obyavlenie-konstant) и их значения. Эта информация затем попадает в редактор для [подсветки](/ru/editor/features#color-themes) и [отображения значений ](/ru/editor/features#pokaz-razlichnoi-informacii-o-tekushem-opkode)констант. ``` const x = 10 end x // x подсвечивается ``` Константы могут быть подсвечены двумя способами: * все константы подсвечиваются одинаково * каждая константа подсвечивается так же, как ее значение ("семантическая подсветка") При включенной семантической подсветке в примере выше `x` было бы раскрашено как обычное число (по умолчанию бордовым цветом). Языковая служба также служит источником данных для функции автодополнения, которая срабатывает при нажатии `Ctrl+Space`. Она выводит список констант и их значения. При выключенной языковой службе константы не отображаются в списке. # Режимы редактирования Sanny Builder поддерживает разные игры и платформы в серии Grand Theft Auto. Для этого в его состав входит конфигурация для каждой поддерживаемой игры, которая называется **режимом редактирования**. Режим редактирования определяет следующую информацию: * целевая игра * пути к игровым файлам * пути к файлам со вспомогательной информацией (имена [меток](/ru/edit-modes#labels), [переменных](/ru/edit-modes#variables), [констант](/ru/edit-modes#constants)) Sanny Builder хранит настройки режимов в папке `data`. Если любая из папок в этой директории содержит файл `mode.xml`, этот файл автоматически загружается как новый режим редактирования. {% hint style="info" %} Версии Sanny Builder до 3.9 хранили настройки режимов редактирования в файле `data\modes.xml`. Начиная с версии 3.9 этот файл был разделен на отдельные XML файлы для каждого режима. {% endhint %} Режимы редактирования загружаются автоматически при старте Sanny Builder. В случае необходимости, они могут быть перезагружены путем запуска Sanny Builder с [опцией](/ru/editor/cli#x) `-x`. Допускается изменение и расширение существующих режимов, а также создание новых. ## Формат файла `mode.xml` - документ в формате `XML`, который может редактироваться в любом текстовом редакторе. Файл начинается с объявления ```xml ``` После него должен идти корневой элемент ``. В файле может быть только один корневой элемент. `` имеет как обязательные, так и необязательные атрибуты, описанные ниже. Содержимое `` представляет собой набор различных тэгов (элементов), определяющих пути к папкам и файлам. ### Атрибуты режима #### id `id` - это обязательный и неповторяющийся идентификатор режима. Sanny Builder использует его для сохранения некоторых пользовательских настроек режима, например выбранной [директории игры](/ru/editor/options/general#direktoriya-igry). Допустимым значением атрибута является последовательность символов, которая не используется как идентификатор другого режима редактирования. #### extends Режим может наследовать свойства другого режима (родительский режим), чтобы уменьшить число повторяющихся параметров. Это полезно для разных версий одной игры, где большая часть конфигурации одинакова, за исключением некоторых параметров. Родительский режим может наследовать свойства другого режима. Если в конфигурации режима отсутствует какой-то параметр, Sanny Builder рекурсивно проходит по всем родительским режимам, чтобы найти его значение. Допустимым значением атрибута является идентификатор другого режима редактирования, описанного в этом же файле. #### title `title` задает отображаемое имя режима. Из-за ограничений интерфейса избегайте длинных имен и используйте имена короче `24` символов. #### game Атрибут `game` определяет целевую игру для данного режима. Допустимыми значениями являются: * `gta3` * `vc` * `sa` * `lcs` * `vcs` * `vc_mobile` * `sa_mobile` Перед началом работы со скриптом, убедитесь что выбран правильный режим редактирования. Каждая игра имеет свой собственный формат скриптов, который несовместим с другими играми. Даже если компиляция прошла без ошибок, в игре может возникнуть ошибка при попытке чтения скрипта в неизвестном ей формате. {% hint style="info" %} В скомпилированном файле может [храниться информация](/ru/editor/options/general#dobavlyat-dopolnitelnuyu-informaciyu-v-scm) о целевой игре для данного скрипта. Перед началом дизассемблирования такого скрипта Sanny Builder предлагает переключить режим редактирования на нужный. Игнорирование такого предложения может привести к ошибке, т.к. формат скрипта может отличаться от того, что ожидает дизассемблер. {% endhint %} Для удобства пользователей Sanny Builder отображает иконку целевой игры напротив имени режима. #### type Один из режимов для каждой целевой игры должен быть режимом по умолчанию. Это означает, что Sanny Builder использует его при запуске с [опцией](/ru/editor/cli#game) `--game`. Допустимым значением атрибута является `default.` Не указывайте этот атрибут для остальных режимов. ### Параметры режима #### arrays путь к [`CustomArrays.ini`](/ru/coding/arrays) #### classes путь к [`classes.db`](/ru/coding/classes) #### constants путь к[`constants.txt`](/ru/coding/constants) #### copy-directory путь к директории, в которую нужно скопировать скрипт при запуске `Компилировать и сделать копию`: Имеет обязательный атрибут `type`:\ `type="scm"` - применяется к обычным `.scm` скриптам \ `type="cleo"` - применяется к скриптам с [директивой](/ru/coding/directives#usdcleo) `{$CLEO}` #### data путь к директории режима редактирования **enums** путь к [enums.txt](/ru/edit-modes/enums.txt) #### ide путь к `.ide` или `.dat` файлу:\ `.ide` файлы содержат [имена моделей](/ru/coding/data-types#imena-modelei) и их характеристики\ `.dat` файлы содержат пути к другим `.ide` файлам Элемент `ide` имеет необязательный атрибут `base`, который задает папку, относительно которой расчитываются пути, определенные внутри `.dat` файла: ```xml default.dat ``` Без `base` все пути расчитываются относительно папки с `.dat` файлом. Режим редактирования может иметь несколько элементов ``. #### keywords путь к файлу со списком [ключевых слов](/ru/coding/keywords) #### labels путь к [`CustomLabels.ini`](/ru/edit-modes/customlabels.ini) #### missions путь к [`missions.txt`](/ru/editor/features#ispolzovanie-originalnykh-imen-missii) #### `library` путь к JSON файлу с определениями скриптовых команд, используемых в целевой [игре](/ru/edit-modes#game). доступен для скачивания в [Sanny Builder Library](/ru/editor/features#integration-with-sanny-builder-library), #### opcodes путь к файлу со [списком опкодов](/ru/edit-modes/opcodes-list-scm.ini). может использоваться неоднократно для подключения нескольких файлов. является необязательным параметром, если используется **library** (см. выше). #### templates путь к файлу с [эксклюзивными шаблонами](/ru/edit-modes/code-templates) Имеет обязательный атрибут `type`:\ `type="default"` - путь к файлу с шаблонами, включенными в состав Sanny Builder\ `type="custom"` - путь к файлу с пользовательскими шаблонами, [добавленными](/ru/edit-modes/code-templates#adding-a-new-template) из редактора #### text путь к `.gxt` файлу `` имеет обязательный атрибут: `format`. Допустимыми значениями являются: `gta3`: `.gxt` с одной таблицей, текстовыми ключами, кодировкой ANSI\ `vc`: `.gxt` с несколькими таблицами, текстовыми ключами, кодировкой ANSI\ `sa`: `.gxt` с несколькими таблицами, зашифрованными ключами, кодировкой ANSI\ `sa_mobile`: `.gxt` с несколькими таблицами, зашифрованными ключами, кодировкой UTF-16 #### variables путь к [`CustomVariables.ini`](/ru/coding/variables) #### examples путь к [`opcodes.txt`](/ru/editor/opcode-search-tool) ### Доступные переменные Sanny предоставляет несколько переменных, которые могут использоваться в параметрах и атрибутах (там, где это применимо). `@game:` - путь к [папке с игрой](/ru/editor/options/general#direktoriya-igry), которая выбрана в настройках\ `@sb:` - путь к папке Sanny Builder (где находится `sanny.exe`) Оба пути не включают в себя завершающий слеш (`/`). ## Список режимов Sanny Builder предлагает много различных режимов, их количество может меняться от версии к версии: | Название | Id | Имена опкодов | Порядок параметров | Игра | | ----------------------- | ----------- | -------------- | ------------------ | -------------------------------------------------------------------------------------------------- | | GTA III | gta3 | сообщество | измененный | все версии GTA III | | GTA VC (SBL) | vc\_sbl | Rockstar | первоначальный | все версии Vice City | | ~~GTA VC~~ | ~~vc~~ | ~~сообщество~~ | ~~измененный~~ |

все версии Vice City
режим устарел, начиная с версии 4.0, используйте новый режим VC SBL

| | GTA SA (v1.0 - SBL) | sa\_sbl | Rockstar | первоначальный | SA версия 1.0 | | ~~GTA SA v1.0~~ | ~~sa~~ | ~~сообщество~~ | ~~измененный~~ |

SA версия 1.0;
режим устарел, начиная с версии 4.0, используйте новый режим SA SBL

| | GTA SA v2.0 | sa\_v2 | сообщество | измененный | SA версия 2.0 | | ~~GTA SA (v1.0 - SCR)~~ | ~~sa\_scr~~ | ~~Rockstar~~ | ~~первоначальный~~ |

SA версия 1.0;
режим удален в версии 4.0, используйте новый режим SA SBL

| | GTA LCS | lcs | Rockstar | первоначальный | все версии Liberty City Stories | | GTA VCS (PSP) | vcs\_psp | Rockstar | первоначальный | VCS для PSP | | GTA VCS (PS2) | vcs\_ps2 | Rockstar | первоначальный | VCS для PS2 | | VC Mobile | vc\_mobile | сообщество | измененный | версия для Android и iOS | | SA Mobile | sa\_mobile | сообщество | измененный | версия для Android и iOS | Колонка `Имена опкодов` определяет способ именования опкодов. Первые имена неизвестным опкодам были даны в результате анализа игрового кода, проводимого сообществом скриптеров в течение многих лет. Так появились такие термины как "актёр" ("actor") или "поток" ("thread"). Альтернативой является оригинальная терминология, использованная разработчиками игры (соответственно, "персонаж" ("char") или "скрипт" ("script")). Эта терминология вместе со списком оригинальных названий всех опкодов оказались доступны в коде игры GTA SA: Mobile. `Порядок параметров` определяет как расположены параметры опкода относительно друг друга. В первоначальном порядке все параметры находятся в той последовательности, как было задумано разработчиками игры, от параметра с наименьшим индексом к параметру с наибольшим индексом. Измененный порядок подразумевает, что в некоторых опкодах параметры переставлены местами для повышения читаемости кода или по иным причинам. Сочетание оригинальной терминологии и сохранение порядка следования параметров обеспечивает максимальное сходство скриптов с тем языком, который использовали разработчики игры. ## Переключение режимов Чтобы переключить режим редактирования, кликните в правом нижнем углу программы. Появится список доступных режимов. Выберите нужный и кликните по нему. Sanny Builder загрузит все требуемые файлы и вы сразу можете продолжить работу. ![](/files/-M11n8tgn2zH-yLlRZmJ) Выбрать режим через командную строку можно с [опцией](/ru/editor/cli#mode) `--mode`. Чтобы выбрать режим по умолчанию для какой-либо игры, используйте [опцию](/ru/editor/cli#game) `--game`. Запуск Sanny Builder с [опцией](/ru/editor/cli#x) `-x` перезагружает режимы редактирования и обновляет список доступных режимов. {% hint style="info" %} Вы можете зарегистрировать новое сочетание клавиш для быстрого обновления режимов редактирования без необходимости перезапуска Sanny Builder. Добавьте новый элемент в [меню внешних приложений](/ru/editor/features#menyu-vneshnikh-prilozhenii): Путь: `sanny.exe`\ Параметры: `-x --no-splash`\ Shortcut: `` {% endhint %} # CustomLabels.ini Вы можете присваивать меткам специфичные имена, которые не будут зависеть от [опций](/ru/editor/options/formats#imena-metok) дизассемблера. Такие имена содержатся в файле `CustomLabels.ini` (отдельный для каждого [режима редактирования](/ru/edit-modes#labels)). ## Формат файла `<адрес метки>=<имя>` Если в дизассемблируемом файле есть метка по указанному адресу, она получит присвоенное имя. Узнать адрес метки можно, включив отладочную [опцию](/ru/editor/console#code_offsets) `CODE_OFFSETS`. После дизассемблирования число в начале каждой инструкции будет ее адресом. # Enums.txt **Перечисляемый тип** или **перечисление** - это набор констант (называемых *полями перечисления*), имеющих общее имя (*имя перечисления*). Перечисления имеют несколько преимуществ перед обычными константами. Они не засоряют общее пространство имен и являются участниками системы типов. Параметры, у которых перечисление является типом, имеют ограниченную область допустимых значений, что помогает избегать ошибок, связанных с неверным значением параметра. **Enums.txt** - это текстовый файл, который содержит перечисления, доступные для [режима редактирования](/ru/edit-modes). ## Формат файла Каждое перечисление задается следующим образом: `enum <имя перечисления>`\ `<поля перечисления>`\ `end` `имя перечисления` - это любая комбинация букв, цифр и `_` \ `поля перечисления` - одна или несколько строк в формате: `<имя поля> [= <значение поля>]` `имя поля` - любая комбинация букв, цифр и `_` \ `значение поля` - число или строковый литерал, заключенный в двойные кавычки. Если отсутствует, компилятор присваивает [новую константу](/ru/edit-modes/enums.txt#format-faila) автоматически. ``` enum Town LS = 0 SF = 1 LV = 2 end ``` Поля перечисления могут разделяться переносом строки (как в примере выше) или запятой: ``` enum Town LS = 0, SF = 1, LV = 2 end ``` В одном файле может быть несколько перечислений. Каждое из них должно иметь уникальное имя. {% hint style="warning" %} Файл с перечислениями не может содержать комментарии или незнакомый синтаксис. {% endhint %} ### Поля перечисления Каждое поле перечисления представляет собой константу, которая присваивается явно либо неявно. Явным образом это происходит, если после имени поля стоит знак `=` и допустимая константа: ``` enum Town LS = 0 SF = 1 LV = 2 end ``` `Town.LS` представляет число `0`, `Town.SF` представляет число `1` и `Town.LV` представляет число `2`. ``` enum TicTacToe Player1 = "X" Player2 = "O" end ``` `TicTacToe.Player1` представляет строковый литерал `X` и `TicTacToe.Player2` представляет строковый литерал `O`. Если полю перечисления явным образом не присвоена константа, это происходит автоматически. Первому полю присваивается `0`, второму `1`, третьему `2` и т.д.: ``` enum Town LS SF LV end ``` `Town.LS` представляет число `0`, `Town.SF` представляет число `1` и `Town.LV` представляет число `2`. Если в одном перечислении используются и явное, и неявное присвоения, это происходит по следующим правилам: * полю, которое следует за явно присвоенным числом, присваивается это число плюс 1: ``` enum E A = 10 B C = 100 D E end ``` `E.A` = `10`, `E.B` = `11`, `E.C` = `100`, `E.D` = `101`, `E.E` = `102` * полю, которое следует за явно присвоенным строковым литералом, присваивается литерал, дублирующий имя поля: ``` enum Month Jan = "January" Feb = "February" March end ``` `Month.Jan` = `"January"`, `Month.Feb` = `"February"`, `Month.March` = `"March"` {% hint style="warning" %} Перечисление не может одновременно представлять числа и строковые литералы. Тип перечисления определяется по первой явно присвоенной константе: ``` enum Int X, Y // X = 0, Y = 1, end enum String X, Y = "Y" // X = "X", Y = "Y" end ``` {% endhint %} # Расширения **Расширение** - это набор новых инструкций (опкодов), добавленных в игру. [Библиотека CLEO](https://cleo.li) и плагины к ней являются наиболее известным источником таких наборов. Чтобы Sanny Builder знал о намерении использовать в скрипте нестандартные опкоды, скрипт должен иметь [директиву](/ru/coding/directives#usduse) `{$USE}`. Эта директива подключает дополнительный набор инструкций (см. ниже [список доступных расширений](/ru/edit-modes/extensions#extensions-list)): ``` {$USE CLEO} {$USE ini} {$USE CLEO+} ``` Каждый опкод, доступный в [INI файлах](/ru/edit-modes/opcodes-list-scm.ini) Sanny Builder, принадлежит к какому-либо расширению. Это сделано через файл `extensions.txt`. {% hint style="info" %} См. [#74](https://github.com/sannybuilder/dev/issues/74) чтобы узнать о дальнейших планах по развитию расширений. {% endhint %} ### Расширения по умолчанию Стандартные игровые опкоды включены в расширение с именем `default`, которое доступно по умолчанию в каждом скрипте. Использование директивы `{$USE default}` допускается, но является избыточным. Использование [директивы](/ru/coding/directives#usdcleo) `{$CLEO}` также подразумевает `{$USE CLEO}`, что делает стандартные CLEO опкоды доступными компилятору. ### Список расширений Sanny Builder включает в себя общие и популярные расширения для различных режимов редактирования: | Имя расширения | Источник | Режимы, в которых доступно | | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------- | |

CLEO

{$USE CLEO}

|

CLEO для GTA III
CLEO для Vice City

CLEO 4.4

|

GTA III

Vice City

GTA SA v1.0, v2.0, (v1.0 - SCR)

| |

ini

{$USE ini}

|

плагин IniFiles.cleo
(поставляется с CLEO)

|

GTA III
Vice City

GTA SA v1.0, v2.0, (v1.0 - SCR)

| |

file

{$USE file}

|

плагин FileSystemOperations
(поставляется с CLEO)

|

GTA III
Vice City

GTA SA v1.0, v2.0, (v1.0 - SCR)

| |

bitwise

{$USE bitwise}

|

плагин IntOperations
(поставляется с CLEO4)

|

GTA III
Vice City

GTA SA v1.0, v2.0, (v1.0 - SCR)

| |

clipboard

{$USE clipboard}

| плагин ClipboardControl |

GTA III
Vice City

GTA SA v1.0, v2.0, (v1.0 - SCR)

| |

memory

{$USE memory}

| плагин MemoryModule |

GTA III
Vice City

| |

CLEO+

{$USE CLEO+}

| плагин CLEO+ | GTA SA v1.0, v2.0, (v1.0 - SCR) | |

newOpcodes

{$USE newOpcodes}

| плагин newOpcodes | GTA SA v1.0, v2.0 | |

vcmobile

{$USE vcmobile}

| Vice City на мобильных устройствах | Vice City | |

Restoration

{$USE Restoration}

| [Opcode Restoration Project](https://gtamods.com/wiki/Opcodes_Restoration_Project) | Vice City | Допускается использование опкодов из источников, не перечисленных выше, при этом компилятор не будет требовать использование директивы `{$USE}`. # Список опкодов (SCM.INI) {% hint style="success" %} Документацию по опкодам можно найти в [Sanny Builder Library](https://library.sannybuilder.com/). {% endhint %} Основной файл, который обеспечивает компиляцию и дизассемблирование скриптов, – `INI` файл со списком опкодов. В Sanny Builder есть список опкодов для каждого [режима редактирования](/ru/edit-modes#opcodes). {% hint style="info" %} Начиная с версии 4.0 этот файл является необязательным для работы и может быть заменен определениями команд, доступными для скачивания в формате JSON в Sanny Builder Library. Новые режимы редактирования используют только файлы SBL. {% endhint %} | Игра | Имя файла | Директория | | -------------------- | ---------- | --------------- | | GTA III | SCM.INI | data\gta3 | | Vice City | VCSCM.INI | data\vc | | San Andreas | SASCM.INI | data\sa | | Liberty City Stories | LCSSCM.INI | data\lcs | | Vice City Stories | VCSSCM.INI | data\vcs | | VC Mobile | VCSCM.INI | data\vc\_mobile | | SA Mobile | SASCM.INI | data\sa\_mobile | ## Формат файла Строки, начинающиеся с `;`, игнорируются. ### Метаданные Файл может иметь особые параметры, которые содержат метаданные о его текущей версии. `VERSION` – номер версии. См. директиву [$VERSION](/ru/coding/directives#usdversion)\ `PUBLISHER` – автор изменений \ `DATE` – дата обновления\ \ Дизассемблер выводит эту информацию в комментарии на первой строке исходника. ### Опкоды Каждая строка с опкодом имеет следующий формат: `xxxx=N, yyyy` \ `XXXX` – номер опкода\ `N` – кол-во параметров\ `yyyy` – описание опкода Не допускается редактирование первых двух значений (номер опкода и кол-во параметров). Описание опкода может меняться свободно. Если в `INI` файле содержится несколько определений для одного и того же опкода, используется последнее. Существует соглашение, по которому описание условного опкода всегда начинается с двух пробелов. ### Параметры опкодов Параметры - это динамическая часть опкода. В описании опкода они начинаются и заканчиваются `%` ``` 0001=1,wait %1d% ms ``` Данная строка указывает дизассемблеру, что для опкода `0001` следует написать слова `wait` и `ms`, а между ними единственный параметр опкода: ``` 0001: wait 10 ms ``` Определение параметра включает в себя его [порядковый номер](/ru/edit-modes/opcodes-list-scm.ini#poryadok-sledovaniya-parametrov) и [тип](/ru/edit-modes/opcodes-list-scm.ini#tipy-parametrov). #### Порядок следования параметров Число в параметре `%1d%` - его порядковый номер. Он нужен, потому что в некоторых опкодах параметры переставлены местами для улучшения читабельности кода. ``` 0053=5,%5d% = create_player %1o% at %2d% %3d% %4d% ``` Для опкода `0053` дизассемблер поставит 5-й параметр в начале: ``` 0053: $PLAYER_CHAR = сreate_player #NULL at 2488.562 -1666.865 12.8757 ``` Если бы параметры выводились в оригинальном порядке, опкод `0053` выглядел бы так: ``` 0053: сreate_player #NULL at 2488.562 -1666.865 12.8757 $PLAYER_CHAR ``` {% hint style="warning" %} Изменение порядка следования параметров должно быть крайней мерой, т.к. оно приводит к несовместимости старых скриптов с новым INI файлом. {% endhint %} {% hint style="info" %} Порядок следования параметров может различаться от режима к режиму. Смотрите [сравнительную таблицу](/ru/edit-modes#available-modes), чтобы узнать больше. {% endhint %} #### Типы параметров Буква после номера параметра обозначает его тип. `d` - любое значение\ `p` - имя [метки](/ru/coding/data-types#metki)\ `o` - имя [модели](https://app.gitbook.com/s/-M0dALM7uq5_eDYhSBjl-1508421016/coding/data-types.md#imena-modelei) (включая объекты)\ `m` - имя модели из `.ide` файла (исключая объекты)\ `g` - ключ из [`.gxt`](/ru/edit-modes#text) файла\ `x` - ID внешнего скрипта\ `k` - строковый литерал фиксированной длины (128 байтов)
{% hint style="info" %} Типы параметров могут свободно меняться в случае необходимости. {% endhint %} # Шаблоны кода Шаблоны - это заранее подготовленный код, которой вставляется в редактор, после ввода имени шаблона и нажатия `F2`. Вызвать список шаблонов можно комбинацией `Ctrl+J`. Например, напишите`for` и нажмите `F2`. Редактор вставит следующий код: ``` for = to // step 1 end // for ``` ## Типы шаблонов Существует два типа шаблонов: *общие* и *эксклюзивные*. Общие доступны во всех [режимах редактирования](/ru/edit-modes). Они содержатся в файле `data\templates.txt`. Эксклюзивные шаблоны разработаны под конкретный режим. Путь к файлу с эксклюзивными шаблонами задается через ключ [`template`](/ru/edit-modes#templates) в конфигурации режима редактирования: ``` @sb:\data\gta3\templates.txt ``` Редактор объединяет общие и эксклюзивные шаблоны в один список. Эксклюзивный шаблон имеет приоритет над общим шаблоном с такими же именем. ## Синтаксис файла Каждый файл шаблонов имеет следующий синтаксис:\ Имя шаблона пишется отдельной строкой. После имени должен стоять знак `=`. После `=` можно добавить краткое описание шаблона. Поддерживаются только однострочные описания. После строки с именем записывается содержимое шаблона, каждая строка начинается знаком `=`. Место, куда должен быть помещен курсор после вставки, обозначается символом `|`. ## Добавление новых шаблонов Можно сохранить новый шаблон прямо из редактора. Для этого нужно выделить нужный кусок текста и выбрать меню `Сервис->Добавить шаблон`. ![](/files/-MgCs2j-tManhUJwfPwl) Введите имя шаблона, описание (необязательно), выберите тип шаблона и нажмите кнопку `OK`. Новый шаблон будет сразу же готов к использованию. Пользовательские шаблоны сохраняются либо в файл `data\templates.custom.txt` (*общие пользовательские шаблоны*) либо в файл `data\<режим редактирования>\templates.custom.txt`(*эксклюзивные пользовательские шаблоны*). Путь к файлу с эксклюзивными пользовательскими шаблонами может быть изменен в [настройках](/ru/edit-modes#templates) режима редактирования. {% hint style="info" %} Сохранение шаблона только для текущего режима возможно, если файл `modes.xml`содержит тэг `