CFG File Documentation/ru

From Kerbal Space Program Wiki
< CFG File Documentation
Revision as of 22:01, 26 October 2013 by CrazyCo (talk | contribs) (Правила привязки)
Jump to: navigation, search
Большая часть описанного на этой странице уже устарела, либо изначально неправильно, так что теперь размещенные на здесь данные могут ввести Вас в заблуждение.



:В этом руководстве будет разобран состав файла конфигурации отдельной детали посредством создания файла фиктивной детали, которая будет вести себя так же, как и настоящая, только для ее полного функционирования не будет хватать моделей, звуков и текстур.

Руководство по созданию деталей. Основы.


Убедитесь, что модель сама по себе не сломает игру при загрузке. Для этого:

  • Для файла детали должен существовать файл «.dae»;
  • Все -- даже пересечения сетка -- сетка - существенны;
  • Детали должны быть проименнованы корректно; например, пересечение сетки всегда должно называться «node_collider».
    == Создание файла детали. ==


Создайте пустой файл в «Блокноте», который станет файлом «.cfg», в каталоге Вашего дополнения -- обычно «../KerbalSpaceProgramDirectory/Parts/ВашеДополнение».

Этот пустой файл станет файлом «.cfg».


=== Последовательность данных, содержащихся в конфигурационном файле. ===


// Title (заголовок)

// Name of your part (название Вашей детали)

//



// --- general parameters --- (основные параметры)



// --- asset parameters --- (устанавливаемые параметры 3D-модели)



// --- node definitions --- (описание узловой точка)



// --- FX definitions --- (описание FX)



// --- Sound FX definition --- (описание звуковых эффектов)



// --- editor parameters --- (параметры редактора)



// attachment rules: stack, srfAttach, allowStack, allowSrfAttach, allowCollision (правила присоединения)



// --- standard part parameters --- (стандартные параметры детали)



// --- specific part parameters --- (специфические параметры детали)


:Двойной прямой слэш перед каждым названием указывает, что эта строка была закомментирована; программа игнорирует такие строки.

Задание названия для Вашей детали.


Большинство файлов деталей содержит пару строк, наподобие тех, что указаны ниже:

// Kerbal Space Program – Конфигурационный файл

// Мой супер потрясающий двигатель, который может делать каджилион миль в час, lol



Эти строки полезны, когда другие хотят учиться на ваших файлах деталей.
Первая строка показывает, что данный файл является файлом детали для KSP, вторая – содержит ее название.


// Kerbal Space Program - файл CFG детали

// Ракетный двигатель «Mark V»

Продолжаем!



Основные параметры.


// --- general parameters ---
В этом разделе указываются название и описание нескольких свойств всех деталей. Ниже приведен список того, что подходит под основные параметры:
name = solidBooster
module = SolidRocket
author = Il Carnefice


name
Это значение может содержать все, что является уникальным, одним словом,и без подчеркивания. Это нельзя закомментировать, потому что KSP будет внутри ссылаться на деталь посредством этого параметра (пользователь не будет видеть это имя).


module
Что происходит после того, как модуль перемещает каждую деталь в категорию: например, твердотопливный ракетный ускоритель отличается от жидкостного ракетного двигателя. См. Valid Part Modules для получения значений, которые Вы сможете здесь использовать.
author
Имя автора


Ниже приведен пример:

Ниже приведен пример:

<pre>

// Kerbal Space Program - файл CFG детали

// Ракетный двигатель «Mark V»
// --- General Parameters ---
name = LiquidThrusterV
module = LiquidEngine
author = YourName


Детали

Название детали Описание
SolidRocket Напоминает твердотопливный ускоритель - постоянно горящая ракета, которая не имеет управления тягой и не может быть деактивирована, после того как была зажжена.
LiquidEngine Напоминает систему орбитального маневрирования – ракетный двигатель с управляемой тягой.
FuelTank Содержат топливо.
CommandPod Содержит экипаж и системы управления.
SASModule Удерживает курс.
SASModule2 ???
Strut Соединяет модули ракеты. Не имеет специальных способностей.
Decoupler Соединяет модули ракеты и может отбрасывать себя и присоединенные модули.
RadialDecoupler Соединяет модули ракеты и может отбрасывать себя как и «Decoupler», но радиально.
Parachutes Выпускает парашют.
ControlSurface Подвижная крылоподобная поверхность. Может выступать в роли руля, элерона, руля высоты, канарда (небольшое крыло, расположенное впереди основного крыла) или другой аэродинамической поверхности управления - функция зависит от размещения на
WarpEngine Варп-двигатель. Не функционирует с 0.15.2.
Winglet Неподвижная аэродинамическая поверхность, создающая подъемную силу.
Stabilizer Аналог ControlSurface (рекомендуется не использовать)
StrutConnector  ???
RCSFuelTank Бак для однокомпонентного топлива.
RCSModule Двигатель на однокомпонентном топливе.
AtmosphericEngine Атмосферный двигатель с параметрами турбонаддува воздуха.
AdvSASModule Модуль наподобии SAS, который вносит возможность пользовательского управления системой радиолокационного управления(RCS), крутящим моментом аппарата(Pod) и качанием двигателей и рулей.
DecouplerGUI Обычный разделитель, который может отделяться по клику правой клавишей мыши на графическом интерфейсе пользователя(GUI).
DockingPort Незаконченный стыковочный узел?
FuelLine Трубы(шланги) для передачи топлива.
FuelTankGUI Цистерна с топливом со способностью прекратить подачу топлива по клику правой клавишей мыши на графическом интерфейсе пользователя(GUI).
LandingLeg Движущаяся посадочная опора, использующая параметры «.cfg» для движения.
HLandingLeg Движущаяся посадочная опора, использующая анимацию для движения.
HParachutes Анимированный модуль парашюта?
LandingGear Колесное, анимированное посадочное шасси для космических аппаратов.
SatELight Осветительный модуль(прожектор).
LiquidFuelEngine Жидкотопливный двигатель, который работает с созданием импульсов и реактивной струи, с использованием топливных узлов.

Модули деталей

Пожалуйста прочтите: "Обновление 0.15 - PartModule, KSPField, KSPEvent, ConfigNode и PartResource"

Название модуля Описание
ModuleAerodynamicLift Модуль, создающий аэродинамическую подъемную силу?
ModuleAnimateHeat ???
ModuleAnimatorLandingGear Модуль анимированного посадочного шасси?
ModuleCommand Командный отсек?
ModuleEngineRocketLiquid Модуль жидкостного ракетного двигателя?
ModuleGenerator Используется RTG, ресурсами ввода/вывода.
ModuleResource Основной модуль ресурсов?
ModuleResourceIntake Основной модуль "потребляемых" ресурсов, дополнительный илии отделенный от "ModuleResource"?
ModuleTest ???

Параметры 3-D моделей


Этот раздел определяет модуль 3D-моделей - он соединяет модель и файл текстур, а также обеспечивает дополнительные настройки.

// --- asset parameters ---
mesh = modelfile.dae
scale = 0.1
texture = texturemap.png
specPower = 0.5
rimFalloff = 3
alphaCutoff = 0
//rescaleFactor = 1.25


mesh
Название сетки. Напишите свое название в нем и сохраните файл сетки в том же каталоге, что и файл детали.


scale
Масштаб модели - в зависимости от единиц в программе 3D-моделирования. Если Вы использовали единицу = один метр , то используйте значение 1 . Если это 1 единица, равная 0.1 метра , то используйте значение 0.1. Используйте значение коэффициент масштабирования 0.1, потому что потом легче соответствовать другим частям , чем возиться с коэффициентами масштабирования. Этот фактор будет влиять только на размерах составных частей, участвующих в составе детали и не повлияет на реальный размер самой детали.


texture
Наименование файла текстуры, который расположен в каталоге KSPDirectory/Parts/yourAddon/textures. Текстуры могут быть следующих размеров: 256x256, 512x512 или 1024x1024


specPower
Зеркальное отражение Вашей детали. Лучше оставьте его нетронутым.


rimFalloff
Определяет силу эффекта освещения. Более высокое значение увеличивает эффект вблизи краев.


alphaCutoff
Определяет порог прозрачности текстуры детали. Значение 0 означает, что в текстуре ничто не считается прозрачным. Значение 1 означает полностью прозрачную деталь. Текстуры с альфа-каналом (прозрачностью) может быть прозрачной в одних местах и ​​непрозрачной - в других.


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


Ниже приведен пример:

// Kerbal Space Program - файл CFG детали
// Ракетный двигатель Mark V

// --- General Parameters ---
name = LiquidThrusterV
module = LiquidEngine
author = YourName

// --- Asset Parameters ---
mesh = myMesh.dae
scale = 0.1
texture = awesometexture.png
specPower = 0.5 
rimFalloff = 3 
alphaCutoff = 0

Описание узловых точек

Defines where parts attach to other parts. Tricouplers have four: three bottom and one at the top, while most parts simply have two, and a few parts have only one.

node_stack_bottom = x, y, z, angx, angy, angz, size
node_stack_top = x, y, z, angx, angy, angz, size
node_attach = x, y, z, angx, angy, angz, size

Above are three example nodes. Two are useful in this tutorial: node_stack and node_attach. Node stack defines where the part vertically stacks with other parts, and node attach defines where on a part's surface other parts attach - in other words, horizontal attachment.

All node attachment values relate to an object's origin, and their values correspond to a model's units and scaling factors. A node_stack_bottom with x, y, and z values of (2.5, 5.0, 3.0) will have an attachment node 2.5 units to the right, 5.0 units up, and 3.0 units forward. The next three values refer to the orientation that a particular node will accept other attachments, on a scale of -1.0 to 1.0. These represent the vector that a part will orient itself on when attaching to the node. For example, a fuel tank with a node_stack_bottom will have angx, angy, and angz values of (0.0, -1.0, 0.0). This represents a vector downward relative to the part model, in the negative y direction. A value of (0.0, -1.0, 1.0) would represent a diagonal vector downward and forward, while a value of (1.0, 1.0, 1.0) would represent a vector to the right, up, and forward.

Generally, most parts will have angx, angy, and angz values of either (0.0, -1.0, 0.0) for a node_stack_bottom and (0.0, 1.0, 0.0) for a node_stack_top.

The last value indication the visual size of an attachment node. Values may be either 0 (small half-meter node), 1 (normal), or 2 (large). This parameter is optional and will default to 1 if nothing is specified. Keep in mind, naming conventions (_stack_bottom, _stack_top) for nodes only apply to node_attach; they are only helpful in identifying a node's position.

// Kerbal Space Program - Part CFG file
// Mark V Rocket Engine

// --- General Parameters ---
name = LiquidThrusterV
module = LiquidEngine
author = YourName

// --- Asset Parameters ---
mesh = myMesh.dae
scale = 0.1 
texture = awesometexture.png
specPower = 0.5 
rimFalloff = 3 
alphaCutoff = 0 

// --- Node Definitions ---
node_stack_bottom = 0.0, -3.5, 0.0, 0.0, 1.0, 0.0, 1.0

Описание FX

More definitions! But this time, you're positioning the flame coming out the back of the rocket.

fx_exhaustFlame_yellow = x, y, z, angx, angy, angz, active
fx_exhaustLight_yellow = x, y, z, angx, angy, angz, active
fx_smokeTrail_medium = x, y, z, angx, angy, angz, active

Okay, looks pretty similar to node_definitions, right?

You'll notice, just like node definitions, there are separate parts to each effect. You have fx_exhaustFlame, fx_exhaustLight, and fx_smokeTrail.

There are exactly what they sound like, the flame, the light, and the smoke trail.

There are variations on flame color, blue is also an option. To get a blue flame, you would use fx_exhaustFlame_blue. You would do the same for the exhaustLight.

The 'active' switch on the end is used to define when this effect will be visible. See the FX Groups listing to know which effect groups are available, and when they are used. It's also possible to assign an effect to more than just one FX Group. If for instance, you want a smoke effect to be visible both when the part activates and also when it deactivates itself, you can do this:

fx_gasBurst_white = x, y ,z, angx, angy, angz, activate, deactivate

This is particularly useful if you're defining a lot of effects, like the gas discharges on an RCS module.

Feel like you're getting the hang of this now? Let's keep building the dummy part file, and add in a blue flame and light, but leave out the smoke trail.

// Kerbal Space Program - Part CFG file
// Mark V Rocket Engine

// --- General Parameters ---
name = LiquidThrusterV
module = LiquidEngine
author = YourName

// --- Asset Parameters ---
mesh = myMesh.dae
scale = 0.1
texture = awesometexture.png
specPower = 0.5 
rimFalloff = 3 
alphaCutoff = 0

// --- Node Definitions ---
node_stack_bottom = 0.0, -3.5, 0.0, 0.0, 1.0, 0.0, 1.0

// --- FX Definitions ---
fx_exhaustFlame_blue = 0.0, -10.0, 0.0, 0.0, 1.0, 0.0, active
fx_exhaustLight_blue = 0.0, -10.0, 0.0, 0.0, 0.0, 1.0, active

Описание звуковых настроек FX

This is pretty easy to use in a basic way, which will suit our needs just fine.

Under this section, comes:

sound_vent_medium = activate
sound_rocket_hard = active
sound_vent_soft = deactivate

Sounds are added to FX Groups, in much the same way smoke and flame effects are. Of course, sounds do not need to be positioned in space, nor do they have rotations, so all you need is to indicate in which FX Group the sound will be executed. As with effects, you can assign multiple groups to a sound.


Since 0.20 GameData structure there are 2 ways to add a sound to a part:

  • KSP has an internal sound library, which contains a few sound effects. By defining a sound as in the example above, KSP will search for that sound in its internal library.
  • The second way is to add new sound files which is ONLY possible if adding the sound file to the GameData/modName/parts/partName/part/sounds/ folder. Note that all the sounds are therefore "private", only accessed by that part. For now, the legacy folder or a shared mod folder method doesn't work, devs are probably going to fix this problem in the future.


REMEMBER: If you add a custom sound, the file name must start with sound_ (e.g., sound_myNewSoundEffect.wav).

To use a sound from the KSP internal library or the part/sounds folder, you must not include the extension in the sound name (e.g., sound_vent_medium = activate), otherwise the sound will not work.

Supported files are 48000Hz .wav files and .ogg

Adding sound FX to our dummy part file:

// Kerbal Space Program - Part CFG file
// Mark V Rocket Engine

// --- General Parameters ---
name = LiquidThrusterV
module = LiquidEngine
author = YourName

// --- Asset Parameters ---
mesh = myMesh.dae
scale = 0.1 
texture = awesometexture.png
specPower = 0.5 
rimFalloff = 3 
alphaCutoff = 0 

// --- Node Definitions ---
node_stack_bottom = 0.0, -3.5, 0.0, 0.0, 1.0, 0.0, 1.0

*'''// --- FX Definitions ---
fx_exhaustFlame_blue = 0.0, -10.0, 0.0, 0.0, 1.0, 0.0, active
fx_exhaustLight_blue = 0.0, -10.0, 0.0, 0.0, 0.0, 1.0, active

// --- Sound FX definition ---
sound_vent_medium = activate
sound_rocket_hard = active
sound_vent_soft = deactivate

Параметры редактора


Ага! Мы вернулись к параметрам! Это набор параметров позволяет решть, как наша часть отображается в редакторе ракет. Этот раздел содержит следующее:

 // --- editor parameters ---
 cost = 450
 category = Propulsion
 subcategory = 0
 title = 
 manufacturer =
 description = 


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


category
Всего семь категорий:
Категория Описание
Pods Командный отсек и кабины пилотов находятся здесь
Propulsion Двигатели, топливные цистерны, монокомпанентные цистерны и тому подобное.
Control модули системы стабилизации (SAS), двишатели на монокомпанентном топливе (RCS) и тому подобное.
Structural Подпорки, разделители, адаптеры и тому подобное.
Aero Крылья, управляющие поверхности (рули) и носовые обтекатели.
Utility Парашюты, стыковочные стрелы, тепловые экраны, осветительное оборудование, посадочные шасси/опоры, лесницы, батареи, солнечные панели, генераторы и тому подобное.
Science Датчики, антенны, спутниковые тарелки и тому подобное.


subcategory
Еще не используется. Установите значение равным 0.


title
Как Вы хотите, чтобы Ваша деталь называлась в редакторе ракет?


manufacturer
Кто производит Вашу деталь?


description
Здесь опишите свою деталь. (Не используйте разрывы строк. KSP в подсказке детали разрывает строки автоматически. Разрыв строки вызовет отображение Вашего описания в усеченном виде).

И это все. Обновленный фиктивный cfg-файл теперь выглядит следующим образом:

// Kerbal Space Program - CFG файл детали
// Ракетный двигатель Mark V

// --- General Parameters ---
name = LiquidThrusterV
module = LiquidEngine
author = YourName

// --- Asset Parameters ---
mesh = myMesh.dae
scale = 0.1 
texture = awesometexture.png
specPower = 0.5 
rimFalloff = 3 
alphaCutoff = 0 

// --- Node Definitions ---
node_stack_bottom = 0.0, -3.5, 0.0, 0.0, 1.0, 0.0, 1.0

*'''// --- FX Definitions ---
fx_exhaustFlame_blue = 0.0, -10.0, 0.0, 0.0, 1.0, 0.0, active
fx_exhaustLight_blue = 0.0, -10.0, 0.0, 0.0, 0.0, 1.0, active

// --- Sound FX definition ---
sound_vent_medium = activate
sound_rocket_hard = active
sound_vent_soft = deactivate

// --- editor parameters ---
cost = 120
category = Propulsion
subcategory = 0
title = Ракетный двигатель Mark V
manufacturer = Утрашающе Ужасные Ракетные Двигатели Инкорпорейтед
description = Эта деталь теперь выведет Вас в космос с потерями меньшими на 60%, чем двигатель Mark IV.


Правила привязки



Здесь задаются параметры,определяющие как ваша деталь прикрепляется к другим деталям.

  • // attachment rules: stack, srfAttach, allowStack, allowSrfAttach, allowCollision
  • attachRules = 1,1,1,1,1



Правила соответствуют значениям, приведенным ниже - 1 разрешает, 0 - запрещает. Теги:

stack - позволяет Вашей детали быть пристыкованной к другим?

SrfAttach - позволяет Вашей детали располагаться на поверхности?

allowStack - позволяет другим деталям пристыковываться к Вашей детали?

allowSrfAttach позволяет другим деталям располагаться на поверхности Вашей детали?

allowCollision - Особенность: Может ли Ваша деталь или ее часть быть помещена в пересечении с другой деталью?

Обратите внимание, что Вы также можете заставить детали, прикрепленные к этой детали присоединиться с указанной симметрией.

  • // Правила симметрии: 0=1x, 1=2x, 2=3x, 3=4x и так далее...
  • stackSymmetry = 3



Достаточно легко, правда? Добавляем к фиктивному файлу и продолжим.

// Kerbal Space Program - CFG файл детали
// Ракетный двигатель Mark V
// --- General Parameters ---
name = LiquidThrusterV
module = LiquidEngine
author = YourName
// --- Asset Parameters ---
mesh = myMesh.dae
scale = 0.1
texture = awesometexture.png
specPower = 0.5
rimFalloff = 3
alphaCutoff = 0
// --- Node Definitions ---
node_stack_bottom = 0.0, -3.5, 0.0, 0.0, 1.0, 0.0, 1.0
// --- FX Definitions ---
fx_exhaustFlame_blue = 0.0, -10.0, 0.0, 0.0, 1.0, 0.0, active
fx_exhaustLight_blue = 0.0, -10.0, 0.0, 0.0, 0.0, 1.0, active
// --- Sound FX definition ---
sound_vent_medium = activate
sound_rocket_hard = active
sound_vent_soft = deactivate
// --- editor parameters ---
cost = 120
category = Propulsion
subcategory = 0
title = Ракетный двигатель Mark V
manufacturer = Утрашающе Ужасные Ракетные Двигатели Инкорпорейтед
description = Эта деталь теперь выведет Вас в космос с потерями меньшими на 60%, чем двигатель Mark IV.
// attachment rules: stack, srfAttach, allowStack, allowSrfAttach, allowCollision
attachRules = 1,1,1,1,0


Стандартные параметры детали


Здесь определяется, как ваша деталь действует в воздухе и за его пределами. Следует отметить, что не все эти параметры должны быть определены. Если они исключены из CFG файла, KSP будет использовать значения по умолчанию для них.

  • mass =
  • dragModelType = default
  • maximum_drag =
  • minimum_drag =
  • angularDrag =
  • crashTolerance =
  • breakingForce =
  • breakingTorque =
  • maxTemp =
  • heatConductivity =
  • heatDissipation =
  • stageOffset =
  • childStageOffset =
  • fuelCrossFeed =
  • NoCrossFeedNodeKey =


mass - Сколько весит Ваша деталь? (Или, если эта деталь имеет также параметр dryMass, сколько она весит когда наполнена?)
dragModelType - Оставьте это значение по-умолчанию.
maximum_drag - Каково максимальное значение аэродинамического сопротивления Вашей детали? (Обычно меньше 1). Как правило, аэродинамическое сопротивление, когда направление детали соответствует ее оси y.
minimum_drag - Минимальное значение аэродинамического сопротивления Вашей детали, когда она пристыкована. (Обычно меньше 1 и меньше, чем maximum_drag) (это значение не используется, если значение dragModelType установлено по-умолчанию) Как правило, аэродинамическое сопротивление, когда направление детали перпендикулярно ее оси y.
angularDrag - Насколько велико угловое сопротивление/сопротивление повороту? (Также обычно меньше 1.)
crashTolerance - Насколько хороша прочность Вашей детали при аварии? Чем выше число, тем выше прочность. Считается ориентировочно максимальным воздействием скорости в м/с.
breakingForce - На сколько хороша способность соединения между этой деталью и присоединенными к ней деталями противостоять влиянию линейных сил?
breakingTorque - На сколько хороша способность соединения сопротивления моментам сил?
maxTemp - Максимальное значение температуры, которую Ваша деталь может выдержать до взрыва.
heatConductivity - Насколько хорошо Ваша деталь проводит тепло? По-умолчанию - 0.08, значения используются CFG в версии 0.13.3, но не в 0.15.2.
heatDissipation - Насколько хорошо Ваша деталь рассеивает тепло от летательного аппарата? По-умолчанию - 0.08, значения используются CFG в версии 0.13.3, но не в 0.15.2.
stageOffset и childStageOffset - Может принимать значения 0, 1, и так далее... Определяет, будет ли деталь создавать новую ступень до или после себя, или и в обоих случаях (как делают стыковочные узлы). Это относится только к автоматически сгенерированной последовательность ступеней. Эти параметры заменили stageBefore и stageAfter.
fuelCrossFeed - Способность детали передавать топливо между деталями, прикрепленными к ней?
NoCrossFeedNodeKey - Устанавливается значение bottom когда удерживает топливо текущим через нижние узловые точки (Позволяет избежать некоторого дисбаланса стека и его частичного смягчения в версии 0.15 - ошибка генерации двигателями топлива). Используется с деталями, у которых несколько нижних узловых точек, таких как Адаптер три-к-одному TVR-1180C Mk1.

Теперь перейдем к другой секции, ниже.

Фиктивный файл CFG:

// Kerbal Space Program - CFG файл детали
// Ракетный двигатель Mark V
// --- General Parameters ---
name = LiquidThrusterV
module = LiquidEngine
author = YourName
// --- Asset Parameters ---
mesh = myMesh.dae
scale = 0.1 
texture = awesometexture.png
specPower = 0.5 
rimFalloff = 3 
alphaCutoff = 0 
// --- Node Definitions ---
node_stack_bottom = 0.0, -3.5, 0.0, 0.0, 1.0, 0.0, 1.0
// --- FX Definitions ---
fx_exhaustFlame_blue = 0.0, -10.0, 0.0, 0.0, 1.0, 0.0, active
fx_exhaustLight_blue = 0.0, -10.0, 0.0, 0.0, 0.0, 1.0, active
// --- Sound FX definition ---
sound_vent_medium = activate
sound_rocket_hard = active
sound_vent_soft = deactivate
// ---Editor parameters ---
cost = 120
category = Propulsion
subcategory = 0
title = Ракетный двигатель Mark V
manufacturer = Утрашающе Ужасные Ракетные Двигатели Инкорпорейтедdescription = Эта деталь теперь выведет Вас в космос с потерями меньшими на 60%, чем двигатель Mark IV.
// --- Standard part parameters ---
mass = 1.5
dragModelType = default
maximum_drag = 0.4
minimum_drag = 0.2
angularDrag = 0.2
crashTolerance = 5
maxTemp = 2500

Специфические параметры детали



Мы почти закончили, полностью созданная деталь почти в наших руках и Вы уже должны знать практически все, что нужно для создания файла "part.cfg". Однако помните, раньше, когда мы настраивали типы? Ну каждый тип имеет индивидуальный набор конкретных параметров детали, которые меняются в зависимости от того, какая эта деталь.

Вы не можете смешивать и сочетать параметры из разных типов модулей - это не работает.

Эти специфические параметры на самом деле - общие переменные, определенные в самом классе детали. Обычные параметры объявлены в базовой части класса, а также специфические - в каждом расширении детали (т.е. модуле)

Например, если тип Вашей детали (модуля) был SolidRocket, Ваши специфические параметры детали будут иметь следующий вид:

  • thrust = 130
  • dryMass = 0.36
  • heatProduction = 550
  • fuelConsumption = 4
  • internalFuel = 100
  • fullExplosionPotential = 0.8
  • emptyExplosionPotential = 0.1
  • thrustCenter = 0, -0.5, 0
  • thrustVector = 0, 1, 0



Время перейти и посмотреть, какие специальные параметры может иметь каждый модульь.

Жидкостной двигатель



Жидкостной двигатель имеет следующие специфические параметры:

  • maxThrust =
  • minThrust =
  • heatProduction =
  • fuelConsumption =



Выглядит довольно просто, и все в значительной степени то, чего Вы ожидали здесь увидеть. Сейчас Вы уже должны понимать, что эти параметры означают, но на всякий случай:

maxThrust - Максимальное значение тяги для жидкостного двигателя.

minThrust - Минимальное значение тяги. Обычно 0, если Вы не хотите ракету, которая не может быть полностью выключена.

heatProduction - Насколько много тепла выделяет Ваша деталь.

fuelConsumption - Сколько топлива использует ваш двигатель.

Твердотопливный ракетный ускоритель

  • thrust =
  • dryMass =
  • heatProduction =
  • fuelConsumption =
  • internalFuel =
  • fullExplosionPotential =
  • emptyExplosionPotential =
  • thrustCenter = x, y, z
  • thrustVector = angx, angy, angz

A lot of those values look pretty similar to the liquid engine parameters, right?

thrust - The thrust of the solid rocket booster. Note how there is no minimum thrust because it can not be turned off once lit.

dryMass - How much the SRB weighs when empty.

heatProduction - Exactly the same as the liquid rocket, how much heat your rocket puts up.

fuelConsumption - How much fuel the rocket uses per second.

internalFuel - How much fuel does the SRB hold inside it?

fullExplosionPotential - The potential for explosion when the rocket is full of fuel

emptyExplosionPotential - And the potential when it's empty.

thrustCenter - Where the thrust comes from.

thrustVector - And which direction it goes.

Топливная цистерна

Топливные баки описываются немного по-другому, в связи с тем, что у них нет параметров тяги.


  • fuel =
  • dryMass =
  • fullExplosionPotential =
  • emptyExplosionPotential =

Если Вы прочитали все написанное выше, то должны точно знать - что эти параметры делают, и, поэтому, я не буду снова их Вам объяснять.

Модуль системы стабилизации (SAS)

  • maxTorque =

maxTorque - The maximum amount of torque the module can apply to halt the ship's rotation.

Ki, Kd and Kp - These parameters allow for tuning of the internal workings of the SAS module. If you're not experienced in working with PID controllers, just leave them as they are.

Крылья

  • dragCoeff =
  • deflectionLiftCoeff =

dragCoeff - аэродинамическое сопротивление крыла.

deflectionLiftCoeff - подъемная сила крыла.

Управляющие поверхности (рули)

  • dragCoeff =
  • deflectionLiftCoeff =
  • ctrlSurfaceRange =
  • ctrlSurfaceArea =

ctrlSurfaceRange - How far off centre the control surface (rudder / aileron etc) can move under control

ctrlSurfaceArea - The effective surface area of the control surface - the bigger the surface, the bigger the surface area must be set to

Разделители

  • ejectionForce =

ejectionForce - How hard it separates on stage ejection.

Note, decouplers also add two lines to Standard Part Parameters, "stageAfter = True" and "stageBefore = True"

Парашюты

  • useAGL =
  • autoDeployDelay =
  • minAirPressureToOpen =
  • deployAltitude =
  • closedDrag =
  • semiDeployedDrag =
  • fullyDeployedDrag =

useAGL - Whether or not the parachute opens at the set altitude above ground level, instead of above sea level.

autoDeployDelay - Time before parachutes attached to jettisoned parts are activated.

minAirPressureToOpen - The minimum air pressure required before the chute will activate.

deployAltitude - At what altitude the parachute deploys fully once activated.

closedDrag - The drag when the parachute is closed.

semiDeployedDrag - The drag when it's semi-deployed

fullyDeployedDrag - And finally, the drag when it's entirely deployed.

В заключение

There you go then. By now, you should know the ins and outs of the part.cfg file, and how to create one, edit one, play around with one, etc. All sorts of cool stuff like that. The final dummy part.cfg file will be after this, with the special part parameters added in.

Anyway, that's that, now you know, now go make some cool addons like FTL drives and newton-defying inertial dampeners.

Фиктивный файл part.cfg завершен

// Kerbal Space Program - Part CFG file
// Mark V Rocket Engine
// --- General Parameters ---
name = LiquidThrusterV
module = LiquidEngine
author = YourName
// --- Asset Parameters ---
mesh = myMesh.dae
scale = 0.1 
texture = awesometexture.png
specPower = 0.5 
rimFalloff = 3
alphaCutoff = 0
// --- Node Definitions ---
node_stack_bottom = 0.0, -3.5, 0.0, 0.0, 1.0, 0.0, 1.0
// --- FX Definitions ---
fx_exhaustFlame_blue = 0.0, -10.0, 0.0, 0.0, 1.0, 0.0, active
fx_exhaustLight_blue = 0.0, -10.0, 0.0, 0.0, 0.0, 1.0, active
// --- Sound FX definition ---
sound_vent_medium = activate
sound_rocket_hard = active
sound_vent_soft = deactivate
// ---Editor parameters ---
cost = 120
category = Propulsion
subcategory = 0
title = Mark V Rocket Engine
manufacturer = Awesomely Terrible Spaceship Engines Inc.
description = This part will now get you to space with 60% less limb loss than the mark IV engine.
// --- Standard part parameters ---
mass = 1.5
dragModelType = default
maximum_drag = 0.4
minimum_drag = 0.2
angularDrag = 0.2
crashTolerance = 5
maxTemp = 2500
// --- Special Part Parameters ---
maxThrust = 150
minThrust = 0	
heatProduction = 360
fuelConsumption = 7

More Example?

// KSP - Parts
// Chemi Ion engine , using normal fueltank :D
// Mark I Ion engine
// 

// --- general parameters ---
name = ChemiIonEngine
module = LiquidEngine
author = Chemi | G-min
// --- asset parameters ---
mesh = CIonengMK1.dae

scale = 0.1
texture = hotsurf.png
specPower = 0.5
rimFalloff = 4
alphaCutoff = 0

// --- node definitions ---
node_stack_bottom = 0, 0, 0, 0, -1.0, 0, 1

node_stack_top = 0, 0.2, 0, 0, 1.0, 0, 1

// --- FX definitions ---
fx_exhaustFlame_yellow = 0, -0.05, 0, 0, 1.0, 0, active

fx_exhaustLight_yellow = 0, -0.05, 0, 0, 0, 0, active
fx_smokeTrail_medium = 0, 0, 0, 0, 1.0, 0, active
// --- Sound FX definition ---
sound_chemiionengine.wav = activate

sound_chemiionengine.wav = active
sound_vent_soft = deactivate

// --- editor parameters ---
cost = 1000

category = Propulsion
subcategory = 0
title = Chemi Ion engine MK1
manufacturer = Chemi Jet Propulson Laboratory / G-min Parts design
description = The great Ion engine :D with crash resiston G-JPG Around 999 m/s! (not mean inside ion engine will be resist 999 m/s crash!!! I warned you!) and with SPECIAL STRONGER! shock absorber!    now with viscosion coolant!(really absorbs and conduct :D) (it's GEL!) great for Interplanetary jornal.

// attachment rules: stack, srfAttach, allowStack, allowSrfAttach, allowCollision
attachRules = 1,1,1,1,0
// --- standard part parameters ---
mass = 1.22

dragModelType = default 
maximum_drag = 0.399 
angularDrag = 0.4
crashTolerance = 29.16
breakingForce = 1024
breakingTorque = 567
maxTemp = 3100
heatConductivity = 3.6
heatDissipation = 0.014
// --- specific part parameters ---
maxThrust = 369

minThrust = 0
heatProduction = 58
fuelConsumption = 0.009
// end!