Skip to Content
Enderdash

Knowledge blocks and widgets

Author Minecraft guides with Markdown directives and reusable interactive interfaces.

Choose a content type

Use ordinary Markdown for instructions, tables, task lists, images, and code. Use directives for familiar guide components. Use a widget when players need a calculator, decision tree, configurator, or another custom interface.

The visual editor's Insert menu includes widgets, connection guides, commands, guide links, reusable page content, steps, and Java/Bedrock tabs. Use Markdown mode to edit directive attributes. Unrecognized directives survive visual-editor round trips as source blocks.

Connection guides and commands

Enter the addresses that players should use. A connection guide remembers the reader's selected edition across other edition tabs.

::join-guide{java="play.example.net" bedrock="play.example.net" port="19132"}

::command[Claim land]{value="/lands claim" permission="lands.command.claim"}

Commands and code blocks have copy buttons. The permission attribute documents a requirement; it does not change server permissions or execute the command.

:::steps

1. Join the server.
2. Visit spawn.
3. Protect your first build.

:::

::card[Server rules]{url="/rules" description="Read the rules before you start."}

Paths such as /rules resolve within the current organization's knowledge base, including on a custom domain. Give code fences a language for syntax highlighting. Readers can enlarge article images without leaving the page.

Persistent edition tabs

Tabs with the same group share a reader preference. Give every tab a stable value.

:::tabs{group="edition"}
::tab[Java]{value="java"}
Open Multiplayer and add the server address.
::
::tab[Bedrock]{value="bedrock"}
On a supported device, open Play, Servers, then Add Server.
::
:::

Reuse a page as a snippet

Open a source page's actions and choose Copy reusable include. Paste the copied directive into another page, or use Insert > Reusable page content.

::include{id="aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaa1"}

Internal reading uses the source's saved content. Public reading uses its latest published snapshot. Publish a shared source deliberately: its update can appear in every article that includes it. A staff-only, unpublished, archived, foreign, or circular source cannot expose content through a public include.

Expansion supports four nesting levels and up to 16 includes per article. Use short shared instructions, such as connection details or reporting procedures, rather than including entire handbooks.

Build a custom widget

In the knowledge base, open the … menu next to the search field and select Widgets. Start with the claim calculator or write self-contained HTML, CSS, and JavaScript. Enter a name and a useful text alternative. Set default properties as a JSON object. Refresh preview runs the current code in the preview frame.

Save revision creates an immutable internal revision. Select an older revision to inspect or copy it into a new revision. An admin can choose Publish revision after reviewing the code and preview. The Copy saved embed action pins the selected revision:

::widget{id="cccccccc-cccc-4ccc-8ccc-ccccccccccc1" revision="2"}

Override default properties with JSON in an attribute:

::widget{id="cccccccc-cccc-4ccc-8ccc-ccccccccccc1" revision="2" props='{"pricePerBlock":2}'}

Publishing a later widget revision does not change articles pinned to an older one. Update each embed's revision when it is ready. Archive a widget to remove it from future public reads. Previously cached documents follow the site's cache policy.

Widget interface

The host provides window.enderdash:

InterfaceUse
propsRead the default properties merged with the embed's properties.
stateRead the widget's restored session state after enderdash:ready.
setState(value)Save JSON state for this page and widget revision in the reader's session.
resize()Ask the host to measure the widget again. Height also updates automatically.
enderdash:readyInitialize controls after properties, theme, and state are available.

Use theme variables such as --background, --foreground, --primary, --primary-foreground, --muted, and --border. Include labels, keyboard controls, and a readable text alternative. Preview errors appear to authors below the frame.

Widget code runs in an opaque iframe with scripts enabled. External assets, fetch requests, forms, nested frames, and workers are blocked by its content policy. Include assets in the HTML, CSS, or data URLs. The host bridge supports configuration, theme, bounded session state, resize, and author errors. It does not expose dashboard data, agent actions, cookies, or arbitrary tools. Keep secrets out of widget code and properties. Readers can view both.

HTML is limited to 512 KB, properties to 8 KB of serialized JSON, session state to 16 KB, and frame height to 100–1,800 pixels.

Design with an assistant

Design with Ocelot opens the assistant with the current widget context. Describe the player task, inputs, and expected result. The assistant can read widgets and save a draft revision through knowledge tools. Review the result and publish it separately.

An authorized MCP client can use list_knowledge_widgets, get_knowledge_widget, and save_knowledge_widget. Publishing uses publish_knowledge_widget and requires an owner or admin. See MCP knowledge tools.

Discord guide lookup

Share article links or a search link such as https://kb.enderdash.com/@your-server?q=claiming in your Discord community. Articles include titles and descriptions for link previews.

A Discord /guide command also exists. It works only through a Discord application that Enderdash operates. You cannot connect your own Discord application to the hosted knowledge base. If the command is not available in your Discord server, share a search link.

Where the command is available, players use /guide organization:your-server query:claiming. They receive up to three public article links in a private response. Unpublished pages and staff-only pages are excluded.

Continue

Use publication controls to review changes and manage variants. Use maintenance to collect player feedback and schedule article reviews.

Was this page helpful?

Send a quick note if anything is missing or unclear.

Last updated on