Guides/Adding New Ship Customization Entries

This page is under construction Check back later for additional changes

Preface

Adding new ship customization entries to the game files requires jumping through a couple of hoops, but at the same time is relatively straightforward. It's important to remember that while you're able to add new entries to the files that any other mods that modify the same file(s) will break things.

For example: if you want to have make two mods that both add new type of sails to customize your ship, they will overwrite each other. There is a workaround of making your mods compatible together, but that will only work within the scope of those two mods in particular. In other words - there is no real benefit of adding new ship customization items as separate entries to the game files unless you and the players intend to play without any other mod that edits the files that were changed to include new customization entries in the game.

Refer to Like a Dragon: Pirate Yakuza in Hawaii/Ship Customization for extra information on what files to look for and where.

Table of reference of files to edit

All origin filenames and directories are relative to <game dir>\LikeADragonPirates\runtime\media\data

List of files that need to be edited to add new sails and hull entries to the game (figurehead and body decorations TBD)

Filename	Origin	Editing purpose
pause_pirate_menu_ship_customize_part.bin	db.spr.<language>.par	Add an entry for your sails/hull to be selectable in Customization screen: name, price, availability (e.g. direct purchase, a shop, etc.), variants (more than one type of customization that you can select one you acquire the item)
pirate_ship_ship_model_customize_body.bin	db.spr.<language>.par	Add an entry for your hull stating which hull model, mast and rudder wheel to use
pirate_ship_ship_model_customize_sail.bin	db.spr.<language>.par	Add an entry for your sails stating which sail category to use (see below) and what base colour of the sails is (RGB value)
pirate_ship_ship_model_customize_sail_category.bin	db.spr.<language>.par	Add an entry that explicitly lists which texture file is used for which part of the sails. Your new custom texture filenames must be listed here
item.bin	db.spr.<language>.par	Add the sails/hull as an actual item for the game to add to your inventory regardless of whether your item will be sold at a store or be purchasable from the Customization menu
ui_texture.bin	puid.spr\	Add an entry of your new UI texture to a list of all UI textures in the game which will be referenced multiple times across other files
asset_id.dat	asset_ngen.par	Contains data equivalent of pirate_ship_ship_model_customize_sail_category.bin but for hull textures instead of sails textures, add a new entry here detailing which hull texture is used on which part of the hull's model (and which model is used)

Dependencies

If it wasn't clear - the files that we need to edit all have dependencies on one another creating a whole cascading effect of entries that you need to add into other files for the game to put your things into the right places.

<insert diagram of what exact entry in each file depends on what file and which entry to visualise this>