⚙️Main Configuration

How to configure the configuration.yml ?

Fake Plugin Name

Set the plugin's display name at fake-plugin-name, and it will use this name in commands and other outputs.

Fake Player's World

The fake players are teleported to a world automatically generated by the plugin, to change the name of the world use the field fake-player-world

Toggle stone platform for fake player's

This setting enables or disables the creation of a small stone platform under the bots' spawn point.

Allow staff to go into fake player's world

The allow-staff-go-into-bot-world setting determines whether staff can teleport to the fake players' world. If set to true, they will be able to, if set to false, they will not.

Enable fake player join commands

The enable-join-commands setting determines whether the commands specified in join-commands are enabled. If set to true, they will be enabled, if set to false, they will be disabled.

Fake player join commands

The join-commands are the commands executed by the fake player upon joining. These commands will not run if enable-join-commands is set to false.

Port used for fake players ip

The port-used-for-spoof-ip determines the port displayed in the fake players' IP addresses. If you're unsure, it's best to leave it unchanged unless you know what you're doing.

Hide fake players names in tablist

The setting hide-fake-players-in-tab determines whether you want the names of fake players hidden in the tablist. Set it to true to hide the names, or false to show them.

Spoof base amount

spoof-base-amount will set the amount of fake players to be in the server during non-fluctuating hours.

Spoof percentage amount

spoof-percentage-amount is the percentage taken from the total number of real players on the server, and then an equivalent number of fake players (excluding the existing fake players) are added.

Fake player lifetime minimum

fake-player-lifetime-min represents the minimum amount of seconds a fake player remains in the server before being automatically kicked.

Fake player lifetime maximum

fake-player-lifetime-max represents the maximum amount of seconds a fake player remains in the server before being automatically kicked.

Join quit interval minimum

join-quit-interval-min represents the minimum interval, in seconds, at which the server checks whether to add or remove a fake player.

Join quit interval maximum

join-quit-interval-maxrepresents the maximum interval, in seconds, at which the server checks whether to add or remove a fake player.

Fake player permissions

fake-player-permissions are the permissions assigned to all fake players.

Allow bots to quit their world

allow-bots-quit-their-world determines whether fake players are allowed to leave their designated world. If set to true, they will be allowed to leave, if set to false, they will remain in the world indefinitely.

Fluctuation settings

enable-fluctuation determines whether fluctuation is enabled. Set it to true to enable it, and false to disable it.

Fluctuation

You can specify the time intervals during which there's typically a higher player count in the configuration. Here are the relevant fields:

fluctuation-hours: # Specify hours in 24-hour format
  - 12:00-14:00
  - 18:00-23:00
time-zone: Europe/Istanbul
fluctuation-amount: 10
fluctuation-percentage: 50

In this setup, the server will adjust its behavior according to the specified time intervals, taking into account the time-zone set to Europe/Istanbul. (You can find all timezones here) The fluctuation-amount indicates the number of additional players during these times, and fluctuation-percentage denotes the percentage increase.

Disable welcome messages

disable-welcome-message determines whether the welcome messages specified in welcome-messages will be enabled. When enabled, fake players will select one of the messages to welcome new people to the server.

Disable fake player join messages

disable-bot-chat-join-message controls whether the feature to send join messages specified in join-messages is enabled. When activated, fake players will select a message from the list to send upon joining.

Welcome messages

welcome-messages contains the messages that fake players will send to new players upon joining they will only choose one message in the list. You can use placeholders such as %player% to display the new player's username, and %player_simplified% to show a simplified version of the player's name, especially useful for complex usernames. For example, if the username is _Z3lt0v, it will hypothetically show as Zeltuv. This will only work if disable-welcome-message is set to false.

Join messages

join-messages contains the messages that fake players will send when they join the server. However, this feature will only function if disable-bot-chat-join-message is set to false.

Last updated