The clientoptions.json file is the configuration file where the client configuration is stored since Tibia 11. The contents is stored as plain-text JSON and can be modified to change the client configurations while offline. When running and closing the Tibia client, this file gets updated to reflect any changes made to the configuration.

This page aims to document the contents of this file.

actionBarsOptions

allowTooltip

• true
• false

lockActionBars

• true if Action Bars should be locked from drag & drop changing
• false if the Action Bars should have drag & drop enabled

showActionBar1

• true if the Action Bar 1 should be displayed.
• false otherwise.

showActionBar2

• true if the Action Bar 1 should be displayed.
• false otherwise.

showAmount

• true if amount if items should be displayed on Action Buttons.
• false if amount of items should be hidden.

showCooldown

• true if cooldown animation should be displayed
• false otherwise

showCooldownNumber

• true if cooldown countdown should e displayed
• false otherwise

showHotkey

• true if the associated hotkey should be displayed on the Action Button
• false otherwise

showSpellParameters

• true if spell parameters (e.g. creature name in Creature Illusion) should be displayed
• false if no parameter should be displayed

battleListWidgetOptions

battleListSortOrder

This field determines what criteria to sort by. This field contains an array of strings.

Strangely, the client only permits one sort criterion to be selected, although it stores two sort criteria in the array.

The following strings are supported:

• byAgeAscending
• byAgeDescending
• byDistanceAscending
• byDistanceDescending
• byHitpointsAscending
• byHitpointsDescending
• byNameAscending
• byNameDescending

contentHeight

This field stores a number which represents the vertical size of the battle window contents. This does not(?) include the filter height.

showFilters

This field stores a Boolean value: true if the filters are shown in the battle window, false otherwise.

showMonsters

This field stores a Boolean value:

• true if the show monsters filter has been applied; monsters will be shown in the battle window.
• false otherwise; monsters will be hidden.

showNPCs

This field stores a Boolean value:

• true if the show NPCs filter has been applied; NPCs will be shown in the battle window.
• false otherwise; NPCs will be hidden.

showNonSkulledPlayers

This field stores a Boolean value:

• true if the show non-skulled players filter has been applied; players without PVP skulls will be shown in the battle window.
• false otherwise; players without PVP skulls will be hidden.

showPartyMembers

This field stores a Boolean value:

• true if the show party members filter has been applied; party members will be shown in the battle window.
• false otherwise; party members will be hidden.

showPlayers

This field stores a Boolean value:

• true if the show players filter has been applied; players will be shown in the battle window.
• false otherwise; players will be hidden.

chatOptions

This field contains an object with fields corresponding to chat-related settings.

chatModeOn

This field stores a Boolean value:

• true if the Chat Mode is active; the player can write messages.
• false otherwise; players will be able to use their configured hotkeys that would otherwise enter text into the console.

openChannels

This field stores an array of numbers. These numbers have the following meaning:

• 1 -
• 2 - Tutor Channel
• 3 - World Chat
• 4 - English Chat
• 5 - Advertising Channel
• 6 - Advertising-Rookgaard Channel
• 7 - Help Channel

clientOptionsVersion

This field stores a number. Its purpose is not known, but is most likely a value used by the client to determine if any amendments need to be made to the file (e.g. an update to the format).

convertedLegacyConfiguration

This field stores a Boolean:

• true if the user migrated from an older version of Tibia.
• false otherwise.

It is unknown why the client needs to store this information.

gameWindowOptions

This field contains an object with fields corresponding to Tibia Client dimension settings.

clientWindowHeight

This field contains a number, representing the vertical size of the Tibia Client. This field is ignored if the client window is maximized. See also client window width.

clientWindowIsMaximized

This field contains a boolean:

• true if the game window has been maximized.
• false if it has not been maximized.

This is used to determine whether the client should be maximized when the client is opened.

clientWindowPositionX

This field contains a number, representing the Tibia client's vertical position.

clientWindowPositionY

This field contains a number, representing the Tibia client's horizontal position.

clientWindowScreenName

This field contains a string.

clientWindowWidth

This field contains a number, representing the horizontal size of the Tibia Client. This field is ignored if the client window is maximized. See also client window height.

mapWindowHeight

This field contains a number, representing the height of the Game Window

minimapZoomLevel

This field contains a number corresponding to the minimap zoom level.

Possible values:

• -100 (zoomed out 100%)
• 0 (normal)
• 100 (zoomed in 100%)
• 200 (zoomed in 200%)

generalOptions

animatedMouseCursor

This field contains a Boolean:

• true to display the animated cursor hints when hovering over tiles.
• false otherwise; hovering over tiles has no graphical effect.

askBeforeBuyingStoreProducts

This field contains a Boolean:

• true to display a prompt every time a Store item is being purchased.
• false otherwise; no prompt will be displayed.

autoChase

This field contains a Boolean:

• true turns on persistent chasing; if the player moves while chasing, chase opponent state remains unchanged.
• false turns off persistent chasing; if the player moves while chasing, chase opponent state is disabled.

This setting is somewhat counter-intuitive. The name implies that the character automatically chases the opponent, but it's actually the inverse of the flag to turn chasing off, found in the general settings.

controlScheme

This field contains a number, representing the control scheme.

• 0 - Classic controls,
• 1 - Regular controls,
• 2 - Left Smart-Click controls.

desiredIsPremiumPanelVisible

This field contains a Boolean:

• true to display the Premium Features panel.
• false to hide the Premium Features panel; this won't be hidden if the account doesn't meet the requirements to hide it.

dragAndDropDefaultActionIsMoveAll

This field contains a Boolean:

• true to skip the prompt when moving stackable items, and moved the entire stack by default.
• false to prompt the player to decide how many of the top item to move.

highlightMouseTarget

This field contains a Boolean:

• true to display a frame around the tile being hovered over.
• false to hide the frame.

keyboardDelay

This field contains a number, representing the number of milliseconds to delay keyboard inputs.

rotateWithAlt

This field contains a Boolean:

• true if, when holding Alt, keys mapped to character movement will cause your character to change directions.
• false if Alt does not have this effect.

rotateWithCtrl

This field contains a Boolean:

• true if, when holding Ctrl, keys mapped to character movement will cause your character to change directions.
• false if Ctrl does not have this effect.

rotateWithShift

This field contains a Boolean:

• true if, when holding ⇧ Shift, keys mapped to character movement will cause your character to change directions.
• false if ⇧ Shift does not have this effect.

showCooldownBar

This field contains a Boolean:

• true if the cooldown bar is shown at the bottom of the screen.
• false if the cooldown bar is hidden.

stayLoggedInByDefault

This field contains a Boolean:

• true if logins are per-session. You will not have to re-authenticate
• false if logins are not per-session.

systemCursor

This field contains a Boolean:

• true if the cursor is to be controlled by the operating system.
• false if the cursor is to be controlled by the client.

graphicsOptions

ambientLight

This field stores a number, representing the ambient light percentage. Thus, this is a number in the range 0 ≤ ambientLight ≤ 100.

antialiasing

This field contains a Boolean:

• true if the renderer should use antialiasing
• false if the renderer should not use antialiasing.

Antialiasing creates smoother frames at a very small cost to performance. This option does nothing if the game renderer performs no resizing. Even if the game window is resized, the graphics engine needs to be able to support antialiasing for this to work.

borderlessWindow

This field contains a Boolean:

• true if the game is in fullscreen mode.
• false otherwise; the game is in windowed mode.

frameRateLimit

This field contains a number, representing the upper frame rate limit. No matter how powerful the system specifications, the renderer will stop processing frames if this number of frames is reached in a single second.

gameWindowFixedSize

This field contains a Boolean:

• true if the game window should not be stretched or shrinked. The sprites in the game world will be displayed in exact dimensions, multiples of 32x32 pixels. This option is good for taking screenshots, because the sprites will be captured in their exact quality.
• false if the game window can be resized.

levelSeparator

This field contains a number, representing the percentage difference in ambient light for levels that are above or below you. This is a number in the range 0 ≤ ambientLight ≤ 100.

lightEffects

This field contains a Boolean:

• true to display light effects. This uses ambient light and separator to determine how bright the environment should be.
• false to not use the ambient light option. The client will have full light and Light Sources will have no visual effect to the player.

noFrameRateLimit

This field contains a Boolean:

• true to enable the frame rate limit.
• false to disable the frame rate limit; the game will try to draw as many frames as possible.

renderer

This field contains a number, representing the engine used to render the graphics.

• 0 - auto-select
• 1 - OpenGL
• 2 - ?
• 3 - Software
• 4 - DirectX (compatibility)
• 5 - DirectX (performance)

rendererChangeConfirmationRequired

This field contains a Boolean,

• true - The player will need to confirm the selected graphics engine at the next client restart
• false - No confirmation of new graphics engine is required upon next restart

This is changed by the client automatically when a new renderer is selected to pop up the confirmation dialog when the client is restarted.

vSync

This field contains a Boolean,

• true to use the V-Sync option if the system supports it.
• false to disable V-Sync option. Sometimes, V-Sync can cause rendering glitches, so there is an option to disable it.

Using V-Sync is hit-and-miss. It may cause screen-tearing, or it may improve performance.

hotkeyOptions

This field is the largest because it contains all hotkey sets.

autoSwitchHotkeyPreset

This field contains a Boolean:

• true - if there's a Hotkey Preset with the same name as the character that logged in, it will be selected
• false - the Hotkey Preset will not be changed based on the character's name

currentHotkeySetName

This field contains a string, representing the name of the current active hotkey preset.

hotkeySets

This field contains an object. Each of the object keys are names of hotkey presets, and their values are objects containing the data for the corresponding preset.

PresetName

The name of this object varies; it corresponds to the name of a hotkey preset. It contains an object with two keys:

• chatOn - an array of hotkeys that are active when the chat mode is on.
• chatOff - an array of hotkeys that are active when the chat mode is off.

The Hotkey Specification section documents the specification for hotkeys.

showStaticHotkeysFirst

This field contains a Boolean:

• true if the hotkey configuration dialog should list static hotkeys before all others;
• false - otherwise; static hotkeys will be displayed on the bottom.

Static hotkeys are:

• Battle List: Attack Next Target
• Battle List: Attack Previous Target
• Chat Channel: Close Current Channel
• Chat Channel: Next Channel
• Chat Channel: Open Channel List
• Chat Channel: Open Help Channel
• Chat Channel: Open NPC Channel
• Chat Channel: Open Server channel
• Chat Channel: Previous Channel
• Chat Channel: Show Default Channel
• Chat Mode: Set to Chat Off
• Chat Mode: Set to Chat On
• Chat Mode: Set to Chat On*
• Chat Text: Copy to clipboard
• Chat Text: Select All
• Chat: Send current chat line
• Chat: Toggle Show Server messages in Current Channel
• Combat Mode: Set to Balanced
• Combat Mode: Set to Defensive
• Combat Mode: Set to Offensive
• Dialogs: Open Bugreport
• Dialogs: Open Ignore List
• Dialogs: Open Options - General
• Dialogs: Open Options - Graphics
• Dialogs: Open Options - Help
• Dialogs: Open Options - Hotkeys
• Dialogs: Open Options - Messages
• Dialogs: Open Prey Dialog
• Dialogs: Open Questlog
• Minimap: Center
• Minimap: One Floor Down
• Minimap: One Floor Up
• Minimap: Scroll East
• Minimap: Scroll North
• Minimap: Scroll South
• Minimap: Scroll West
• Minimap: Zoom In
• Minimap: Zoom Out
• Misc.: Activate Lenshelp
• Misc.: Change Character
• Misc.: change Outfit
• Misc.: Clear oldest messages from Game Window
• Misc.: Logout
• Misc.: Next Hotkey Preset
• Misc.: Previous Hotkey Preset
• Movement: Go East
• Movement: Go North
• Movement: Go North-East
• Movement: Go North-West
• Movement: Go South
• Movement: Go South-East
• Movement: Go South-West
• Movement: Go West
• Movement: Mount / Dismount
• Movement: Stop All Actions
• PvP Mode: Set to Dove
• PvP Mode: Set to Red Fist
• PvP Mode: Set to White Hand
• PvP Mode: Set to Yellow Hand
• UI: Toggle Creature Names and bars
• UI: Toggle FPS / lag indicator
• UI: Toggle Fullscreen
• Windows: Toggle Battlelist
• Windows: Toggle Prey Window
• Windows: Toggle Skills Window
• Windows: Toggle VIP Window

huntingSessionAnalyserWidgetOptions

contentHeight

impactAnalyserWidgetOptions

contentHeight

lootAnalyserWidgetOptions

contentHeight

lootTrackerWidgetOptions

contentHeight

messagesOptions

showEventMessagesInConsole

This field stores a Boolean value:

• true to enable the display of event messages in the console.
• false to disable the display of event messages in the console.

Event messages include:

• Messages shown upon login (last visit, offline training),
• Most quest-related messages that occur when interacting with the environment (as opposed to NPCs),
• Updates to the quest log,
• Messages shown when earning rewards,
• Messages shown when earning achievements,
• Messages about raids

showInfoMessagesInConsole

This field stores a Boolean value:

• true to enable the display of informational messages in the console.
• false to disable the display of informational messages in the console.

Informational messages include:

• Look text,
• Hotkey use-item text

showLevelsInConsole

This field stores a Boolean value:

• true to enable the display of player levels in the console; player levels will be shown in the console when they cast a spell or send a message.
• false to disable the display of player levels in the console.

showLinkCopyWarning

This field stores a Boolean value:

• true to enable the warning when copying links to the system clipboard.
• false to disable the warning when copying links to the system clipboard.

showMessagesInGameWindow

This field stores a Boolean value:

• true to enable the display of messages in the game window; event messages, info messages and creature sounds will be displayed in the game window.
• false to disable the display of messages in the game window; no messages will be shown in the game window.

showOthersSpellsInGameWindow

This field stores a Boolean value:

• true to enable the display of other players' spell casts in the game window.
• false to disable the display of other players' spell casts in the game window.

showOwnSpellsInGameWindow

This field stores a Boolean value:

• true to enable the display of your own spell casts in the game window.
• false to disable the display of youw own spell casts in the game window.

showPrivateMessagesInGameWindow

This field stores a Boolean value:

• true to enable the display of private messages in the game window.
• false to disable the display of private messages in the game window.

This setting respects your blacklist/whitelist.

showStatusMessagesInConsole

This field stores a Boolean value:

• true to enable the display of your own status messages in the console.
• false to disable the display of your own status messages in the console.

showStatusMessagesOfOthersInConsole

This field stores a Boolean value:

• true to enable the display of other players' status messages in the console.
• false to disable the display of other players' status messages in the console.

Status messages of others include:

• Damage other players take,
• Damage other players heal,
• Damage other players deal

showTextualEffects

This field stores a Boolean value:

• true to enable the display of textual effects on the game window.
• false to disable the display of textual effects on the game window.

Textual effects include:

• Damage dealt by yourself, creatures or other players,
• Damage healed by yourself, creatures or other players,
• Mana recovered by yourself.

Does not include:

• Mana recovered by another player.

showTimestampsInConsole

This field stores a Boolean value:

• true to enable the display of timestamps on console messages.
• false to disable the display of timestamps on console messages.

The time displayed is based on your system time.

networkOptions

useProtectedNetworkRoute

This field stores a Boolean value:

• true to use the external DDoS mitigation server as a relay when connecting to the Tibia servers.
• false to connect to the Tibia servers directly.

npcTradeOptions

allowSellingEquippedItems

This field stores a Boolean value:

• true to include equipped items when selling with NPCs; you will be able to sell equipped items.
• false to exclude equipped items when selling to NPCs; you will be unable to sell equipped items.

ignoreCapacityWhenBuying

This field stores a Boolean value:

• true to consider capacity when buying items.
• false to ignore capacity when buying items; items may drop to the floor.

This setting doesn't work as effectively as one would expect. The change in currency may consume additional capacity, which is not accounted for by this setting. This means that items may still drop to the floor in some situations.

purchaseShoppingBagWhenBuying

This field stores a Boolean value:

• true to purchase the minimum amount of Shopping Bags to store the purchased items in.
• false to place the items in your backpack without purchasing a Shopping Bag.

sortFieldWhenBuying

This field stores a string value and determines how the buy window of the NPC Trades dialog is sorted.

• name - sort the inventory list by item name,
• price - sort the inventory list by item price,
• weight - sort the inventory list by item weight,

sortFieldWhenSelling

This field stores a string value and determines how the sell window of the NPC Trades dialog is sorted.

• name - sort the inventory list by item name,
• price - sort the inventory list by item price,
• amount - sort the inventory list by the amount of that item carried.

panelOptions

controllButtonsVisible

This field stores a Boolean value:

• true if the control buttons are visible,
• false if the control buttons are hidden.

Controls buttons include:

• Buttons to show the windows for skills, battle, VIP, quest log, unjustified kills and prey window,
• Button to show client options,
• Button to log out.

playerOptions

chaseModeEnabled

This field stores a Boolean value:

• true to chase the attacked target.
• false to not chase the attacked target.

combatMode

This field stores a number, representing the combat mode.

• 1 - Offensive mode.
• 2 - Balanced mode,
• 3 - Defensive mode.

minimizeInventory

This field stores a Boolean value:

• true to hide the inventory,
• false to show the inventory.

preyWidgetOptions

contentHeight

This field stores a number representing the height of the prey window. It has a lower limit of 38.

questTrackerWidgetOptions

contentHeight

This field stores a number representing the height of the quest tracker.

sidebarPanelsMangerOptions

panelsOrder

This field contains an array of strings. Each string represents the name of a panel.

The following panel names are supported:

• minimap
• hitpointManabar
• buttons
• inventoryStatus

sidebarWidgetsMangerOptions

openWidgetsOrder

skillsWidgetOptions

contentHeight

This field stores a number, representing the height of the skill window. There is a lower limit of 38.

invisibleProgressBars

This field stores an array of strings. Each string contains the name of a progress bar. These progress bars will not be shown in the skill window.

Names of progress bars:

• level
• magiclevel
• shielding
• distancefighting
• clubfighting
• swordfighting
• axefighting
• fistfighting
• fishing
• stamina
• offlinetraining

spellListWidgetOptions

contentHeight

This field stores a number, representing the height of the spell window.

showAttackSpellGroup

• true
• off

showConjureSpellGroup

• true
• off

showDruidSpells

• true
• off

showFreeSpells

• true
• off

showHealingSpellGroup

• true
• off

showKnightSpells

• true
• off

showOnlyCurrentLevel

• true
• off

showOnlyCurrentProfession

• true
• off

showPaladinSpells

• true
• off

showPowerstrikesSpellGroup

• true
• off

showPremiumOnlySpells

• true
• off

showSorcererSpells

• true
• off

showSupportSpellGroup

• true
• off

showUnkownSpells

• true
• off

statusOptions

creatureHudEnabled

This field stores a Boolean value:

• true to show the creature's HUD.
• false to hide the creature's HUD.

The creature's HUD shows the name, health, marks, and icons of creatures and NPCs. Each of these can be individually turned off.

creatureShowHealth

This field stores a Boolean value:

• true to show the creature's health on the HUD.
• false to hide the creature's health on the HUD.

creatureShowMarks

This field stores a Boolean value:

• true to show the creature's marks on the HUD.
• false to hide the creature's marks on the HUD.

creatureShowName

This field stores a Boolean value:

• true to show the creature's name on the HUD.
• false to hide the creature's name on the HUD.

npcShowIcon

This field stores a Boolean value:

• true to show NPC icons on the HUD.
• false to hide NPC icons on the HUD.

playerHudEnabled

This field stores a Boolean value:

• true to show the player's HUD.
• false to hide the player's HUD.

The player's HUD shows the name, health, mana and marks. Each of these can be individually turned off.

playerHudStyle

This field stores a string representing the HUD style:

• bar to show the player's health and mana as bars below the character name,
• arc to show the player's health and mana as arcs around the character.

playerShowHealth

This field stores a Boolean value:

• true to show the player's health on the HUD.
• false to hide the player's health on the HUD.

playerShowMana

This field stores a Boolean value:

• true to show the player's mana on the HUD.
• false to hide the player's mana on the HUD.

playerShowMarks

This field stores a Boolean value:

• true to show the player's marks on the HUD.
• false to hide the player's marks on the HUD.

playerShowName

This field stores a Boolean value:

• true to show the player's name on the HUD.
• false to hide the player's name on the HUD.

showFrames

This field stores a Boolean value:

• true to show the frames around the player and creatures when being interacted with.
• false to hide the frames around the player and creatures when being interacted with.

These frames are the red, green and black squares around creatures that are being attacked, followed, or are attacking you. For the PvP frames, see Show Frames PvP.

Note: Due to a bug, this option is not configurable in the settings. To change it, you must edit the JSON file.

showFramesPvp

This field stores a Boolean value:

• true to show the PvP frames around the player and creatures.
• false to hide the PvP frames around the player and creatures.

survey

id

status

vipWidgetOptions

contentHeight

This field contains a number, representing the height of the VIP window.

hideOfflineVips

This field contains a Boolean value:

• true to hide offline VIPs.
• false to show offline VIPs.

vipSortOrder

This field contains an array of strings. Each string represents a sort criterion.

List of supported sort criteria:

• byState - sort by status
• byType - sort by type
• byName - sort by name

wasteAnalyserWidgetOptions

contentHeight

This field contains a number, representing the height of the Supply Analyser.

whiteBlacklistOptions

blacklistedNames

This field contains an array of strings. Each string stores a character and/or NPC name. These characters/NPCs will be ignored while the ignore list is active.

whitelistedNames

This field contains an array of strings. Each string stores a character and/or NPC name. These characters/NPCs will be allowed to message you despite having private messages ignored.

xpAnalyserWidgetOptions

contentHeight

This field contains a number, representing the height of the XP Analyser.

Hotkey Specification

Hotkeys are specified as an object with two fields, as described in the following sections.

keysequence

This field contains a string, representing a button pressed state.

Values are in the format: "<modifier>+<key>" (without the angle brackets).

List of modifiers:

• Ctrl = Ctrl
• Alt = Alt
• Shift = ⇧ Shift
• Num

List of keys:

• A-Z
• Backtab = Tab ↹ (only with ⇧ Shift modifier)
• Up, Down, Left, Right = ↑, ↓, ←, →
• Home, End
• Enter = ↵ Enter (only with Num modifier)
• F1-F12
• PgUp / PgDown
• Return = ↵ Enter
• Space
• Esc
• Backspace = ← Backspace
• CapsLock = ⇪ Caps Lock
• Tab = Tab ↹
• Ins = Insert
• Del = Delete
• ... and more

actionsetting

This field contains an object with details on what happens when this hotkey is pressed. The specifications of this object depend on what the hotkey is trying to perform.

chatText

This field specifies that the hotkey is to fill the console message box with the specified message. Hotkeys of this type should also have the Send Automatically field.

sendAutomatically

This field specifies that the hotkey is to send the contents of the message automatically when triggered. This is used in conjunction with Chat Text.

action

This field specifies a special type of action to perform.

Actions:

• AttackNextTarget
• AttackPreviousTarget
• Bugreport
• ChangeCharacter
• ChatModeTemporaryOn
• ClearOldestMessage
• CloseCurrentChannel
• Copy
• GoEast
• GoNorth
• GoNorthEast
• GoNorthWest
• GoSouth
• GoSouthEast
• GoSouthWest
• GoWest
• Logout
• MinimapFloorDown
• MinimapFloorUp
• MinimapScrollEast
• MinimapScrollNorth
• MinimapScrollSouth
• MinimapScrollWest
• MinimapZoomIn
• MinimapZoomOut
• NextChannel
• NextHotkeyPreset
• OpenChannelList
• OpenHelpChannel
• PressEnterInChat
• PreviousChannel
• SelectAll
• ShowDefaultChannel
• ShowIgnorelist
• ShowLenshelp
• ShowOptionsHotkeys
• ShowPrey
• ShowQuestlog
• StopPlayer
• ToggleBattlelist
• ToggleCreatureHudsVisible
• ToggleFPSLagIndicator
• ToggleFullscreen
• ToggleMounted
• ToggleShowServermessagesInCurrentChannel
• ToggleSkillsWidget
• ToggleVipWidget

useObject

This field specifies an item that should be used. The value of this field is a number corresponding to an item ID. The Use Type field should be used as well.

useType

This field contains a string specifying what to do with the item used by the hotkey. This is used in conjunction with the Use Object field.

Use Types:

• UseOnTarget
• UseOnYourself
• Use
• SelectUseTarget
• Equip