Description

Unplugged-AFK

Unplugged-AFK is an eco-friendly Minecraft mod that allows players to "go unplugged." By utilizing this mod, players can spawn a bot of themselves to stay AFK at their farms while they disconnect. This allows you to safely shut off your computer, saving electricity and promoting a "Green" approach to server farming!

InfoGraphic

Prerequisites & Installation

Mod Loader: Fabric
Minecraft Version: 1.19.2 up to 26.2

Features

Go Green: Turn off your PC while your player-bot continues to AFK for you.
Customizable Timeouts: Set specific durations for how long a bot should remain active. The default timeout is 129600 minutes (90 days).
Admin Control: Server administrators have full command control to spawn, kick, or manage unplugged players.
Safety Options: Configurations allow you to reset health upon death, disable damage for unplugged players, or even hide them from other players and operators.
Server Restart: The mod also respawns all AFK bots at server restart with a slight delay.

Commands

Player Commands

/unplug [<minutes>] [<reason>]: Disconnects you and leaves an unplugged bot in your place.
- Note: This command cannot be used by the single-player server owner.

Admin Commands

Requires permission level 3 by default.

/unplugged-admin: Displays information about the mod.
/unplugged-admin save: Saves the current configuration.
/unplugged-admin reload: Reloads the configuration, overwriting the current configuration.
/unplugged-admin purge: Purges players and resyncs the current player/unplugged maps with the live server.
/unplugged-admin spawn <player> [<minutes>] [<reason>]: Manually spawns an unplugged bot for a specified player.
/unplugged-admin kick <player>: Removes/kicks an active unplugged bot.
/unplugged-admin info [<player>]: Displays detailed debug information for a specific player. (advancedAdminOptions enables the full "player" info)
/unplugged-admin list [players|unplugged|all]: Lists currently tracked players or active unplugged bots. (advancedAdminOptions enables the list sub commands)
/unplugged-admin set <setting> <value>: Sets a config setting value. (advancedAdminOptions enables this sub command)

Configuration

The mod features a highly customizable unplugged_afk.json file. Key options include:

Category Option Description Default Main unpluggedAfkEnabled Toggles the entire AFK feature. true Main debugMode Enables debugging output. false Main reducedListDebugInfo Enables Reduced output for various information commands. true Main advancedAdminOptions Enables advanced Admin options, such as 'set'. false Unplugged defaultUnpluggedTimeout Set the default timeout (in minutes). The default is for 90 days. 129600 Unplugged resetHealthUponDeath Resets the AFK bots Health when killed. false Unplugged unpluggedDisableDamage Prevents the AFK bot from taking damage. false Unplugged unpluggedHidePlayer Makes the bot invisible to others. false Unplugged unpluggedHideFromOps Makes the bot invisible to to Operators as well. false Command unplugCommandPermissions Permission level required to use /unplug. 0 Command unpluggedAdminCommandPermissions Permission level for /unplugged-admin. 3 Command afkCommandPermissions Permission level required to use /afk. 0 Command enableUnplugCommand Enables the /unplug Command. true Command enableAfkCommand Enables the /afk Command. (Works the same as /unplug) false Messages broadcastMessages Enables the broadcasting of Unplugged status messages. false Messages hideUnpluggedJoin Enables the disabling of the default player has joined messages while bots are spawned, where possible. false Messages displayDuration Enables the duration display of Unplugged status messages. false Messages displayReturnFeedback Enables the Feedback display of the reason why an Unplugged session ended false

Messages & Formatting: Server owners can extensively customize broadcast messages and formatting. For example, the default kick message when a player successfully uses the command is "§6Your player will be AFK§r". The duration and the timeDate are CoreLib time formatting options for the broadcast messages while displayDuration is enabled.