Fabric Offline Players Mod - Reworked

Installing

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.

Dependencies and Compatibility

This mod is built for Minecraft version 1.21 & 1.21.1 and is build using the following dependencies:

Fabric Loader 0.15.11 or higher
Fabric API 0.102.1+1.21.1 or higher

Other dependencies:

MidnightLib 1.5.8-fabric
JsonDB 1.0.106
Commons Logging 1.3.3
Guava 33.3.0-jre

Versions

Current Version (1.21 & 1.21.1): Download v1.0.7-mc.1.21.1
- Available on modrinth: OfflinePlayers - Modrinth
Legacy Version (1.18.2): Download v0.1.6-mc.1.18.2
- This version is deprecated and will not be available on Modrinth.

Goal

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.

How to Use

Type /offline to spawn an offline player.

Actions

You can add actions to your offline player. Available actions include:

Name	Description
attack	Player left click
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 actions to see a list of available actions

Interval/Offset

You can execute actions with set intervals or offsets:

Interval: /offline attack:20 (20 tick or 1 second interval between attacks)
Offset: /offline attack:20:10 (10 tick offset added to the action)

Time Parsing

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

Chaining

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.

Config

After initialization, the configuration file is located at config/OfflinePlayersReworked.json in your Minecraft server's root folder.

The configuration looks as follows:

{
  "opRequired": false,
  "autoOp": true,
  "autoWhitelist": false,
  "autoDisconnect": true,
  "killOnDeath": true,
  "respawnKickedPlayers": true,
  "informAboutKickedPlayer": true,
  "copySkin": true,
  "databaseLocation": "./offlineplayersreworked/",
  "offlinePlayerPrefix": "[OFF]",
  "availableOptions": ["attack","use","etc..."]
}

opRequired: If true, only OPs can use /offline.
autoOp: If true, offline players of OPs are automatically made OPs.
autoWhitelist: If true and whitelist is enabled, offline players are auto-whitelisted. (Default value is false at it doesn't seem necessary)
autoDisconnect: If true, players automatically disconnect after using /offline. (Use false at your own risk)
killOnDeath: If true, players automatically die upon reconnecting if their offline player died.
respawnKickedPlayers: If true, offline players automatically respawn on server restart when kicked
informAboutKickedPlayer: If true, if offline player was kicked and player rejoins, player will be informed about offlline player being kicked
copySkin: If true, offline players copy the original player's skin.
databaseLocation: Folder location for the database. Default is ./offlinePlayersReworked/.
offlinePlayerPrefix: Sets the prefix for the offline player.
availableOptions: A list of the available action options that can be used.

Reporting Issues

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.

Screenshots

Offline Player

Able to spawn a offline player with the prefix [OFF] OfflinePlayersScreenshot

Updated death message

When the offline player dies because of, for example, a creeper; the original player will have a updated death message OfflinePlayersScreenshot_Dead

Player list

Player list will show 0/20 online when only offline players are online but will still show them in the small preview list. OfflinePlayersScreenshot_PlayerList

Setup

For setup instructions, please see the Fabric wiki page relevant to your IDE.

Credits

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.

License

This template is available under the CC0 license. Feel free to learn from it and incorporate it into your own projects.

TheMisterFish / Fabric_OfflinePlayersReworked

readme