RetroConsole

RetroConsole brings libretro emulation into Minecraft 1.21.1 (NeoForge). Place a console in your world, build a TV wall from Screen blocks, browse your game library, and play on in-world displays or in a fullscreen viewer.

Early release (0.1.0) — expect rough edges. Feedback welcome on GitHub.

What you get

• Retro Console block with a game library UI — tabs per system, search, favorites
• Screen blocks that form multiblock TV walls (console must touch the wall)
• Fullscreen TV view with volume, quick save/load (F5/F6)
• Server-side emulation — video and audio stream to nearby players
• Per-player saves, play-time stats, PS2 memory-card sync
• In-game config UI — paths, streaming distances, session limits, video presets
• Hardware-render cores (PS2, PSP, Dreamcast) via bundled headless OpenGL helper

Requirements

| | |
|—|—|
| Minecraft | 1.21.1 |
| Loader | NeoForge 21.1.x |
| Java | 21 |
| OS | Windows or Linux (64-bit) |

macOS is not supported.

This mod does not ship libretro cores, BIOS files, or ROMs. You must supply them yourself and only use content you have the legal right to use.

Quick start

1. Install the mod JAR into your mods folder.
2. Launch the game — config/retroconsole/ is created automatically.
3. Download libretro cores (.dll / .so) from the libretro buildbot → config/retroconsole/cores/
4. Add ROMs to config/retroconsole/roms/<system>/ (e.g. nes/, gba/, ps2/)
5. For PS2 / Dreamcast: add BIOS to config/retroconsole/system/ (see wiki/README on GitHub)
6. Craft blocks (or use the Retro Console creative tab)
7. Place the console so it touches your screen wall. Right-click → library → Launch.
8. Right-click again while playing → fullscreen TV view.

TV screens

• Screens link only by physical contact with the console.
• Same facing/orientation → one rectangular wall.
• Look down/up sharply to place floor/ceiling screens.

Tested cores (0.1.0)

Tested on Windows 11. Other libretro cores may work but are not guaranteed.

| Core | System |
|——|——–|
| nestopia_libretro | NES |
| snes9x_libretro | SNES |
| mgba_libretro | GBA |
| genesis_plus_gx_libretro | Genesis / Mega Drive |
| pcsx_rearmed_libretro | PS1 |
| pcsx2_libretro | PS2 (needs BIOS) |
| ppsspp_libretro | PSP |
| flycast_libretro | Dreamcast (needs BIOS) |

Supported catalog folders also include: gb, sms, psp, segacd, saturn — depending on which core you install.

Multiplayer

On a dedicated server, ROMs and cores live on the server. Emulation runs server-side; clients receive video/audio streams. Saves and stats are per-player on the server.

Configuration

Open ⚙ in the library, or Mods → RetroConsole → Config.

• retroconsole-common.toml — folder paths
• retroconsole-server.toml — streaming distances, session limits (maxCoreSlots, maxPcsx2Sessions), video quality presets

Controls (defaults)

Emulator: Arrow keys = D-Pad · Z/X/C/V = A/B/X/Y · Q/W/E/R = L1/R1/L2/R2 · Enter = Start · Right Shift = Select · I/K/J/L and T/G/F/H = analog sticks
TV view: F1 = help · F5/F6 = quick save/load · Esc = exit
Rebind under Options → Controls → Retro Console.

Legal

• RetroConsole is not RetroArch and is not affiliated with the libretro project. It implements the libretro API only.
• No ROMs, BIOS, or cores are included. You are responsible for complying with copyright and core licenses.
• Mod license: GPL-3.0. Source: GitHub

Links

• Source & full docs: github.com/Gaigen/retroconsole
• Libretro cores: buildbot.libretro.com