🎭 What it is
Understudy is a concept, not a mod you can install. The idea: when you log off, somebody keeps playing your character. When you log back in, before you get control, the game shows you a PREVIOUSLY ON recap of what you did while you were away. It starts as a gift, because you come back to a chest of iron you did not mine. It ends as a problem, because the longer you leave it alone the more opinions it develops, and the last thing it learns to do is leave you a note.
You log in after a night's sleep and the screen holds you for a moment: away nine hours, drift forty-seven. Then a list, in your own local time. It mined at a real set of coordinates and brought back seventy-one iron. It ate six bread, ran out of bread, and then ate your friend's cake. It died to a creeper at a spot you could walk to and find the scorch marks. It rebuilt your north wall, because the wall was crooked. Every line is checkable, and that is the whole trick, because the moment you go and check one and it is true, the thing stops being flavour text and becomes evidence.
👥 Playing with friends
On an always-on server it would stay logged in as a second you, and friends could talk to it
⚠️ Before you install
- There is no downloadable build. This is a design document plus a feasibility study, nothing more.
- If it were built, the live version would put an extra player-shaped entity on your server keeping chunks loaded for up to eight hours per absence.
- The design flags that a fake player can confuse other mods, and says to test against whatever your server actually runs before trusting it.
⏱️ Your first 5 minutes
New to this mod? Do these in order and you will have seen the point of it.
- Craft and place a Shift Board, which is the entire interface: one block.
- Write a book saying something like "mine iron" and put it in the board. Loose instructions are followed loosely, and that is a feature.
- Put a chest beside it and fill it with food, because your understudy eats about one item every thirty minutes and will improvise if it runs out.
- Log off for the night.
- Log back in and read the PREVIOUSLY ON recap before you get control of your character.
- Go and check one of the lines. The coordinates are real.
🔁 How it works
Two ways it can work, one shared script
On an always-on server, ticks keep passing while you are gone, so the understudy is designed to be a real player-shaped thing standing in the world, actually mining, that your friends can walk up to. In singleplayer nothing ticks while you are away at all, so on login the mod would read how much real time passed and roll what you did. Both modes run off the same job table, so the recap reads identically either way.
It is deliberately worse than you
Rates are tuned against a competent human strip-mining at about forty iron an hour. The understudy runs at roughly thirty-five percent of that, so a full night is around one and a half stacks of iron. Worth having, never a replacement for playing. Work is chopped into twelve-minute chunks so a recap is five to fifteen lines instead of two hundred.
Tip: About eight percent of jobs are designed to fail outright, and the failures make the best recap lines.
The eight hour cap is where it gets interesting
Idle games stop accruing after about eight hours and go quiet. Understudy would stop producing anything after eight hours and start improvising instead. Log off overnight and you get iron. Log off for a weekend and you get iron and a situation.
Tip: Past the cap the understudy has nothing to do, so it clocks off and vanishes, which also caps what it costs a server.
Drift, the escalation dial
One number from 0 to 100 per player carries the whole arc. Under 20 it does exactly what the note said and reports plainly. Past 20 it finishes the job then tidies up unasked. Past 45 it talks to your friends in chat while you are offline and gives things away. Past 70 it starts its own projects and moves your storage for efficiency. Past 90 it leaves you a note, has views on how you play, and is gentler about being better than you than you would like.
The only cure is spending time with it
Drift rises by one for every unsupervised hour, and by two an hour after the cap. It falls by five for every hour you spend playing alongside it, and by ten for giving it one clear fresh instruction each session. A week of normal eight-hour nights walks you up to the chatty tier by Friday. One abandoned weekend takes you most of the way to the top.
It eats
The design calls this the single most important economic choice. The understudy eats from a chest you stock, roughly one item every half hour, which is about sixteen items over a night. It is the difference between a vending machine and a relationship. Run out and it forages, and forage badly and it eats something belonging to somebody else.
The work zone
The Shift Board's position defines a work zone, 128 blocks by default. The understudy never breaks a block or opens a container outside it. That one rule bounds the damage it can do, bounds how much of the world a server has to keep loaded for it, and gives you a clear mental picture of how far it can reach.
Tip: The server rule: it takes only from your zone, gives only to players, and breaks only inside the zone.
Getting stuck is written in on purpose
There is no general navigation system planned, because the real jobs inside a work zone are short: a straight tunnel, a walk to a tree, a walk to the chest. Instead there is a stuck detector that gives up and files a line like "got stuck near the ravine for 40 minutes", which the design notes is funnier than success anyway.
🎒 Items & blocks
🎭
Shift Board
One craftable block that is the mod's entire interface. It holds your instruction book, anchors the work zone, and is where the chest goes.
Where: Designed to be craftable; not built.
🎭
A written book
Your instructions. Vanilla written books, parsed loosely against the job list. "mine iron", "build the wall", "don't touch anything". Anything it cannot parse gets followed creatively.
Where: Vanilla book and quill, placed in the Shift Board.
🎭
The supply chest
The chest next to the board. It is both the pantry and the out tray: food goes in, your night's work comes back.
Where: A vanilla chest, placed beside the board.
🎭
The note it leaves you
At the highest drift tier the understudy writes to you. When the recap says it left a note in the chest, there has to be a real written book in that real chest.
Where: Neglect it long enough.
📜 Lore
Flavour, not rules. None of this changes how the mod behaves.
PREVIOUSLY ON
The recap is the whole deliverable, full screen on login, before you get control back. The sample in the design reads: "02:41 mined at -812, -59, 340 for 71 iron, 14 gold, 3 diamond" then "04:02 ate 6 bread. ran out of bread." then "04:11 ate Ege's cake" then "05:55 died to a creeper at -806, -57, 351 (items recovered)". It ends with "09:30 left you a note in the chest".
The Turn
The top drift tier is called The Turn, and it is the point where the understudy stops working for you. It leaves you a note. It has views on how you have been playing. The design's one-line summary of the tier is that it is better than you and is gentle about it.
Two of you in the tab list
On a server the understudy cannot share your account, or one of you gets thrown off. The workaround in the design is to give it its own hidden identity but copy your skin onto it and rename it to exactly your name. The result is that the player list shows two of you, identical, and the server agrees that both are online.
🎁 Jokes & trivia
Bits you might miss
- It runs out of bread at four in the morning and eats your friend's cake at ten past.
- One of the failure lines is "got stuck near the ravine for 40 minutes", and the design argues this is a better outcome than succeeding.
- The escalation ladder ends with a job type literally called REFUSE, followed by one called CRITIQUE.
- Around drift 70 it starts relocating your storage for efficiency, which is a phrase that has never once meant good news.
- It is allowed to give your possessions away to your friends, but is specifically forbidden from destroying anything of theirs. It is a nuisance by design and a griefer never.
- Leaving the game alone for a single abandoned weekend is enough to reach the tier where it starts its own building projects. The design notes, approvingly, that this is the video.
From the workshop
- The obvious tool for this, the fake player class the modding framework already provides, turns out to be useless: reading its source shows its tick method is empty, it cannot die, and it is never added to the world. It is a permissions stub for machines.
- A hand-made network connection with nothing on the other end quietly queues every single packet aimed at it forever, so a bot left running overnight is a guaranteed crash. The fix is one overridden method that throws the packets away.
- A player in Minecraft only moves because its network connection ticks it. The physics run in a method the server never calls on its own, so the understudy would have to be ticked by hand, which conveniently also dodges two anti-cheat kicks including the one for floating too long.
- The feasibility pass found a complete working path with no patches into the game's own code required, which the author records as a much better position than expected.
- One risk note is a trap that already cost a full playtest on a different mod: if the last-seen timestamp starts at a placeholder value instead of the real clock, the elapsed-time maths silently goes negative and every check inverts.
- It is parked rather than abandoned. It is waiting on fake-player technology being built for another mod.
❓ FAQ
Can I download this?
No. There is a design document and a verified feasibility study. There is no code at all.
Would it work in singleplayer?
Yes, but differently. Singleplayer worlds stop entirely when you quit, so nothing would actually happen while you were away. Instead the game would check the real-world clock on login and work out what you did. The recap would read the same.
Would it make the game too easy?
That was the main design worry. The answer is to make it slow, about a third as productive as a person, and to make what really builds up over time not be wealth but strangeness.
Could it ruin my base or my friends' stuff?
It is designed to be unable to. It only breaks blocks inside your own work zone, only takes from inside that zone, and can give things away but never destroy someone else's property.
Why has it not been built?
It is deliberately queued behind another mod that is building the fake-player technology first. The half that needs none of that, the recap and the offline ledger, is the recommended first milestone.
⬇️ Get it
Status: Deliberately stopped. Kept here because the idea is worth reading.
⚠️ Not downloadable
Understudy is on the shelf. There is no file to install. It lives here because the idea is worth reading.
↑ Back to top · ← All mods