The property editor contains a list of configuration settings, grouped into several sections as described below. To edit a property value, either double-click it or select it and then click the Enter key on your keyboard or the Edit button on the toolbar. When a property is selected in the list, a brief description of it is displayed in the yellow box just below the list. Note: some properties cannot be changed while the game server is online. In those cases, the Ok button on the editor dialog will be disabled.
Site name - Enter a unique name for your poker site, up to 50 characters. This name will appear in the player module and in the server directory at PokerMavens.net (if the Directory Listing property is set to Yes).
Site description - This is an optional site description, up to 500 characters. This text is displayed when your site is selected in the server directory at PokerMavens.net (if the Directory Listing property is set to Yes).
Site password - Optional site password. Leave blank if your site will be open to the public.
Site news - Optional site news. This text will be displayed to each player when they login if it has been edited since their previous login. They can also view it any time by selecting the news option from the client help menu. The following HTML tags can be used to markup your text:
<a> - (anchor) - Use this tag to link to another site. Always use the target="_blank" attribute so that a new window is opened. Otherwise the contents of the game site will be replaced and the player will disconnect. Unlike regular HTML, this tag does not style the link with an underline or a different color so that has to be done manually. Example: <a href="http://www.google.com" target="_blank"><u>Google</u></a>
<b> - (bold) - Use this tag to bold text. Example: <b>Hello</b>
<font> - (font) - Use this tag to change the color and/or point size of text.
Example: <font color="#FF0000" size="20">Hello</font>
<i> - (italic) - Use this tag to make italic text. Example: <i>Hello</i>
<p> - (paragraph) - Use this tag to make a paragraph. Example: <p>Hello</p>
<u> - (underline) - Use this tag to underline text. Example: <u>Hello</u>
Directory listing - Select Yes to list your site at PokerMavens.net, subject to the terms in the License Agreement. If you select a site password then your site will be listed in the private section. Trial versions are listed at PokerMavens.net/trial instead.
Directory key - Enter your custom directory key that was provided by Briggs Softworks. This will allow your site to be listed in the server directory at PokerMavens.net.This feature is not used in the Trial version of Poker Mavens.
Support email - This is an optional email address where players can contact you via the Help menu in the Player Module. Leave blank for none.
Support web site - This is an optional web site address (include the http:// prefix) where players can get more information about your site. A link to this site will appear in the Help menu in the Player Module. Leave blank for none.
Internet IP address - This is your Internet IP address that your players will connect to. Click the Lookup button to get this value automatically. If your site has its own domain name, you can enter it instead.
Auto lookup IP - If this property is set to Yes, the software will perform the Internet IP lookup function automatically for you each time you put the server online. Set this to No if you were provided a static Internet IP address from your Internet service provider.
File port - This is your HTTP port number that will serve files to the player's web browser. The default value is 8087. This value cannot be changed while the game server is running.
Packet port - This is your TCP/IP port number that will be used to transfer game packets to and from the client Flash module. The default value is 8088. This value cannot be changed while the game server is running.
Local IP address - This is one or more local IP's to bind to your server. Check the box next to an IP to include it. The localhost (127.0.0.1) IP can be used for local testing. This value cannot be changed while the game server is running.
Max connections - This is the maximum number of connections allowed at once into your site. The default is 50.
Max idle minutes - This is the maximum number of minutes that a player's connection can be idle before it is automatically terminated. Set to 0 to disable. Idle time is determined by the last packet received from a player as recorded in the Last Action column on the Connections tab.
Allow duplicate IPs - Select No to prevent multiple logins from the same IP address.
Allow duplicate PCs - Select No to prevent multiple logins from the same computer. Note: client computers are assigned a random 32-bit identification number (PC ID) that is saved locally on the first login attempt. It is possible (but not likely) for more than one computer to have the same PC ID.
Allow remote administration - Use this feature to manage your poker server from the web browser of any remote computer connected to the Internet. Simply append "/admin" to the end of your Internet URL (or Local URL if inside your own network) and enter the administrator password. For example, if your IP is 123.45.67.89 and your File port is 8087 then point your web browser to "http://123.45.67.89:8087/admin" to connect to your server. You will be presented with a web interface that contains most of the functions that are available in the local Windows server module.
Administration password - You must enter a password here to use the remote administration feature.
Administration whitelist - Specify a list of IP addresses (one per line) that can access the remote administration interface. This is a security feature than can prevent unauthorized access to your game server even if the administration password becomes compromised. Leave this setting blank to allow access from any IP address.
Enable API - Select Yes to enable the Application Programming Interface, which allows you to control the server via an extrernal program. You must specify an API Password to enable this feature.
API password - You must enter a password here to use the API feature.
API whitelist - Specify a list of IP addresses (one per line) that can access the API commands. This is a security feature than can prevent unauthorized access to your game server even if the API password becomes compromised. Leave this setting blank to allow access from any IP address.
Autostart server at bootup - Select Yes and the server will automatically start up and run in the system tray on the next bootup.
Data folder - This is the base folder to store program data files. This includes ring game and tournament settings, player accounts and blacklists, hand histories, and event logs. Leave blank to specify the default %APPDATA%\Poker Mavens\ folder where %APPDATA% is specific to your Windows user name.
Play login chime - Select Yes to play a chime each time a player logs into your server.
Require session keys - Select Yes to only allow automated player logins via the SessionKey parameter generated through the API. Select No to allow players to login manually with their regular account password in addition to the automated methods. See the Technical Information/Misc topic for more information.
Allow new accounts - Select Yes to allow new players to create an account at your site. Otherwise, new accounts can only be created by the administrator from the Accounts tab or via the API.
Allow account changes - Select Yes to allow players to change settings in their account (avatar, real name, gender, location, password, and email). Otherwise, accounts can only be edited by the administrator from the Accounts tab or via the API.
Starting balance - This is the amount of chips given to new players. Buy-ins are debited from this balance when a player joins a ring game or a tournament. Any chips they still have when leaving a ring game (or winnings from a tournament) are credited back to their balance. The default value is 0.
Allow negative balance - Set to Yes to allow player balances to go below zero. Otherwise, players will not be able to play if they run out of chips until the administrator manually resets their account balance.
Allow balance resets - Select Yes to allow players to request more chips when their balance drops below the starting balance value. "Starting balance" value must be greater than 0 and "Allow negative balance" must be disabled to use this feature.
Balance reset minutes - This is the minimum time (in minutes) that players must wait before requesting more chips when "Allow balance resets" is enabled.
Allow chip transfers - Select Yes to allow player to player chip transfers via the client lobby menu. "Allow negative balance" must be disabled to offer this option.
Allow password recovery - Select Yes to display an "Email My Password" button in the client login dialog. You must fill in the SMTP settings to use this feature.
Validate email addresses - Select Yes to force email address validation. Players will be required to enter a code (sent to their email account) before they can login for the first time or after they change their email address. You must fill in the SMTP settings to use this feature.
Allow duplicate email addresses - Select No (the default value) to prevent a player from creating an account that uses the same email address as an existing account.
Crash recovery - Select Yes to automatically refund player accounts after a server crash or power outage. A system of data files is created in the CrashProtect subfolder of the data folder while tables are active. They are normally deleted automatically when the tables are emptied. If any of these files still exist when the program restarts, that indicates an improper shutdown from the previous session and player accounts were not credited.
A file of chip counts is maintained for each ring game and is updated at the end of each hand and also when players join or leave the table, or add more chips. Two files are maintained for tournments, one for registration lists and another for running tournaments. For registrations, the buy-in amounts are recorded each time a player registers or unregisters from the tournament. For running tournaments, an equal share of the remaining prize pool is recorded for the remaining entrants and is updated each time a player gets knocked out of the tournament.
Custom field caption - This is a caption (up to 15 characters) used to identify the data saved in the "Custom" field for each player. It can be displayed in the avatar mouseover text on the poker table and when players create a new account in the flash client (if those options are enabled). A trailing colon will be appended automatically.
Custom field description - This is a description (up to 80 characters) of the "Custom" field that will be displayed along with the caption settng when players create a new account or edit their existing account settings in the flash client (if that option is enabled).
Custom field edit - Set to Yes to allow players to edit their Custom account field in the flash client when they create or edit their account settings.
Custom field mouseover - Set to Yes to display a player's Custom account field when someone hovers their cursor over the player's avatar when seated at a table.
Use custom language - Select Yes to replace the default captions and messages in the player client with the ones specified on the Language tab. Settings to include or exempt the hand history text from this option are available below.
Use custom client hh - Select Yes to use the custom settings on the Language tab in the client-side hand history window. "Use custom language" must also be set to "Yes".
Use custom language - Select Yes to use the custom settings on the Language tab in the server-side hand history files. "Use custom language" must also be set to "Yes".
Beep sound - Enter the full path of a local mp3 audio file to use as the sound effect for alerting a player when it is their turn to act. Leave this value blank to use the default sound effect. For best results, save your mp3 file with a sample rate of 44100 Hz. This feature is only available in the Pro/Gold version of Poker Mavens.
Bet sound - Enter the full path of a local mp3 audio file to use as the sound effect when a player makes or calls a bet. Leave this value blank to use the default sound effect. For best results, save your mp3 file with a sample rate of 44100 Hz. This feature is only available in the Pro/Gold version of Poker Mavens.
Card sound - Enter the full path of a local mp3 audio file to use as the sound effect when a card is dealt from the deck. Leave this value blank to use the default sound effect. For best results, save your mp3 file with a sample rate of 44100 Hz. This feature is only available in the Pro/Gold version of Poker Mavens.
Check sound - Enter the full path of a local mp3 audio file to use as the sound effect when a player checks their option to bet. Leave this value blank to use the default sound effect. For best results, save your mp3 file with a sample rate of 44100 Hz. This feature is only available in the Pro/Gold version of Poker Mavens.
Pot sound - Enter the full path of a local mp3 audio file to use as the sound effect when chips are moved toward or away from the pot. Leave this value blank to use the default sound effect. For best results, save your mp3 file with a sample rate of 44100 Hz. This feature is only available in the Pro/Gold version of Poker Mavens.
Login sound - Enter the full path of a local mp3 audio file to use as the sound effect when another player logs into the site. Leave this value blank to use the default sound effect. For best results, save your mp3 file with a sample rate of 44100 Hz. This feature is only available in the Pro/Gold version of Poker Mavens.
Avatar folder - Enter the path of a local folder that holds your communal avatar set. Leave blank to use the default set. Avatars are 48 x 48 pixels in size with transparent backgrounds. You may include up to 64 avatars (Avatar01.* to Avatar64.*) in either GIF, PNG or SWF format. Note that individual players can be assigned a custom avatar in their account settings that is not in this communal set. This feature is only available in the Pro/Gold version of Poker Mavens.
Card back graphic - Enter the full path of a local image file (50x70 GIF, PNG, or SWF format) to use as the card back graphic (i.e., face-down cards). Leave this value blank to use the default graphic. This feature is only available in the Pro/Gold version of Poker Mavens.
Table graphic - Enter the full path of a local image file (700x510 GIF, PNG, JPG, or SWF format) to use as the table graphic. Leave this value blank to use the default graphic. This feature is only available in the Pro/Gold version of Poker Mavens.
Table chat graphic - Enter the full path of a local image file (700x510 GIF, PNG, or SWF format) to use as the table chat graphic. Leave this value blank to use the default graphic. This feature is only available in the Pro/Gold version of Poker Mavens.
Table seat graphic - Enter the full path of a local image file (65x65 GIF, PNG, or SWF format) to use as the table seat graphic. Leave this value blank to use the default graphic. This feature is only available in the Pro/Gold version of Poker Mavens.
Table top text color - Enter the text color for the chip values that appear over the table graphic. The default color is white (#FFFFFF). This feature is only available in the Pro/Gold version of Poker Mavens.
Table background text color - Enter the text color for the various checkbox controls that appear around the table graphic. The default color is white (#FFFFFF). This feature is only available in the Pro/Gold version of Poker Mavens.
Background color - Specify the color of the game surface background. The default color is white (#FFFFFF). This feature is only available in the Pro/Gold version of Poker Mavens.
Window color - Specify the color of the lobby and table window frames. The default color is gold (#D4C6A1). This feature is only available in the Pro/Gold version of Poker Mavens.
Button color - Specify the color of the buttons and menu/grid headers. The default color is sand (#D3CCBA). This feature is only available in the Pro/Gold version of Poker Mavens.
List color - Specify the background color of the various lists, dialogs, and chat boxes. The default color is off-white (#F3EEE1). This feature is only available in the Pro/Gold version of Poker Mavens.
Admin chat color - Specify the Administrator chat text color. The default color is red (#FF0000). This feature is only available in the Pro/Gold version of Poker Mavens.
System chat color - Specify the System chat text color. The default color is magenta (#C000C0). This feature is only available in the Pro/Gold version of Poker Mavens.
Dealer chat color - Specify the Dealer chat text color. The default color is black (#000000). This feature is only available in the Pro/Gold version of Poker Mavens.
Player chat color - Specify the Player (seated) chat text color. The default color is blue (#0000FF). This feature is only available in the Pro/Gold version of Poker Mavens.
Observer chat color - Specify the Player (non-seated) chat text color. The default color is green (#008000). This feature is only available in the Pro/Gold version of Poker Mavens.
Show player title in chat - Select Yes to display the player's title setting in the chat boxes. The title (if not blank) will appear between square brackets in front of their name.
Lobby chat - Set to Yes to display a chat box in the client lobby window. This setting does not affect the chat in the table windows.
Profanity filter - Create a list of terms that will be filtered out (replaced with asterisks) in the player chat window. Also, players will not be able to create new accounts that contain these terms in the player name or location text.
Suspend chat during all-in - Select Yes to temporarily suspend the player chat at tournament tables when a player moves "all-in". This setting discourages collusion between players when another player may be on the verge of being eliminated from the tournament. This setting does not apply to ring games.
Table invite seconds - This is the number of seconds (10 to 120) given to a player on the waiting list to accept an available seat. The default value is 30.
Rathole minutes - This is the number of minutes (0 to 120) that a player must wait before they can return to the same ring game table with fewer chips than they left with.
Maximum sitout minutes - This is the number of consecutive minutes that a player can sit out in a ring game before being removed from the table. This does not apply to tournaments. The default value is 10.
Showdown seconds - This is the number of seconds (0 to 15) to pause at the end of a hand with a showdown. The default value is 2.
Unregister at logout - Select Yes to automatically unregister a player from all tournaments if they logout before the tournaments start. If the administrator manually terminates a player's connection, the player will be unregistered regardless of this setting.
Allow lurkers - Select Yes to allow people to browse the site and watch other players prior to logging in. Lurkers cannot enter chat messages or join any games until they log in.
Player profile URL - Enter a web address (including the http prefix) to be called when a player's name in the Login list or a player's avatar at a table is double clicked. A "?Player=xxxxxx" parameter will be appended automatically to the URL so that a web script can read it and display the applicable information for that player. Leave the URL blank to disable this feature.
Auto check hands - Select Yes to auto check hands when a player's turn times out and there is no bet to them. When set to No, their hand will be folded if they do not respond in time, regardless if there is a bet before them.
Save logs to file - Select Yes to automatically save event and error log items to text files. Otherwise log items are only saved temporarily on the Logs tab. File names are date-encoded in the format of EventLogYYYY-MM-DD.txt and ErrorLogYYYY-MM-DD.txt and saved in the Logs subfolder under the main data folder.
Maximum log days - This is the maximum number of days to keep event and error log files before they are automatically deleted. Use a value of 0 to disable automatic deletion.
Maximum log items - This is the maximum number of items to hold in the lists on the Logs tab to prevent memory overflow. The oldest items are then deleted to allow new items to be added. The default value is 10000. The lists are cleared each time the game server is started. This setting does not affect logs saved to file.
Log errors - Set to Yes to record errors. Errors are displayed in red in the upper list on the Logs Tab and are saved in a separate file in the logs folder.
Log file events - Set to Yes to record in the Event Log each time an external file is sent to a client. This includes items such as custom table graphics and avatars.
Log resource events - Set to Yes to record in the Event Log each time an internal resource file is sent to a client. This includes items such as the flash client and the default table graphics.
Log system events - Set to Yes to record system events in the Event Log. System events include starting and stopping the game server.
Log connect events - Set to Yes to record in the Event Log each time someone connects to your server.
Log login events - Set to Yes to record in the Event Log each time someone logs into your server.
Log logout events - Set to Yes to record in the Event Log each time someone logs out from your server.
Log account events - Set to Yes to record in the Event Log each time someone creates a new account, edits their account, or has an email sent for account validation or password recovery.
Log rake accounts - Set to Yes to record in the Event Log each time chips are debited or credited to the ring game rake or tournament entry fee accounts. These balances can be viewed and adjusted from the Chips menu on the Accounts tab.
Log table events - Set to Yes to record in the Event Log each time someone joins or leaves a ring game table or tournament.
Log listing events - Set to Yes to record in the Event Log each time the server updates the directory at pokermavens.net.
Log remote administration - Set to Yes to record in the Event Log each time a command is executed through the remote administration interface.
Log API access - Set to Yes to record in the Event Log each time a command is executed through the application programming interface.
Save history to file - Select Yes to automatically save hand histories to text files. File names are date-encoded in the format of "HHYYYY-MM-DD TableName.txt" and saved in the HandHistory subfolder under the main data folder. These settings do not affect the hand histories that are displayed to the players.
Save player chat - Select Yes to save player and administrator chat text inside the hand history files.
Maximum history days - This is the maximum number of days to keep hand history files before they are automatically deleted. Use a value of 0 to disable automatic deletion.
Save tournament results - Select Yes to automatically save tournament results to text files. File names are date-encoded in the format of "TRYYYY-MM-DD TournamentName.txt" and saved in the TourneyResults subfolder under the main data folder.
Maximum tournament days - This is the maximum number of days to keep tournament results files before they are automatically deleted. Use a value of 0 to disable automatic deletion.
Save lobby chat to file - Select Yes to record all chat in the client lobby window. File names are date-encoded in the format of LobbyChatYYYY-MM-DD.txt and saved in the Logs subfolder under the main data folder.
Maximum lobby chat days - This is the maximum number of days to keep lobby chat files before they are automatically deleted. Use a value of 0 to disable automatic deletion.
Enable callbacks - Set to Yes if you want the poker server to call the specified URL when any of the specified events/errors are triggered.
URL - Specify the full URL (including the http prefix) to call when any of the enabled events are triggered. Typically this will point to a PHP file or other web scripting system. Any results returned are ignored.
Password - Specify an optional "Password" parameter than can be checked by your web script for validation. It will be sent via POST with each callback.
Balance event - Set to Yes if you want the callback URL to be called when a player's chip balance changes. Six POST parameters are sent: Event, Player, Change, Balance, Source, and Time. Event will be set to "Balance", Player will contain the player's name, Change will show the number of chips added or subtracted, Balance will contain the new chip balance, Source will indicate the reason for the change, and Time will be in YYYY-MM-DD HH:MM:SS format.
Login event - Set to Yes if you want the callback URL to be called when a player logs into your site. Three POST parameters are sent: Event, Player, and Time. Event will be set to "Login", Player will contain the player's name, and Time will be in YYYY-MM-DD HH:MM:SS format.
Logout event - Set to Yes if you want the callback URL to be called when a player logs out from your site. Three POST parameters are sent: Event, Player, and Time. Event will be set to "Logout", Player will contain the player's name, and Time will be in YYYY-MM-DD HH:MM:SS format.
Tournament start event - Set to Yes if you want the callback URL to be called when a tournament starts. Four POST parameters are sent: Event, Name, Number, and Time. Event will be set to "TourneyStart", Name will be set to the tournament name, Number will will be set the sequential tournament number, and Time will be in YYYY-MM-DD HH:MM:SS format.
Tournament finish event - Set to Yes if you want the callback URL to be called when a tournament completes. Four POST parameters are sent: Event, Name, Number, and Time. Event will be set to "TourneyFinish", Name will be set to the tournament name, Number will will be set the sequential tournament number, and Time will be in YYYY-MM-DD HH:MM:SS format.
Ring game error - Set to Yes if you want the callback URL to be called when a fatal error occurs in a ring game. Four POST parameters are sent: Event, Name, Error, and Time. Event will be set to "RingGameError", Name will be set to the table name, Error will be set to the reported error message, and Time will be in YYYY-MM-DD HH:MM:SS format.
Tournament error - Set to Yes if you want the callback URL to be called when a fatal error occurs in a tournament. Five POST parameters are sent: Event, Name, Table, Error, and Time. Event will be set to "TourneyError", Name will be set to the tournament name, Table will be set to the table number (or 0 if all tables), Error will be set to the reported error message, and Time will be in YYYY-MM-DD HH:MM:SS format.
