Description
This plugin gives your players the opportunity to be temporally longer AFK through given or bought AFK time. It can detect every AFK machine, that I currently know about.
The Shop can be set up with AFK time, which can be bought with in game money. Server Administrator can also create rewards for players. It will be automatically claimed, after they join the server.
Bungeecord/Velocity is supported for the best synchronization between the servers. It's possible to share your AFK time to players on other servers as well. They don't need to be on the same server.
As always, everything is customizable in the Configs! (More at
Configuration)
Wiki for all information:
https://wiki.uc-gg.de/en/TempAfk
Tutorial
The player only got few commands to work with.
/temp
afk is the most important. If the player got AFK time left, it sets the player AFK mode to de-/active.
While the player is AFK, the time is shown above the hotbar or as a Bossbar. Depending on what you set up in the config. The AFK time counts down, after the default AFK time is over. If no time is left or the player hasn't the mode active, he will be kicked with the message from the config.
Players can share their AFK time with other players on the server. They only need to run
/Temp
Afk
give %Player% %Amount% %TimeUnit%.
But it is also possible, to buy AFK time through the integrated Shop System. (
/Temp
Afk
shop) The Administrator of the server can define the AFK time which will be received and how much it should cost.
Administrator can easily create messages, for the AFK time.
Code (Text):
#Countdown Message; The until option doesnt work for different timeunits 5m-3s; only 5m-3m/10s-1s
Countdown:
NoAfkTimeLeft:
'3m':
Message: '&6Afk time is running out in &f&l3 Minutes&6.'
MessageType: 'CHAT'
'10s-1s':
Message: '&6Afk time is running out in &f&l%time% Seconds&6.'
MessageType: 'CHAT'
'0s':
Message: '&6You got no more time left. Kicking...'
MessageType: 'TITLE'
Bungeecord/Velocity Support
The plugin was mainly built for a Bungeecord server. It also supports Velocity. You only need to add the same TempAfk.jar to the proxy plugin directory.
This is needed for the synchronization between the Servers. No Config is generated/needed to be edited. TempAfk does everything else through the Subservers.
Own API
The plugin also offers for Developers an own API.
You can find a general documentation here:
https://wiki.uc-gg.de/en/TempAfk/API (in Progress)
For any farther questions, try contacting the discord!
Installation
- Download the newest Version from Spigot.
- Stop your Minecraft Server.
- Go into your Minecraft Server folder and search for a directory with the name plugins.
- Move the downloaded .jar file into the plugins directory.
- Start your Minecraft Server. TempAfk will then create a new Directory.
- (Only Bungeecord/Velocity) Install the .jar also on the proxy. No Config needed.
MySQL Setup
- Open your /plugins/TempAfk/Config.yml in a file editor.
- The first lines should look like the following:
Code (Text):
#Your MySQL Connection Settings; SQLLite only needs the type. The other settings are ignored.
#Type can be MARIADB, MYSQL and SQLITE
Database:
Type: 'SQLITE'
Host: 'ipaddress'
Port: 3306
UseSSL: true
User: 'admin'
Password: 'S€CR3T'
Database: 'Database'
- Configure your database credentials there. (The Port is in the most cases correct)
- Restart your Minecraft Server. If everything is correct, then there should be a "{SQL} successfully connected to Database." message in the log.
More information about the Configs can be found
here.
Commands
/ta - De-/Activates the AFK Mode. After enabling, the player won't get kicked, as long he has AFK time left.
/ta shop - Opens the Shop Menu.
/ta give %player% %amount% [TimeUnit] - Give the target player some of your own AFK time. If no time unit is used, then it will use seconds.
/ta add %player% %amount% [TimeUnit] - Same like the give command, but for admins. This command won't remove AFK time of your own Account.
/ta remove %player% %amount% [TimeUnit] - Removes the AFK time of the target player.
/ta set %player% %amount% [TimeUnit] - Sets the AFK time of the target player.
Permissions
tempafk.command.<command> - Permission to use the
/ta user commands.
tempafk.admin.<command> - Permission to use the
/ta admin commands. (add, remove, set, …)
tempafk.bonus.<group> - Access for the reward group defined in the config.
tempafk.bypass - Player won't be kicked and TempAfk won't start counting
Final
Ideas are always welcome and can be added. I want to keep improving the plugin with Bug Fixes and new features as long my time allows it.
If you need help with the installation. Just contact the
Support and the issue will be resolved as fast as possible!