ModsFinder

PuppetPlayers

by senseiwells

PuppetPlayers lets operators spawn fake player accounts, called puppets, that act and send packets to the server like a real player.

FabricServer-side onlyMIT LicenseOpen source1.21.5 – 26.3

What it does

The mod adds a puppet command that operators can use after installing it. The join subcommand spawns a puppet at the position where a player last logged off, while spawn places one at a given position. The shadow subcommand makes a puppet join the place of an online player. Puppets are ticked in the correct tick phase, and their actions are simulated on the server.

Players can take over a puppet and leave their own body behind in the world, a feature called puppeteering. Puppeteering stays off until a server owner turns it on in the config file. While puppeteering, the player appears to other players as the puppet, and the original body resumes its position with its inventory once the player stops. Anything done through the puppet persists after stopping, and stats and advancements stay tied to the account. Because the account is still in use, someone can run a command that targets the player's name.

PuppetPlayers is a Fabric mod, released under the MIT License and open source. It runs on the server only, so players join without installing it. Files exist for 1.21.5 – 26.3, with 2.1.0+26.3 as the latest file. Fabric API and Fabric Language Kotlin are required.

Key features

  1. Puppet spawning

    Spawn and join subcommands place a puppet at a chosen position or where a player last logged off.

  2. Shadow mode

    The shadow subcommand lets a puppet join the place of an online player.

  3. Server-side actions

    Puppets send packets and interact with the server as a real player does, with actions simulated on the server.

  4. Puppeteering

    A player can take over a puppet, leaving the original body behind, and return to it later with its inventory.

Compatibility

Latest build for each game version and loader.

26.x5 of 5 versions with builds
26.32.1.0+26.3
26.22.0.2+26.2
26.1.21.6.2+26.1.2
26.1.11.5.2+26.1.1
26.11.5.0+26.1
1.21.x7 of 7 versions with builds
1.21.111.4.0+1.21.11
1.21.101.2.3+1.21.9
1.21.91.2.3+1.21.9
1.21.81.0.8+1.21.8
1.21.71.0.4+1.21.8
1.21.61.0.4+1.21.8
1.21.51.0.0+1.21.5
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Required 2

Fabric APILightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Required
Fabric Language KotlinThis is a mod that enables usage of the Kotlin programming language for Fabric mods.
Required

Use cases

Who it’s for: Server owners and operators who need fake player accounts that behave like real players, and players who want to control a puppet from their own account.

How it compares

Full comparison

Carpet Org Addition is server-side and open source under the MIT License, with files for 1.19.4 – 26.3, and players outside the server need nothing. Fake AFK is also server-side and open source, but under the GNU Lesser General Public License v3.0 only, and it is published for 1.20 – 26.2. PuppetPlayers covers 1.21.5 – 26.3 with server-side use only and is not a general carpet addon.

ModLoadersGame versionsEnvironmentUpdated
PuppetPlayersFabric1.21.5 – 26.3Server-side only2026-09-15
Carpet Org AdditionFabric1.19.4 – 26.3Server required, client optional2026-09-27
Fake AFKFabric1.20 – 26.2Server-side only2026-07-10

Questions

Does PuppetPlayers need Carpet installed?

No. PuppetPlayers is a standalone Fabric mod. Carpet's fake player actions work alongside it, and the author recommends the provided actions instead.

Do players need to install PuppetPlayers?

No. The mod is server-side only, so only the server needs it and players join without installing anything.

Why is puppeteering disabled by default?

The feature must be enabled in the config before a player can take over a puppet and leave their body behind.

In the catalog

PuppetPlayers is one of 29,952 Game mechanics mods on ModsFinder, and one of 19,630 Game mechanics mods for Fabric. 8,071 mods support Minecraft 26.3.

More from senseiwells

All projects

Similar mods

What the author says

Modern, simple implementation of the fake players implemented originally in Carpet Mod. There are some fundamental differences to how these fake players are implemented in comparison to the original implementation in Carpet Mod.
senseiwells, on the Modrinth page

Official listing

Owner
senseiwells
Published
2025-05-28
Updated on Modrinth
2026-09-15
Facts verified
2026-10-15

Tags