Skip to main content

editor detail (Editor)



EvEditor is Evennia's in-game line editor. It opens when a command
            needs you to write or revise longer text, such as a room, place,
            message, profile, or other editable field.

            Type normal text to add it to the end of the buffer. Commands inside
            the editor begin with `:`.

            Common Commands:
              :h
                Show the editor's built-in help.

              :
                Show the buffer with line numbers. Add a line number or range to
                show only those lines, such as `: 3` or `: 3:7`.

              ::
                Show the raw buffer without line numbers or color parsing.

              :::
                Add a literal `:` as its own line.

              :w
                Save without leaving the editor.

              :wq
                Save and leave the editor.

              :q
                Leave the editor. If you have unsaved changes, it asks whether
                to save them.

              :q!
                Leave without saving.

            Editing Commands:
              :u
                Undo one change.

              :uu
                Redo one change.

              :UU
                Reset all changes back to the starting text.

              :dd <line>
                Delete a line or line range.

              :DD
                Clear the whole buffer.

              :i <line> <text>
                Insert text before a line.

              :r <line> <text>
                Replace a line.

              :I <line> <text>
                Insert text at the beginning of a line.

              :A <line> <text>
                Append text to the end of a line.

              :s <line> <word> <text>
                Search and replace in the whole buffer or in a line/range.

              :dw <line> <word>
                Delete a word or regex from the whole buffer or from a line/range.

              :y <line>
                Copy a line or line range.

              :x <line>
                Cut a line or line range.

              :p <line>
                Paste copied or cut text before a line.

            Formatting Commands:
              :j <line> <align> = <width>
                Justify text. Alignment can be `l`, `c`, `r`, or `f`.

              :f <line> = <width>
                Flood-fill text to a width.

              :fi <line>
                Indent the whole buffer, a line, or a line range.

              :fd <line>
                De-indent the whole buffer, a line, or a line range.

              :echo
                Toggle whether the editor echoes your input back to you.

            Notes:
              - Line numbers start at 1.
              - A line range looks like `3:7`.
              - `<word>` can be one word or quoted text.
              - Most commands can omit `<line>` to act on the current default
                line or the whole buffer, depending on the command.
              - Some special code-editor commands exist only in code editor mode.