0.1.1
Compatibility
Changes
Marionette
Spawn & control real fake players — on any server, any version.
Marionette spawns fully-functional fake players (real bots that actually join your server) and lets you control them with a clean command set: move them, make them attack/mine/use, manage their inventory, ride entities, and more.
Built from the ground up to be self-contained and universal — no external libraries to install, drop the jar in and go.
✦ Why Marionette
- Runs everywhere — Spigot, Paper, Purpur, Pufferfish and other forks, on every modern Minecraft version (including the very latest).
- Zero dependencies — no CommandAPI, no Adventure platform to install. Native Bukkit under the hood.
- Real players — fakes appear in the tab list, can be hit, can mine, can hold items, persist while you're offline.
- Lightweight — fast enable, no bloat.
- Clean UX — branded, well-formatted responses; a clickable /marionette list; a proper /help marionette.
✦ Features
- Spawn fake players at your location or any world/coords
- Persist while the creator is offline (configurable)
- Movement & posture: move, look, turn, sneak, sprint, jump, swap, sleep
- Actions: attack, mine, use, drop — once / continuous / interval
- Ride entities & vehicles
- Inventory: invsee, hold slot, drop item/stack/inventory
- Run server commands as a fake player
- Teleport, select, status, distance, exp transfer
- Per-player limits, permissions, configurable lifespan
✦ Commands
Base command: /marionette (alias /mar). Full list in-game with /marionette help.
/marionette spawn [name] [world] [x y z]
/marionette kill [names|-a] /marionette killall
/marionette list /marionette select /marionette status
/marionette tp | tphere | tps
/marionette attack|mine|use|jump|drop (once|continuous|interval <ticks>|stop)
/marionette move|look|turn|sneak|sprint|ride|swap|sleep|hold
/marionette invsee | expme | cmd | set | config
✦ Installation
- Drop Marionette-x.x.x.jar into your /plugins folder.
- Restart the server. That's it — no other plugins required.
✦ Permissions
- marionette.* — everything
- marionette.command.<name> — individual commands (e.g.
marionette.command.spawn)
Open-source & free. Suggestions and bug reports welcome!
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:caHRssE7:Rwf6yXIM"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:caHRssE7:Rwf6yXIM"
}

