BlockBoy Arcade

BlockBoy Arcade

Serverside GameBoy emulator as Arcade machines with data driven cartridge items!

by
2.2K Downloads
fabricgame-mechanicsminigamesocial
Rent Server with this Mod

Screenshots

Arcade machines
Games

About this Mod

This mod will no longer be updated on modrinth!

See https://www.curseforge.com/minecraft/mc-mods/blockboy-arcade for the latest version!

Arcade machines with full gameboy resolution and color support!

Fully server-side, using polymer!
Checkout polymers authost feature to host the resource-pack (in polymer/resourcepack.zip) automagically!

There are no recipes, use /polymer creative to see the items or use /give @s blockboy:arcade

The mods' builtin datapack comes with 6 open source gameboy games:

Config

{
  "dateFormat": "dd.MM yyyy, HH:mm",
  "sound": false
}
  • dateFormat: Date format for rom save data tooltip
  • sound: Flag to enable sounds for the playing player using simple voice chat

Adding roms / items

You can either add cartridge items using filament or just use the blockboy:rom component to give yourself an item that can play a given rom file:
/give @s paper[blockboy:rom="namespace:game.gb"]

Put the roms in data/<namespace>/blockboy/<rom>.gb and data/<namespace>/blockboy/<rom>.gbc
Make sure the rom file names are lowercase and only contain letters from a to z, 0-9 and/or underscores.

To add your own arcade model item + block use the filament mod and the blockboy:arcade behaviour for decorations.

Arcade example for filament (data//filament/decoration/.json):

{
  "id": "blockboy:arcade",
  "group": "blockboy:items",
  "blockTags": ["shulker_boxes"],
  "itemResource": {
    "models": {
      "default": "blockboy:item/arcade-item",
      "floor": "blockboy:item/arcade"
    }
  },
  "properties": {
    "rotate": true,
    "rotateSmooth": true,
    "stackSize": 1,
    "destroyTime": 2,
    "requiresTool": false
  },
  "behaviour": {
    "blockboy:arcade": {
      "seatTranslation": [0, 0.4, 0],
      "screenTranslation": [0, 0.95, -0.775],
      "screenPitch": -22.5,
      "brightness": 10
    }
  },
  "blocks": [
    {
      "origin": [0,0,-1],
      "size": [1,1,2]
    },
    {
      "origin": [0,1,-1],
      "size": [1,1,1]
    }
  ]
}

Cartridge / rom item example for filament (data//filament/item/.json):

{
  "id": "blockboy:flooder",
  "translations": {
    "en_us": "Flooder"
  },
  "group": "blockboy:items",
  "vanillaItem": "minecraft:paper",
  "itemResource":{
    "models": {
      "default": "blockboy:item/cartridge2"
    }
  },
  "properties": {
    "stackSize": 1
  },
  "components": {
    "blockboy:rom": "namespace:flooder.gb"
  }
}

Blockboy Arcade comes with 2 item textures/models for cartridges, feel free to modify them as you wish:
blockboy:item/cartridge1 and blockboy:item/cartridge2

Permissions for Luckperms and friends: blockboy_arcade.command, with vanilla permission level 1

Controls:

  • WASD = DPAD
  • Jump = A
  • Left-Click = B
  • F (swap held item) = Start
  • Q (drop held item) = Select

This project uses code from the coffee-gb gameboy emulator and the Image2Map Mod
You can find the original licenses in the "licenses" directory.
My changes are also licensed under the MIT license.

Available Versions

BlockBoy Arcade 1.0.4+26.1release
MC 26.1, 26.1.1, 26.1.2fabric
March 29, 2026
BlockBoy Arcade 1.0.3+1.21.11release
MC 1.21.11fabric
December 23, 2025
BlockBoy Arcade 1.0.3+1.21.6release
MC 1.21.6, 1.21.7, 1.21.8fabric
September 18, 2025
BlockBoy Arcade 1.0.1+1.21.6release
MC 1.21.6, 1.21.7, 1.21.8fabric
September 7, 2025

How to Install BlockBoy Arcade on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.2).

3

Install Mod

Open the mod browser in the dashboard and search for "BlockBoy Arcade". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabric

Minecraft Versions

26.1.2, 26.1.1, 26.1 (+5 more)

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

BlockBoy Arcade server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1.2). You can switch loaders with one click in the panel.

Is BlockBoy Arcade compatible with fabric?

BlockBoy Arcade officially supports fabric for Minecraft 26.1.2, 26.1.1, 26.1. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with BlockBoy Arcade – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if BlockBoy Arcade consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install BlockBoy Arcade with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
GNU Lesser General Public License v3.0 or later
Server-side
Required

Supported Versions

26.1.226.1.126.11.21.111.21.81.21.71.21.61.21.5