Создаём Уникальные Вещи своими руками

[Yegor]

supernewbie, Ага мануал. Это аналогично чтению книги в которой каждый новый абзац идет на другой странице и не по порядку.

[EmL]

Сообщение от Yegor

EmL, большое спасибо. Нормальных мануалов по настройке Java серверов почти нет. Приходится все познавать методом проб, ошибок и изучением исходников..

Незачто,спасибо за спасибку ^^,

[supernewbie]

Сообщение от Yegor

supernewbie, Ага мануал. Это аналогично чтению книги в которой каждый новый абзац идет на другой странице и не по порядку.

там 2 страницы епт, DocumentSkill.java и DocumentBase.java

[Yegor]

В Delphi ты тоже по его исходникам разбираешься? Мне например проще загуглить интересующий вопрос. Не люблю "изобретать велосипеды".

[supernewbie]

когда как, иногда лучше смотреть сорцы чем гуглить

[J-Fobos]

Перенес в курилку, к другим разделам эта тема никак не подходит.

Если тема кому-то интересна, то вот моя очень старая статья.


Оффтоп

===================================
Для написания статьи использовалась википедия, форумы разработчиков сборок emu и base, а также пара статьей с портала вампиров. Авторские права использованных материалов принадлежат исключительно авторам этих материалов.
При копировании статьи прошу не удалять этот текст. (c) j-Fobos
===================================


1. Введение
Что же такое XML?
Это текстовый формат, предназначенный для хранения структурированных данных, для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями. Первая строка XML-документа называется объявлением XML — это необязательная строка, указывающая версию стандарта XML (обычно это 1.0), также здесь может быть указана кодировка символов и внешние зависимости.

<?xml version="1.0" encoding="UTF-8"?>

Спецификация требует, чтобы процессоры XML обязательно поддерживали Юникод-кодировки UTF-8 и UTF-16. Но признаются допустимыми, поддерживаются и широко используются и другие кодировки. Так же в XML есть возможность добавления комментария. Комментарий может быть размещен в любом месте дерева. XML комментарии размещаются внутри пары тегов <!-- и -->. Два знака дефис (--) не могут быть применены ни в какой части внутр. комментария. Вот пример комментария:

<!-- Текст коментария -->

Не будем углубляться во все особенности XML, нас интересует только часть, которая касается Lineage 2.
XML в сервере Lineage применяется для описания статов оружия, брони, скилов, аргументов, зон, магазинов, зон рестарта чаров и много другого. Для оружия это например параметры физ. и маг. атаки, для брони - защиты, для скилов - продолжительность действия, сила, эффект и т.д. А например в файле "servername.xml" хранятся имена серверов по умолчанию. Эти имена когут быть легко изменены. Но помимо изменений на серверной части необходимы и изменения со стороны клиента (со стороны клиента необходимо изменить файл "servername-e.dat". Изменяться *.dat файлы клиента могут с помощью специальных программ. В XML файлах зон хранятся параметры этих зон. Есть и XML файлы где к определенному предмету приписывается определенный скил(например ошейнику волка привязывается скилы вызова волка).


2. Основы.
Что нужно знать как основу для редактирования?

1) XML файлы по умолчанию хранятся в папках gameserver\data\ и открываются любым текстовым редактором что работыет с UTF кодировками.

2) Имена *.xml файлов даются по диапазону id статов, Например в файле с именем 0800-0899.xml будут статы от id=800 до id=899. Для быстродействия желательно (но не обязательно) в одном файле хранить не больше ста id. Надо сказать что в названиях могут быть исключения, файлы могут называться и без указания диапазона id которые в нем хранятся. Такое характерно для аргументов и зон и файла с итемами петов.

3) При использовании текста рекомендовано (но не обезательно) использовать латинские символы.

4) Параметр ID должен быть в диапазоне от 1 до 2ккк

3. Редактирование статов и скилов.
В папке stats можно найти несколько папок которые отвечают за параметры брони, оружия, аргументов, скилов и некоторых других предметов (например банок для востоновления хп/цп/мп или свитков с бафовами).

Формат записи одного стата следующий:

<item id='числовой_идентификатор' name="Название стата">
<for>
<add val='значение' order="приоритет" stat='название стата'/>
<mul val='значение' order="приоритет" stat='название стата'/>
<sub val='значение' order="приоритет" stat='название стата'/>
<enchant val='значение' order="приоритет" stat='название стата'/>
<set val='значение' order="приоритет" stat='название стата'/>
</for>

Все изменения в стате должны находится между тегами <for></for>

Теперь рассмотрим главные операции со статами.
<add /> - добавление статов. Стат увеличится на указаную величину.
<mul /> - умножение статов. То есть если вы оденете вещь или используете скил, ваши статы умножатся. Например если
<sub /> - вычетание. То есть если вы оденете вещь(или заюзатете скил), ваши статы (или статы цели) уменьшатся.
<enchant /> - увеличение/снижение при заточке. Роказывает, на сколько увеличится/уменшится стат при заточке еще на +1
<set /> - задание строгого значения. То есть если вы оденете вещь со значением 20, то тот стат, но который это значение влияет будет равен 20. Со скилами также.

Главными параметрами этих операций являются:
val="" - значение
order="" - приоритет в формуле (подробно о приоритетах писать в этой статье не буду, это отдельная и сложна тема)
stat="" - что собственно изменять

Значения order могут быть следущие:
0x08 - set
0x10 - add/sub (оружие, броня, бижутерия) и (STR, CON, DEX, INT, WIT ,MEN)
0x20 - не используется (опционально)
0x30 - mul/div (masteries, buffs, debuffs, SA (специальные возможности оружия), бонусы брони)
0x40 - add/sub (masteries, buffs, debuffs, SA (специальные возможности оружия))
0x50,0x60 - не используется (опционально)
0x0C - enchant

Списки статов доступных для изминения:
Этот список в разных сборках разный, но в большинстве случаев принято использовать следующие названия.

Изменение максимального количества HP - maxHp
Изменение максимального количества CP - maxCp
Изменение максимального количества MP - maxMp
Регенерация НР - regHp
Регенерация СР - regCp
Регенерация МР - regMp
Эффективность хила - gainHp
Умение хила - giveHp
Бонус хила - bonusHp
Физическая защита - pDef
Магическая защита - mDef
Физическая атака - pAtk
Магическая атака - mAtk
Скорость физической атаки - pAtkSpd
Скорость магической атаки - mAtkSpd
Скорость отката - mReuse
Защита щитом- sDef
Угол защиты щитом - shieldDefAngle
Критический удар - cAtk
Прибавка к критическому удару - cAtkAdd
Физ. урон в пвп (например для Duel Might) - pvpPhysDmg
Маг. урон - pvpMagicalDmg
Урон скилом - pvpPhysSkillsDmg
Уворот - rEvas
Уворот от скилов- pSkillEvas
Шанс блокировки щитом - rShld
Шанс крита - rCrit
Шанс Blow - blowRate
Шанс Lethal - lethalRate
Маг. крит. шанс - mCritRate (mCrit doesn't work!!)
EXP,SP шанс - rExp
Cancel - cancel
Точность - accCombat
Зона покрытия физ. атаки - pAtkRange (for fighters)
Зона покрытия маг. атаки- mAtkRange (for mages)
Угол атаки (только для воинов) - pAtkAngle
Количество атакуемых - atkCountMax
Откат физ. скилов - atkReuse
Скорость бега - runSpd
Скорость ходьбы - walkSpd
STR - STR
DEX - DEX
WIT - WIT
INT - INT
MEN - MEN

Уязвимости

Агрессия - aggressionVuln
Кровотечение - bleedVuln
Яд - poisonVuln
Стан - stunVuln
Парализация - paralyzeVuln
Удерживающие заклинания - rootVuln
Сон - sleepVuln
"Перекидывание" таргета -confusionVuln
Движение - movementVuln
Огонь - fireVuln
Ветер - windVuln
Вода - waterVuln
Земля - earthVuln
Святые атаки - holyVuln
Темные атаки - darkVuln
Резист к cancel - cancelVuln
Дебаффы - debuffVuln
Резист к криту - critVuln

Резисты простив оружия (тут думаю описание не нужно)

noneWpnVuln
swordWpnVuln
bluntWpnVuln
daggerWpnVuln
bowWpnVuln
crossbowWpnVuln
poleWpnVuln
etcWpnVuln
fistWpnVuln
dualWpnVuln
dualFistWpnVuln
bigSwordWpnVuln

Отражение

Процент отражаемого урона - reflectDam (pay attention! not reflectDmg!! reflectDam)
Процент рассеиваемого урона - absorbDam
Процент переносимого урона- transDam
Отражение маг. скилов - reflectSkillMagic
Отражение физ. скилов - reflectSkillPhysic

Другое (для примера):

Атака на гигантов - pAtk-giants
Защита на нежить - pDef-undead
Атака на животных - pAtk-animals
Защита на монстрах - pDef-monsters
Лимит инвентаря - inventoryLimit
Лимит ВХ - whLimit
Freight лимит - FreightLimit
Лимит продажи. - PrivateSellLimit
Лимит покупки - PrivateBuyLimit
Лимит гномьего крафта - DwarfRecipeLimit
Лимит common крафта - CommonRecipeLimit
Потребление МР физ. скилами - PhysicalMpConsumeRate
Потребление МР маг. скилами - MagicalMpConsumeRate
Потребление МР дансами - DanceMpConsumeRate
Потребление НР - HpConsumeRate
Потребление МР - MpConsume
Потребление соулшотов - soulShotCount
Skill Мastery - skillMastery
Время пребывания под водой - breath

[J-Fobos]

Оффтоп

Дополнения для редактирования статов скилов

Важно знать что любой скилл начинается с открывающего тега и заканчивается закрывающим тегом. В скилах есть 3 обязательных тега, без которых он не будет работать - это target, skilltype и operatetype.

1. target - тег, который показывает на кого будет браться таргет, что видно из названия. Принимает следующие значения:

TARGET_SELF - обозначает, что скилл будет использоватся исключительно на его владельца (селф бафф типа Battle Roar или War Cry)
TARGET_NONE - цель неопределена
TARGET_ONE - обозначает, что цель вашего скилла - тот кто в таргете.
TARGET_AREA - обозначает, что скилл будет массовым
TARGET_AGGREMENT - обозначает, что целью будет тот, кто вас атакует

2. skilltype - тег, указывающий на тип скилла (бафф, дебафф)
Принимает следующие значения:
BUFF - бафф (оказывает положительное воздействие)
DEBUFF - дебафф (оказывает негативное воздействие)

3. operatetype - этот тег служит для определения типа скилла (активный либо пассивный)
OP_ACTIVE - активный скилл, может быть использован игроком
OP_PASSIVE - пассивный скилл, скилл с таким operateType не может быть использован (действует всегда)

Это были обязательные переменные, используемые в скилах. Теперь перейдем к остальным:
-power - сила скилла
-hitTime - скорость. Для баффа это скорость чтения заклинания, для физ. скилла - скорость атаки
-reuseDelay - откат скилла
-hpconsume , mpconsume - потребление МР, НР
-castRange - это дальность использования того или иного скилла (дистанция)
-isMagic, isDebuff, isBuff - это наводящие теги, могут иметь значение "true" и "false". К примеру, isBuff = true (это значит что скилл является баффом)
-effectRange - радиус действия (для массовых скиллов)
-agro - что такое агр, и что такое сила агра думаю объяснять не нужно.

Надо сказать что в зависимости от сборки могут использоваться и другие теги, но так как этот мануал общий для всех сборок их приводить не будем.

Тег effect в скиллах Lineage 2 встречается очень часто. Обычно тег используется для "добавления сложных действий" к скиллу. Если скилл имеет сложный вариант реализации то обычно в тег добавляют некоторые отдельные значения, которые реализованы в ядре сервера Lineage. Это самый важный тег для использования в скилах. Приведем пример использования тега :

<for>
<effect name="тип" val="значение" time="время действия" stackOrder="переменная" stackType="переменная ядра">
</effect>
</for>
</skill>

Что это значит?
name - это тип эффекта
val - значение эффекта. Для дебаффов - шанс прохождения, для боевых скилов - сила.
time - время действия эффекта
StackOrder и stackType - это значения уже описаные в данном скиле и заданы в ядре сервера и в разных сборках могут называться по разному (или даже отсутствовать).


4. Зоны
Довольно важным в игровом мире есть понятие зон. Например в городах мирные зоны в которых запрещены атаки других игроков (и иногда нпц). Или зоны арен где не насчитывается пвп/пк счетчик. Зоны, также как и статы/скилы принято задавать в xml файлах.
Рассмотрим структуру описания зоны:

<zone id="ID зоны" name="Имя зоны" type="Тип зоны">
<settings exitOnDeath="true" buffRepeat="true" affected="single" />
<skill applyEnter="ID эффекта, уровень эффекта" removeExit="ID эффекта" />
<shape type="Форма зоны" zMin="Минимум Z" zMax="максимум Z">
<point x="координата" y="координата"/>
<point x="координата" y="координата"/>
</shape>
</zone>

Параметры что используются при создании заны:
id - идентификатор зоны.
type - тип зоны (town, arena, jailzone, Boss). Например: Town - мирная зона (город), Arena - боевая зона (PVP). Также могут быть другие типы зон которые описаны в ядре сервера.
shape type - это форма или вид зоны. Может быть двух типов: Poly(многоугольные зоны) и Rect(прямоугольные зоны). В разных сборках названия типов могут отличатся (напрмиер nPoly и Cupoid). Также в некоторых сборках может использоваться и тип Circle (круг), для задания этого типа указываются координаты центра и радиус.
minZ - это минимально допустимая координата высоты (z) в данной зоне .
maxZ - это максимально допустимая координата высоты (z) в зоне.
minZ и maxZ используются для избежания прохождения через текстуры, провалов под них и т.д.
name - зоне можно задать любое имя, но только из допустимых символов, используется для удобства работы с большим количеством зон
point - задает координаты границ зоны.

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

Так же внутри тегов можно использовать описание точек "респавна" чара в них. При указании нескольких точек "респавна" чар будет появляться в них рандомно.

<stat name="spawnX" val="X координата"/>
<stat name="spawnY" val="Y координата"/>
<stat name="spawnZ" val="Z координата"/>

5. Магазины
В линейдж есть особенный тип магазинов под названием multisell, изначально он был задуман для обмена вещей на вещи (впервые использоваться у рыбаков). В наше время этот магазин широко используется в на пвп серверах для создания ГМ шопов, хотя этом круг его использования не ограничивается.
Названия XML файлов для магазинов такие как ID этих магазинов (но тут также есть небольшие исключения, есть магазины где название и id разные). Формат данных в магазине следующий:

<item id="номер по возрастанию">
  <production id="id предмета" count="количество"/>
  <ingredient id="id предмета" count="5количество"/>
</item>

item id - номер предмета в ячейка магазина, используется для задания порядка отображения предметов в магазине. Обратите внимание что этот номер НЕ должен повтояться и для каждого предмета должен быть уникален в рамках одного магазина.
production - предмет который покупается в магазине. в этом теге указывается id предмета и его количество.
ingredient - предмет за который можно купить production в магазине. в этом теге указывается id предмета и его количество. В большинстве случаев используют адену, древнюю адену или колы, но предметом для покупки может быть любая вещь.

Надо знать что в одном теге item может быть несколько тегов ingredient, это будет значить что при покупку production вам надо будет несколько указанных предметов. Напримиер при покупке заточек у мамона надо иметь древнюю адену и чистые скролы. Использование нескольких production также возможно, но крайне не рекомендовано создателями сборок.
Также можно указывать дополнительные параметры покупки, например часто используется параметр enchant, который позволит покупать уже заточенную вещь. Например <production id="7575" count="1" enchant="10"/> - будет куплен драк лук +10. Еще довольно интересно: при задании параметра enchant у ошейников для вызова питомцев питомец будет уже прокачан до указанного в параметре enchant уровня. Кроме enchant можно использовать и параметры для камней стихий и т.п.


6. Заключение
В заключении хотелось бы первым делом извинится перед людьми, чьи материалы были использованы при написании этой статьи, за не указание их ников. Материалов было много и просто запутался с какого ресурса какой был взят.
Также следует сказать что в сборках серверов XML файлы используются очень широко не только в описанных выше случаях. Например dimensionalRift.xml описывает параметры рифта, а recipes.xml параметры изучения и использования рецептов, также есть summon_items.xml в котором хранятся параметры ошейников для петов. Круг использования XML довольно широк и в рамках этой статьи описан не полностью.
Существует много споров на тему стоит ли использовать xml или же все таки стоит в полную использовать базы данных. Это связано с тем что размер XML-документа существенно больше бинарного представления тех же параметров в базе данных, что влияет на большую потребность в ресурсах и увеличении времени обработки информации. Хотя не смотря на это полностью отказывается от XML разработчики серверов не собираются в связи с универсальностью этого формата.

[supernewbie]

это под какую сборку всё?

[J-Fobos]

Сообщение от supernewbie

это под какую сборку всё?

Под большинство сборок сойдет.

[Yegor]

Раз уже зашел вопрос о сборках. Кто то в курсе вообще откуда они первоначально появились? Да сейчас есть команды разработчиков которые перерабатывают сборки под новые хроники и на этом неплохо зарабатывают, но они обычно берут за основу сборки от предыдущих хроник. А откуда взялись самые первые? Например изучив исходники сборки феникс я увидел что изначальный код был написан очень профессионально с комментариями на английском языке и программа имеет колоссальную сложность. Для новых хроник видно как поверх сделаны фиксы, уже с комментариями на русском. Фиксы часто с ошибками, с избыточностью, иногда без дополнительных проверок с несоблюдением придерживания одного стиля форматирования текста кода и.т.п.