Table of Contents

Основы LSL

resident scripter

Изучите основы LSL (Linden Scripting Language) для создания интерактивных объектов в Каприке.

Введение

LSL (Linden Scripting Language) — это скриптовый язык, используемый для добавления интерактивности объектам в гридах на базе OpenSimulator, таких как Каприка. С помощью LSL вы можете заставлять объекты двигаться, реагировать на касания, воспроизводить звуки, отображать текст и многое другое.

Что можно делать с LSL: * Заставлять объекты двигаться или вращаться * Воспроизводить звуки и музыку * Отображать текст над объектами * Реагировать на взаимодействия пользователей (касание, сидение, чат) * Общаться с другими скриптами * Создавать игры и головоломки * Строить интерактивные системы

Начало работы

Где писать скрипты

Редактор скриптов в мире: 1. Правый клик по объекту 2. Выберите “Edit” → вкладка “Content” 3. Кликните “New Script” 4. Откроется редактор скриптов

Внешние редакторы: * Используйте предпочитаемый текстовый редактор - Копируйте/вставляйте в редактор в мире - Многие вьюверы поддерживают внешнее редактирование

Базовая структура скрипта

Каждый скрипт LSL имеет эту базовую структуру:

```lsl default {

  state_entry()
  {
      // Ваш код здесь
  }

} ```

Компоненты: * default — Основное состояние скрипта * state_entry() — Выполняется при запуске скрипта * {} — Блоки кода * ; — Завершитель оператора

Пример Hello World

Создадим ваш первый скрипт, который говорит “Hello” при касании:

```lsl default {

  state_entry()
  {
      llSay("Hello World!");
  }
  touch_start(integer total_number)
  {
      llSay("You touched me!");
  }

} ```

Что это делает: * Говорит “Hello World!” при запуске скрипта * Говорит “You touched me!” когда кто-то касается объекта

Развертывание скрипта: 1. Вставьте в редактор скриптов 2. Кликните Save 3. Закройте редактор 4. Скрипт скомпилируется и запустится

Переменные и типы данных

LSL поддерживает несколько типов данных:

Общие типы

Тип Описание Пример
——————-——–
integer Целые числа `integer x = 5;`
float Десятичные числа `float y = 3.14;`
string Текст `string name = “John”;`
key UUID (уникальный ID) `key id = llGetKey();`
vector 3D координаты `vector pos = <10,20,30>;`
rotation 3D вращение `rotation rot = <0,0,0,1>;`

Объявление переменных

```lsl integer count = 0; float price = 10.5; string message = “Welcome”; vector position = <0,0,0>; ```

Область видимости

* Глобальные переменные — Вне функций, доступны везде - Локальные переменные — Внутри функций, только в этой функции

Функции

Функции — это блоки кода, выполняющие конкретные задачи.

Встроенные функции

LSL имеет множество встроенных функций (функции ll*):

* `llSay(string msg)` — Говорит текст в локальном чате - `llShout(string msg)` — Кричит текст (слышен на большем расстоянии) - `llWhisper(string msg)` — Шепчет текст (только поблизости) - `llGetPos()` — Возвращает позицию объекта - `llSetPos(vector pos)` — Устанавливает позицию объекта - `llGetKey()` — Возвращает UUID объекта - `llListen(integer channel, string name, string id)` — Слушает команды чата

Кастомные функции

Вы можете создавать свои функции:

```lsl string getGreeting() {

  return "Welcome to Caprica!";

}

default {

  state_entry()
  {
      llSay(getGreeting());
  }

} ```

События

События запускаются конкретными действиями. Функции с префиксом `event_` обрабатывают их.

Общие события

Событие Запускается когда
——-—————
`state_entry()` Скрипт запускается или состояние меняется
`state_exit()` — Скрипт заканчивается или состояние меняется
`touch_start()` — Объект касается чего-то
`touch_end()` - Касание заканчивается
`collision_start()` - Объект сталкивается с чем-то
`collision_end()` — Столкновение заканчивается
`listen(integer channel)` - Чат на прослушиваемом канале
`timer()` - Таймер срабатывает

Параметры событий

События часто предоставляют параметры:

```lsl touch_start(integer total_number) {

  // total_number = количество аватаров, касающихся
  llSay("Touched by " + (string)total_number + " people");

} ```

Условная логика

Используйте операторы if/else для принятия решений.

Оператор If

```lsl integer count = 5;

if (count > 10) {

  llSay("More than 10");

} else if (count == 10) {

  llSay("Exactly 10");

} else {

  llSay("Less than 10");

} ```

Операторы сравнения

Оператор Значение Пример
———-—————–
`==` Равно `if (x == 5)`
`!=` Не равно `if (x != 5)`
`>` Больше чем `if (x > 5)`
`<` Меньше чем `if (x < 5)`
`>=` Больше или равно `if (x >= 5)`
`⇐` Меньше или равно `use if (x ⇐ 5)`

Циклы

Циклы повторяют код несколько раз.

Цикл For

```lsl integer i;

for (i = 0; i < 5; i++) {

  llSay("Count: " + (string)i);

} ```

Это посчитает от 0 до 4.

Цикл While

```lsl integer count = 0;

while (count < 5) {

  llSay("Count: " + (string)count);
  count++;

} ```

Векторы

Векторы представляют 3D координаты (X, Y, Z).

Компоненты вектора

```lsl vector pos = <10, 20, 30>; float x = pos.x; 10 float y = pos.y; 20 float z = pos.z; 30 ``` ==== Операции с векторами === ```lsl vector a = <1, 2, 3>; vector b = <4, 5, 6>; vector c = a + b; <5, 7, 9> vector d = a - b; ←3, -3, -3> ``` ===== Распространённые паттерны LSL ===== ==== Перемещение объектов === ```lsl vector target = <10, 20, 30>; float speed = 1.0; llSetPos(target); llSetTimer(“move_back”, 5.0, FALSE); ``` ==== Воспроизведение звуков === ```lsl string sound = “my_sound”; llPlaySound(sound, 1.0); ``` ==== Отображение текста === ```lsl llSetText(“Hello Caprica!”, <1,1,1>, 1.0); ``` ==== Прослушивание команд === ```lsl integer CHANNEL = 0; default { state_entry() { llListen(CHANNEL, “”, “”, “”); } listen(integer channel, string name, string id, string message) { if (message == “hello”) { llSay(“Hello ” + name + “!”); } } } ``` ===== Отладка ===== ==== llOwnerSay vs llSay === * `llSay` — Все могут видеть - `llOwnerSay` — Только владелец может видеть (используйте для отладки) ==== Добавление отладочных сообщений === ```lsl llOwnerSay(“Script started”); llOwnerSay(“Current state: ” + llGetScriptName()); ``` ===== Лучшие практики ===== ==== Организация === * Используйте комментарии для объяснения кода - Используйте осмысленные имена переменных - Разбивайте сложные задачи на функции - Держите скрипты короткими и сфокусированными ==== Производительность === * Избегайте бесконечных циклов - Используйте таймеры вместо занятых циклов ожидания - Минимизируйте использование listen(), когда не нужно - Очищайте слушатели, когда закончите ==== Безопасность === * Никогда не хардкодите чувствительные данные (пароли, ключи) - Проверяйте разрешения перед разрешением действий - Проверяйте пользовательский ввод - Будьте осторожны с денежными транзакциями ==== Разрешения === Объекты имеют разрешения, влияющие на скрипты: * Modify — Можно редактировать скрипт - Copy — Можно копировать скрипт - Transfer — Можно передавать/продавать скрипт ===== Ресурсы ===== ==== Справочник встроенных функций === Официальная вики LSL имеет полную документацию: * Все функции ll* - Справочник событий - Типы данных - Константы ==== Ресурсы сообщества === * LSL Portal: https://wiki.secondlife.com/wiki/LSL_Portal - LSL Wiki: https://wiki.secondlife.com/wiki/LSL_Wiki - Форумы сообщества для помощи ==== Примеры скриптов === Многие бесплатные скрипты доступны: * LSL Library - Бесплатные скрипты в мире - Репозитории сообщества ===== Следующие шаги ===== Теперь, когда вы понимаете основы LSL: * События LSL — Глубокое погружение в события * Справочник функций LSL — Библиотека функций * Примеры LSL — Практические примеры * Основы строительства — Создавайте объекты для скриптинга Продолжайте экспериментировать и учиться!