Скрипт

Материал из Ганджавики
Перейти к навигации Перейти к поиску

Сцена́рный язык (Скрипт) — высокоуровневый язык программирования для написания сценариев — кратких описаний действий, выполняемых системой. В ганджамире у большинства игроков скрипты являются неотъемлемой частью игры. В связи с этим администрация интегрировала GWPanel в игру.

Сценарный язык — javascript-файл, который можно подключать к браузеру для обработки определенных страниц. Основная цель, с которой их внедряют в игру — косметические или функциональные доработки. Одни скрипты просто видоизменяют странички так, как многим игрокам хотелось бы, а другие — добавляют довольно серьезный функционал, которого нам так не хватает. В любом случае — скрипты делают процесс игры более комфортным.

Всё что требуется для использования скриптов в игре — добавить в браузер пользовательский скрипт GanjaScripts.user.js. После этого вы можете выбрать, подключить и/или настроить любой скрипт из каталога без скачивания дополнительных файлов.

Преимущества применения
  • Не надо скачивать кучу разных файлов скриптов. Достаточно скачать только один скрипт — все остальные настройки по подключению скриптов предоставлены на сайте сервиса.
  • Для настройки скриптов не надо лезть в код скрипта. Вся настройка осуществляется на сайте.
  • Гарантия безопасности использования. Все поступающие скрипты становятся доступными для подключения только после проверки модераторами скриптов.
  • Привязка подключения скриптов и их настроек к персонажу в ГВ (используется кросс-серверная авторизация, привязанная к залогиненному у вас персонажу).
  • Один источник скриптов от разных авторов.
  • Более функциональные скрипты благодаря библиотеке функций, которые предоставляются разработчикам.
  • Единые стандарты оформления упростят подбор нужного вам скрипта.

Разработчикам

Если вы имеете опыт и желаете внести свою лепту, вам необходимо ознакомиться с информацией для разработчиков.

Преимущества

Есть ряд плюсов для разработчиков:

  • Единый разрекламированный ресурс для размещения своих творений — отпадает необходимость в оплате хостинга для сайта, выкладывании скриптов в фотоальбомах, информации персонажа.
  • Библиотека функций и регулярных выражений для работы с ГВ, которая сэкономит время написания и усилия.
  • Предоставление интерфейса для отправки сообщений в ICQ из скриптов
  • Лёгкое создание странички настройки скрипта.
  • Статистика количества пользователей ваших скриптов. (в стадии разработки)
  • Рейтинги скриптов и авторов (в стадии разработки)

Особенности JS кода

Основные отличия в оформлении скриптов для GanjaScripts от обычных пользовательских скриптов:

  • Весь скрипт должен быть оформлен внутри одной функции, которая будет точкой входа.
  • При сохранении скрипта используйте кодировку ANSI, а не UTF-8
  • В функцию-точку входа может передаваться один параметр с настройками скрипта. Но об этом ниже.
  • Не добавляйте проверку адреса странички. Если на странице, которую открыл пользователь ваш скрипт не должен работать — он не будет запрошен.

Правила для скриптов

Чтобы гарантировать игрокам безопасность, перед добавлением в каталог все скрипты проверяются модераторами скриптов. Для безболезненной проверки и гарантированного добавления скрипта, он должен соблюдать такие правила:

  • Скрипт не должен нарушать текущие Правила игры, в особенности пункт касающийся использования автоматических скриптов. Если вы не уверены — проконсультируйтесь с представителями синдиката  #1321 GW - Полиция.
  • Скрипт не должен вредить его пользователям (продавать вещи,выполнять рассылку писем, переводить деньги и другое без подтверждения пользователя).
  • С целью обезопасить пользователей от вредоносного кода старайтесь минимально использовать подключение скриптов или других данных со сторонних сайтов. Если есть необходимость — пишите Bick и картинки/широко используемые js библиотеки будут размещены на сайте GanjaWiki (их список внизу этой страницы).
  • Описания, названия скриптов не должны содержать нецензурные выражения.
  • Скрипт не должен передавать информацию о пользователе на сторонние ресурсы без упоминания об этом в описании скрипта.
  • Передавать на сторонние ресурсы или сторонним лицам закрытой информации пользователей строго запрещена и наказуема.