Skip to main content
@groundsgg/motd lets you display and edit a Minecraft Java server entry. You can use the pure TypeScript core in Node.js, the DOM adapter in any browser framework, or the optional React adapter. You do not need the Grounds Portal, an account, React, or a connection to a Minecraft server to use the core. The viewer targets the selected Vanilla client profile. It displays supplied status snapshots, static colors and decorations, native obfuscated text, and optional client-menu panorama motion. It does not simulate continuously changing MOTD frames, scrolling, blinking, or animated gradient phases.
Native fidelity is the target, not a blanket verification claim. Client profiles retain explicit reference coverage and approximation diagnostics. Original Minecraft textures and client binaries are not included in the npm package.

Choose your entry point

Start here

Getting started

Install the package and run a core, DOM, or React example.

Documents and context

Separate saved authoring intent from client settings, runtime values, and editor state.

Embed the tools

Choose a viewer or editor, row or menu presentation, and fixed or selection toolbar.

Vanilla behavior

Understand native motion, status snapshots, and the limits of the measured evidence.
Use the API reference for commands and public types. Read known limits before treating an arbitrary font, resource pack, or component as pixel-verified. The code is MIT-licensed. Bundled fonts use SIL OFL 1.1; consult the package’s third-party notices. NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.