Download/Build the .jar file and place it in the /mods/ folder of your Minecraft Fabric server. If the server is already running, restart it.
Note: This is a Server-side mod only.
This mod allows players to go AFK on a server without leaving their computers on. Simply use the /offline command to spawn an exact copy of your player, called an offline player. Depending on the configuration, you'll be kicked after the offline player has spawned.
If the offline player is killed, it won't drop loot but will be kicked from the server. When you rejoin, the inventory and XP levels from the offline player are copied to you, and you'll be killed. This gives you time to retrieve your items.
If the offline player survives until you rejoin, its inventory and gained experience will be transferred to you.
Type /offline to spawn an offline player.
You can add actions to your offline player. Available actions include:
| Name | Description |
|---|---|
| attack | Player left click |
| break | Player left click, but wait for block to fully break. |
| place / use | Player right click |
| crouch | Player crouching |
| jump | Player jumping |
| eat | Player eating (only if hungry & having food in one hand) |
| drop_item | Drops an item from the active slot |
| drop_stack | Drops all items from the active slot |
| move_forward | Moves the player forward |
| move_backward | Moves the player backwards |
| disconnect | Automatically disconnects the offline player after a set interval |
To use an action, type /offline [action], e.g., /offline attack.
Tip: use
/offline actionsto see a list of available actions
You can execute actions with set intervals or offsets:
- Interval:
/offline break:20(20 tick or 1 second interval between breaking blocks) - Offset:
/offline attack:20:10(10 tick offset added to the action)
Besides using ticks (the default), it is also possible to set the interval and offset to milliseconds, seconds, minutes, hours, and even days.
Example: /offline use:100ms, /offline attack:1s, /offline attack:1.5m, /offline eat:0.25h, /offline disconnect:1d
You can chain actions, for example:
/offline attack move_forward/offline attack:100 jump eat:20:10/offline jump:20 attack eat move_backward
Actions are executed in the order specified.
After initialization, the configuration file is located at config/OfflinePlayersReworked.properties in your Minecraft server's root folder.
The configuration looks as follows:
opRequired=false # - If true, only OPs can use `/offline`. | default: false
autoOp=true # - If true, offline players of OPs are automatically made OPs. | default: true
autoWhitelist=false # - If true and whitelist is enabled, offline players are auto-whitelisted. | default: false
autoDisconnect=true # - If true, players automatically disconnect after using `/offline`. (Use false at your own risk) | default: true
killOnDeath=true # - If true, players automatically die upon reconnecting if their offline player died. | default: true
respawnKickedPlayers=true # - If true, offline players automatically respawn on server restart when kicked | default: true
informAboutKickedPlayer=true # - If true, if offline player was kicked and player rejoins, player will be informed about offline player being kicked | default: true
copySkin=true # - If true, offline players copy the original player's skin. | default: true
ignoreSleepingPercentage=true # - If true, offline players will not be counted towards the sleeping percentage rule. | default: true
autoOfflineOnDisconnect=false # - If true, offline players automatically be created on disconnect. | default: false
offlinePlayerInvincible=false # - If true, offline players are invincible. Mobs won't target the offline player. | default: false
offlinePlayerPrefix=[OFF] # - Sets the prefix for the offline player. | default: [OFF]
availableOptions=attack,break,place,use,crouch,jump,eat,drop_item,drop_stack,move_forward,move_backward,disconnect # | default: attack,break,place,use,crouch,jump,eat,drop_item,drop_stack,move_forward,move_backward,disconnect
# ^ A comma-separated list of the available action options that can be used.If you encounter any bugs or have suggestions for improvements, please create an issue on our GitHub repository. To create an issue:
- Go to the Issues tab of this repository.
- Click on "New Issue".
- Choose between "Bug report" or "Feature request" template.
- Fill out the template with as much detail as possible.
- Submit the issue.
Able to spawn a offline player with the prefix [OFF]
When the offline player dies because of, for example, a creeper; the original player will have a updated death message
Player list will show 0/20 online when only offline players are online but will still show them in the small preview list.
For setup instructions, please see the Fabric wiki page relevant to your IDE.
This mod incorporates classes from the Carpet mod, which served as a valuable reference for implementation. We extend our gratitude to the Carpet mod developers for their work.
This template is available under the CC0 license. Feel free to learn from it and incorporate it into your own projects.