Something went wrong. Try again.
Minecraft text rendering inside the browser! www.npmjs.com/package/libmojangles
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491import { createLibmojangles, parseResourceLocation, type Libmojangles, type Font, type FontResolver, type TextComponent, type ResourceLocation,} from "libmojangles";import { FetchResourcePack } from "./FetchResourcePack";import { MemoryResourcePack } from "./MemoryResourcePack";
interface PlaygroundState { guiScale: number; textComponent: TextComponent; textX: number; textY: number; centerX: boolean; showDebug: boolean; bboxMethod: "picking" | "tf"; bgColor: string; customProgramId: string | null;}
const state: PlaygroundState = { guiScale: 3, textComponent: { extra: [ { text: "Hello " }, { text: "World!", color: "gold", bold: true }, ], }, textX: 10, textY: 10, centerX: true, showDebug: false, bboxMethod: "picking", bgColor: "#000000", customProgramId: null,};
const canvas = document.getElementById("canvas") as HTMLCanvasElement;const debugCanvas = document.getElementById("debug-canvas") as HTMLCanvasElement;const canvasContainer = document.getElementById("canvas-container") as HTMLDivElement;
let lib: Libmojangles;let fontResolver: FontResolver;
const uploadedPacks: MemoryResourcePack[] = [];const loadedFonts = new Set<string>();
const MINECRAFT_TEXT_VSH: ResourceLocation = { namespace: "minecraft", path: "shaders/core/rendertype_text.vsh" };const MINECRAFT_TEXT_FSH: ResourceLocation = { namespace: "minecraft", path: "shaders/core/rendertype_text.fsh" };
let defaultVertexSource = "";let defaultFragmentSource = "";let currentVertexSource = "";let currentFragmentSource = "";
async function init() { lib = createLibmojangles({ canvas });
const defaultPack = new FetchResourcePack("vanilla", "/"); lib.addResourcePack(defaultPack);
await lib.loadFont({ namespace: "minecraft", path: "default" }); loadedFonts.add("minecraft:default"); setStatus("Loading shaders...");
try { defaultVertexSource = await lib.resources.readText(MINECRAFT_TEXT_VSH) || ""; defaultFragmentSource = await lib.resources.readText(MINECRAFT_TEXT_FSH) || ""; currentVertexSource = defaultVertexSource; currentFragmentSource = defaultFragmentSource; } catch (e) { console.warn("Could not load default Minecraft shaders:", e); }
fontResolver = (name) => { if (name) { const found = lib.fonts.getFont(parseResourceLocation(name)); if (found) return found as Font; } return lib.fonts.getDefaultFont(); };
setupResizeObserver(); setupControls(); setupCollapsibleSections(); setupResourcePackUpload(); setupShaderEditor(); setupSavePng(); handleResize(); startRenderLoop();
setStatus("Ready");}
function setupResizeObserver() { const observer = new ResizeObserver(() => handleResize()); observer.observe(canvasContainer);}
function handleResize() { const width = canvasContainer.clientWidth; const height = canvasContainer.clientHeight;
canvas.width = width; canvas.height = height; canvas.style.width = `${width}px`; canvas.style.height = `${height}px`;
debugCanvas.width = width; debugCanvas.height = height; debugCanvas.style.width = `${width}px`; debugCanvas.style.height = `${height}px`;
lib.resize(width, height); updateBackground();}
function updateBackground() { if (state.bgColor === "checker") { canvasContainer.style.background = "repeating-conic-gradient(#404040 0% 25%, #606060 0% 50%) 50% / 20px 20px"; } else { canvasContainer.style.background = state.bgColor; }}
function setupControls() { const sidebar = document.getElementById("sidebar")!; const toggleBtn = document.getElementById("toggle-sidebar")!; toggleBtn.addEventListener("click", () => { sidebar.classList.toggle("collapsed"); setTimeout(handleResize, 10); });
const guiScaleInput = document.getElementById("gui-scale") as HTMLInputElement; guiScaleInput.addEventListener("input", () => { state.guiScale = Math.max(1, parseInt(guiScaleInput.value) || 1); });
const bgColorSelect = document.getElementById("bg-color") as HTMLSelectElement; bgColorSelect.addEventListener("change", () => { state.bgColor = bgColorSelect.value; updateBackground(); });
const showDebugCheckbox = document.getElementById("show-debug") as HTMLInputElement; const bboxMethodRow = document.getElementById("bbox-method-row")!; const bboxMethodSelect = document.getElementById("bbox-method") as HTMLSelectElement;
showDebugCheckbox.addEventListener("change", () => { state.showDebug = showDebugCheckbox.checked; bboxMethodRow.style.display = state.showDebug ? "" : "none"; if (!state.showDebug) clearDebugCanvas(); });
bboxMethodSelect.addEventListener("change", () => { state.bboxMethod = bboxMethodSelect.value as "picking" | "tf"; });
const textInput = document.getElementById("text-input") as HTMLTextAreaElement; const textError = document.getElementById("text-error")!; textInput.addEventListener("input", () => { try { state.textComponent = JSON.parse(textInput.value); textError.textContent = ""; } catch (e) { textError.textContent = (e as Error).message; } });
const textXInput = document.getElementById("text-x") as HTMLInputElement; textXInput.addEventListener("input", () => { state.textX = parseInt(textXInput.value) || 0; });
const textYInput = document.getElementById("text-y") as HTMLInputElement; textYInput.addEventListener("input", () => { state.textY = parseInt(textYInput.value) || 0; });
const centerXCheckbox = document.getElementById("center-x") as HTMLInputElement; centerXCheckbox.addEventListener("change", () => { state.centerX = centerXCheckbox.checked; });}
function setupCollapsibleSections() { document.querySelectorAll(".section.collapsible .section-title").forEach((title) => { title.addEventListener("click", () => { title.closest(".section")?.classList.toggle("collapsed"); }); });}
function setupResourcePackUpload() { const packUpload = document.getElementById("pack-upload") as HTMLInputElement; const packStatus = document.getElementById("pack-status")!;
packUpload.addEventListener("change", async () => { const file = packUpload.files?.[0]; if (!file) return;
packStatus.innerHTML = '<span class="info-text">Loading...</span>';
try { const arrayBuffer = await file.arrayBuffer(); const pack = new MemoryResourcePack(file.name.replace(/\.zip$/i, "")); const paths = await pack.loadFromZip(arrayBuffer);
lib.addResourcePack(pack); uploadedPacks.push(pack);
const fonts = pack.getFonts(); for (const font of fonts) { const fontKey = `${font.namespace}:${font.path}`; if (!loadedFonts.has(fontKey)) { try { await lib.loadFont(font); loadedFonts.add(fontKey); } catch (e) { console.warn(`Failed to load font ${fontKey}:`, e); } } }
updatePackList(); await reloadShaderEditor();
packStatus.innerHTML = `<span class="success">Loaded ${paths.length} files, ${fonts.length} fonts</span>`; } catch (e) { packStatus.innerHTML = `<span class="error">${(e as Error).message}</span>`; }
packUpload.value = ""; });}
function updatePackList() { const packList = document.getElementById("pack-list")!; packList.innerHTML = "";
for (const pack of uploadedPacks) { const item = document.createElement("div"); item.className = "pack-item"; item.innerHTML = ` <span class="pack-name">${pack.name}</span> <button data-pack="${pack.name}">Remove</button> `; item.querySelector("button")?.addEventListener("click", () => { lib.removeResourcePack(pack); const idx = uploadedPacks.indexOf(pack); if (idx !== -1) uploadedPacks.splice(idx, 1); updatePackList(); }); packList.appendChild(item); }}
async function reloadShaderEditor() { try { const vsSource = await lib.resources.readText(MINECRAFT_TEXT_VSH); const fsSource = await lib.resources.readText(MINECRAFT_TEXT_FSH);
if (vsSource) { defaultVertexSource = vsSource; currentVertexSource = vsSource; } if (fsSource) { defaultFragmentSource = fsSource; currentFragmentSource = fsSource; }
const vertexTextarea = document.getElementById("vertex-shader") as HTMLTextAreaElement; const fragmentTextarea = document.getElementById("fragment-shader") as HTMLTextAreaElement;
if (vertexTextarea && fragmentTextarea) { vertexTextarea.value = currentVertexSource; fragmentTextarea.value = currentFragmentSource; }
state.customProgramId = null; setStatus("Shader reloaded from pack"); } catch (e) { console.warn("Could not reload shaders:", e); }}
function setupShaderEditor() { const shaderTabs = document.querySelectorAll(".shader-tab"); const vertexTextarea = document.getElementById("vertex-shader") as HTMLTextAreaElement; const fragmentTextarea = document.getElementById("fragment-shader") as HTMLTextAreaElement; const shaderError = document.getElementById("shader-error")!; const compileBtn = document.getElementById("compile-shader")!; const resetBtn = document.getElementById("reset-shader")!;
vertexTextarea.value = currentVertexSource || "(loading...)"; fragmentTextarea.value = currentFragmentSource || "(loading...)";
if (currentVertexSource) { vertexTextarea.value = currentVertexSource; fragmentTextarea.value = currentFragmentSource; } else { const checkLoaded = setInterval(() => { if (defaultVertexSource) { vertexTextarea.value = defaultVertexSource; fragmentTextarea.value = defaultFragmentSource; currentVertexSource = defaultVertexSource; currentFragmentSource = defaultFragmentSource; clearInterval(checkLoaded); } }, 100); }
shaderTabs.forEach((tab) => { tab.addEventListener("click", () => { shaderTabs.forEach((t) => t.classList.remove("active")); tab.classList.add("active");
const which = (tab as HTMLElement).dataset.tab; vertexTextarea.style.display = which === "vertex" ? "block" : "none"; fragmentTextarea.style.display = which === "fragment" ? "block" : "none"; }); });
compileBtn.addEventListener("click", async () => { currentVertexSource = vertexTextarea.value; currentFragmentSource = fragmentTextarea.value;
compileBtn.setAttribute("disabled", "true"); compileBtn.textContent = "Compiling...";
try { const programId = await compileCustomShader(currentVertexSource, currentFragmentSource); state.customProgramId = programId; shaderError.textContent = ""; setStatus("Shader compiled"); } catch (e) { shaderError.textContent = (e as Error).message; setStatus("Shader error"); } finally { compileBtn.removeAttribute("disabled"); compileBtn.textContent = "Compile"; } });
resetBtn.addEventListener("click", async () => { await reloadShaderEditor(); vertexTextarea.value = currentVertexSource; fragmentTextarea.value = currentFragmentSource; shaderError.textContent = ""; setStatus("Shader reset to pack default"); });}
function setupSavePng() { const savePngBtn = document.getElementById("save-png")!; savePngBtn.addEventListener("click", () => { const offscreen = document.createElement("canvas"); offscreen.width = canvas.width; offscreen.height = canvas.height; const ctx = offscreen.getContext("2d")!;
ctx.drawImage(canvas, 0, 0);
if (state.showDebug) { ctx.drawImage(debugCanvas, 0, 0); }
offscreen.toBlob((blob) => { if (!blob) return; const url = URL.createObjectURL(blob); const a = document.createElement("a"); a.href = url; a.download = "libmojangles.png"; a.click(); URL.revokeObjectURL(url); }, "image/png"); });}
let customShaderCounter = 0;let customShaderPack: MemoryResourcePack | null = null;
async function compileCustomShader(vertexSource: string, fragmentSource: string): Promise<string> { const id = `custom-${++customShaderCounter}`;
if (!customShaderPack) { customShaderPack = new MemoryResourcePack("__playground_shaders__"); lib.addResourcePack(customShaderPack); }
const vshLoc: ResourceLocation = { namespace: "playground", path: `shaders/${id}.vsh` }; const fshLoc: ResourceLocation = { namespace: "playground", path: `shaders/${id}.fsh` };
customShaderPack.setTextFile(vshLoc, vertexSource); customShaderPack.setTextFile(fshLoc, fragmentSource);
const program = await lib.shaders.loadProgram(vshLoc, fshLoc); return program.id;}
function startRenderLoop() { function render() { lib.renderer.beginFrame();
const screenWidth = canvas.width; const guiWidth = Math.floor(screenWidth / state.guiScale);
let screenX: number; let screenY = state.textY * state.guiScale;
if (state.centerX) { try { const glyphs = lib.parser.parse(state.textComponent); const textWidthGui = lib.layout.measureWidth(glyphs, fontResolver); const guiX = Math.floor(guiWidth / 2) - Math.floor(textWidthGui / 2); screenX = guiX * state.guiScale; } catch { screenX = state.textX * state.guiScale; } } else { screenX = state.textX * state.guiScale; }
try { const useTF = state.showDebug && state.bboxMethod === "tf"; const drawResult = lib.drawText(state.textComponent, screenX, screenY, { scale: state.guiScale, ...(state.customProgramId ? { programId: state.customProgramId } : {}), generatePicking: state.showDebug && !useTF, cachePicking: state.showDebug && !useTF, transformFeedback: useTF, });
if (state.showDebug && drawResult) { drawDebugOverlay(drawResult, canvas.height); } } catch (e) { // Silently ignore parse errors during typing }
lib.renderer.endFrame(); requestAnimationFrame(render); }
render();}
function drawDebugOverlay( drawResult: { components: Array<{ id?: string; bbox: { min: [number, number]; max: [number, number] } }> }, canvasHeight: number) { const ctx = debugCanvas.getContext("2d"); if (!ctx) return;
ctx.clearRect(0, 0, debugCanvas.width, debugCanvas.height);
for (const comp of drawResult.components) { const { min, max } = comp.bbox; const minY = canvasHeight - max[1]; const maxY = canvasHeight - min[1]; const w = max[0] - min[0]; const h = maxY - minY;
ctx.fillStyle = "rgba(255, 0, 0, 0.3)"; ctx.fillRect(min[0], minY, w, h); ctx.strokeStyle = "rgba(255, 255, 0, 0.8)"; ctx.lineWidth = 1; ctx.strokeRect(min[0], minY, w, h); }}
function clearDebugCanvas() { const ctx = debugCanvas.getContext("2d"); if (ctx) ctx.clearRect(0, 0, debugCanvas.width, debugCanvas.height);}
function setStatus(message: string) { const status = document.getElementById("status"); if (status) status.textContent = message;}
init().catch((err) => { console.error(err); setStatus(`Error: ${err.message}`);});