IdleBot — Step up your AFK game
An Essential Discord/Minecraft AFK Utility
By MetalTurtle and Camshaft
Description: IdleBot is a plugin that sends messages to players in Discord when various events occur while idle. Players are able to link their Discord account to Minecraft, then they can choose to receive alerts in a public channel or direct message from the bot.
Features:
- Alert on death
- Alert on damage
- Alert when a player's inventory is full
- Alert when a player reaches a certain coordinate
- Alert when a player reaches a certain experience level
- Alert when a player gets a certain advancement
- Alert when a player breaks a tool
- Player-specific configuration of time between alerts
- Integration with the DiscordSRV plugin
Roadmap: These are some planned features for IdleBot that have not yet been implemented. For a more complete list, see our GitHub Project.
- Permission support for admins
- Full GUI control for players in-game
- Localization
Story: We enjoy Minecraft for its technical aspects and often AFK to obtain more resources in the game. This was effective, but we were limited by the control we had over monitoring our AFK-ing. We spent countless hours scouring the internet, looking for possible solutions to our struggles, but to no avail. Finally we decided that this type of tool could be realized as a Spigot plugin. Using our previous experience of building plugins, we decided to collaborate to create this utility. We hope you can step up your AFK game too!
Configuration:
config.yml
# This is the configuration file for the IdleBot plugin!
# More information and help can be found here: https://github.com/IdleBot-Development/IdleBot/wiki
# Comments refer to the option BELOW them
# _____ _ _ ____ _
# |_ _| | | | | _ \ | |
# | | __| | | ___| |_) | ___ | |_
# | | / _` | |/ _ \ _ < / _ \| __|
# _| || (_| | | __/ |_) | (_) | |_
# |_____\__,_|_|\___|____/ \___/ \__|
# This is the token you get from your application in the Discord Developer Portal: https://discord.com/developers/applications | DO NOT INCLUDE THE <> | Ignored if discordSRV is true
botToken: <Bot Token Here>
# This is the ID of the Discord channel you want the bot to send messages to | DO NOT INCLUDE THE <> | Not needed if publicChannelMessagesEnabled is set to false
channelID: <Channel ID Here>
# Do you want this plugin to rely on DiscordSRV for account linking? (Recommended if you are using DiscordSRV)
discordSRV: false
# Category ignored if discordSRV is true
customBotActivity:
# The type of activity in the bot's Discord status | default: watching | options: [watching, listening, playing, none]
type: watching
# The second part of the bot's Discord status. For example, if this says "idle players" the bot's status could be "Watching idle players" | default: idle players
message: idle players
messageChannels:
# Should players be allowed to have alerts sent to a public channel | default: true
publicChannelMessagesEnabled: true
# Should players be allowed to have alerts sent to a private channel | default: true
privateChannelMessagesEnabled: true
# The default message channel to set for players when they first link their account | default: public | options: [public, private]
defaultMessageChannel: public
AFKMode:
# Should players be allowed to go AFK just by standing still | default: true
autoAFKEnabled: true
# Should players be allowed to go AFK by typing a command | default: true
manualAFKEnabled: true
# Should players be allowed to have alerts repeated without becoming AFK again | default: false
alertAutoTimeoutEnabled: false
# The default mode for players to go AFK | default: auto | options: [auto, manual]
defaultAFKMode: auto
idleTime:
# (s) The default idle time for players who do not set their own | this must be between minimum and maximum idle time set below | default: 120
defaultIdleTime: 120
# (s) The minimum idle time a players can set for themselves | you can set this to a minimum of 5 seconds | default: 20
minimumIdleTime: 20
# (s) The maximum idle time a players can set for themselves | you can set this to a maximum of 86400 seconds (1 day) | default: 600
maximumIdleTime: 600
alertRepeatTimeout:
# (s) The default time between alerts for players who do not set their own | this must be between minimum and maximum alert repeat timeout set below | default: 20
defaultAlertRepeatTimeout: 20
# (s) The minimum time between alerts a players can set for themselves | you can set this to a minimum of 5 seconds | default: 10
# Users will be able to set their time to 0 regardless of what you set here. This disables alerts from repeating for the player.
minimumAlertRepeatTimeout: 10
# (s) The maximum time between alerts a players can set for themselves | you can set this to a maximum of 86400 seconds (1 day) | default: 120
maximumAlertRepeatTimeout: 120NOTE: When updating IdleBot, we recommend removing the config.yml file in the IdleBot directory and letting it re-generate by starting and stopping the server.
Please see the GitHub Wiki to learn how to configure and use IdleBot.
If you come across any bugs, please make a GitHub issue.
Logo designed by Reevak05.
Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
25MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
Emotecraft
Create your own emotes in Minecraft.
7.5MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
3.9MSueta
Set Home
A lightweight plugin for players to set their homes.
3.8MSueta