Nwnplayer.ini
From NWNWiki
Contents |
[edit] Description
The nwnplayer.ini file controls and saves the settings chosen in the main game client for all modes of play: single-player, multi-player, and server (not the stand-alone server). Below is a listing of the different sections and fields that make up the file.
[edit] File layout
[edit] [Game Options]
This section contains fields which control options for the player client. It also contains fields which "unlock" the campaign modules, allowing users to edit them in the toolset.
- CODEWORD=hacktastic
- This line unlocks the modules of the original campaign. The possible values for this code word (in order of progress through the campaign) are rangersandhamsters, gnomelover, andiwantapony, chimpfactor5, notzesty, setinjello, and hacktastic.
- CODEWORD XP1=ffrodriguez
- This line unlocks the modules of the Shadows of Undrentide campaign. The possible values for this code word (in order of progress through the campaign) are canyousaymonkey, hickorysticks, and ffrodriguez.
- CODEWORD XP2=barkeater
- This line unlocks the modules of the Hordes of the Underdark campaign. The possible values for this code word (in order of progress through the campaign) are bionoel, biojello, and barkeater.
- ClientChatLogging=0
- Setting this to 1 will add all player chat heard by the client to the client log. The file can be found in the "logs" directory of the NWN base install path (eg. nwnclientLog1.txt). Note that the log will overwrite itself; preventing long term chat logging over multiple play sessions. This can be prevented by renaming the log after every session, or using a Log Rotator [1].
- Client CPU Affinity=0
- Specifies the CPU the game client will use on a multi-core computer. Cores are numbered from 0 to the number of cores minus 1. As of patch 1.69, a value of '-1' is treated as '0' and a value of '-2' indicates that the game should use the default affinity (if any) provided by the operating system. (Added in patch 1.67.)
- Death Logging=0
- Changing the '0' to '1' causes all creature deaths to be recorded in the log file (defaults to off). (Added in patch 1.69.)
- Debug Mode=1
- This line used to enable the use of DM console commands in single player, but it is no longer necessary.
- In-game Text Swear Filter=0
- Changing the '0' to '1' enables the in-game text swear filter. (Added in patch 1.69; only supports English.)
- Visible Cloaks=1
- Changing the '1' to '0' causes the visible cloaks introduced in version 1.68 to not render. (Added in patch 1.69.)
[edit] [Chat Colors]
Allows different colors for different types of messages in the chat window.
Example:
[Chat Colors]
TalkColor=240,240,240
ShoutColor=255,239,80
WhisperColor=128,128,128
TellColor=32,255,32
ServerColor=176,176,176
PartyColor=255,102,1
DMColor=16,223,255
[edit] [Control Options]
This section contains fields which contain settings for the in-game camera.
- EnableDialogZoom=1
- Setting this to 0 will prevent the camera from zooming / panning during in-game conversation dialogs. This can be useful in a server setting where players have access to menus, as it can be frustrating managing the camera angle.
[edit] [Profile]
This section stores information about the GameSpy screens when a user accesses multiplayer.
- Client Port=5121
- This is the port the client will use to connect to servers. If there is more than one client connected through a (home) network, these ports must be different for each client.
- ServerList Show All Versions=0
- Setting this to '1' will enable servers of differing versions to be listed when browsing servers.
Note: Enabling this option can result in the game not retrieving proper game versions, and thus disable connecting to some servers.
[edit] [Server Options]
This section stores server information settings when server games are launched from inside the main game client.
| Field name | Possible values | Comments |
|---|---|---|
| BackupSavedChars=0 | 0, 1 | backs up saved chars on exit * 0 - no backup * 1 - backup |
| ShowDMJoinedMessage=1 | 0, 1 | shows a server message when the DM joins * 0 - no message * 1 - display message |
| Disallow Shouting=0 | 0, 1 | disallow channel shout for player on chat bar (dm still able to shout) * 0 - allows shout channel * 1 - disables shout channel |
| CD Banned Behavior=0 | 0, 1 | |
| Game Port=5121 | 5121+ | sets which port the game listens on |
| Max Players=18 | 1-64 | sets the maximum number of players |
| Server Name=**** | sets the server name (replace ****) | |
| GameSpy Enabled=1 | 0, 1 | sets whether or not server posts to GameSpy * 0 - no * 1 - yes |
| Game Type=0 | 0-12 | GameSpy category the server will display in
|
| Disable AutoSave=0 | 0, 1 | Disables server autosave * 0 - do not disable * 1 - disable |
| ServerAdminPassword=***** | sets password for the server admin (replace *****) | |
| MinCharLevel=1 | 1-40 | the minimum level a character can be and enter the server |
| MaxCharLevel=20 | 1-40 | the maximum level a character can be and enter the server |
| AllowLocalChars=1 | 0, 1 | allow local vault characters * 0 - no (server vault) * 1 - yes |
| PauseAndPlay=0 | 0, 1 | allow players to pause like in single-player * 0 - no * 1 - yes |
| One Party Only=0 | 0, 1 | allow only one party * 0 - no (allow multiple parties) * 1 - yes (only one) |
| ItemLevelRestrictions=1 | 0, 1 | enforce item level restrictions * 0 - do not enforce ILR * 1 - enforce ILR |
| Enforce Legal Characters=1 | 0, 1 | enforce legal characters * 0 - do not use ELC * 1 - use ELC |
| Auto Save Interval=0 | 0-?? | time between autosaves (in minutes) * 0 - disable timed autosave |
| MPEnabled=1 | 0, 1 | enable Message Private, talk between players (i.e. the tell channel) * 0 - no * 1 - yes Not implemented. |
| DMPassword=***** | sets password for DMs (replace *****) | |
| PlayerPassword=***** | sets password for players (replace *****) | |
| PVP Setting=1 | 0, 1, 2 | sets the servers default pvp setting * 0 - no pvp * 1 - party pvp * 2 - full pvp |
| Game Region=0 | ||
| ServerDownTimer=180 | 0-?? | how long a client should wait before reporting the server as unreachable (down) |
| Suppress Base Servervault=0 | 0, 1 | |
| Reload Module When Empty=1 | 0, 1 | Module is reloaded when the last person logs out. * 0 - do not reload * 1 - reload |
| RotateServerLog=0 | 0, 1 | Server logs are rotated/overwritten on server restart. |
| 2DA Cache Size=10 | 1-?? | Specifies the number of .2da files to be cached for use with Get2DAString(). (Added in patch 1.69.) |
| Always Reset Encounter Spawns=0 | 0, 1 | When set to '1', an encounter will recalculate which creatures to spawn every time it spawns creatures. If left at '0' (the default), encounters sometimes retain this calculation from an earlier triggering, potentially causing level-inappropriate creatures to be spawned. (Added in patch 1.69.) |
| Hide Hit Points Gained=0 | 0, 1 | When set to '1', the hit points gained are not displayed in the level up summary window (defaults to off). (Added in patch 1.69.) |
| Max Hit Points=1 | 0, 1 | When set to '1', players always roll the maximum on their hit die at level up (defaults to off). (Added in patch 1.69.) |
| Restore Spell Uses On Login=0 | 0, 1 | When set to '1', a player character's spell slots are preserved across logins to a server vault server (defaults to off). (Added in patch 1.69.) |
[edit] [Banned Ips]
This section stores the IP Addresses that have been banned from accessing this server.
[edit] [Banned Players]
This section stores the player names that have been banned from accessing this server.
[edit] [Banned CD Keys]
This section stores the public CD Keys that have been banned from accessing this server.
[edit] [Favorites Page]
This section stores the list of servers that have been added to the Favorites page in GameSpy.
[edit] [History Page]
This section stores the list of servers that have been accessed.
[edit] [Keymapping]
This section stores the user settings of which actions are performed by what keystroke on the keyboard.
[edit] [Script Options]
This section allows a builder to create logs to aid debugging and optimizing scripts. (Added in patch 1.69.)
Note: At most, only one of the options in this section should be enabled at a time.
- Enable Logging=0
- Changing the '0' to '1' causes each script to be logged as it executes. This will degrade game performance and should only be used for script debugging purposes (e.g. to determine the last script executed before a module freezes).
- Enable Profiling=0
- Changing the '0' to '1' causes script profiling data to be collected and recorded in the log file. This will degrade game performance and should only be used for script optimization purposes (e.g. to determine which scripts have the biggest performance impact on a module).
[edit] [Trap Colors]
This section allows a player to change the colors used to depict traps, so that red/green color blind users do not get killed by traps unexpectedly. (Added in patch 1.69.)
- FriendlyColor=0,255,0
- HostileColor=255,0,0
- These are RGB color codes, ranging from 0 to 255. That is, the first number indicates the amount of red, the second green, and the third blue, each measured on a scale from 0 to 255.
