Mastering CosmicNPCs: Motion Capture and NPC Replay in Minecraft
If you have ever wanted to clone your own movements in Minecraft and turn them into a fully interactive NPC, CosmicNPCs is the mod that makes it happen. It records your actions in real time, then replays them through a custom-named, custom-skinned entity that can break blocks, shoot bows, chat, and even ride horses. Whether you are building adventure maps, creating cinematics, or just want a doppelganger to show off your parkour skills, this tool adds a layer of performance capture that feels surprisingly natural inside the blocky world.
What Exactly Does CosmicNPCs Do?
At its core, CosmicNPCs is a simple motion capture mod. You start a recording, perform any supported action, stop the recording, and later spawn an NPC that mimics everything you did. The mod tracks movement, block breaking and placing, right-click interactions, using ranged weapons, swimming, crouching, sending chat messages, dropping items, and even equipping armor. The replay NPC can carry a custom name, wear any skin you provide, and optionally use a different entity model such as a chicken or villager.
Version 1.4 introduced a loop feature and several quality-of-life improvements, making it easier to create repeating scenes or patrols. The mod also includes a built-in command-hotkey system that lets you bind NPC spawn commands to a single key press, effectively turning your keyboard into a director’s control panel.
Recording Your Performance
Getting started is straightforward. Open the chat and type:
/npc-rec <Filename>
Replace <Filename> with a name of your choice — this becomes the record file you will reference later. For example, /npc-rec leyla1 begins capturing. Now everything you do, from walking and mining to firing a crossbow, is saved. When you are finished, use the same command again to stop recording. The file is stored automatically, ready for playback.
Before you jump into recording, you need to have the mod installed. Many players find it easiest to manage mods through a dedicated launcher. For instance, you can grab CosmicNPCs directly from the foxygame.net launcher, a flexible and modern Minecraft launcher that lets you browse and install mods right from its menu, no manual folder diving required. Once loaded, the mod’s commands become available in any singleplayer world or on a server where it is installed.
Replaying Your Actions as an NPC
Once a recording exists, spawn the NPC with:
/npc-play <Filename> <NPC Name> <Skin Filename> [Model]
Each argument controls a different aspect:
- Filename – the record file you created (e.g.,
leyla1). - NPC Name – the name displayed in the nametag and chat.
- Skin Filename – the name of the texture file without “.png”. Use
defaultif you want the vanilla Steve or Alex look. - Model (optional) – any valid Minecraft entity model, such as
minecraft:chickenorminecraft:villager. If omitted, the standard player model is used.
For example, /npc-play leyla1 Leyla leyla_evil spawns a player-model NPC named “Leyla” wearing the leyla_evil.png skin. If you want a chicken that repeats your actions, try /npc-play gchicken4 GreenChicken green_chicken minecraft:chicken. The NPC will walk, break blocks, and even cluck through chat messages exactly as you did.
Advanced Customization with Settings
When you specify a model, you can add curly brackets at the end of the command to fine-tune behavior. The format is {Setting:Value}, and multiple settings are separated by commas. This is where CosmicNPCs truly shines for map makers.
Available settings include:
- ShowNameTag – 0 (invisible), 1 (always visible), 2 (visible only when looked at).
- Invulnerable – true/false or 1/0, makes the NPC immune to damage.
- UseCommands – allows the NPC to execute commands during playback.
- IsChild – true/false, spawns a baby variant of the model.
- Layer – adds a secondary texture layer (e.g., glowing eyes). Layer files go in
.../config/cosmicnpcs/resources/textures/layers. - VillagerType and Profession – for villager models, set biome type and job.
- Color – for sheep, set wool color; “rainbow” gives a rainbow sheep.
- Sheared, Charged, Saddled, Head – control specific mob states like sheared sheep, charged creeper, saddled pig, or snow golem head block.
- MushroomBlock – defines the block on a mooshroom’s back.
- Armor – currently sets horse armor on horses.
An example command with multiple settings: /npc-play leyla1 Leyla leyla_evil minecraft:player {ShowNameTag:1,Invulnerable:1,Layer:green_eyes}. This spawns an invulnerable NPC with a visible nametag and an extra glowing eye layer.
Using Custom Skins
To give your NPC a unique appearance, place your 64x64 pixel skin file (for player models) inside .../config/cosmicnpcs/resources/textures/main. Always use lowercase filenames because Minecraft cannot process uppercase letters in resource paths. On multiplayer servers, every player must have the same skin files in their local texture folder; otherwise, they will see the default Steve or Alex instead of your custom design.
The Command GUI: Instant NPC Spawning
CosmicNPCs includes a handy command-hotkey system called the Command GUI. Press Numpad 3 to open the interface, where you can set a command on each page. Press Numpad 9 to execute the command of the current page. Pressing Numpad 9 again moves to the next page, so you can queue multiple NPC spawns and trigger them in sequence. This is perfect for live performances or adventure map events where you need to summon actors on the fly without typing long commands.
Version Differences and Compatibility
If you play on older Minecraft versions, some features are limited:
- 1.12.2 (CosmicNPCs-1.2.1): Only six models are available (Player, PlayerSlim, Villager, Witch, Vex, Chicken). The texture folder is located at
.minecraft/config/cosmicnpcs/assets/npctextures. Only ShowNameTag and Invulnerable settings work, and values must be 1 or 0 (true/false not accepted). NPCs can use commands by default. - 1.7.10 (CosmicNPCs-1.1): No model argument exists; only the default player model. Textures go in the same npctextures folder. You can add “Invulnerable” as an extra argument after the skin name to make the NPC invulnerable. Skins must be 64x32 instead of 64x64, and command execution by NPCs is not supported.
Conclusion
CosmicNPCs transforms Minecraft into a stage where your own recorded performances become permanent actors. The mod’s straightforward recording and playback commands, combined with deep customization through model selection and settings, give builders and storytellers a powerful tool for creating dynamic scenes. The loop feature and Command GUI make repeated sequences effortless, while the ability to use any entity model opens up comedic and dramatic possibilities. Whether you are crafting a haunted mansion with ghostly player echoes or a bustling village where every villager acts out a scripted routine, CosmicNPCs delivers motion capture simplicity without sacrificing creative control. Just remember to keep your skin filenames lowercase and share textures with friends on servers, and you will have a reliable NPC companion ready to replay your every move.