七日杀Mods：新人礼包

描述

当玩家第一次进入游戏时，给予新人礼包。

前置

运行环境：7 Days To Die V1.0(b309)
涉及内容：entity_classes.xml，items.xml，Localization.txt
文件布局：

编辑 items.xml

在items.xml中，追加我们所需要添加的新人礼包。

<config>
	<append xpath="/items">
		<item name="agQuestRewardStarterBundle">
			<property name="Extends" value="questRewardBundleMaster"/>
			<property name="CreativeMode" value="Player"/>
			<property name="CustomIcon" value="agBundleStarter"/>
			<property name="CustomIconTint" value="FFFFFF"/>
			<property name="ItemTypeIcon" value="bundle"/>
			<property name="DescriptionKey" value="agQuestRewardStarterBundleDesc"/>
			<!-- 公爵赌场币*500，手枪（1~6级随机），9毫米子弹（100~300），维修工具*5，急救绷带*5，自行车*1 -->
			<property class="Action0">
				<property name="Create_item" value="casinoCoin,gunHandgunT1Pistol,ammo9mmBulletBall,resourceRepairKit,medicalFirstAidBandage,vehicleBicyclePlaceable"/>
				<property name="Create_item_count" value="500,1-6,100-300,5,5,1"/>
			</property>
		</item>
	</append>
</config>

• Extends：继承questRewardBundleMaster类，此类为组合包道具的基类，我们只需重写方法Action0生成所需item即可；
• CreativeMode：创意模式可调用角色，默认为All，设为Player，可被玩家调用；
• CustomIcon：展示给玩家的图标，可设置为内置图标；若想引用自定义类型图标，需在目录Mod\UIAtlases\ItemIconAtlas\下新增宽高尺寸一致的PNG图片文件；；
• CustomIconTint：展示给玩家的图标色调，值类型为HEX，不想着色设置为FFFFFF即可；
• ItemTypeIcon：Item类型图标，可设置为内置的图标bundle；若想引用自定义类型图标，需在目录Mod\UIAtlases\UIAtlas\下新增宽高尺寸一致的PNG图片文件；
• DescriptionKey：文本描述的Key，据此从Mod\Config\Localization.txt中取用户语言类型的值，若无对应的语音类型，则取存在的值。
• Create_item：生成组合包内的item，多个用逗号隔开，值为所需item的name；
• Create_item_count：生成组合包内的item的数量，多个用逗号隔开，一一对应，值为整数；

编辑 entityclasses.xml

在entityclasses.xml中，通过覆盖entity_classes下子节点playerMale的属性ItemsOnEnterGame.GameModeSurvival的值，实现当玩家首次进入游戏时，发放自定义的新人礼包。

<config>

	<set xpath="/entity_classes/entity_class[@name='playerMale']/property[@name='ItemsOnEnterGame.GameModeSurvival']/@value">agQuestRewardStarterBundle</set>
	<set xpath="/entity_classes/entity_class[@name='playerMale']/property[@name='ItemsOnEnterGame.GameModeSurvivalSP']/@value">agQuestRewardStarterBundle</set>
	<set xpath="/entity_classes/entity_class[@name='playerMale']/property[@name='ItemsOnEnterGame.GameModeSurvivalMP']/@value">agQuestRewardStarterBundle</set>
	
</config>

编辑 Localization.txt

在Localization.txt中，编写对应数据，实现本土化翻译。

Key,File,Type,UsedInMainMenu,NoTranslate,english,Context / Alternate Text,german,spanish,french,italian,japanese,koreana,polish,brazilian,russian,turkish,schinese,tchinese
agQuestRewardStarterBundle,items,item,,,,,,,,,,,,,,,新人礼包,
agQuestRewardStarterBundleDesc,items,item,,,,,,,,,,,,,,,新人礼包,