RetroConsole
RetroConsole 0.3.0 将 libretro 模拟带入 Minecraft 1.21.1 —— 支持 NeoForge 和 Fabric。在世界中放置一台主机,使用 Screen 方块搭建电视墙,浏览你的游戏库,并在游戏内的显示设备上或通过全屏查看器进行游玩。
当前版本:0.3.0。 该移植版托管于 GitHub,并发布在 GitHub Releases(同一 JAR 文件也附在此项目的 Files 标签页中)。0.3.0 版本新增了 Fabric 构建版本,通过 mkxp-z 支持 RPG Maker XP / VX / VX Ace,并解决了重型核心加载或停止时世界卡死的问题。
早期发布版本——可能存在瑕疵。欢迎在 GitHub Issues 提交错误报告和截图。
我需要哪个文件?
| 加载器 |
文件 |
| NeoForge 21.1.x |
retroconsole-0.3.0+1.21.1-neoforge.jar |
| Fabric Loader 0.16+ |
retroconsole-0.3.0+1.21.1-fabric.jar — 需要 Fabric API |
两个构建包含相同的游戏代码,并读取相同的 config/retroconsole.json,因此如果你切换加载器,设置、存档和游戏统计信息都会保留。
0.3.0 版新增内容
-
Fabric 支持 — 该模组现已同时提供 Fabric Loader 和 NeoForge 版本,功能完全一致。
-
RPG Maker XP / VX / VX Ace 支持,通过 mkxp-z 核心实现 —— 每个游戏文件夹对应一个库条目,即使游戏会缩放窗口也能正确显示图片大小,并在缺少 RTP 时通过聊天消息提示具体名称,而不是让你面对黑屏。
-
启动和停止不再导致世界冻结——核心在各自的线程上引导、停止并保存快照状态;20 秒的 RPG Maker 加载时间不再阻塞游戏刻循环。
-
屏幕上的文字清晰可读——缩小比例时采用像素平均而非丢弃,使得小尺寸墙面上的单像素字符笔画得以保留。
-
启动反馈 — 当核心启动时,电视会显示带有已耗时间的“正在启动 <游戏>”卡片,而不是具有误导性的无信号。
-
游戏内配置界面 — 一个设置屏幕(⚙),用于路径、流式传输距离、会话限制和视频预设。
-
verboseLogs — 可选的调试开关,用于心跳和 GL 诊断;默认关闭。
你将获得
- 带有游戏库界面的复古主机方块——按系统分标签页,支持搜索与收藏
- 屏幕方块可组成多块电视墙(主机必须紧贴墙壁放置)
- 全屏电视视图,支持音量调节与快速存档/读档(F5/F6)
- 服务器端模拟——向附近玩家流式传输视频和音频
- 每位玩家独立的存档、游戏时长统计、PS2 记忆卡同步
- 游戏内配置界面——路径设置、流式传输距离、会话限制、视频预设
- 通过内置的无头 OpenGL 辅助工具提供硬件渲染核心(PS2、PSP、Dreamcast、Doom 3、RPG Maker、3DS)
- 通过
boom3 核心运行 Doom 3——零售版或免费演示版均可
- 通过
mkxp-z 核心运行 RPG Maker XP / VX / VX Ace——支持 RTP 感知,每个游戏对应一个入口
- Nintendo DS / 3DS 模拟器,配备绝对触摸指针(DeSmuME、melonDS、Citra)
前置要求
|
|
| Minecraft |
1.21.1 |
| Loader |
NeoForge 21.1.x 或 Fabric Loader 0.16+(需 Fabric API) |
| Java |
21 |
| OS |
Windows 或 Linux(64 位) |
| GPU (HW cores) |
OpenGL 3.3+ |
不支持 macOS。
本模组不附带 libretro 核心、BIOS 文件或 ROM。你需要自行准备这些内容,并且仅使用你拥有合法使用权的内容。
快速上手
- 安装 NeoForge 21.1.x ——或安装带有 Fabric API 的 Fabric Loader——并将对应的模组 JAR 放入
mods 文件夹。
- 启动游戏——
config/retroconsole/ 目录会自动创建。
- 从 libretro buildbot 下载 libretro 核心(
.dll / .so),放入 config/retroconsole/cores/
- 将 ROM 添加到
config/retroconsole/roms/<system>/(例如 nes/、gba/、ps2/)。RPG Maker 游戏请放入 roms/rpgmaker/<game>/。
- 对于 PS2 / Dreamcast:将 BIOS 文件添加到
config/retroconsole/system/(详见 GitHub README)
- 合成这些方块(或使用复古主机创造模式标签页):
Retro Console Screen ×2
I I I G G G
I R I G R G
I I I I I I
I = iron ingot, R = redstone, G = glass pane
- 放置主机,确保其紧贴你的屏幕墙。右键点击 → 打开图书馆 → 启动。
- 播放时再次右键点击 → 进入全屏电视视图。
电视屏幕
- 屏幕仅通过与主机的物理接触进行链接。
- 朝向/方向相同 → 形成一个矩形墙面(L 形需拆分为独立的矩形)。
- 快速向下/向上查看以放置地板/天花板屏幕(类似 CC:Tweaked 风格)。
已测试核心 (0.3.0)
已在 Windows 11 上进行基础测试。其他 libretro 核心可能可用,但不保证兼容。
| 核心 |
系统 |
备注 |
fceumm_libretro · nestopia_libretro · quicknes_libretro · mesen_libretro |
NES / Famicom |
软件渲染 — 任选其一均可作为 NES 核心 |
snes9x_libretro |
SNES |
软件渲染 |
gambatte_libretro |
Game Boy / Game Boy Color |
软件渲染 |
mgba_libretro |
GBA |
软件渲染 |
genesis_plus_gx_libretro |
Genesis / Mega Drive, Master System, Game Gear, Sega CD |
软件渲染 |
desmume_libretro · desmume2015_libretro |
Nintendo DS |
软件渲染,双屏,触摸指针 |
citra_libretro |
Nintendo 3DS |
硬件 OpenGL,顶部 + 底部屏幕,触摸指针 |
pcsx_rearmed_libretro |
PS1 |
软件渲染 |
pcsx2_libretro (LRPS2) |
PS2 |
硬件 OpenGL,需要 BIOS,多控制台支持 |
ppsspp_libretro |
PSP |
硬件 OpenGL,多控制台支持 |
flycast_libretro |
Dreamcast |
硬件 OpenGL,需要 BIOS,多控制台支持 |
boom3_libretro |
Doom 3 |
硬件 OpenGL,游戏数据位于 roms/doom3/ |
mkxp-z_libretro |
RPG Maker XP / VX / VX Ace |
硬件 OpenGL,每个游戏文件夹对应一个条目,RTP 文件位于 system/mkxp-z/RTP/ |
easyrpg_libretro |
RPG Maker 2000 / 2003 |
软件渲染,异步核心(前端控制其时钟和音频),游戏以 .zip 或解压后的文件夹形式存放于 roms/easyrpg/ |
任何其他 libretro 核心都可以放入 cores/ 目录,并在 Other 标签页中按游戏选择(N64、Saturn …),但上述核心是 0.3.0 冒烟测试的一部分。mkxp-z 核心未包含在 libretro 构建机器人的构建中;请从 mkxp-z 源代码 自行编译。
多人游戏
在专用服务器上,ROM 文件和核心位于服务器端。模拟运行在服务端;客户端接收视频/音频流。存档、快速存档以及游戏统计数据均在服务器端按玩家独立保存。
在多人游戏中,客户端不会扫描其本地的 roms/ 文件夹 — 游戏库来源于服务器的 config/retroconsole/ 目录。
配置
打开图书馆中的 ⚙ 图标,或进入 Mods → RetroConsole → Config(NeoForge;Fabric 请使用 ⚙ 按钮)。
config/retroconsole.json — 路径、串流距离、会话限制(maxCoreSlots、maxPcsx2Sessions)、视频预设、调试开关
- 从 0.2.6 或更早版本升级?旧的
retroconsole-common.toml / retroconsole-server.toml 会被读取一次并合并到新文件中;随后这些 toml 文件将被忽略。
- 在专用服务器上,请编辑服务器端的副本 — 客户端无法通过 UI 更改服务器的串流或视频设置。
控制键(默认)
模拟器: 方向键 = 方向键 · Z/X/C/V = A/B/X/Y · Q/W/E/R = L1/R1/L2/R2 · N/M = L3/R3 · Enter = Start · Right Shift = Select · I/K/J/L 和 T/G/F/H = 模拟摇杆
电视视图: F1 = 帮助 · F5/F6 = 快速存档/读档 · Esc = 退出(退出时自动存档)
可在 Options → Controls → Retro Console 中重新绑定按键。
已知限制
- macOS 不受支持(无头 GL 辅助程序仅限 Windows/Linux)。
- Linux 构建版本包含相应的原生辅助程序,但其硬件渲染核心在 Linux 上的测试程度不如在 Windows 上充分。
- 高性能核心需要配备 OpenGL 3.3+ 的显卡;PS2/Dreamcast 需要 BIOS 转储文件。
- 使用 RTP 的 RPG Maker 游戏需要将 RTP 包解压至
system/mkxp-z/RTP/ 目录下(包括 Standard、RPGVX、RPGVXAce)。
- 当某个核心的状态数据过大时(mkxp-z 会序列化其整个 Ruby 堆内存,约 100 MB),系统将跳过自动恢复存档状态的功能——但快速槽位 F5/F6 以及游戏自身的存档功能仍然可用。
- 3DS (Citra) 默认在服务器配置中禁用(
limits.enable3ds)。
- 不包含任何核心、BIOS 或 ROM。
法律声明
- RetroConsole 不是 RetroArch,也未与 libretro 项目建立关联。它仅实现了 libretro API。
- 不包含任何 ROM、BIOS 或核心。 请自行确保遵守版权及核心许可证规定。
- 模组许可证:GPL-3.0。源码地址:GitHub
链接
RetroConsole
RetroConsole 0.3.0 brings libretro emulation into Minecraft 1.21.1 — on both NeoForge and Fabric. 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.
Current version: 0.3.0. The port lives on GitHub and is published on GitHub Releases (the same JAR is attached to this project's Files tab). 0.3.0 adds a Fabric build next to NeoForge, RPG Maker XP / VX / VX Ace through mkxp-z, and stops the world from freezing while a heavy core boots or stops.
Early release — expect rough edges. Bug reports and screenshots are welcome in GitHub Issues.
Which file do I need?
| Loader |
File |
| NeoForge 21.1.x |
retroconsole-0.3.0+1.21.1-neoforge.jar |
| Fabric Loader 0.16+ |
retroconsole-0.3.0+1.21.1-fabric.jar — requires Fabric API |
Both builds contain the same game code and read the same config/retroconsole.json, so settings, saves and play stats carry over if you switch loaders.
What's new in 0.3.0
- Fabric support — the mod now ships for Fabric Loader as well as NeoForge, feature-for-feature.
- RPG Maker XP / VX / VX Ace via the
mkxp-z core — one library entry per game folder, a correctly sized picture even for games that scale their window, and a chat message that names the missing RTP instead of leaving you at a black screen.
- Launching and stopping no longer freezes the world — cores boot, stop and snapshot save states on their own threads; a 20-second RPG Maker load no longer stalls the tick loop.
- Legible text on screens — downscaling averages pixels instead of dropping them, so 1-pixel glyph stems survive on small walls.
- Boot feedback — while a core starts, the TV shows a "Launching <game>" card with elapsed time instead of a misleading No Signal.
- In-game config UI — one settings screen (⚙) for paths, streaming distances, session limits, video presets.
verboseLogs — optional debug toggle for heartbeats and GL diagnostics; off by default.
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, Doom 3, RPG Maker, 3DS) via a bundled headless OpenGL helper
- Doom 3 through the
boom3 core — retail or the free demo
- RPG Maker XP / VX / VX Ace through the
mkxp-z core — RTP-aware, one entry per game
- Nintendo DS / 3DS with an absolute touch pointer (DeSmuME, melonDS, Citra)
Requirements
|
|
| Minecraft |
1.21.1 |
| Loader |
NeoForge 21.1.x or Fabric Loader 0.16+ (+ Fabric API) |
| Java |
21 |
| OS |
Windows or Linux (64-bit) |
| GPU (HW cores) |
OpenGL 3.3+ |
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
- Install NeoForge 21.1.x — or Fabric Loader with Fabric API — and drop the matching mod JAR into
mods.
- Launch the game —
config/retroconsole/ is created automatically.
- Download libretro cores (
.dll / .so) from the libretro buildbot → config/retroconsole/cores/
- Add ROMs to
config/retroconsole/roms/<system>/ (e.g. nes/, gba/, ps2/). RPG Maker games go into roms/rpgmaker/<game>/.
- For PS2 / Dreamcast: add BIOS to
config/retroconsole/system/ (see the GitHub README)
- Craft the blocks (or use the Retro Console creative tab):
Retro Console Screen ×2
I I I G G G
I R I G R G
I I I I I I
I = iron ingot, R = redstone, G = glass pane
- Place the console so it touches your screen wall. Right-click → library → Launch.
- 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 (L-shapes split into separate rectangles).
- Look down/up sharply to place floor/ceiling screens (CC:Tweaked-style).
Tested cores (0.3.0)
Smoke-tested on Windows 11. Other libretro cores may work but are not guaranteed.
| Core |
System |
Notes |
fceumm_libretro · nestopia_libretro · quicknes_libretro · mesen_libretro |
NES / Famicom |
software render — any of them works as the NES core |
snes9x_libretro |
SNES |
software render |
gambatte_libretro |
Game Boy / Game Boy Color |
software render |
mgba_libretro |
GBA |
software render |
genesis_plus_gx_libretro |
Genesis / Mega Drive, Master System, Game Gear, Sega CD |
software render |
desmume_libretro · desmume2015_libretro |
Nintendo DS |
software render, dual screen, touch pointer |
citra_libretro |
Nintendo 3DS |
HW OpenGL, top + bottom screen, touch pointer |
pcsx_rearmed_libretro |
PS1 |
software render |
pcsx2_libretro (LRPS2) |
PS2 |
HW OpenGL, needs BIOS, multi-console |
ppsspp_libretro |
PSP |
HW OpenGL, multi-console |
flycast_libretro |
Dreamcast |
HW OpenGL, needs BIOS, multi-console |
boom3_libretro |
Doom 3 |
HW OpenGL, game data in roms/doom3/ |
mkxp-z_libretro |
RPG Maker XP / VX / VX Ace |
HW OpenGL, one entry per game folder, RTPs in system/mkxp-z/RTP/ |
easyrpg_libretro |
RPG Maker 2000 / 2003 |
software render, async core (the frontend drives its clock and audio), game as a .zip or an unpacked folder in roms/easyrpg/ |
Any other libretro core can be dropped into cores/ and picked per game from the Other tab (N64, Saturn, …), but only the cores above were part of the 0.3.0 smoke test. The mkxp-z core is not on the libretro buildbot; build it from the mkxp-z source.
Multiplayer
On a dedicated server, ROMs and cores live on the server. Emulation runs server-side; clients receive video/audio streams. Saves, save states and play stats are per-player on the server.
Clients do not scan their local roms/ folder in multiplayer — the library comes from the server's config/retroconsole/.
Configuration
Open ⚙ in the library, or Mods → RetroConsole → Config (NeoForge; on Fabric use the ⚙ button).
config/retroconsole.json — paths, streaming distances, session limits (maxCoreSlots, maxPcsx2Sessions), video presets, debug toggles
- Upgrading from 0.2.6 or older? The old
retroconsole-common.toml / retroconsole-server.toml are read once and folded into the new file; the toml files are then ignored.
- On a dedicated server, edit the server's copy — clients cannot change server streaming or video from the UI.
Controls (defaults)
Emulator: Arrow keys = D-Pad · Z/X/C/V = A/B/X/Y · Q/W/E/R = L1/R1/L2/R2 · N/M = L3/R3 · 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 (autosave runs on exit)
Rebind under Options → Controls → Retro Console.
Known limitations
- macOS is not supported (headless GL helper is Windows/Linux only).
- Linux builds include the matching native helper, but hardware-render cores are less tested there than on Windows.
- Heavy cores need a GPU with OpenGL 3.3+; PS2/Dreamcast need BIOS dumps.
- RPG Maker games that use an RTP need that package unpacked into
system/mkxp-z/RTP/ (Standard, RPGVX, RPGVXAce).
- Automatic save-state resume is skipped when a core's state is huge (mkxp-z serializes its whole Ruby heap, ~100 MB) — quick slots F5/F6 and the game's own saves still work.
- 3DS (Citra) is disabled in the server config by default (
limits.enable3ds).
- No cores, BIOS or ROMs are included.
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧