Difference between revisions of "The Dvorak Engine"
(First draft dump of content from the old site.) |
(Adding "Engine usage" section.) |
||
Line 1: | Line 1: | ||
The Dvorak Engine is a MUSH object that supports the storage and play of Dvorak games; this is a list of its commands. | |||
(For more about MUSHing, refer to the [[MUSHing Guide]].) | |||
==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 '''newcard''' commands (topped with a '''cleardeck''' and ending with a '''@dolist''' which automatically approves each card) - this is copied-and-pasted into your telnet client to create the deck in the Engine. ''(This doesn't yet work with the new wiki archive.)'' | |||
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 watch your assumptions and feed in fresh MUSHcode if in doubt. | |||
==Key== | |||
When you use these commands... | When you use these commands... | ||
Line 12: | Line 28: | ||
:'''destroy <num>''' [[Image:MUSH_viewall.gif]] Destroy a specific card in play, moving it to the discard pile. | :'''destroy <num>''' [[Image:MUSH_viewall.gif]] Destroy a specific card in play, moving it to the discard pile. | ||
=Viewing the Game== | ==Viewing the Game== | ||
:'''readcard <num>''' [[Image:MUSH_viewnone.gif]] 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.) | :'''readcard <num>''' [[Image:MUSH_viewnone.gif]] 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.) |
Revision as of 12:44, 1 February 2007
The Dvorak Engine is a MUSH object that supports the storage and play of Dvorak games; this is a list of its commands.
(For more about MUSHing, refer to the MUSHing Guide.)
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 newcard commands (topped with a cleardeck and ending with a @dolist which automatically approves each card) - this is copied-and-pasted into your telnet client to create the deck in the Engine. (This doesn't yet work with the new wiki archive.)
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 watch your assumptions and feed in fresh MUSHcode if in doubt.
Key
When you use these commands...
- 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 all 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.