Bulletpies · wiki
Emerald OS icon

Emerald OS

Your villagers traded at fair prices with zero fees. We identified this as an inefficiency

BuiltForgeNeoForgeFabric1.21.11.20.1
Status
Playtested for many rounds; store pages written, unpublished
Mod loader
Forge, NeoForge, Fabric
Minecraft
1.21.1, 1.20.1
Who installs it
Everyone on the server needs it

What it is

Emerald OS turns villager trading into a tech company, and puts you in charge of it. You implant a Villager Chip in a villager, they become an employee with a number, and a craftable phone, the Trade Tablet, lets you browse and buy from every chipped villager in range without walking anywhere. The tablet has a boot screen, an app grid, ads, paid upgrades and a convenience fee, all written in flawless corporate deadpan. Later there is a stock market, and the market has a button labelled FINANCIAL ADVICE that says "No."

The first chip feels like a shortcut: no more running to the librarian. Then the tablet boots with a loading bar that says "Downloading more RAM (village-sourced)", an ad slides in for hot single pillagers in your area, and you notice that trades under three emeralds now carry a one-emerald convenience fee, which you can remove by buying Premium, from the people who invented the fee. By the time you have crafted a Stonks Terminal, watched an iron golem die and seen GOLM dip because of it, and read a headline about Employee #4821 filing a dream about a slightly larger hut, you have stopped playing Minecraft and started running a company. Nobody in the village agreed to any of this. The paperwork says otherwise.

👥 Playing with friends

Set your network public and strangers can trade your staff while you take a commission

⚠️ Before you install

  • Every placed antenna force-loads its own chunks. A large tower network keeps a lot of world ticking whether you are there or not.
  • Chipping is one-way. There is no way to un-chip a villager once you have onboarded them.
  • Trading past five times in one Minecraft day can crash the ticker you touched, and the message telling you is private.
  • This is satire about fintech, told with a straight face. It taxes, upsells and manipulates you on purpose.

Your first 5 minutes

New to this mod? Do these in order and you will have seen the point of it.

  1. Craft a Chip Base: two copper ingots, redstone and a gold nugget.
  2. Combine a Chip Base with an emerald for two Villager Chips, then right-click a villager to onboard them.
  3. Craft the Trade Tablet (glass, iron, an emerald and a Chip Base) and right-click the air to boot it.
  4. Open TradeLink and buy from your new employee without walking to them.
  5. Buy something cheap and read the convenience fee. Then read what Premium costs.
  6. Save 16 emeralds for the Search Bar in the Store, and read the terms while you are there.

How it works

Chipping the workforce

Use a Villager Chip on any villager and they join your employee directory with a permanent employee number, greeted by a line about their orientation packet and a welcome to the Program. A small badge renders beside a chipped villager's head. Chips stamp the chipper's UUID, so your staff are yours. There is no chip removal tool.

Tip: Baby villagers show as Unpaid Interns and legally cannot sign contracts yet. Nitwits are listed as Consultants.

The Trade Tablet

The tablet boots with a logo, a loading bar and a rotating joke, then opens onto a phone-style app grid: TradeLink, Store, Investments, AutoSell, Village News, My Network and Portfolios. Locked tiles do not hide themselves; they upsell you to the Store. TradeLink lists every chipped villager in coverage with their rank (Intern through C-Suite) and lets you close their trades from where you stand, with server-side checks on range, stock and funds. Boot time gets faster the more upgrades you own.

Tip: The Skip button on the boot screen appears about 90% of the way through the boot.

Fees and the Emerald Store

Emerald payments below three emeralds incur a one-emerald convenience fee. In-tablet upgrades are Search Bar (16 em), Premium (32 em, which removes the ads and the fees), Pro (64 em, which unlocks investments, AutoSell and network controls) and Haggle (128 em, which requires Pro). Selling to villagers is never taxed; the fee applies to purchases only. The store's fine print notes that all sales are final and licenses are valid on this specific device only.

Tip: Emerald OS 2.0 is listed in the store as SOLD OUT with the description "Coming never."

Haggle and Section 4.2

The Haggle upgrade takes twenty-five percent off emerald costs by having employees volunteer discounts. It also carries an undisclosed twelve-percent chance per discounted trade that a non-obedient villager reads Section 4.2 and starts fighting the chip, which locks their trades until you install an Obedience Chip. Already-obedient staff are immune, and a resisting villager gets a pulsing red marker on their badge. Section 4.2 is never printed anywhere; the terms note only that it applies, and has always applied.

Tip: Haggle costs 128 emeralds and needs Pro first, so the risk arrives late and expensively.

Obedience Chips and the Remote Control

An Obedience Chip installs on any already-chipped villager and permanently ends the discussion ("the conversation, but concluded") and comes with an exclusive contract, so only the installer can trade with that villager. You cannot install one on somebody else's compliant staff; pacifying an actual rebel is allowed. The Remote Control toggles an uplink: while it is on, your obedience-chipped villagers within 48 blocks follow you, and right-clicking a block dispatches them to it.

Tip: The remote's antenna visibly extends when the uplink is live. Toggle it off and normal villager AI resumes.

Village Bell Networks coverage

A Villager Antenna is a coverage tower with a 48-block radius. Your tablet reaches towers within 48 blocks of you, towers relay to other towers within 96 blocks, and any chipped villager within 48 blocks of a connected tower is tradeable. Antennas keep their own chunks loaded, because business continuity does not stop when you look away. Every one of those distances is configurable.

Tip: Chain towers across the map and you can trade with a village you are nowhere near.

The Stonks Terminal and the Emerald Exchange

The terminal is a block with a candlestick chart, a marquee news ticker and buy buttons in 8 and 16 emerald sizes. There are five tickers plus an index fund: EMC the blue chip, LAPIS which is "definitely not just a rock", VBN whose price scales with how many antennas exist in the world, GOLM which crashes whenever an iron golem dies anywhere loaded, NITWIT which pays a dividend of one poisonous potato per day held, and DIRT, described only as "A fund. It holds things. Diversified, allegedly." Prices are a deterministic function of game time plus a ledger of shocks that world events append.

Tip: Hold over 64 emeralds of one ticker and your personal price quietly biases downward. Whales get whale treatment.

Overtrading, and the Founder's Key

You get five trades per Minecraft day; past that, each further trade rolls a chance, six percent per excess trade and capped at fifty, to crash the ticker you touched by fifteen percent, told to you privately. Sell out of a position entirely and your chart pumps up to plus forty percent over about seven minutes, returning to normal the instant you buy back in. DIRT alone is immune to shocks, whale bias and day-trade crashes, and nothing in the interface says so. The Founder's Key ends the game the other way: hold at least half the outstanding LAPIS supply when you use it and you cash out your whole position at the full pre-pull price with no fees, LAPIS is pinned to the floor forever, everyone on the server is told, and further buys are refused pending "investigation".

Tip: The key checks your holdings when you use it, not when you craft it. The advancement is Nothing Personal, Kid.

Items & blocks

Chip Base

Chip Base

The shared component in every Emerald OS product. Nothing in the mod is craftable without it.

Where: Shapeless: two copper ingots, redstone and a gold nugget, for two.

Villager Chip™

Villager Chip™

Onboards a villager into your employee directory and gives them an employee number and a badge.

Where: Shapeless: a Chip Base and an emerald, for two.

Obedience Chip™

Obedience Chip™

Resolves resistance permanently and binds that employee to an exclusive contract with whoever installed it. Also required for Remote Control.

Where: Shapeless: a Chip Base, a diamond, a ghast tear and a blaze rod.

Trade Tablet

Trade Tablet

The phone. Boot screen, app grid, employee directory, store, ads, market tab and your upgrade licenses, all stored on the item itself.

Where: Craft glass, iron ingots, an emerald and a Chip Base in a shaped recipe.

Villager Antenna

Villager Antenna

A coverage tower with a 48-block radius that relays to other towers up to 96 blocks away. Keeps its chunks loaded.

Where: Craft iron bars, a Chip Base, iron ingots and an emerald.

Stonks Terminal

Stonks Terminal

The Emerald Exchange as a placeable block: chart, tickers, portfolio, news ticker, and a FINANCIAL ADVICE button that answers "No."

Where: Craft an Antenna, a Trade Tablet, a Chip Base and gold ingots.

Remote Control™

Remote Control™

Toggles an uplink that makes your obedience-chipped villagers within 48 blocks follow you, or dispatch to a block you point at.

Where: Craft a stick, a Chip Base, iron and gold.

Founder's Key

Founder's Key

Rug-pulls LAPIS if you hold at least half the supply: full price for you, permanent floor for everyone else, one server-wide announcement.

Where: Craft three lapis lazuli, a gold ingot and a diamond in a key shape.

Lore

Flavour, not rules. None of this changes how the mod behaves.

Village Bell Networks LLC

Every antenna you place is infrastructure belonging to Village Bell Networks LLC, whose slogan is "Signal by Village Bell Networks LLC" and whose stock, VBN, rises with the number of towers in the world. It is the only ticker in the game with real fundamentals, and the fundamentals are you. Villagers accept the Terms of Service by existing within range of the infrastructure.

Section 4.2

Section 4.2 is referenced in the store's terms, in the Haggle purchase confirmation, and in the message you get when an employee stops trading with you. It is never printed. What is known is that an employee who reads it stops cooperating, and that the Obedience Chip is described as clearing "resistance, provocation, and 'having a point'" instantly.

The Employee Retirement Program

The Portfolios app shows what your chipped villagers have done with their trade earnings, complete with live profit and loss and a morale note. One employee is down forty percent; the note reads "Morale unaffected. He does not know." Another "has requested to be addressed as 'an investor'." The app's subtitle is "Their earnings, professionally reallocated."

Jokes & trivia

Bits you might miss

  • The tablet's boot messages include "Consulting the org chart (it is a circle)", "Accepting all cookies on your behalf" and "Negotiating with Iron Golem firewall".
  • The Stonks Terminal has a button labelled FINANCIAL ADVICE. Pressing it prints: "No."
  • Footer tickers along the bottom of the tablet include "Uptime: yes.", "Your data is safe with us and our 400 partners." and "Emerald OS is not responsible for your poverty."
  • The exchange's disclaimers include "Not FDIC insured. FDIC does not exist here." and "Past performance guarantees future performance."
  • Fifty-plus rolling news headlines, all filed with total seriousness: "BREAKING: The bell rang. Employees confirm they heard the bell." and "SPORTS: An Iron Golem stood in one spot all day. Fans call it a classic."
  • The in-tablet ads are clickable and open a full sponsored post: "12 Pillagers Want To Raid Your DMs", "LapisCoin™: You're Still Early (You Are Not)", and one for Obedience Chips that asks "Why negotiate with staff when you can update their firmware?"
  • Every ad closes with the same line: "Sponsored. This ad was selected for you because: you exist."
  • Market headlines are generated live, so you will eventually get "MARKET CLOSED FOR EMOTIONAL REASONS" and "BREAKING: NOTHING, BUT LOUDLY".

From the workshop

  • DIRT quietly compounds about one percent per in-game day and is immune to every crash mechanic in the game. The UI never hints at this, on purpose; the author's note is that players should discover it themselves.
  • Market moves used to be broadcast in chat. They were removed for the same reason: discovery beats announcement.
  • A villager strike system shipped, was playtested, and was deliberately shelved. The machinery is still in the code, dormant. The conclusion was that friction is not the same thing as comedy, and the Obedience Chip was friction enough.
  • Convenience fees originally applied to your income too. That was cut after a playtest, on the grounds that it was too evil and players could not make money.
  • The mod id had to be renamed from emeraldos to emeraldospro for its store release, because a hyphen is not legal in a mod id. The Java package never changed.
  • On Fabric, items never get a chance to react to right-clicking a villager, because vanilla opens the trade screen first, so the chips had to be routed through a separate interaction hook that Forge does not need.

FAQ

Do the villagers mind?

Villagers accept the Terms of Service by existing within range of the infrastructure. Some of them do fight the chip, which locks their trades until you install an Obedience Chip.

Can I take a chip back out?

No. There is no removal tool. An "exit interview" shears variant is on the roadmap and has never been built.

Is the stock market random?

No. Prices are a deterministic function of world time plus a ledger of shocks caused by real events: a golem dying, a wandering trader arriving, a raid starting, or you making a large trade.

What actually is DIRT?

Consolidated Dirt Holdings. The tablet describes it as "A fund. It holds things. Diversified, allegedly." It is worth watching over several in-game days.

Is any of this balanced for survival?

There is a day-trade limit of five trades per Minecraft day specifically to stop the exchange becoming an emerald farm, and holding a large position biases your own prices downward.

Which builds exist?

Forge, NeoForge and Fabric on 1.21.1, and Forge, NeoForge and Fabric on 1.20.1. Forge 1.21.1 is the original the others are ported from.

Crafting recipes

Crafting recipe for Antenna
Antenna
Crafting recipe for Chip Base
Chip Base
Crafting recipe for Founders Key
Founders Key
Crafting recipe for Obedience Chip
Obedience Chip
Crafting recipe for Remote Control
Remote Control
Crafting recipe for Stonks Terminal
Stonks Terminal
Crafting recipe for Trade Tablet
Trade Tablet
Crafting recipe for Villager Chip
Villager Chip

Get it

Status: The jar compiles and the author has tested it himself, but it has not had a real playtest yet.

  1. Install Forge, NeoForge, Fabric for Minecraft 1.21.1, 1.20.1. The install guide walks through this assuming no prior knowledge.
  2. Drop the mod's .jar file into your mods folder.
  3. Everyone on the server needs it.
  4. Launch the game with that loader's profile selected.

📦 Where is the file?

This wiki documents the mods; it does not host them. Builds live in the project's own repository under mc-emerald-os/build/libs/.

Mod by Bulletpies. MIT, the one clause the lawyers couldn't monetize.

↑ Back to top · ← All mods