Fork 0
A Minetest mod that can limit how long players are allowed to play
Go to file
𝘋𝘪𝘳𝘬 03ec04a368
fix typo
2023-05-25 21:31:08 +02:00
locale Initial commit 2022-04-02 06:29:31 +02:00
system add in-code documentation 2022-04-02 06:51:36 +02:00
LICENSE.txt Initial commit 2022-04-02 06:29:31 +02:00
README.md add user-facing documentation 2022-04-02 07:07:32 +02:00
init.lua Initial commit 2022-04-02 06:29:31 +02:00
mod.conf add 5.6 human readable title 2022-08-12 08:22:56 +02:00
settingtypes.txt fix typo 2023-05-25 21:31:08 +02:00


Playtime Limit Limit how long players are allowed to play

This mod allows server owners to configure a playtime limit for individual players and a reset interval for this limit.

The playtime is counted up until the limit is reached and the player will then be disconnected. After the given reset interval the player can reconnect to the server. If the player disconnects while still within the limit the counter for that player is paused and resumed when the player reconnects.

This mod can be used to limit the playtime on highly frequented server or when running a server for kids and you do not want them to play for too long.


The mod can be configured to provide default values for new players. Players that were on the server while the mod was enabled with older configuration wont get the new configuration. You need to change their values manually.

The following values and defaults are used. Those values can either be set in the config file for the server or in the clients configuration when running an ad-hoc server.

playtime_limit_default_limit = 1800
playtime_limit_default_interval = 86400
playtime_limit_step_size = 60
  • playtime_limit_default_limit: Playtime limit in seconds. If players were that long on the server theyre disconnected.
  • playtime_limit_default_interval: The interval for resetting the playtime counter in seconds. When the playtime is up, players need to wait this long before being able to reconnect again.
  • playtime_limit_step_size: How often the validity is checked. After this amount of seconds the mod iterates over all players and validates if their playtime limits are reached.

You should not use “invalid values” like step size being lager than playtime limit or interval being lower than playtime limit, etc.

Also keep in mind that too high step sizes allow “cheating” the playtime limit by disconnecting before the validity check is being done. Too low values on high-load server cause additional lag because the validity check is done more often. Lower step values are more precise, though.

Chat command

Players with server privilege can configure other players playtime limits and reset intervals.

  • /playtime_limit_set MyCoolPlayer limit 1200 -> Limit the playtime of “MyCoolPlayer” to 20 minutes. If the limit is already reached or passed the player will be disconnected on the next validity check step.
  • /playtime_limit_set MyCoolPlayer limit -1 -> Disable playtime limit for “MyCoolPlayer”. The player will not receive any further playtime notifications. If re-enabling with another value the player might get kicked because the join timestamp is used to determine the playtime.
  • /playtime_limit_set MyCool Player interval 43200 -> Set the playtime reset interval to 12 hours. After those 12 hours the player can reconnect after being disconnected. On reconnect the playtime counter is reset.