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” при касании:
```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 для принятия решений.
```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)` |
Циклы повторяют код несколько раз.
```lsl integer i;
for (i = 0; i < 5; i++) {
llSay("Count: " + (string)i);
} ```
Это посчитает от 0 до 4.
```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 — Практические примеры * Основы строительства — Создавайте объекты для скриптинга Продолжайте экспериментировать и учиться!