book

Creates a readable document from a loaded book template and puts it in your backpack.

Syntax	Console	In game	Minimum level	Role
`book <template> [name=value ...]`	No	Yes	GameMaster	Game

.book welcome_letter contact_name=Vega
.book grammar_of_orcish
.book blank_book

The template is the case-sensitive filename without .toml, from <root>/templates/books/. To create your own scroll:

Save this as <root>/templates/books/messaggio.toml:

title = "Message for $player_name"
author = "Lord British"
item_template = "readable_scroll"
content = """
Dear $player_name,

Welcome to $server_name!
Please report to the castle.
"""

Restart the server normally to load the new template.
Run .book messaggio in game as a GameMaster or Administrator.

A double click opens the parchment; with item_template = "readable_book" it opens the client’s book instead (books and parchments), as grammar_of_orcish does. The invoking character supplies $player_name; the configured server language selects translations when present. Text is saved at creation and stays unchanged when the document is traded or read by someone else. This command also preserves any attachments defined by the template, ready for its backpack bearer to claim once.

Custom name=value pairs supply the variables declared in the TOML. Names are case-sensitive; values are literal strings, with no variable expansion. All declared variables must be supplied, with no extra names or duplicates. An empty value is allowed (contact_name=); the value may contain =. Arguments are separated by whitespace: quoted values with spaces are not supported. For longer values, use book.give in Lua.

An unknown template reports its missing source. Invalid values, a missing or full backpack, busy inventory or unavailable serials fail without creating a document. After an update, copy the new messages 30181–30184 from the shipped data/messages/<language>/moongate.toml into any preserved existing root.

book

See also