# yukocha0/computerpc-minecraftbrowsermod architecture

> Architecture diagram of the GitHub repository yukocha0/computerpc-minecraftbrowsermod, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-04-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yukocha0/computerpc-minecraftbrowsermod
- Repository: https://github.com/yukocha0/computerpc-minecraftbrowsermod

## Overview

1. **What this mod is**
   - Computer PC is a **Fabric Minecraft mod** that turns placed blocks into a **multiblock in-world browser display**.
   - The core architectural idea is: a world-placed block cluster owns browser state, while the client renders that state using an embedded Chromium runtime.

2. **Top-level split: server/game logic vs client/browser UI**
   - `src/main/java/justpc/computerpc` contains the **shared/game-side logic**: blocks, block entities, browser state models, networking, and registries.
   - `src/client/java/justpc/computerpc` contains the **client-only rendering and screens**: browser bootstrap, display rendering, and the remote control UI.
   - This split is important because browser initialization/rendering is client-only, while block state and multiplayer sync must exist on both sides.

3. **World object model: Display Block + Block Entity**
   - `DisplayBlock` is the placeable block players build into a screen wall.
   - `DisplayBlockEntity` is the persistent per-block data holder. It likely stores the display’s browser-related state and participates in save/load and sync.
   - The block entity is the main boundary between Minecraft world state and browser runtime state.

4. **Multiblock behavior**
   - The `util` package contains `DisplayCluster` and `DisplayClusterResolver`, which indicate the display is not treated as isolated blocks but as a **cluster of connected blocks**.
   - This cluster layer is the architectural unit for things like shared power state, shared browser session, resolution/aspect handling, and “one screen wall behaves like one display.”
   - From an architecture diagram perspective, the cluster resolver is the bridge from individual blocks to a logical display surface.

5. **Browser state model**
   - `browser/BrowserTabData` and `browser/DisplayStateData` are the main state carriers.
   - `BrowserTabData` represents tab-level browser information, while `DisplayStateData` appears to represent the overall screen/display configuration.
   - These are the data objects that move across boundaries: saved world state, multiplayer synchronization, and client-side UI/rendering.

6. **Client-side embedded browser integration**
   - `BrowserBootstrap` and `DisplayBrowserManager` are the client-side integration points for the embedded browser runtime.
   - The README says the mod uses **embedded Chromium via JCEF**, so these classes likely manage browser process startup, lifecycle, and per-display browser instances.
   - `BrowserRenderUtil` suggests a render bridge that takes browser output and makes it drawable inside Minecraft.

7. **Rendering pipeline**
   - `client/render/DisplayBlockEntityRenderer` is the in-world renderer for the display block entity.
   - The render path is: world/block entity state → browser output handled by browser manager → rendering utility → block entity renderer draws it in the game world.
   - This is a key boundary: the game engine renders a browser-backed texture/surface instead of a static block texture.

8. **Player-facing control surface**
   - `client/screen/RemoteBrowserScreen` and `client/screen/DisplayControlScreen` are the interactive GUIs.
   - `RemoteItem` on the game side is the item that opens the controller UI, which matches the README’s “Browser Remote.”
   - `VolumeSlider` is a custom widget for per-display audio control, showing that media volume is part of the display state, not just a browser setting.

9. **Multiplayer/network synchronization**
   - `network/ComputerpcNetworking` and `network/ComputerpcPayloads` define the packet layer.
   - The mod explicitly supports multiplayer synchronization so nearby players see the same browser activity; these payloads are the conduit for updates like URL changes, tab actions, power toggles, and display settings.
   - In diagram terms, this is the cross-boundary path between a client action and authoritative display state.

10. **Registries and content bootstrap**
   - `registry/ComputerpcBlocks`, `ComputerpcBlockEntities`, and `ComputerpcItems` centralize Fabric registration.
   - `Computerpc.java` and `ComputerpcClient.java` are the likely mod entrypoints that wire up registration, networking, rendering, and client bootstrap.
   - This registry layer is the startup boundary that connects Minecraft’s mod lifecycle to the rest of the codebase.

11. **Assets and data pack content**
   - `src/main/resources` holds the block/item models, blockstates, language, recipes, and loot tables.
   - These files define the in-game identity and crafting/loot behavior for `display` and `remote`, but they do not contain core runtime logic.
   - Architecturally, they support the mod’s world objects and items rather than driving behavior.

12. **Build/runtime constraints**
   - The project is built with **Gradle** and targets **Minecraft 26.1 / Fabric / Java 25**.
   - The embedded browser runtime and client-only classes mean the project has a meaningful runtime dependency boundary: server-safe game logic must stay separate from browser/JCEF-dependent code.
   - The README also notes the bundled browser runtime may need initialization on first launch, which affects client startup behavior.

13. **How the main data flow works**
   - Player places display blocks → block entities persist state → cluster resolver groups them into a logical screen → browser manager opens/updates embedded browser instances → renderer draws browser output in the world → networking syncs state changes to other players → remote UI sends control commands back to the authoritative state.
   - That loop is the core architecture to capture in a diagram.

14. **Useful diagram boundaries**
   - Separate these boxes: **Minecraft world objects**, **multiblock cluster logic**, **browser runtime/rendering**, **player control UI**, and **network sync**.
   - The strongest coupling points are between block entities and cluster resolution on one side, and browser manager/rendering plus networking on the other.

Main entry points: [`src/main/java/justpc/computerpc/network/ComputerpcNetworking.java`](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/network/ComputerpcNetworking.java) (Networking), [`src/main/java/justpc/computerpc/Computerpc.java`](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/Computerpc.java) (Computerpc), [`src/main/java/justpc/computerpc/blockentity/DisplayBlockEntity.java`](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/blockentity/DisplayBlockEntity.java) (Display Entity), [`src/main/java/justpc/computerpc/block/DisplayBlock.java`](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/block/DisplayBlock.java) (Display Block)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Game logic"]
  node_entry_main["Computerpc<br/>mod entry<br/>[Computerpc.java]"]
  node_display_block["Display Block<br/>[DisplayBlock.java]"]
  node_display_entity[("Display Entity<br/>block entity")]
  node_cluster_resolver{{"Cluster Resolver<br/>multiblock logic"}}
  node_cluster{{"Display Cluster<br/>surface model"}}
  node_browser_state["Display State<br/>state model"]
  node_tab_state["Browser Tab<br/>state model"]
  node_network["Networking<br/>sync layer"]
  node_payloads["Payloads<br/>packet defs"]
  node_remote_item["Remote Item<br/>[RemoteItem.java]"]
  node_block_reg["Blocks<br/>registry"]
  node_be_reg["Block Entities<br/>registry"]
  node_item_reg["Items<br/>registry"]
end

subgraph group_client["Client runtime"]
  node_entry_client["ComputerpcClient<br/>client entry"]
  node_browser_bootstrap["Browser Bootstrap<br/>jcef bootstrap"]
  node_browser_manager["Browser Manager<br/>browser lifecycle"]
  node_render_util["Render Util<br/>render bridge"]
  node_renderer["Block Renderer<br/>world renderer"]
  node_remote_screen["Remote Screen<br/>ui screen"]
  node_control_screen["Control Screen<br/>ui screen"]
  node_volume_slider(("Volume Slider<br/>ui widget<br/>[VolumeSlider.java]"))
end

subgraph group_content["Assets"]
  node_assets["Resources<br/>assets/data"]
end

node_entry_main -->|"registers"| node_block_reg
node_entry_main -->|"registers"| node_be_reg
node_entry_main -->|"registers"| node_item_reg
node_entry_main -->|"initializes"| node_network
node_block_reg -->|"creates"| node_display_block
node_be_reg -->|"creates"| node_display_entity
node_item_reg -->|"creates"| node_remote_item
node_display_block -->|"owns"| node_display_entity
node_display_entity -->|"resolved by"| node_cluster_resolver
node_cluster_resolver -->|"builds"| node_cluster
node_cluster -->|"drives"| node_browser_state
node_browser_state -->|"contains"| node_tab_state
node_entry_client -->|"starts"| node_browser_bootstrap
node_entry_client -->|"wires"| node_browser_manager
node_browser_bootstrap -->|"enables"| node_browser_manager
node_browser_manager -->|"feeds"| node_render_util
node_render_util -->|"draws"| node_renderer
node_display_entity -->|"syncs"| node_network
node_network -->|"defines"| node_payloads
node_remote_item -->|"opens"| node_remote_screen
node_control_screen -->|"uses"| node_volume_slider
node_remote_screen -->|"sends"| node_network
node_control_screen -->|"sends"| node_network
node_assets -->|"describes"| node_display_block
node_assets -->|"describes"| node_remote_item

click node_entry_main "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/Computerpc.java"
click node_entry_client "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/ComputerpcClient.java"
click node_display_block "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/block/DisplayBlock.java"
click node_display_entity "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/blockentity/DisplayBlockEntity.java"
click node_cluster_resolver "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/util/DisplayClusterResolver.java"
click node_cluster "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/util/DisplayCluster.java"
click node_browser_state "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/browser/DisplayStateData.java"
click node_tab_state "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/browser/BrowserTabData.java"
click node_network "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/network/ComputerpcNetworking.java"
click node_payloads "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/network/ComputerpcPayloads.java"
click node_remote_item "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/item/RemoteItem.java"
click node_block_reg "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/registry/ComputerpcBlocks.java"
click node_be_reg "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/registry/ComputerpcBlockEntities.java"
click node_item_reg "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/registry/ComputerpcItems.java"
click node_browser_bootstrap "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/client/BrowserBootstrap.java"
click node_browser_manager "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/client/DisplayBrowserManager.java"
click node_render_util "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/client/render/BrowserRenderUtil.java"
click node_renderer "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/client/render/DisplayBlockEntityRenderer.java"
click node_remote_screen "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/client/screen/RemoteBrowserScreen.java"
click node_control_screen "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/client/screen/DisplayControlScreen.java"
click node_volume_slider "https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/client/widget/VolumeSlider.java"
click node_assets "https://github.com/yukocha0/computerpc-minecraftbrowsermod/tree/main/src/main/resources"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry_main,node_display_block,node_display_entity,node_cluster_resolver,node_cluster,node_browser_state,node_tab_state,node_network,node_payloads,node_remote_item,node_block_reg,node_be_reg,node_item_reg toneBlue
class node_entry_client,node_browser_bootstrap,node_browser_manager,node_render_util,node_renderer,node_remote_screen,node_control_screen,node_volume_slider toneAmber
class node_assets toneMint
```

## Components

### Game logic

Shared block, state, networking, and registry code.

- [Computerpc](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/Computerpc.java): mod entry · Main Fabric entrypoint for shared initialization. · `src/main/java/justpc/computerpc/Computerpc.java`
- [Display Block](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/block/DisplayBlock.java): block · Placeable block that forms the visible screen surface. · `src/main/java/justpc/computerpc/block/DisplayBlock.java`
- [Display Entity](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/blockentity/DisplayBlockEntity.java): block entity · Persistent world state for each display block. · `src/main/java/justpc/computerpc/blockentity/DisplayBlockEntity.java`
- [Cluster Resolver](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/util/DisplayClusterResolver.java): multiblock logic · Detects connected blocks and builds a logical display cluster. · `src/main/java/justpc/computerpc/util/DisplayClusterResolver.java`
- [Display Cluster](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/util/DisplayCluster.java): surface model · Logical screen wall representation shared across blocks. · `src/main/java/justpc/computerpc/util/DisplayCluster.java`
- [Display State](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/browser/DisplayStateData.java): state model · Top-level display configuration and browser session state. · `src/main/java/justpc/computerpc/browser/DisplayStateData.java`
- [Browser Tab](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/browser/BrowserTabData.java): state model · Per-tab browser data used by the display state. · `src/main/java/justpc/computerpc/browser/BrowserTabData.java`
- [Networking](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/network/ComputerpcNetworking.java): sync layer · Packet registration and multiplayer synchronization path. · `src/main/java/justpc/computerpc/network/ComputerpcNetworking.java`
- [Payloads](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/network/ComputerpcPayloads.java): packet defs · Concrete network payload definitions for display updates. · `src/main/java/justpc/computerpc/network/ComputerpcPayloads.java`
- [Remote Item](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/item/RemoteItem.java): item · Player-held item that opens or controls the browser UI. · `src/main/java/justpc/computerpc/item/RemoteItem.java`
- [Blocks](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/registry/ComputerpcBlocks.java): registry · Registers the display block and related block content. · `src/main/java/justpc/computerpc/registry/ComputerpcBlocks.java`
- [Block Entities](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/registry/ComputerpcBlockEntities.java): registry · Registers the display block entity type. · `src/main/java/justpc/computerpc/registry/ComputerpcBlockEntities.java`
- [Items](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/main/java/justpc/computerpc/registry/ComputerpcItems.java): registry · Registers the remote and block item content. · `src/main/java/justpc/computerpc/registry/ComputerpcItems.java`

### Client runtime

Browser integration, rendering, and player-facing screens.

- [ComputerpcClient](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/ComputerpcClient.java): client entry · Client-only entrypoint for browser and render setup. · `src/client/java/justpc/computerpc/ComputerpcClient.java`
- [Browser Bootstrap](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/client/BrowserBootstrap.java): jcef bootstrap · Initializes the embedded Chromium runtime on the client. · `src/client/java/justpc/computerpc/client/BrowserBootstrap.java`
- [Browser Manager](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/client/DisplayBrowserManager.java): browser lifecycle · Manages per-display browser instances and lifecycle. · `src/client/java/justpc/computerpc/client/DisplayBrowserManager.java`
- [Render Util](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/client/render/BrowserRenderUtil.java): render bridge · Converts browser output into something Minecraft can draw. · `src/client/java/justpc/computerpc/client/render/BrowserRenderUtil.java`
- [Block Renderer](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/client/render/DisplayBlockEntityRenderer.java): world renderer · Renders the display block entity in the world. · `src/client/java/justpc/computerpc/client/render/DisplayBlockEntityRenderer.java`
- [Remote Screen](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/client/screen/RemoteBrowserScreen.java): ui screen · Browser remote interface for player control. · `src/client/java/justpc/computerpc/client/screen/RemoteBrowserScreen.java`
- [Control Screen](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/client/screen/DisplayControlScreen.java): ui screen · Display configuration and control interface. · `src/client/java/justpc/computerpc/client/screen/DisplayControlScreen.java`
- [Volume Slider](https://github.com/yukocha0/computerpc-minecraftbrowsermod/blob/main/src/client/java/justpc/computerpc/client/widget/VolumeSlider.java): ui widget · Custom volume control for display audio. · `src/client/java/justpc/computerpc/client/widget/VolumeSlider.java`

### Assets

Resource and data files that define in-game content.

- [Resources](https://github.com/yukocha0/computerpc-minecraftbrowsermod/tree/main/src/main/resources): assets/data · Blockstates, models, language, recipes, and loot tables. · `src/main/resources`

## Connections

- Computerpc → Blocks: registers · Shared startup wires up content registration.
- Computerpc → Block Entities: registers · Shared startup wires up block entity types.
- Computerpc → Items: registers · Shared startup wires up items.
- Computerpc → Networking: initializes · Shared startup sets up multiplayer sync.
- Blocks → Display Block: creates · Registry exposes the display block.
- Block Entities → Display Entity: creates · Registry exposes the display block entity.
- Items → Remote Item: creates · Registry exposes the remote item.
- Display Block → Display Entity: owns · Placed blocks carry persistent block entity state.
- Display Entity → Cluster Resolver: resolved by · Block entity participates in multiblock grouping.
- Cluster Resolver → Display Cluster: builds · Connected blocks are collapsed into one logical display.
- Display Cluster → Display State: drives · Cluster shape and state feed the browser session model.
- Display State → Browser Tab: contains · Overall display state includes tab-level browser data.
- ComputerpcClient → Browser Bootstrap: starts · Client entry initializes browser runtime.
- ComputerpcClient → Browser Manager: wires · Client entry prepares browser lifecycle management.
- Browser Bootstrap → Browser Manager: enables · Embedded Chromium startup supports per-display instances.
- Browser Manager → Render Util: feeds · Browser output is handed to rendering utilities.
- Render Util → Block Renderer: draws · Rendered browser surfaces are composited in-world.
- Display Entity → Networking: syncs · World state changes are propagated across players.
- Networking → Payloads: defines · Packet layer is specified by payload types.
- Remote Item → Remote Screen: opens · Item launches the player remote control UI.
- Control Screen → Volume Slider: uses · Control screen includes audio control widget.
- Remote Screen → Networking: sends · UI actions become sync packets.
- Control Screen → Networking: sends · Display settings changes become sync packets.
- Resources → Display Block: describes · Resources define block visuals and identity.
- Resources → Remote Item: describes · Resources define remote visuals and identity.
