WebLib
lets you write Minecraft GUI screens using HTML, CSS, and a lightweight JavaScript bridge that calls back into your Java mod code.
No ratings yet
Be the first to rate it.
Community listing page
Community listing page, reviews may not be monitored by the author.
Community voices
Reviews
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
About
Description
WebLib — HTML/CSS/JS GUIs for Minecraft NeoForge 1.21
WebLib (web_lib) is a lightweight library mod that lets mod developers build fully-featured Minecraft GUI screens using standard HTML and CSS, with a simple JavaScript-to-Java callback bridge — all rendered natively via Minecraft's own GuiGraphics, with zero external browser dependencies.
Stop wrestling with Minecraft's widget system. Write your mod's menus the way web developers write interfaces.
Features
- HTML rendering — Supports a rich set of elements:
div,p,h1–h6,span,button,input,select,img,ul/ol/li,pre,hr,code, and more. - Full CSS engine — Cascade, inheritance, specificity, and a broad property set including:
- Box model (
margin,padding,border,width,height) - Flexbox (
flex-direction,justify-content,align-items,flex-wrap,gap) - Colors (
#RGB,#RRGGBB,#RRGGBBAA,rgb(),rgba(), named colors) - Text styling, overflow, z-index, relative positioning, and more
- Selectors: type, class, ID, attribute, pseudo-classes (
:hover,:active,:focus,:nth-child,:not, etc.), and all combinators
- Box model (
- JavaScript bridge — Fire Java callbacks directly from HTML
onclick/onchangeevents. Pass arguments, access and mutate the DOM from Java. - Built-in JS functions —
alert(),navigate(),reload(),setStyle(),setInnerText(),toggleClass(),setVar(),console.log()— no registration needed. - Multi-page navigation — Build multi-screen UIs with back ◀ / forward ▶ / reload ↺ browser chrome, or go headless.
- External CSS & JS files — Reference stylesheet and script files from your mod's assets using the standard
namespace:pathResourceLocation convention. - Resource-based pages — Load HTML pages directly from your mod's resource pack with
WebLibApi.openPageFromResource(...). - Advanced
WebPageAPI — Build, inject CSS, mutate, and layout pages programmatically before opening them.
For Mod Developers
Adding WebLib to your mod is a single dependency declaration:
[[dependencies.yourmod]]
modId = "web_lib"
type = "required"
versionRange = "[1.0,)"
ordering = "AFTER"
side = "CLIENT"
Then open any screen with a single call:
WebLibApi.openPage("<html><body><h1>Hello, Minecraft!</h1></body></html>");
Register Java functions that HTML can call:
WebLibApi.registerFunction("myMod.openShop", (args, ctx) -> {
Minecraft.getInstance().tell(() -> Minecraft.getInstance().setScreen(new MyShopScreen()));
return null;
});
Requirements
- Minecraft: 1.21
- Mod Loader: NeoForge
- Side: Client-only
- License: Apache 2.0
Source Code
Available on GitHub under the Apache 2.0 License. Contributions welcome!

Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
Stats
- Downloads
- <1,000
- Used in
- 0 modpacks
- Followers
- 0
- In stacks
- 0
- Created
- Last synced
-
Nov 3, 2026 6:40 AM UTC
New file updates sync automatically.
When ModDex last fully re-synced this project from CurseForge or Modrinth. A new file release triggers a resync usually within minutes, and every project is also re-synced on a schedule. Edits that don't ship a file, such as a new description or screenshots, are checked every few hours and can appear before this date changes.
How syncing works
External Links
Stats
- Downloads
- <1,000
- Used in
- 0 modpacks
- Followers
- 0
- In stacks
- 0
- Created
- Last synced
-
Nov 3, 2026 6:40 AM UTC
New file updates sync automatically.
When ModDex last fully re-synced this project from CurseForge or Modrinth. A new file release triggers a resync usually within minutes, and every project is also re-synced on a schedule. Edits that don't ship a file, such as a new description or screenshots, are checked every few hours and can appear before this date changes.
How syncing works