RMOO 1.3

The following documents how to get RMOO up and running for the complete beginner. If you're unfamiliar with Emacs, the conventions used may be a bit odd. Here's a quick rundown of how commands are presented:

When prefixed with a C-, that means hold down CTRL and the letter following C-. e.g. C-w means hold down CTRL while pressing w.

When prefixed with an M-, that means your meta key. Typically this is your Windows or Option key. e.g. M-x means to hold down meta while pressing x. (This will often be followed by a full string. M-x allows you to run commands by typing them in.)

Installation

Emacs 30+

1. Add a use-package expression like the following to your init.el.

(use-package rmoo
 :vc (:url "https://github.com/g-gundam/rmoo" :branch "master")
 :demand t
 :bind (("C-c C-r" . rmoo))
 :init
 ;; rmoo uses plural hooks, so I can't use use-package's :hook which assumes singular.
 (add-hook 'rmoo-interactive-mode-hooks #'goto-address-mode)
 (add-hook 'rmoo-interactive-mode-hooks (lambda () (electric-pair-mode -1)))
 :config
 (require 'rmoo-autoload)
 (require 'moocode-mode)
 (require 'coldc-mode)
 (add-to-list 'auto-mode-alist '("\\.moo$" . moocode-mode)))

Emacs Before Version 30

1. git clone https://codeberg.org/ggxx/rmoo.git ~/.emacs.d/rmoo
2. git clone https://github.com/atomontage/xterm-color.git ~/.emacs.d/xterm-color
3. Add the following to your configuration file:

(add-to-list 'load-path "~/.emacs.d/xterm-color")
(add-to-list 'load-path "~/.emacs.d/rmoo")
(require 'rmoo-autoload)
(require 'moocode-mode)
(require 'coldc-mode)
(global-set-key (kbd "C-c C-r") 'rmoo)
(add-to-list 'auto-mode-alist '("\\.moo$" . moocode-mode))
(add-hook
 'rmoo-interactive-mode-hooks
 (lambda ()
 (linum-mode -1) ;; ... no line numbers
 (goto-address-mode t))) ;; ... clickable links

World Management

Adding World

To add a world, type: M-x rmoo-worlds-add-new-moo (or press C-c C-w C-a)

You will then be prompted for the following:

• World Name - The name of the MOO you're connecting to. e.g. Miriani
• Site - The address of the MOO you're connecting to. e.g. toastsoft.net
• Port - The port of the MOO you're connecting to. e.g. 1443
• TLS/SSL - If the MOO you're connecting to supports secure connections over TLS / SSL, say yes here.
• Log File Path - The path of the file where all of the MOO's output will be saved.

Once the world is added, you'll probably want to save it for future connections. To save your world file, type: M-x rmoo-worlds-save-worlds-to-file (or C-c C-w C-s)

Connecting and Disconnecting

To connect to a world, type M-x rmoo (or C-c C-r)

To disconnect from a world, type M-x rmoo-quit (or C-c C-q)

Editing Code

First, enable local editing inside your MOO: @edit-option +local

Once you @edit a verb, the screen will split in half with your verb code on one side and the MOO output on the other. For basic commands to use to manipulate windows, see the Window Management section below. Here are some commands that will come in handy in the editor:

Commands and Keybindings

Miscellaneous Settings

These are some settings you can put in your Emacs init file to enhance your rmoo experience. RMOO-specific settings can be configured from within Emacs by typing M-x customize-group, rmoo.

Window Management

Changelog

Version 1.3 (In Progress)

• Add UTF-8 support.
• Add M-space to jump to your last command in the buffer.
• Add an option to retain command history across connections in the same buffer.
• Fix an issue where reconnecting from an existing buffer would duplicate the contents of that buffer, eventually leading to a crash after several reconnections.
• Add minimal support for ColdC worlds. (At the moment, this only affects which mode LambdaMOO-style local editing will invoke.)
• Update moocode-mode to add new types and built-in functions from ToastStunt.
• Convert common UTF characters to ASCII when sending commands.

Version 1.2 (November 13, 2018)

• Add 256-color ANSI support.
• Add support for SSL/TLS connections.
• Prevent backspace from deleting the prompt.
• Add logging capabilities.
• Add a scratch buffer, allowing you to execute arbitrary commands from a separate buffer. Useful for pasting @dump output, @paste, etc.
• Add a new keybinding to automatically set @linelength based on window size with C-c C-l
• Added more documentation.
• Replaced MCP 1.0 support with MCP 2.1 support. Implemented packages include:
  • mcp-negotiate
  • dns-org-mud-moo-simpleedit
  • dns-com-awns-status
  • dns-com-vmoo-client
• Made settings visible by adding an 'rmoo' group to M-x customize-group.

Earlier Versions

• See CREDITS.txt for original changelogs and version control notes.

Authors

Ron Tapia <tapia@nmia.com>, Matthew Campbell <mattcampbell@pobox.com>, Todd Sundsted, lisdude <lisdude@lisdude.com>