Contents 1 What is pirates_local.ini? 2 Setting up a blank pirates_local.ini file 3 Correctly setting options in pirates_local.ini file 3.1 Colors 3.2 Timings 4 Creating your pirates_local.ini file 4.1 UI Settings 4.1.1 sdc=true 4.1.2 Text Colors 4.1.3 Health UI Text 4.1.4 Map Icon Colors 4.1.5 Skirmish Stats 4.1.6 Skirmish Join Tab 4.1.7 Color of Enemy Ports Your Nation Puts Into Unrest 4.1.8 Color of Your Ports That Your Enemy Puts Into Unrest 4.1.9 Color of Ports With No Unrest 4.1.10 Skill Shop Font Color 4.1.11 Friends List Font Color 4.1.12 Player and Ship Stats Page Font Color 4.1.13 Client Timers 4.1.14 Inventory Items Font Colors 4.1.15 Mission Level Difficulty Font Colors 4.1.16 Battle Marker Colors 4.1.17 Chat Font and Size 4.1.18 Tool Tip Mouse-Over Hover 4.2 Game Logger Options 4.3 Ship Manager 4.3.1 Ship Scale on Sailing Map 4.4 Client Info Manager 4.4.1 Zoom Ranges on the Open Sea 4.5 Sailing Map Constrants 4.5.1 Map Size Radius 4.6 Local Map Changes 4.7 Avatar Constraints 4.7.1 Adjusting Camera Zoom 4.7.2 Adjusting Camera Swing 4.8 Avatar Manager 4.8.1 Tab Target Changes 4.9 Ship Constraints 4.9.1 Ship Camera Options

What is pirates_local.ini?

The pirates_local.ini file allows you to edit various client settings of the game. These settings range from simple colours of texts, to your local and area map size and detail all the way to the level of zoom you have on the open sea.

Setting up a blank pirates_local.ini file

If you haven't got one of these files, you will first need to make one. Open up notepad and save a blank file as "pirates_local.ini" making sure that in the "save as type" option below the filename you change it to All Files. This will ensure you save it as a .ini file and not a .ini.txt file.

The save location needs to be in the same folder as your main game files are, by default:

C:\ProgramData\Sony Online Entertainment\Installed Games\Pirates of the Burning Sea.

Either way, so long as it's in the same folder as where PotBS.exe is, it'll work fine.

Correctly setting options in pirates_local.ini file

Colors

For picking your colours for the various options below, we use a RGB-Alpha setup. To make things easier on the settings, we use a decimal version of RGB-Alpha.

For example, a colour of R=255 G=255 B=255 and alpha as 100 would =1 1 1 1 and R=125 G=245 B=20 and alpha 70 would =.49 .96 .07 .7

You can use the tool below to convert Hex values for color into our decimal format.

Hexadecimal Color Code:	<- click!
pirates_local.ini Color Code:

Timings

All timings that we use in the settings are done in seconds.

Creating your pirates_local.ini file

What follows below are all the main options you have available for this file. To use any of these options, you first have to have the main category for those options as a whole in your file (the categories are the text in square brackets) and then you need to copy the line you want.

Any comments I have made about each option are displayed BELOW that option in normal text, rather than in code boxes. You do not need to copy the comments into your file.

UI Settings

The first thing you need to place in your pirates_local.ini file to adjust any of the UI is the settings category, which is [UI].

From there, you can carry on with the other UI settings listed below.

sdc=true

[UI]
sdc=true

This allows for use of the /addmetric command (amongst others) within the game. Type /help in-game for a list of available commands. Another useful example is the /freecamera command.

Text Colors

levelColor_you=
levelColor_friend=
levelColor_group=
levelColor_neutral=
levelColor_enemy_trivial=
levelColor_enemy_easy=
levelColor_enemy_moderate=
levelColor_enemy_hard=
levelColor_enemy_harder=

These are used for the text colors of names. Use the above section on colors if you're unsure how to set these.

Health UI Text

IFFColor_default=
IFFColor_you=
IFFColor_derelict=
IFFColor_NPC_ally=
IFFColor_NPC_neutral=
IFFColor_NPC_hostile=
IFFColor_PC_PVPoff=
IFFColor_PC_PVPoff_group=
IFFColor_PC_PVPon_group=
IFFColor_PC_PVPon_ally=
IFFColor_PC_PVPon_attacker_only=
IFFColor_PC_PVPon_victim_only=
IFFColor_PC_PVPon_enemy=
IFFColor_PC_hated=

These are used for the text colors in the Health UI.

Map Icon Colors

IFFIconColor_default=
IFFIconColor_you=
IFFIconColor_derelict=
IFFIconColor_NPC_ally=
IFFIconColor_NPC_neutral=
IFFIconColor_NPC_hostile=
IFFIconColor_PC_PVPoff=
IFFIconColor_PC_PVPoff_group=
IFFIconColor_PC_PVPon_group=
IFFIconColor_PC_PVPon_ally=
IFFIconColor_PC_PVPon_attacker_only=
IFFIconColor_PC_PVPon_victim_only=
IFFIconColor_PC_PVPon_enemy=
IFFIconColor_PC_hated=
worldMapIconColorPirate=
worldMapIconColorSpain=
worldMapIconColorEngland=
worldMapIconColorFrance=
worldMapIconColorDutch=
worldMapIconColorPirateEnemy=

These are used for the map icon colors in the local map and mini map.

Skirmish Stats

skirmishSideRed=
skirmishSideBlack=
skirmishSideBlue=
skirmishSideYellow=

These colors are used for skirmish stats

Skirmish Join Tab

skirmishNameColorNormal=
skirmishNameColorNoJoin=

These colors are used for entries in the list of skirmishes on the skirmish UI join tab

Color of Enemy Ports Your Nation Puts Into Unrest

worldMapUnrestGoodColor=

The color of ENEMY NATION ports that your nation has put into unrest

Color of Your Ports That Your Enemy Puts Into Unrest

worldMapUnrestBadColor=

The color of YOUR ports that have been put into unrest

Color of Ports With No Unrest

worldMapUnrestNeutralColor=

The color of NEUTRAL ports that don't have unrest.

Skill Shop Font Color

skillShopCantPurchaseColor=
skillShopAlreadyOwnedColor=

The color of the font used in the skill shop.

Friends List Font Color

friendsOnlineColor=
friendsOfflineColor=

The color of the font in your friends list

Player and Ship Stats Page Font Color

shipStatsGoodColor=
shipStatsBadColor=
shipStatsNormalColor=
playerStatsGoodColor=
playerStatsBadColor=
playerStatsNormalColor=

Player and ship stats page font colors

Client Timers

AFKTimeout=
playerIdleTimeout=
quitShutdownTimeout=

Various timers that you can adjust for your client.

Inventory Items Font Colors

inventoryTypeValidColor=
inventoryTypeUncommonColor=
inventoryTypeExceptionalColor=
inventoryTypeUniqueColor=
inventoryTypeSpecialColor=
inventoryTypeInvalidColor=
inventoryTypeOwnedColor=

Colors of the text for inventory items.

Mission Level Difficulty Font Colors

missionLevelHarderColor=
missionLevelHardColor=
missionLevelModerateColor=
missionLevelEasyColor=
missionLevelTrivialColor=

Colors of the text for missions based on levels

Battle Marker Colors

battleMarkerCountFullColor=
battleMarkerCountNotFullColor=

The color of the battle markers on the OS

Chat Font and Size

chatOutputFont=
chatOutputFont1=
chatOutputFont2=
chatOutputFont3=
chatOutputFont4=
chatOutputFont5=

These change the font type and size of the chat for when you change it using in-game preferences. Type the font name first and the size after it. Example: Arial10

Tool Tip Mouse-Over Hover

mouseHoverTime=

This changes how long it takes to have in-game tool tips show when you hover your mouse over something.

Game Logger Options

Logs are stored in your My Documents\Pirates of the Burning Seas folder. Note that you will get logs even if without an entry in the INI, but they will contain less information.

The category for these options is [Logger] which you'll need on there if you wish for any of these options to work.

[Logger]
Mission=Info
Combat=Info
Combat_Totals=Info
Encounter=Info
ConsoleCommand=Info
Chat_Messages=Info

These options determine what gets put into the logs stored on your computer for each session. Logs are stored in your My Documents\Pirates of the Burning Seas folder.

Ship Manager

Ship Scale on Sailing Map

[ShipManager]
sailingMapScale=1

This option will change the scale of the ships displayed in the game, making them larger. Originally presented by Taelorn as a workaround for those people that felt that the open sea sailing felt too fast, this definitely makes it feel slower.

Client Info Manager

Zoom Ranges on the Open Sea

[ClientInfoManager]
zoomRanges=10,25,50,75,100,250,500,750,1000,2000,3000,4000,5000,7500,10000

Adding this option adds more zoom ranges on the open sea.

Sailing Map Constrants

This category is designed to alter settings on your sailing map in-game. The category is [CONSTRAINTS_SAILINGMAP]

Map Size Radius

[CONSTRAINTS_SAILINGMAP]
offsetRadiusMax = 200000;

Affects the main map size maximum radius.

Local Map Changes

This option is designed to adjust your local map settings. The category you need for this is [NavMeshRenderer]

[NavMeshRenderer]
width = 
height = 
obeyTexturePrefs = false

This allows you to adjust your local map size to a width and height you state, as well as keeping it in high detail all the time.

Avatar Constraints

Adjusting Camera Zoom

[CONSTRAINTS_AVATAR]

pitchRestricted = true
maxPitch = -.25
minPitch = -85

enforceFloor = true;
floorInCM = 100;

offsetHeightMax = 75000;
offsetHeightMin = 1500;

offsetRadiusMax = 450000;
offsetRadiusMin = 200;

These settings allow you to zoom out while in Avatar combat.

Adjusting Camera Swing

[CONSTRAINTS_AVATAR]
maxCameraCorrectionRotationSpeed=10
minCameraCorrectionRotationSpeed=3.75

These control the swing of the camera when you move your avatar around. By playing with these you can make the camera either stick rigidly to your avatar and move/stop when it does or alow some lag so the camera moves slightly after the avatar and stops slightly after. From BSharp: the first number is the speed of the camera, the second is the slow down at the tail end of the journey.

Avatar Manager

Tab Target Changes

[AvatarManager]
maxAvatarTabTargetRangeM=30
maxAvatarTabTargetFOVDeg=180

These are the default values. To make it work the way it used to in the old avcom, it'd be -1 in the first value to target at any distance, and then 360 in the second value to target anyone around you.

Ship Constraints

Ship Camera Options

[CONSTRAINTS_SHIP]
maxCameraCorrectionRotationSpeed=10
minCameraCorrectionRotationSpeed=3.75
offsetRadiusMax=500000

pitchRestricted = true
maxPitch = -.25
minPitch = -85

enforceFloor = true;
floorInCM = 100;

offsetHeightMax = 75000;
offsetHeightMin = 1500;

offsetRadiusMax = 450000;
offsetRadiusMin = 200;

Designed to alter the ship camera's rotation movement and speed and allow you to zoom out much further than the default settings. Port Battle Commanders may find this option very helpful as will port battle participants.