riscv-mc

KO | EN

gitlite — search

#proxy #agents #claude #privacy #windows #cpp #artificial-intelligence #machine-learning #kubernetes #database

(★ 9)

RISC V emulator in Minecraft!

File Explorer

ZIP Download

- asm.py
- build_kernel_rom.py
- build_rom.py
- fdt.py
- gen_font.py
- layout.py
.gitignore
minimal.dts
pack.mcmeta
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

This requires 26.3 Snapshot 3 or newer.

## Showcase

[![Running Linux in a Minecraft Post Effect Shader](https://img.youtube.com/vi/09OdIie-_jQ/maxresdefault.jpg)](https://www.youtube.com/watch?v=09OdIie-_jQ)

## Building

### Simple Assembly Image

Simply tweak `tools/build_rom.py` and then run that script to generate an image
for the `riscv:demo` shader.

### Linux Image

First you need to compile the dtb file with this (you can also use another
compatible `.dts` file):

```sh
dtc -I dts -O dtb -o minimal.dtb minimal.dts
```

Then you need to get yourself Linux image file. I'd recommend getting them from
the [mini-rv32ima-images](https://github.com/cnlohr/mini-rv32ima-images) repo.
Once you have your image, run:

```sh
python3 tools/build_kernel_rom.py --kernel /path/to/Image --dtb /path/to/minimal.dtb
```

## Custom Font

To build a custom font, first you need either a `.psf`, `.psf2`, `.psf.gz`, or
`.psf2.gz` file.

Then run:

```sh
python3 tools/gen_font.py path/to/font.psf
```

Optionally add `--preview out.png` to generate a preview image.

riscv-mc

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README