The Dvorak Engine

The Dvorak Engine is a MUSH object that supports the storage and play of Dvorak games, which is running on the Dvorak MUSH.

Engine usage

To start a new game of creative Dvorak, use the cleardeck command to clear the Engine of any cards that might be there, and newcard to begin creating cards.

If you want to play a deck from the archives, click the "Generate MUSHcode" link on that deck's page to get a list of generated loadcard commands (topped with a cleardeck and ending with an @emit to alert nearby players to the deck being loaded) - this should be copied-and-pasted into your telnet client to create the deck in the Engine. (If your telnet client interprets the entire text as a single line and rejects it, you'll need to cut and paste it line-by-line.)

There are no particular guidelines for usage - if you've made any cards with it, though, it's worth taking a log of the deck (logcards) and saving it to a text file, before you disconnect - someone else might use the Dvorak Engine in your absence, and your cards would be lost. If you're halfway through an actual game when you leave, use savedeck with a suitably unique save-name, and the game and cards can be retrieved and resumed at a later date. (You can use savedeck as temporary storage for a deck, but there's no guarantee that someone won't deletedeck to tidy up, while you're gone.)

listdecks will give you a list of all saved games currently stored in the Engine - although the names of some of these might tally with decks in the archive, they're not necessarily up-to-date copies, so feed in fresh MUSHcode if in doubt.

Commands

Key

When you use the commands below...

Everyone sees what you've done, and the results it had.

Everyone sees that you've done what you've done, but only you see the actual results of it.

Only you see what you've done, and its results.

Basic Gameplay

• drawcard

Draw a card from the draw pile.

• playcard <num>

Play a specific card from your hand - if it's an Action, it goes to the discard pile; if it's a Thing, it is put into play under your control.

• discard <num>

Discard a specific card from your hand, to the discard pile.

• destroy <num>

Destroy a specific card in play, moving it to the discard pile.

Viewing the Game

• readcard <num>

Read the full text of a specific card. You can read any card that exists, even if it's in another Player's hand or the draw pile, or hasn't been approved yet. (You just won't be told where it is.)

• viewhand

List the cards you have in your hand.

• viewhand <player>

List the cards a specific opponent has in their hand.

• viewplay

List the cards currently in play, and who controls them.

• count <player>

Count the cards in a specific Player's hand.

• countdraw

Count the cards in the draw pile.

• viewdisc

List the contents of the discard pile.

• viewdraw

List the contents of the draw pile.

• viewvote

List any cards which have been created but not yet approved.

• viewall

List all cards that have been approved (i.e. all the cards in the game), but this doesn't reveal their locations.

• viewrep

List all repealed cards.

Advanced Gameplay

• drawvis

Draw a card from the draw pile and show it to all Players.

• discrand

Discard a random card to the discard pile.

• givecard <num> to <player>

Take a specific card, no matter where it is, and put it into a specific Player's hand.

• givething <num> to <player>

Take a specific card, no matter where it is, and put it into play under a specific Player's control.

• shuffle

Shuffle the discard pile into the draw pile.

• shufcard <num>

Shuffle a specific card, no matter where it is, into the draw pile.

• status <num>=<text>

Set the 'status' of a card to any text you like - a card's status is displayed in 'viewplay' and 'readcard', and can be used to keep track of tokens on the card, its position in play, or some arbitrary, adjustable status ('Undead', 'Wounded', 'Tapped', etc).

"status <num>=" will blank that card's status, and cards automatically lose their status when they're destroyed.

• playcard <num> onto <num>

The same as playing a Thing from your hand, except that it's played "onto" another Thing, its status automatically adjusted to reflect that.

• setnotes <text>

Sets the game notes (printed as part of viewplay) to whatever text you like - useful for keeping score in games that require it. 'setnotes by itself will clear the notes.

Card Creation and Amendment

• newcard <name>/ <type>/<text>

Create a new card with a name (eg. "Revenge of Godzilla"), a type ("A" for Action, "T" for Thing), and optionally some card text (eg. "Destroy three Things.").

For example:- newcard Revenge of Godzilla/A/Destroy three Things.

A newly-created card is assigned a number and presented to all players for their approval.

• approve <num>

Approve a card which a player has created. When a card is approved, it is shuffled into the draw pile.

• repeal <num>

Remove a card from the game.

• editcard <num>= <name>/ <type>/<text>

Edit an existing card, using similar syntax to creating a new one. This takes effect immediately, but before-and-after versions are displayed to all Players to allow them to check the edit.

• rename <num>= <name>

A quick way to adjust a card's name, leaving its type and text intact.

Loading, Saving, Resetting

• listdecks

List all games that have been previously saved in the Engine.

• savedeck <name>

Save the current game (including all card positions) under the given name, for future reloading.

• deletedeck <name>

Delete an old saved game.

• savedeck <name>

Save the current game (including all card positions) under the given name, for future reloading.

• newdvorak

Shuffle all the cards in the game back into the draw pile, for a new game with that deck.

• cleardeck

Blank all cards in the current deck, preparing the Engine for a completely new game.

• logcards

Log full details of all cards, including unapproved and repealed ones - you can then paste these into a text file for personal reference, or for manually reformatting for wiki submission.

Source code

The MUSH source for the Dvorak Engine is available, if anyone wants to create better or spinoff versions of it.