Description
This plug-in is intended to change the server size adaptively based upon the number of players currently on the server. The player count and desired server size is reevaluated when a player joins or leaves and changes occur dynamically throughout each round. When calculating the current number of players, the plug-in includes players who are joining the game, but are not in the PRoCon player list, in order to attempt to mimic the number displayed on Battlelog. Due to the fact that player timeouts aren't reported to PRoCon, it's not perfect, but it's accurate 80-90% of the time.
Normally, if the server size is modified to a value greater than what it was when the round began, players exceeding the previous size are required to wait at a black screen until the round ends. This plugin actively works around this issue by setting the server to it's max size before each round begins.
Optionally, the server can display welcome messages to new players when only a limited number of players are on the server in an effort to convince them to stick around and start the server. It will also notify all players on the server when new players join so that they will hopefully stick around if they see people joining.
An adaptive idle kick feature is also available, which will disable the idle kick when less than a specified number of players online.
Commands
This plug-in has no in-game commands.
Settings
Adaptive Server Size
Enable adaptive server size?
If enabled, changes the server size based upon the current number of players.
On startup, assume round started at max server size?
When the plugin initially starts up, it has no way of knowing if the current round started at the maximum server size, or not. By default, if the server is empty, it will restart the round at the maximum server size, but if players are present, it will assume that the round started with the current server size, and will not increase the server size until the current round ends. If this option is enabled, when the plugin starts up, it will assume that the current round started at the maximum server size and make immediate server size changes, as necessary.
Display welcome/join messages to help start server?
If enabled, the server will display welcome messages to new players when only a limited number of players are on the server to encourage them to stick around and help start the server. It will also notify all players on the server when new players join so that they will hopefully stay if they see people joining.
Display messages until how many players are on?
The welcome/join messages will only be displayed until this number of players have joined. It should probably be set to somewhere between 3 and 5 players, as once 4 to 6 players are on your server, it should begin to fill up on it's own.
Welcome messages
These messages are sent to new players as soon as they reach the deploy screen. The second message is sent 5 seconds after the first. [soldierName] is replaced by the new player's name.
Player joining messages
These messages are sent to all players currently on the server when new player(s) are joining. The second message is sent 5 seconds after the first. [joinCount] is replaced by the number of players who are currently joining.
Maximum server size
The maximum number of slots that your server is allowed to have.
Size with X players
The server size that will be set when X players are active on the server.
Maximum [Game Mode] size
The maximum server size that will be set when the specified game mode is active
Adaptive Idle Kick
Enable adaptive idle kick?
If enabled, disables the idle kick time when less than the specified number of players are online.
Disable idle kick until how many players are on?
Once this number of players is reached, idle kick will be enabled and set to the specified value.
Desired idle kick time, in seconds
The number of seconds that the idle kick timer will be set to, once it has been enabled.
Extras
Enable debug output?
If enabled, displays debug info in the console window.
This plug-in is intended to change the server size adaptively based upon the number of players currently on the server. The player count and desired server size is reevaluated when a player joins or leaves and changes occur dynamically throughout each round. When calculating the current number of players, the plug-in includes players who are joining the game, but are not in the PRoCon player list, in order to attempt to mimic the number displayed on Battlelog. Due to the fact that player timeouts aren't reported to PRoCon, it's not perfect, but it's accurate 80-90% of the time.
Normally, if the server size is modified to a value greater than what it was when the round began, players exceeding the previous size are required to wait at a black screen until the round ends. This plugin actively works around this issue by setting the server to it's max size before each round begins.
Optionally, the server can display welcome messages to new players when only a limited number of players are on the server in an effort to convince them to stick around and start the server. It will also notify all players on the server when new players join so that they will hopefully stick around if they see people joining.
An adaptive idle kick feature is also available, which will disable the idle kick when less than a specified number of players online.
Commands
This plug-in has no in-game commands.
Settings
Adaptive Server Size
Enable adaptive server size?
If enabled, changes the server size based upon the current number of players.
On startup, assume round started at max server size?
When the plugin initially starts up, it has no way of knowing if the current round started at the maximum server size, or not. By default, if the server is empty, it will restart the round at the maximum server size, but if players are present, it will assume that the round started with the current server size, and will not increase the server size until the current round ends. If this option is enabled, when the plugin starts up, it will assume that the current round started at the maximum server size and make immediate server size changes, as necessary.
Display welcome/join messages to help start server?
If enabled, the server will display welcome messages to new players when only a limited number of players are on the server to encourage them to stick around and help start the server. It will also notify all players on the server when new players join so that they will hopefully stay if they see people joining.
Display messages until how many players are on?
The welcome/join messages will only be displayed until this number of players have joined. It should probably be set to somewhere between 3 and 5 players, as once 4 to 6 players are on your server, it should begin to fill up on it's own.
Welcome messages
These messages are sent to new players as soon as they reach the deploy screen. The second message is sent 5 seconds after the first. [soldierName] is replaced by the new player's name.
Player joining messages
These messages are sent to all players currently on the server when new player(s) are joining. The second message is sent 5 seconds after the first. [joinCount] is replaced by the number of players who are currently joining.
Maximum server size
The maximum number of slots that your server is allowed to have.
Size with X players
The server size that will be set when X players are active on the server.
Maximum [Game Mode] size
The maximum server size that will be set when the specified game mode is active
Adaptive Idle Kick
Enable adaptive idle kick?
If enabled, disables the idle kick time when less than the specified number of players are online.
Disable idle kick until how many players are on?
Once this number of players is reached, idle kick will be enabled and set to the specified value.
Desired idle kick time, in seconds
The number of seconds that the idle kick timer will be set to, once it has been enabled.
Extras
Enable debug output?
If enabled, displays debug info in the console window.