Changes between Initial Version and Version 1 of ConfigIni_v2

Timestamp:

Dec 29, 2014 12:47:54 PM (10 years ago)

Author:

sagrer

Comment:

--

ConfigIni_v2

@@ +1 @@
+ = Формат файла config.ini (ao_craft_calc_ini) =
+
+Версия №2. '''В разработке.'''
+
+Другие версии:
+ * [wiki:ConfigIni_v1 1].
+
+----
+
+В файле хранится конфигурация программы + имена и идентификаторы реагентов + рецепты из этих реагентов.
+
+Формат представляет из себя *.ini-файл с нестандартными секциями [Reagents], [Recipes], [!RecipesRegs] - содержимое секций читается по строкам, каждая строка соответствует рагенту или рецепту и содержит их характеристики.
+
+Внутри есть секции:
+
+ * [Main]
+ * [Reagents]
+ * [Recipes]
+ * [!RecipesRegs]
+
+----
+
+ == [Main] ==
+
+Внутри есть параметры:
+
+ * !FormatName (string) - имя формата файла. Значение всегда ao_craft_calc_ini.
+ * !FormatVersion (integer) - номер версии формата.
+
+----
+
+ == [Reagents] ==
+
+Нестандартная для обычного ini секция. Внутри список реагентов - по 1 строке на каждый. Строка вида: Parameter1 : Value1; Parameter2 : Value2; ... ; ParameterN : ValueN
+
+Обязательные параметры: 
+ * Name (string) - имя реагента, в юникоде на случай если кириллица или какие-то китайские кравозяблики вдруг, мало ли.
+ * !IcoName (string) - имя файла с иконкой реагента, на случай если однажды будет отображаться в программе. Если содержит none - иконки нету.
+
+Необязательных нет )).
+
+ == [Recipes] ==
+
+Ещё одна нестандартная секция аналогичная предыдущей, содержит рецепты крафта (например рыжий шмот + рыжий улучшитель на капе с 60м уровнем) - по сути это инфа о том какой реагент даёт сколько процентов при крафте. В прочем проценты будут как раз таки ниже в отдельной секции, тут просто общая инфа на рецепт )).
+
+Обязательные параметры:
+ * Name (string) - имя рецепта - нужно для юзверя чтобы понять о чём рецепт и для программы чтобы найти соответствие со строками из !RecipesRegs
+ * !ServerType (string) - тип сервера - по сути тут будет идентификатор типа игры для которой применяется рецепт - чтобы не смешивать рецепты разных сезонов и серверов с разными правилами, мало ли вдруг кто будет считать крафт на какой нибудь пиратке ).
+ * !TargetItem (string) - идентификатор типа шмотки которая улучшается, например нечто обозначающее "любую рыжую шмотку 60 уровня" или "зелёный одноруч 60 уровня" или типа того. В простейшем варианте рассчётов использоваться не будет ибо не нужно но в теории эта инфа может быть полезна для рассчёта крафта в случае если один предмет можно улучшать разными типами улучшителей - тогда в теории опять же можно брать инфу из нескольких рецептов одновременно и учитывать их все исходя из наличия улучшителей у игрока.
+ * !UpgraderItem (string) - аналогичный предыдущему идентификатор но теперь для улучшителя.
+ * !UpgradeCost (integer) стоимость в голде на одну операцию улучшения.
+
+ == [!RecipesRegs] ==
+
+Нестандартная секция (аналогичная предыдущей) для информации о процентах крафта для рецпетов и реагентах. Если бы конфиг был в xml раздел был бы не нужен но у нас тут ini так что пихать один рецепт несколькими строками в одну секцию неоптимально, была бы избыточность инфы.
+
+Обязательные параметры:
+ * !RecipeName (string) - имя рецепта, должно полностью совпадать с именем в секции Recipes.
+ * !RegName (string) - имя реагента, должно полностью совпадать с именем в секции Reagents.
+ * !CraftPrcnt (float) - количество процентов которое даёт один крафт по рецепту с этим реагентом.
+ * !CritPrcnt (float) - шанс на критическое улучшение.
+ * !UpgradeCost (integer) стоимость в голде на одну операцию улучшения. Если -1 - используется базовая стоимость из рецепта.
+
+Вот собсно и всё. Такие дела.