About Custom Shop Support

Synopsis

This hack allows you to specify custom NPCs for car shops.

It also allows you to blacklist and whitelist specific cars and skins at specific phone booths and skin shops respectively.

Configuration

This is an example configuration for this hack with comments explaining how it works.

This configuration file goes into CustomShopSupport.xml in the root of your mod.

We do not recommend copying this entire example into your mod. We recommend only using what is necessary.

<?xml version="1.0" encoding="utf-8"?>
<CustomShopSupport>
	<!--
	
	CustomShopSupport.xml
		Change the characters that own car shops and modify the rosters of individual phonebooths.
	
	<CarShop>
		Level: The level the charshop is in.
		Character: The name of the character that runs the shop (including the "reward_" prefix).
		Conversation: The name of the conversation to use when talking to the character. Leave blank to disable the conversation.
	<PhoneBooth>
		Drawable: Change the drawable that displays above the phonebooth. Optional.
		<Selector>
			Level: The level to use this phonebooth on.
			Locator: The Type 9 SummonVehiclePhone locator to use this phonebooth on.
		<FreeItems>
			<Car>
				[Contents]: Specify the name of the car.
				Path: The path to the car. Defaults to "art\cars\CARNAME.p3d".
				RepairCost: The cost to repair this car.
		<Blacklist>
			<Car>
				[Contents]: Specify the name of the car.
		<Whitelist>
			<Car>
				[Contents]: Specify the name of the car.
				RepairCost: The cost to repair this car.
	<SkinShop>
		Drawable: Change the drawable that represents the skin shop. Optional.
		<Selector>
			Level: The level to use this skin shop on.
			Locator: The Type 9 PurchaseSkin locator to use this phonebooth on.
		<FreeItems>
			<Skin>
				[Contents]: Specify the name of the character.
				Path: The path to the character. Defaults to "art\chars\CHARNAME.p3d".
		<Blacklist>
			<Car>
				[Contents]: Specify the name of the character.
		<Whitelist>
			<Car>
				[Contents]: Specify the name of the character.
		
	-->

	<!-- Default Car Shops -->
	<CarShop Level="1" Conversation="plowking" Character="reward_barney" />
	<CarShop Level="2" Conversation="son" Character="reward_homer" />
	<CarShop Level="3" Conversation="bus" Character="reward_otto" />
	<CarShop Level="4" Conversation="tractor" Character="reward_tractor" />
	<CarShop Level="5" Conversation="borrowing" Character="reward_homer" />
	<CarShop Level="6" Conversation="swine" Character="reward_kearney" />
	<CarShop Level="7" Conversation="" Character="zombie" />
	
	<!-- Custom Phone Booths -->
	<PhoneBooth>
		<!-- Select this Phonebooth if it's Level 1 or 7 -->
		<Selector Level="1" />
		<Selector Level="7" />
		
		<!--  Make it so Homer can't use Apu's car -->
		<Blacklist>
			<Car>apu_v</Car>
		</Blacklist>
	</PhoneBooth>
	
	<PhoneBooth Drawable="wrench"> <!-- Use a wrench drawable for fun! -->
		<!-- Select Level 1 and the Phonebooth across the Simpson's House -->
		<Selector Level="1" Locator="Z1p1"/>
		
		<!-- Specify an empty Whitelist to exclude all Reward Cars -->
		<Whitelist />
		
		<FreeItems>
			<!-- And then here we add a couple cars to the phonebooth -->
			<Car>bart_v</Car>
			<Car>homer_v</Car>
		</FreeItems>
	</PhoneBooth>
	
	<!-- Custom Skin Shop -->
	<SkinShop Drawable="dice">
		<Selector Level="1" Locator="z1_skin2"/>
		
		<FreeItems>
			<Skin>h_fat</Skin>
			<Skin>h_scuzzy</Skin>
		</FreeItems>
	</SkinShop>
	
	<SkinShop Drawable="wrench">
		<Selector Level="1" Locator="z1_skin3"/>
		
		<FreeItems>
			<Skin>h_stcrobe</Skin>
			<Skin>h_undrwr</Skin>
		</FreeItems>
	</SkinShop>
</CustomShopSupport>

History

1.22

Added support for a "SkinShop" element in this hack's configuration file that works similarly to the existing "PhoneBooth" element.

 


Revision #10
Created Sat, Jun 30, 2018 6:02 PM by Loren Goodwin
Updated Thu, Mar 7, 2019 11:09 PM by Loren Goodwin