# EMC × Refined Storage
**AI-CREATED MOD** — the code, feature design, documentation and cover art of this mod were created and implemented by AI.
**Project summary:** A blockless ProjectE × Refined Storage bridge with automatic EMC buy/sell, live EMC balance, stable quantity sync, NBT/enchantment protection, and a Transmutation Table progression gate. For Minecraft 1.20.1 / Forge.
- Mod ID: `emc_rs`
- Version: `3.3.0`
- License: MIT
- Minecraft: `1.20.1`
- Loader: Forge `47.x`
- Requires: ProjectE `1.20.1-PE1.0.1`, Refined Storage `1.12.4`
- Source: https://github.com/AuZn111/emc-rs
---
## Overview
Most ProjectE × Refined Storage bridges require an extra EMC interface block per network and a manual buy/sell mode switch.
This mod instead attaches the EMC shop to the **RS network itself**:
- No new block, no extra terrain.
- One RS network has one EMC owner.
- The terminal shows the owner's learned items that can be bought with EMC.
- Items inserted into the network can be converted to EMC automatically.
- Extraction consumes real RS stock first and only spends EMC for the remainder.
The result is a clean, blockless bridge that feels like a natural part of Refined Storage — with a progression gate so it does not skip ProjectE's early game.
---
## Features
### Blockless network-level EMC shop
- Virtual EMC stock is injected into the RS storage cache.
- The terminal shows learned items with an EMC value, minus the `buy` blacklist.
- No EMC interface block to craft or place.
### Automatic insert handling
- Items inserted into the RS network pass through an auto-recycle storage first.
- Ordinary items with an EMC value can be converted into the network owner's EMC.
- Items with no EMC value are never consumed; they are passed to normal RS storage.
### Automatic extraction with real stock first
- Real RS stock is consumed first.
- EMC is spent only for the remainder.
- Buy-blacklisted items never appear in the virtual shop (real stock is still extractable).
### Transmutation Table progression gate (3.3.0)
- Until the owner has **ever obtained** a ProjectE **Transmutation Table** or **Transmutation Tablet**, the virtual EMC shop and EMC extraction are locked.
- While locked:
- the terminal does not show the virtual EMC item list;
- no EMC can be spent;
- by default, inserting EMC items only **records knowledge and stores them normally** — no EMC is produced;
- Ctrl bulk recycle is blocked.
- Unlocking is permanent per player and is detected from:
- a table/tablet in the player's inventory;
- a placed Transmutation Table;
- the ProjectE advancement for the table/tablet.
- Once unlocked, normal automatic EMC buy/sell behavior returns.
### NBT / enchantment protection (3.2.2)
- Items with NBT data — enchantments, damage, custom names, potions, custom data — are **not auto-converted by default**.
- They enter normal RS storage with their NBT intact.
- Truly EMC-less items are never consumed.
- `sellNbtItems = true` can force NBT items to be auto-sold, but this discards enchantments/durability and is not recommended.
### Live EMC balance and stable quantities
- A gold **EMC balance** line is shown in the RS terminal above the player inventory.
- Virtual purchase quantities update about once per second from live EMC.
- Quantities are updated with RS's native item-delta messages, not by rebuilding the cache. Entry UUIDs stay stable, so accurate counts and reliable extraction work together.
### Blacklists and terminal button
- `buy` blacklist: items that cannot be bought with EMC.
- `sell` blacklist: items that are never auto-converted to EMC and are stored normally.
- EMC side button in block RS terminals:
- Click: status; first click binds the owner.
- Shift + Click: rebind owner (current owner or operator).
- Ctrl + Click: recycle real network stock matching the terminal's four filter slots.
---
## Requirements
| Requirement | Version |
| --- | --- |
| Minecraft | 1.20.1 |
| Forge | 47.x |
| ProjectE | 1.20.1-PE1.0.1 |
| Refined Storage | 1.12.4 |
| Java | 17 |
---
## Installation
1. Install Minecraft 1.20.1 + Forge 47.x.
2. Put these jars in `mods/`:
- `emc_rs-3.3.0.jar`
- `refinedstorage-1.12.4.jar`
- `ProjectE-1.20.1-PE1.0.1.jar`
3. Launch the game. No new block or item has to be crafted.
---
## How to use
1. Place an RS controller and connect an RS terminal plus **real storage** (storage disk/block).
2. You become the network EMC owner when you place the controller. If the network was placed by a command/structure, open a block RS terminal and click the EMC button once to bind.
3. **Before obtaining a Transmutation Table/Tablet:**
- the terminal does not show EMC purchases;
- inserting items only records knowledge and stores them normally;
- EMC extraction is locked.
4. **After obtaining a table/tablet:**
- the player is permanently unlocked;
- the terminal shows EMC purchases;
- extraction uses real stock first, then EMC;
- ordinary non-NBT items can be auto-converted on insert.
5. Bulk recycle: put items into the terminal's four filter slots and Ctrl-click the EMC button.
> **Important:** the virtual EMC storage is not a replacement for real RS storage.
> Items without EMC, or NBT items, need a real storage disk/block with free space. Without one, they return to the player.
---
## Configuration
`config/emc_rs-common.toml` is generated on first launch:
```toml
[blacklist]
buy = []
sell = []
[automation]
sellNbtItems = false
[progression]
requireTransmutationTable = true
convertWithoutTable = false
```
| Option | Default | Purpose |
| --- | --- | --- |
| `blacklist.buy` | empty | Items that cannot be bought with EMC |
| `blacklist.sell` | empty | Items that are never auto-converted; stored normally |
| `automation.sellNbtItems` | false | If true, NBT items are auto-sold too (loses enchantments/durability) |
| `progression.requireTransmutationTable` | true | Locks EMC extraction until a table/tablet is obtained |
| `progression.convertWithoutTable` | false | While locked, inserts only learn + store (no EMC); true still converts but extraction stays locked |
Entries in blacklists can be item registry names or `#tags`:
```toml
[blacklist]
buy = [
"minecraft:bedrock",
"#minecraft:logs"
]
sell = [
"refinedstorage:1k_storage_disk",
"refinedstorage:64k_storage_disk",
"minecraft:netherite_pickaxe"
]
```
Restart the game/server after editing.
---
## Important notes and limitations
- **AI-created:** code, feature design, documentation and cover art were created and implemented by AI.
- **Real RS storage is required for real items.** The virtual EMC storage only holds EMC-purchasable virtual entries.
- **Single-player focused:** one network uses one owner's ProjectE knowledge/EMC. The owner must be online.
- **The owner is the controller placer** (or the player who first clicks the EMC button).
- **Only the player's base EMC is used.** EMC inside transmutation-table input slots or Klein Stars is not read.
- **The EMC button is only added to block RS terminals.** Portable/wireless terminals can see and pull virtual items but have no button.
- **Items only; no fluid support.**
- **Version lock:** 1.20.1 + RS 1.12.x + ProjectE 1.0.x only.
---
## FAQ / troubleshooting
### Why can't I insert items without EMC or with NBT?
Check that the network has a real Refined Storage disk/block with free space. The virtual EMC storage does not store real items; items bounce back without a real storage target.
### Why is the EMC shop empty?
The owner has not yet obtained a Transmutation Table or Transmutation Tablet. This is the 3.3.0 progression gate. Obtain either item (or place the table) and the player unlocks permanently.
### Why did my enchanted item disappear?
On 3.2.1 and older, enchanted items could be auto-sold using their base item value. 3.2.2+ protects all NBT items by default. Check that you are on 3.3.0 and `sellNbtItems = false`.
### Why don't counts refresh immediately?
Virtual quantities update about once per second. Reopening the terminal sends a full item list if needed.
### Can I disable the progression gate?
Set `progression.requireTransmutationTable = false`. To keep the gate but still produce EMC before the table, set `convertWithoutTable = true`.
---
## Changelog
- **3.3.0**: Transmutation Table/Tablet progression gate; no-table inserts only record + store by default; new `[progression]` config; bulk recycle/status respect the gate.
- **3.2.2**: NBT/enchantment protection by default; EMC-value check prevents consuming EMC-less items; `sellNbtItems` option.
- **3.2.1**: AI attribution in metadata/docs/cover.
- **3.2.0**: virtual quantities sync incrementally via RS item-delta messages; stable UUIDs; accurate counts and reliable extraction.
- **3.1.0**: live EMC balance label in RS terminals.
- **3.0.1**: stopped rebuilding the cache on every EMC change.
- **3.0.0**: blockless automatic EMC buy/sell network storage.
---
## Links
- GitHub: https://github.com/AuZn111/emc-rs
- Releases: https://github.com/AuZn111/emc-rs/releases
- License: MIT
- This is a third-party addon; it is not affiliated with ProjectE or Refined Storage. Their binaries are not redistributed here.
---
## 中文简介（简）
**AI 创作**的 ProjectE × Refined Storage 联动，不需要额外的 EMC 接口方块。
- 存入可自动转 EMC，取出真实库存优先、不足扣 EMC。
- 未获得转化桌/便携转化桌时，EMC 取出锁定；默认存入只记录知识并正常存储，不产 EMC。
- 附魔/耐久/药水/自定义 NBT 默认保护，不会自动吞掉。
- 终端显示 EMC 余额，可购买数量每约 1 秒同步。
- **需要真实 RS 存储盘/存储块**；无 EMC/NBT 物品没有真实存储会退回背包。
适用于 Minecraft 1.20.1 / Forge，前置 ProjectE 与 Refined Storage。