림세널 빼면 모드 만드는 사람이 있는지도 모르겠지만...ㅎ

원문

정의(Def) 하나 수정하려고 모든걸 복제하는 대신 수행할 수 있는 11개의 PatchOperation(패치)이 추가됐습니다. 같은 정의의 서로 다른 부분을 바꾸는 두 개의 모드가 충돌 없이 맡은 바를 수행할 수 있게 되어 모드 호환성이 극적으로 향상됐습니다. 본 가이드는 우리가 사용할 수 있는 패치의 기본만을 설명합니다.

패치는 모드의 하위폴더 Patches 아래 xml파일로 포함됩니다. (따라서 결과물은 MyMod\Defs나 MyMod\Textures 처럼 MyMod\Patches 아래에 들어가야 합니다.) 예시

각 PatchOperation은 xpath 노드를 가지며 해당 패치가 수정해야 하는 xml 노드의 xpath를 가리켜야 합니다. 본 가이드는 xpath 튜토리얼이 아닙니다. xpath를 모르셔도 여기서 알려드리진 않겠습니다.

패치를 설명하기 위해 간단한 예시 정의를 하나 만들겠습니다.

<DesignationCategoryDef>
    <defName>ExampleCategory</defName>
    <label>Example</label>
    <specialDesignatorClasses>
        <li>Designator_Cancel</li>
    </specialDesignatorClasses>
</DesignatorCategoryDef>

아래 예시에서는 모두 specialDesignatorClass 노드를 가리킬겁니다.

기본 패치

Add, Insert, Remove, Replace의 네 가지 기본 패치가 가능합니다.
PatchOperationAdd 는 선택한 노드에 자식을 추가합니다.

<Operation Class="PatchOperationAdd">
    <xpath>//DesignationCategoryDef[defName = "ExampleCategory"]/specialDesignatorClasses</xpath>
    <value>
        <li>ZhentarExample.ExampleDesignator</li>
    </value>
</Operation>

위 패치는 예시 정의를 아래로 바꿉니다.

<DesignationCategoryDef>
    <defName>ExampleCategory</defName>
    <label>Example</label>
    <specialDesignatorClasses>
        <li>Designator_Cancel</li>
        <li>ZhentarExample.ExampleDesignator</li>
    </specialDesignatorClasses>
</DesignatorCategoryDef>

PatchOperationInsert 는 선택한 노드의 형제 노드를 추가합니다.

<Operation Class="PatchOperationInsert">
    <xpath>//DesignationCategoryDef[defName = "ExampleCategory"]/specialDesignatorClasses</xpath>
    <value>
        <description>Pointless example designators.</description>
    </value>
</Operation>

위 패치는 예시 정의를 아래로 바꿉니다.

<DesignationCategoryDef>
    <defName>ExampleCategory</defName>
    <label>Example</label>
    <specialDesignatorClasses>
        <li>Designator_Cancel</li>
    </specialDesignatorClasses>
    <description>Pointless example designators.</description>
</DesignatorCategoryDef>

PatchOperationRemove 는 선택한 노드를 제거합니다.

<Operation Class="PatchOperationRemove">
    <xpath>//DesignationCategoryDef[defName = "ExampleCategory"]/specialDesignatorClasses</xpath>
</Operation>

위 패치는 예시 정의를 아래로 바꿉니다.

<DesignationCategoryDef>
    <defName>ExampleCategory</defName>
    <label>Example</label>
</DesignatorCategoryDef>

PatchOperationReplace 는 선택한 노드를 교체합니다.

<Operation Class="PatchOperationRemove">
    <xpath>//DesignationCategoryDef[defName = "ExampleCategory"]/specialDesignatorClasses</xpath>
     <value>
        <specialDesignatorClasses/>
     </value>
</Operation>

위 패치는 예시 정의를 아래로 바꿉니다.

<DesignationCategoryDef>
    <defName>ExampleCategory</defName>
    <label>Example</label>
    <specialDesignatorClasses/>
</DesignatorCategoryDef>

속성 패치

Add, Set, Remove의 세 가지 속성(Attribute) 패치가 가능합니다.

PatchOperationAttributeAdd 와 PatchOperationAttributeSet 은 둘 다 속성을 추가 및 설정할 수 있습니다. 차이점은, 추가 패치는 해당 속성이 존재하지 않을 때만 추가하지만, 설정 패치는 기존 값을 덮어쓴다는 것입니다.

<Operation Class="PatchOperationAttributeSet">
    <xpath>//DesignationCategoryDef[defName = "ExampleCategory"]/specialDesignatorClasses</xpath>
    <attribute>ExampleAttribute</attribute>
    <value>ExampleValue</value>
</Operation>

위 패치는 예시 정의를 아래로 바꿉니다.

<DesignationCategoryDef>
    <defName>ExampleCategory</defName>
    <label>Example</label>
    <specialDesignatorClasses ExampleAttribute="ExampleValue">
        <li>Designator_Cancel</li>
    </specialDesignatorClasses>
</DesignatorCategoryDef>

PatchOperationAttributeRemove 는 속성을 제거합니다. 우리의 예시 정의는 제거할 속성이 붙어있질 않으니 스스로 상상해보시길 바랍니다. ;-)

고급 패치

마지막으로 PatchOperationAddModExtension, PatchOperationSetName, PatchOperationSequence, PatchOperationTest 의 네 가지 고급 패치가 존재합니다.

PatchOperationAddModExtension 은 말 그대로 ModExtension 을 추가합니다. ModExtension 이 뭔지 모르신다면… 다른 가이드가 필요하시겠네요.

PatchOperationSetName 은 노드의 이름을 바꿉니다. 이 패치는 완벽성을 위해 포함되긴 했지만, 알려진 사용 가능한 경우는 없습니다.

PatchOperationSequence 와 PatchOperationTest 는 조건적으로 패치를 수행할 때 사용할 수 있습니다. 같은 요소를 두 번씩 패치하는 상황을 방지할 수 있기 때문에 호환성 유지에 유용합니다. PatchOperationSequence 는 리스트의 각 패치를 순서대로 수행하며 중간에 실패할 경우 중단합니다. PatchOperationTest 는 xpath 선택자와 일치하는 요소가 존재하는지 검사합니다.

아래 예시는 DiningChair 에 costList 요소가 존재하지 않을 때만 추가합니다.

<Operation Class="PatchOperationSequence">
    <success>Always</success>
    <operations>
        <li Class="PatchOperationTest">
            <xpath>//ThingDef[defName = "DiningChair"]/costList</xpath>
            <success>Invert</success>
        </li>
        <li Class="PatchOperationAdd">
            <xpath>//ThingDef[defName = "DiningChair"]</xpath>
            <value>
                <costList />
            </value>
        </li>
    </operations>
</Operation>