Difference between revisions of "Config.ini overrides"
m (→Advanced Overrides: Fixed BNET docs URL's) |
m (1 revision imported) |
(No difference)
|
Latest revision as of 08:20, 1 December 2017
A Config.ini Override is a special setting that can be activated by manually editing your config.ini file.
Contents
.ini File Format
.ini files are formatted as follows:
[SectionName] KeyName=value Key2Name=value2
... and so on. StealthBot has 6 primary sections, each containing several keys.
Available Overrides
Main
The [Main] section of the StealthBot config defines the bot's basic settings such as username, password, etc.
There is one config override that can be placed in the [Main] section:
Key | Description |
---|---|
AutoFilterMS | sets the automatic filtering delay |
Position
The [Position] section of the config stores the data that controls where the bot window goes when it is loaded. These settings are based off of the window's last known position. There are no config hacks that belong in this section.
Other
The [Other] section of the config controls various settings including logging and auto-moderation features.
Key | Description |
---|---|
AutoCompletePostfix | sets a post-fix to automatically be appended to the end of auto-completed usernames |
CaseSensitiveFlags | forces flags to be case sensitive. (i.e. flag b is not the same as flag B) |
ChatDelay | sets the default chat delay |
DefaultSafelistGroup | sets safelisted users to the specified group |
DefaultShitlistGroup | sets shitlisted users to the specified group |
DefaultTagbansGroup | sets tagbanned users to the specified group |
HideClanDisplay | hides clan tags from the channel list display |
HidePingDisplay | hides ping icons from the channel list display |
MathAllowUI | allows UI related commands to be used in the math/eval command. |
MediaPlayer | sets the default media player |
RetainOldBans | keeps bans on the banlist even after the operator that made that ban leaves the channel |
ShowStatsIcons | if set to N no stats icons (e.g. peons) will be shown in the channel list |
StoreAllBans | stores bans from all operators in the channel |
WinampPath | overrides the location to look for WinAmp. |
FlashOnCatchPhrases | flashes the window when a catch phrase is seen |
Override
The [Override] section of the config allows users to customize certain values that are used in the bot. These values include the location to find alternative BNLS servers, the version bytes to use, and the name used as the owner for the bot's CD key.
Key | Description |
---|---|
W3VerByte | Overrides the WAR3/W3XP version byte with the given value. |
D2VerByte | Overrides the D2DV/D2XP version byte with the given value. |
SCVerByte | Overrides the STAR/SEXP version byte with the given value. |
W2VerByte | Overrides the W2BN version byte with the given value. |
OwnerName | Changes the name given to Battle.net as the owner of the CD key. |
DisableSBNews | Disables the loading of news when the bot starts up. |
AutoModerationSafelistValue | Sets the amount of access required to be automatically safelisted (default: 20). |
NoRTBAutomaticCopy | disables automatic copying of highlighted text from the RTB |
WardenDebug | Enables debugging for Warden.dll. |
ScriptViewer | Overrides the default program used to view script files. |
SetKeyIgnoreLength | Ignores the length checks on CD keys. |
LowerCasePassword | Converts the bot's password to lower case before hashing it (default: enabled). |
AddQLinePostfix | Changes the default string added to split up long messages ("[more]"). |
DisableScripts | Disables the scripting system, scripts menu, and does not load any script components. This also disables access to the SSC and BotVars from /exec. |
AddQMaxLength | Overrides the maximum length allowed for chat messages sent to Battle.net. Must be greater than 0, but less than 223. |
BNLSSource | Use a different list of BNLS servers than the default one, for the Automatic BNLS Server Finder (http://stealthbot.net/sb/bnls.php). |
SecondsToIdle | Override the default value of BotVars.SecondsToIdle. After this many seconds, a user is marked as "idle" in the channel list (default: 600 seconds, which equals 10 minutes). |
D2NamingFormat | Override the default Diablo II naming convention format (default value: char (*name)). It accepts the values char = character name, name = Battle.net name, and title = character title. To avoid strange bot behavior, always include name in the value. |
SetBotStatstring | Override the statstring sent in SID_ENTERCHAT. This is for Diablo 1 connections to provide custom, or valid stats. All other products ignore this value and use their own. |
PredefinedGateway | Tells StealthBot what its namespace is ("Azeroth", "USEast", etc). If set, the bot will not join an invalid channel and attempt to /whois itself during log in. For all servers this override will increase log in speed. For private servers, this override will cause StealthBot to not join the "home:number" channel. On official servers it is recommended to use the namespace that the bot is actually on, or risk running into strange behavior. |
RegisterEmailDefault | StealthBot will register this E-mail to new accounts it creates. If not provided, it will prompt you with a popup instead (default behavior) (build 288+). |
RegisterEmailAction | Changes the behavior of E-mail registration (build 288+).
The value Prompt (default) specifies the default behavior where it'll either automatically register the value in RegisterEmailDefault, or prompt the user if nothing is there. The value NeverAsk will cause the bot to register an empty value if Battle.net asks, thus causing Battle.net to not ask again. The value AskLater will cause the bot to ignore Battle.net's registration request completely. Battle.net will ask the bot (or another client) again on next logon. |
StoredKeys
The [StoredKeys] section of the config keeps record of any CD keys you put into the CD key manager so that they can be easily accessed. There are no overrides that can go in this section.
FilePaths
The location of most of the bot's major files and folders can be specified through a config hack in the [FilePaths] section. All overrides in this section have the following format:
[FilePaths] folder=path filename.ext=path
where "filename.ext" is the name of the file being relocated (users.txt, commands.xml, etc...) and "path" is the full path to the location of the file.
A common use for this setting is to allow multiple bots to share the same user database, in which each bot would need an override in its config file specifying the shared database file.
Example:
[FilePaths] users.txt=C:\StealthBot\globalusers.txt
Setting an Override
All toggle overrides (true/false) can be set by using Y and N. For all other overrides that require their own values, simply put the value after the '=' sign.
Advanced Overrides
There are a few overrides that can be added to the config to control how StealthBot handles its connection to the server. Using these overrides incorrectly can result in an IP ban from the server, so only use them if you know what you are doing or have been instructed to by a StealthBot Technician.
Section | Key | Description |
---|---|---|
Override | ForceDefaultLocaleID | changes the value of the computer's locale ID sent to Battle.net in SID_LOCALEINFO (0x12) and SID_AUTH_INFO (0x50). |
Override | UDPString | changes the value of the UDP code sent in SID_UDPPINGRESPONSE (0x14). |
Override | SpawnKey | tells Battle.net that the CD key being used is for SPAWN. |
Override | XXProtID | changes the value of the Protocol ID sent in SID_AUTH_INFO (0x50)). (default: 0)1 |
Override | XXPlatID | changes the value of the Platform ID sent in SID_AUTH_INFO (0x50), SID_STARTVERSIONING (0x06), and SID_REPORTVERSION (0x07). (default: 'IX86')1 |
Override | XXProdLang | changes the value of the Product Language sent in SID_AUTH_INFO (0x50). (default: 0)1 |
Override | Ignore0x51Reply | ignores the reply to SID_AUTH_CHECK (0x51) aka the "version check." |
Override | XXLogonSystem | changes the logon system used for the specified product.1 |
There are also several overrides for tuning the message queue.
Notes
1: In these overrides, XX is replaced with the 2 digit product key of a product. (W3, W2, SC, D2)