Erinome Godville UI+: различия между версиями

Материал из Энциклобогии
Перейти к навигации Перейти к поиску
Строка 18: Строка 18:
''Текст уведомления'' '''|''' ''набор условий'' '''|''' ''тип информера и уведомлений''
''Текст уведомления'' '''|''' ''набор условий'' '''|''' ''тип информера и уведомлений''


Информер можно временно отключить, закомментировав его символом '''#''' в начале строки
Информер можно временно отключить, убрав галочку в начале строки.
 
Начиная с версии 1.1.17.4 в тексте уведомлений можно использовать одиночные переменные. Они указываются отдельными словами, либо в фигурных скобках - {gv.variable}. При изменении значений этих переменных тексты информеров будут соответственным образом обновлены. Для информеров с переменными в названиях существует отдельный тип работы уведомления - возобновляемое.


Несколько условий объединяются логическими операторами '''&&''' (логическое «И»), '''||''' (логическое «ИЛИ») и группируются скобками. Доступно логическое отрицание «НЕ» '''!'''true = false
Несколько условий объединяются логическими операторами '''&&''' (логическое «И»), '''||''' (логическое «ИЛИ») и группируются скобками. Доступно логическое отрицание «НЕ» '''!'''true = false
Строка 48: Строка 50:
|}
|}


Тип информера кодируется определённым числом, определяемым как сумма указанных в таблице модификаторов.
Начиная с версии 1.1.17.4 тип информера кодируется комбинацией букв, соответствующих указанным в таблице модификаторам.
Из соображений обратной совместимости старый тип кодирования суммированием по-прежнему работает.


{| class="standard"  
{| class="standard"  
|-
|-
!Код || Название || Описание
!Буква || Код || Название || Описание
|-
|style="text-align: center;" | <никакая> ||style="text-align: center;" | 0 || style="text-align: center;" | стандартный информер || включается, когда условие активации информера выполняется, выключается - когда условие активации информера перестает выполняться
|-
|style="text-align: center;" | S ||style="text-align: center;" | 1 || style="text-align: center;" | неотключаемый информер || включается при выполнении условия активации информера, выключается - только когда пользователь кликнет на этот информер (или после перезагрузки страницы, когда условие перестает выполняться)
|-
|-
|style="text-align: center;" | 0 || style="text-align: center;" | стандартный информер || включается, когда условие активации информера выполняется, выключается - когда условие активации информера перестает выполняться
|style="text-align: center;" | L||style="text-align: center;" | 16 || тип: стандартное уведомление || мигание заголовком окна браузера и соответствующей вкладки, добавляет метку в углу страницы
|-
|-
|style="text-align: center;" | 1 || style="text-align: center;" | неотключаемый информер || включается при выполнении условия активации информера, выключается - только когда пользователь кликнет на этот информер (или после перезагрузки страницы, когда условие перестает выполняться)
|style="text-align: center;" | D ||style="text-align: center;" | 32 || тип: всплывающее уведомление || отображается всплывающим окошком поверх всех окон
|-
|-
|style="text-align: center;" | 16 || тип: стандартное уведомление || мигание заголовком окна браузера и соответствующей вкладки, добавляет метку в углу страницы
|style="text-align: center;" | A ||style="text-align: center;" | 64 || тип: звуковое уведомление || звуковое оповещение согласно настройкам eGUI+
|-
|-
|style="text-align: center;" | 32 || тип: всплывающее уведомление || отображается всплывающим окошком поверх всех окон
|style="text-align: center;" | R ||style="text-align: center;" | 128 || тип: повторяющееся звуковое уведомление || звуковое оповещение, которое будет повторяться каждые несколько секунд (обратите внимание, что если тип "L" не включен, то данный тип будет работать как тип "A")
|-
|-
|style="text-align: center;" | 64 || тип: звуковое уведомление || звуковое оповещение согласно настройкам eGUI+
|style="text-align: center;" | Q ||style="text-align: center;" | - || тип: возобновимое уведомление || имеет смысл только для информеров, имеющих в своем названии переменные; если информер был выключен пользователем (или не имел тип "L" и был отключен автоматически), а затем его текст изменился, то информер будет автоматически включен обратно
|}
|}
Например, чтобы создать неотключаемый информер, уведомляющий миганием и всплывающим окном, необходимо указать тип: 49 (1+16+32).
Например, чтобы создать неотключаемый информер, уведомляющий миганием и всплывающим окном, необходимо указать тип: SLD (или, если вам нравится складывать числа, то 49 (1+16+32)).


Если модификаторы типа уведомления не указаны, то информер будет использовать набор уведомлений, выбранный для всех пользовательских информеров в общей таблице настроек информеров.
Если модификаторы типа уведомления не указаны, то информер будет использовать набор уведомлений, выбранный для всех пользовательских информеров в общей таблице настроек информеров.
Строка 74: Строка 81:
{| class="standard collapsible collapsed"  
{| class="standard collapsible collapsed"  
|-
|-
!colspan="3" align="left" |Полный перечень переменных версии 1.1.15.0
!colspan="3" align="left" |Полный перечень переменных версии 1.1.17.4
|-
|-
!Переменная || Описание  
!Переменная || Описание  
Строка 174: Строка 181:
|gv.godpower || количество праны  
|gv.godpower || количество праны  
|-
|-
|gv.godpowerMax || максимальное количество праны (может ошибаться у лавковладельцев)
|gv.godpowerMax || максимальное количество праны
|-
|-
|gv.godpowerPrc || количество праны в процентах  
|gv.godpowerPrc || количество праны в процентах  
Строка 193: Строка 200:
|-
|-
|gv.currentMonster || название монстра, если герой бьется с ним в поле, иначе - пустая строка  
|gv.currentMonster || название монстра, если герой бьется с ним в поле, иначе - пустая строка  
|-
|gv.chosenMonster || идет бой с монстром из настроенного списка избранных
|-
|gv.specialMonster || идет бой со спец-монстром из настроенного списка префиксов
|-
|gv.tamableMonster || идет бой с монстром, которого можно приручить (только если у героя нет питомца)
|-
|gv.wantedMonster || идет бой с монстром дня
|-
|gv.petKnockedOut || питомец героя контужен
|-
|-
|gv.lastNews || текст строки из Вестей  
|gv.lastNews || текст строки из Вестей  
Строка 208: Строка 225:
|gv.isGoingBack || герой идет из поля в город  
|gv.isGoingBack || герой идет из поля в город  
|-
|-
|gv.isGoingForth || герой идет из города в поле (экспериментально, может ошибаться!)  
|gv.isGoingForth || герой идет из города в поле (экспериментально, может ошибаться!)
|-
|gv.isGoingGodville || герой идет из поля в столицу (экспериментально, может ошибаться, точно не работает на ближайших к Годвиллю городах)
|-
|-
|gv.isTrading || герой продает трофеи (экспериментально, может ошибаться!)  
|gv.isTrading || герой продает трофеи (экспериментально, может ошибаться!)  
|-
|gv.isFishing || герой рыбачит (экспериментально, может очень ошибаться!);
|-
|-
|gv.dailyForecast || текст астропрогноза  
|gv.dailyForecast || текст астропрогноза  
Строка 233: Строка 254:
|-
|-
|gv.inBossFight || герой находится в бою с босс-монстром (любым) или корованом  
|gv.inBossFight || герой находится в бою с босс-монстром (любым) или корованом  
|-
|gv.inShop || герой-торговец работает в своей лавке
|-
|-
|gv.inTown || герой находится в городе  
|gv.inTown || герой находится в городе  
Строка 280: Строка 303:
|-
|-
|gv.alliesAliveCount || количество живых союзников  
|gv.alliesAliveCount || количество живых союзников  
|-
|gv.lowHealth || низкий уровень здоровья в боевых режимах
|-
|-
|gv.expTimeout || количество минут до окончания штрафа возложения золота в храме (или 10080, если данных нет)  
|gv.expTimeout || количество минут до окончания штрафа возложения золота в храме (или 10080, если данных нет)  

Версия от 06:34, 25 марта 2018


Erinome Godville UI+ — расширение для браузеров, изначально основанное на Godville UI+, но получившее уже заметное количество отличий и дополнительных возможностей от оригинала.

Тема на форуме в квартале мастеровых: Erinome Godville UI+ - браузерное расширение для Годвилля (Firefox, Chrome, Opera).

_

Информеры

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

Пользовательские информеры

Пользовательские информеры позволяют настроить уведомления на произвольный набор событий в игре.

Каждый информер описывается одной строкой в формате:

Текст уведомления | набор условий | тип информера и уведомлений

Информер можно временно отключить, убрав галочку в начале строки.

Начиная с версии 1.1.17.4 в тексте уведомлений можно использовать одиночные переменные. Они указываются отдельными словами, либо в фигурных скобках - {gv.variable}. При изменении значений этих переменных тексты информеров будут соответственным образом обновлены. Для информеров с переменными в названиях существует отдельный тип работы уведомления - возобновляемое.

Несколько условий объединяются логическими операторами && (логическое «И»), || (логическое «ИЛИ») и группируются скобками. Доступно логическое отрицание «НЕ» !true = false

Также имеются другие операторы:

Операторы Описание Примеры
==, !=
<, <=
>, >=
равенство и неравенство
меньше и меньше или равно
больше и больше или равно
100 == 100 →‎ истина
"строка" != "другая строка" →‎ истина
100 > 200 →‎ ложь
~, ~* регистрозависимое и регистронезависимое регулярное выражение,
возвращает результат в виде массива
"здесь есть число 4 и буква Ё" ~ "число 4" →‎ ["число 4"]
"здесь есть число 4 и буква Ё" ~ "число (.*?) и" →‎ ["число 4 и", "4"]
A[x] извлечение элемента номер x из массива A (отсчет x ведется с нуля) ("здесь есть число 4 и буква Ё" ~ "число (.*?) и")[1] →‎ "4"
("здесь есть число 4 и буква Ё" ~ "число (.*?) и")[5] →‎ undefined
+, -
*, /
сложение и вычитание
умножение и деление
100 + 200 →‎ 300
50 * "строка" →‎ NaN
+, -
!
преобразование строки к числу, изменение знака
логическое отрицание
+"50" →‎ 50
!"строка" →‎ ложь

Набор условий считается выполненным и активирует информер, когда итоговый результат преобразуем к истине:

Результат Примеры Описание
ложь 0, "", []
false, null
undefined, NaN
ноль (как цифра), пустая строка и пустой массив
специальные значения, которые могут принимать переменные
и могут получиться в результате применения операторов
истина - истиной считается всё, что не попадает под ложь :)

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

Буква Код Название Описание
<никакая> 0 стандартный информер включается, когда условие активации информера выполняется, выключается - когда условие активации информера перестает выполняться
S 1 неотключаемый информер включается при выполнении условия активации информера, выключается - только когда пользователь кликнет на этот информер (или после перезагрузки страницы, когда условие перестает выполняться)
L 16 тип: стандартное уведомление мигание заголовком окна браузера и соответствующей вкладки, добавляет метку в углу страницы
D 32 тип: всплывающее уведомление отображается всплывающим окошком поверх всех окон
A 64 тип: звуковое уведомление звуковое оповещение согласно настройкам eGUI+
R 128 тип: повторяющееся звуковое уведомление звуковое оповещение, которое будет повторяться каждые несколько секунд (обратите внимание, что если тип "L" не включен, то данный тип будет работать как тип "A")
Q - тип: возобновимое уведомление имеет смысл только для информеров, имеющих в своем названии переменные; если информер был выключен пользователем (или не имел тип "L" и был отключен автоматически), а затем его текст изменился, то информер будет автоматически включен обратно

Например, чтобы создать неотключаемый информер, уведомляющий миганием и всплывающим окном, необходимо указать тип: SLD (или, если вам нравится складывать числа, то 49 (1+16+32)).

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

Переменные

Полный и актуальный перечень доступных переменных находится в файле FAQ на странице дополнения.

Примечание: с апреля 2016 года разработчиками игры было запрещено использовать в аддонах точные внутриигровые данные, поэтому начиная с версии 1.1.1.0 вся информация для переменных берется из общедоступных внешних источников, а некоторые значения, которые более недоступны в точном виде, теперь рассчитываются косвенно - следовательно, возможны разнообразные ошибки.

Готовые примеры


  1. «Кстати, помните активируемые былиноделы, сундуки со сказками и прочие довольно бесполезные куплетописи? Теперь при активации в городе эти трофеи заодно усиливают там влияние гильдии — совершенно задаром». «Богучёт», пост в блоге от 12.05.2017