mooR

mooR is a network-accessible, multi-user, programmable system for building online social environments, games, and collaborative spaces. Think of it as a virtual world where participants can not only interact with each other, but also program and modify the environment itself.

mooR is a modern, from-scratch rewrite of LambdaMOO, maintaining full compatibility with existing LambdaMOO 1.8.x databases while adding significant enhancements.

📖 For comprehensive documentation, see our mooR Book.

⚠️ 1.0-Beta Release: mooR is now in 1.0-beta! This is a significant milestone with stable database formats and APIs. We're in feature freeze mode and focusing on bug fixes, documentation, and performance. See the Status section below for details.

See the full announcement blog post for more...

📦 Repository Migration Notice (August 2025): We've recently moved our primary repository from GitHub to Codeberg. If you're viewing this on GitHub, please consider switching to Codeberg for the latest updates, issue tracking, and contributions.

What Makes MOOs Special

MOOs offer a unique digital experience through:

• Collaborative storytelling where participants build a shared narrative
• Live programming - modify the world while you're in it
• Community-driven development through persistent interactions and relationships
• Rich interaction that engages users through both traditional command-line and modern web interfaces
• Complete customizability - everything from objects to commands can be programmed

mooR builds on the foundation of MUDs (Multi-User Dungeons) and similar multiplayer online environments that have fostered creative communities for decades. Like modern sandbox games, MMORPGs, and social platforms, MOOs provide persistent worlds where players can build, create, and collaborate. What sets MOOs apart is their emphasis on live programming and community-driven content creation - imagine if Minecraft's creative mode, Discord's community features, and a code editor all lived in the same space.

In a world of throwaway apps and walled gardens, mooR is cheerfully dragging the future into the past - taking the best ideas from decades of online community building and rebuilding them with modern technology.

Status

mooR is in 1.0-beta development, focusing on stability, bug fixes, and documentation. The core runtime and database formats are considered "stable" but churn may still happen. It successfully runs databases imported from LambdaMOO with real-world workloads and has passed extensive stress and performance testing.

Beta phase means:

• Feature freeze: No new features will be added before the 1.0 stable release
• Focus on bug fixes, documentation, and performance optimization
• Database formats and APIs are now stable
• Ready for testing and feedback from users

Repository: The primary mooR repository is hosted on Codeberg with a mirror on GitHub.

Key Features & Enhancements

Runtime improvements:

• Fully multithreaded architecture for modern multicore systems
• Web frontend client
• Directory-based import/export format for version control integration
• Modular architecture for easier extension

Language enhancements:

• UTF-8 strings, 64-bit integers, binary values
• Proper boolean values (true/false)
• Maps: associative containers (["key" -> "value"])
• Lexically scoped variables with begin/end blocks
• List/range comprehensions ({x * 2 for x in [1..5]})
• Lambda functions: anonymous functions with closures ({x, y} => x + y)
• Symbol literals ('mysymbol) like Lisp/Scheme (optional)
• UUID object identifiers (optional)
• Anonymous objects with automatic garbage collection (optional)
• Lightweight immutable objects ("flyweights") (optional)

Modern infrastructure:

• Fast, durable, transactional database
• Support for multiple client protocols (web, telnet)
• Easy deployment via Docker

Quick Start

The easiest way to get started is with Docker Compose:

export USER_ID=$(id -u) GROUP_ID=$(id -g)
docker compose up

For faster builds during development, the default configuration uses debug builds. For production deployment with optimized performance, use:

export USER_ID=$(id -u) GROUP_ID=$(id -g)
BUILD_PROFILE=release docker compose up

Note: Debug builds compile significantly faster (especially on resource-constrained systems like Docker Desktop on macOS) while still providing good performance for development and testing.

This starts four services:

• moor-daemon: The backend MOO service
• moor-telnet-host: Traditional telnet interface on port 8888
• moor-web-host: REST API and WebSocket server for web clients
• moor-frontend: Web client served via nginx on port 8080

Connect via:

• Web: http://localhost:8080
• Telnet: telnet localhost 8888

The server comes pre-loaded with an extraction of LambdaCore, providing a ready-to-explore virtual world.

For more detailed setup instructions, see the Docker Compose Setup section in the mooR Book.

Alternative: Frontend Development Setup

For frontend development and testing, you can run just the daemon and web client without Docker:

npm run full:dev

This starts the moor-daemon and web development server, accessible at http://localhost:3000. This setup excludes telnet and provides hot-reloading for frontend development, but it requires installing some dependencies. See the web client's readme for details.

Deployment Options

mooR provides multiple deployment configurations to suit different use cases:

Development & Single-Machine Deployments

The root docker-compose.yml is designed for development and single-machine deployments. All services run on the same host and communicate via IPC (Unix domain sockets).

Services run as your user (via USER_ID and GROUP_ID environment variables), avoiding permission issues with data directories.

To start:

export USER_ID=$(id -u) GROUP_ID=$(id -g)
docker compose up -d

Testing Clustered Configuration

The docker-compose.cluster.yml file is an example configuration that demonstrates TCP-based communication with CURVE encryption. It runs on a single machine but shows what a multi-machine clustered setup would look like:

docker compose -f docker-compose.cluster.yml up -d

This uses TCP with CURVE encryption and enrollment tokens for host authentication. It's useful for testing the clustered setup locally before deploying across actual separate machines.

For actual multi-machine production deployments, use Kubernetes (see future documentation) or deploy Debian packages on separate servers.

Production Deployment Configurations

The deploy/ directory contains production-ready configurations:

• telnet-only/: Minimal telnet-only setup for traditional MUD usage
• web-basic/: Web-enabled deployment with HTTP (for use behind reverse proxies)
• web-ssl/: Web-enabled deployment with HTTPS/TLS support
• debian-packages/: Native Debian/Ubuntu packages with systemd (no Docker)

All production configurations use IPC for single-machine deployments and include automated testing scripts. See each deployment's README for specific setup instructions.

For deployment testing:

cd deploy
./test-all.sh  # Test all deployment configurations

For Developers & Contributors

mooR offers several opportunities for contribution. For detailed contribution guidelines, see CONTRIBUTING.md.

Core Development (Rust):

• Server architecture improvements
• New builtin functions
• Performance optimizations
• Protocol extensions

World Building (MOO language):

• Creating new cores and experiences
• Porting existing MOO content
• Building modern web-enabled interfaces

Documentation & Testing:

• Expanding the mooR Book
• Creating tutorials and examples
• Stress testing and bug reports

Getting Involved

• Issues: Check our Codeberg Issues for current needs
• Discussion: Join our Discord community
• Development: See the mooR Book for architecture details
• Support: Consider sponsoring the project to help with ongoing development

Bug Reports

Found a bug or have a feature request? Please file an issue on our Codeberg issue tracker.

When reporting bugs, please include:

• Steps to reproduce the issue
• Expected vs actual behavior
• Your system information (OS, Docker version if applicable)
• Relevant log output or error messages

Resources

• 📖 Complete Documentation - The comprehensive mooR Book
• 🏗️ Server Architecture - Technical overview
• 💻 MOO Programming Language - Language reference
• 🚀 Running a Server - Deployment guide

License

mooR is licensed under the GNU General Public License v3.0. See LICENSE for details.

This ensures the software remains open and free, in keeping with the the original LambdaMOO project.