# Metaverse Markup Language

## Overview

This is a curated list of resources ([originally assembled by Directive Creator](https://github.com/DirectiveCreator/awesome-mml)) for Metaverse Markup Language (MML): tools, docs, editors, and more.

[MML](https://mml.io/) is Metaverse Markup Language, developed by Msquared.

### MML Basics

1. [**Metaverse Markup Language (MML) - Official Site**](https://mml.io/)**:**\
   Open-source web technologies for building multi-user metaverse experiences using HTML and JavaScript.
2. [**MML Documentation**](https://mml.io/docs)**:**\
   Comprehensive guides and references for MML elements.
3. [**MML Discord**](https://discord.com/invite/hPdWYhfVem)**:**\
   Join the community on Discord to discuss MML and connect with other developers.
4. [**Main MML Repository**](https://github.com/mml-io/mml)**:**\
   Metaverse markup language for describing 3D multi-user interactive metaversal objects and experiences based on HTML.

### Building with MML

* [**MML Editor**](https://mmleditor.com/)**:**\
  An interactive editor for building and testing MML documents.
* [**3D Web Experience**](https://github.com/mml-io/3d-web-experience)**:**\
  Packages to run web-based, multi-user 3D web experiences supporting MML.
* [**Esbuild Plugin MML**](https://github.com/mml-io/esbuild-plugin-mml)**:**\
  An esbuild plugin that bundles JavaScript/React sources into HTML documents for MML.
* [**MML React Starter Project**](https://github.com/mml-io/mml-react-starter-project)**:**\
  Example of a server that serves a live MML document using React.
* [**MML Starter Project**](https://github.com/mml-io/mml-starter-project)**:**\
  Example server for serving live MML documents via WebSocket.
* [**MML Guided Tour**](https://github.com/mml-io/mml-guided-tour)**:**\
  Implements an MML Guided Tour with live, multiplayer experiences.
* [**MML React Space**](https://github.com/mml-io/mml-react-space)**:**\
  Uses MML, 3D Web Experience, and React for interactive 3D web experiences.
* [**MML Playground**](https://github.com/mml-io/mml-playground)**:**\
  Minimal 3D playground powered by MML for creating live, multiplayer experiences.
* [**MML Starter Project Overlay**](https://github.com/mml-io/mml-starter-project-overlay)**:**\
  UI overlay for quick access to MML resources and project sharing.

### MML Resources

* [**MML Blog**](https://mml.io/blog)**:**\
  Stay updated with the latest news, tutorials, and announcements related to MML.
* [**MSquared Blog**](https://msquared.io/blog/)**:**\
  News and updates from MSquared, with frequent MML-related updates.
* [**Introducing Crowd Support in Web Worlds**](https://msquared.io/blog/introducing-crowd-support-in-web-worlds)**:**\
  Mass concurrency and Crowd Support in MML.
* [**AI-Powered NPC with MML**](https://mml.io/blog/ai-powered-npc)**:**\
  Guide on integrating AI to power NPCs using MML and OpenAI.
* [**MSquared Atlas**](https://atlas.msquared.io/things)**:**\
  A live, searchable index of creators, assets, and activity across worlds and chains, with trusted snapshots and runtime policy enforcement to power interoperable MML experiences.
* [**Open Page**](https://other.page/)**:**\
  Fan, engagement, and loyalty platform with MML support.

### Examples and Exploration

* [**MML Examples**](https://mml.io/examples)**:**\
  Demonstrations of MML capabilities and project templates.
* [**MML Editor Explore**](https://mmleditor.com/explore)**:**\
  Explore examples and code snippets within the MML Editor.
* [**3D Web Experience Examples**](https://mml.mgz.me/)**:**\
  Examples showcasing the 3D Web Experience with MML by TheCodeTherapy.
* [**Crazy Run 2**](https://directivecreator.com/crazyrun2)**:**\
  Obstacle course game with leaderboard and achievements, created entirely in MML.

### Streaming

* [**Live Streaming to the Metaverse**](https://mml.io/blog/live-stream-to-the-metaverse)**:**\
  How to stream events inside of MML using Cloudflare.
* [**Cloudflare Stream**](https://www.cloudflare.com/developer-platform/products/cloudflare-stream/)**:**\
  Service for hosting streams integrated with MML.
* [**Dolby OptiView**](https://optiview.dolby.com/)**:**\
  High-quality live streaming and playback service.
* [**OBS (Open Broadcaster Software)**](https://obsproject.com/)**:**\
  Free and open-source software for video recording and streaming, compatible with MML setups.

### Somnia

* [**Somnia Playground**](https://playground.somnia.network/)**:**\
  A hub for creativity and immersive experiences using MML.
* [**Somnia Blockchain**](https://somnia.network/)**:**\
  High-speed EVM blockchain with native MML support.

### On-chain and State Services

* [**Etherbase**](https://github.com/msquared-io/etherbase)**:**\
  A backend read/write service for EVM contracts that makes it easy to emit events, set state, and execute functions. Designed to be MML-compatible for wiring live on-chain data into MML experiences.

### Avatars and Rigging

* [**GLTF Avatar Exporter**](https://mml-io.github.io/avatar-tools/main/tools/gltf-avatar-exporter/)**:**\
  Tool for exporting avatars in GLTF format for use in MML.
* [**MML Avatar Tools**](https://github.com/mml-io/avatar-tools)**:**\
  Web tool for fixing mesh, skeleton, and material issues in avatars.
* [**MML Blender Extension**](https://github.com/mml-io/avatar-tools/blob/main/plugins/blender-geometry-utilities/mml-avatar-tools.py)**:**\
  Blender extension for MML avatar preparation.
* [**Sandbox Converter App**](https://github.com/msquared-io/sandbox-converter-app)**:**\
  Web application that converts various types of The Sandbox avatars into MML-wrapped GLBs, producing assets ready to drop into MML scenes.
* [**Avatar Creator**](https://github.com/msquared-io/avatar-creator)**:**\
  React component library for building fully-rigged 3D avatars powered by PlayCanvas, plus a minimal Next.js app as a live playground/reference integration—useful in MML pipelines.
* [**Game Rig Tools**](https://toshicg.gumroad.com/l/game_rig_tools)**:**\
  Tools for preparing game-ready rigs in Blender.
* [**Surface Heat Skinning**](http://www.mesh-online.net/shd-blender-addon.zip)**:**\
  Blender addon for optimized rigging.
* [**Avatar Documentation**](https://docs.msquared.io/creation/unreal-development/features-and-tutorials/avatars/creating-mml-avatars-with-blender-and-free-rigging-tools)**:**\
  Comprehensive guide and tutorial for creating MML avatars.
* [**Grillz Gang**](https://www.grillzgang.com/)**:**\
  NFT collection with MML-ready avatars.
* [**Mcbess Celmates Avatar Set**](https://directivecreator.com/mml/mcbess-celmates)**:**\
  MML Conversion of Mcbess Celmates avatar.
* [**Broadside Avatar 1**](https://directivecreator.com/mml/broadside)**:**\
  MML Conversion of Broadside avatar.
* [**Broadside Avatar 2**](https://directivecreator.com/mml/broadside2)**:**\
  Another Broadside avatar conversion in MML.
* [**Sappy Seal**](https://directivecreator.com/mml/sappy-seal)**:**\
  MML Conversion of Sappy Seals avatar.
* [**MML Avatar Starterkit**](https://github.com/DirectiveCreator/mml-avatar-starterkit)**:**\
  A quick guide and tool to get started with MML avatars at scale.
* [**MML Avatar Starterkit Web Tool**](https://mml-avatar-starterkit.onrender.com/)**:**\
  Batch web tool to generate multiple MML files from GLB URLs.
* [**Toothpaste Avatar**](https://directivecreator.com/mml/toothpaste)**:**\
  VRM to MML avatar conversion.
* [**Salt and Pepper Avatars**](https://directivecreator.com/mml/salt-pepper)**:**\
  VRM to MML Avatar conversion.
* [**Avatar Tools (online tool)**](https://directivecreator.com/avatar)**:**\
  Online tool for testing and creating avatars.
* [**Further MML Avatar Creation Resources**](https://directivecreator.com/mml/avatar-tutorial)**:**\
  Additional resources for creating avatars with MML.
* [**Blender Workflow Docs**](https://docs.msquared.io/tutorials-and-features/avatars/creating-mml-avatars-with-blender-and-free-rigging-tools)**:**\
  Detailed guide for creating MML avatars using Blender and free rigging tools.
* [**M-Character Reference**](https://mml.io/docs/reference/elements/m-character)**:**\
  A detailed reference for M-Character elements in MML.
* [**Video Tutorial**](https://www.youtube.com/watch?v=0m5xAzhoGkQ)**:**\
  A video tutorial covering avatar creation techniques.