Communication

== Basic ==
These are basic communications methods that show only to the local room.
=== Concepts ===
 speech - <speech> is always text. By default, it's considered 'spoken.' 
 Also note that Speech beginning with a " will always be interpreted as 
 'spoken,' speech beginning with a : is 'posed' and will show as 
 '<yourname> <speech>', and speech beginning with a ; is 'semiposed' and 
 will show as '<yourname><speech>'. use %R to make a LINEBREAK and %T to do
 a TAB/INDENT. 
 IC - In-character. Part of roleplay. The actions of your character. 
 OOC - Out of character. Not part of the game's story or actions of your 
 character.
=== Basic Commands ===
These are IC in most rooms!
 say <text> - Sends a message to the local room. 
 :<text> - Poses/emotes to the room. 
 ;<text> - Semiposes to the room. 
 @emit <text> - Emits text to the room without a beginning name. Mostly 
 used for roleplay. 
=== OOC Commands ===
These are ALWAYS considered Out-of-character communications.
 osay <speech> - Equivalent to say. 
 ooc <speech> - alias of osay 
 +ooc <speech> - Alias of Osay. 
 think <text> - Only you see this text. A personal 'echo.' Useful for 
 testing formatting and colors, etc. 
Interested in coloring your text? Check out help ansi(). You must enclose uses of ansi() in brackets, such as [ansi()]. It's also helpful to enclose your actual text in curly braces {} if you're going to include commas in it. An example: [ansi(hr,{behold, this text is red})] will result in the phrase enclosed in the parentheses turning out red.
== Channels ==
PennMUSH has a rich built-in channel system. Channels are 'global' - anything said on them is heard by anyone else on the channel, no matter where they are. This game uses a softcoded add-on called +channel so some commands are hardcoded, others are softcoded. Hardcoded begin with @
+Channel Aliases: chan, +chan, channel
=== Managing Channels ===
 +channel - List visible channels. Simpler version of @chan/list 
 +channel <channel> - Shows info about a channel. 
 @chan/on <channel> - Join a channel. 
 @chan/off <channel> - leave a channel. 
 @chan/gag [<channel>] - mute a channel. You won't hear messages. This 
 resets on logoff. Leaving <channel> unspecified will mute ALL channels. 
 @chan/ungag [<channel>] - Undoes a gag. Leaving <channel> unspecified 
 unmutes all gagged channels. 
 @chan/who <name> - Show who's listening to a channel. Use +channel <name> 
 for channels that use CODENAMES instead. 
 @chan/title <channel>=<title> - Puts a title before your name when using a
 channel. Set to nothing to clear it. 
=== Channel Messages ===
 +<name> <text> - speak on a channel. <name> supports partial matches! As 
 an example: +p Hi everyone! would send to the Public channel. 
 @chat <channel>=<message> - Alternate way to send messages to a channel. 
 @chan/recall <name>=<#> - Show a channel's recent messages. # is number of
 lines. If # is 0 you'll see ALL remembered lines - VERY SPAMMY! 
 +chan/recall <channel> - Shows messages on <channel> since your last 
 logout, as far back as the system records. 
=== Player Channels ===
Here is a list of channels available to players on the game:
* Broadband   - IC  broadband frequency, available to all characters. Remember, anything you say here will be broadcast to everyone.                   
* Discussion   - For debates or other heated discussion. Please keep it civil.                  
* Guest   - Mainly for guests to use to ask questions and/or familiarize themselves with the game.                     
* Public  -  General OOC chatter. We ask that players avoid sensitive topics on this channel.                     
* RP - RP coordination channel. Please keep random OOC chatter that does not pertain to organizing a scene off of this channel.                              
* Spoilers  - Have you just seen a new movie or read the new IDW comics and want to share without ruining the plot twist at the end for those who haven't seen it yet? Use this channel. We want to respect others' ability to enjoy their favorite media as much as we can.                  
* Staff-Help  - Got a quick question for staff? Ask here.                    
* Unrated  - Any content that is outside the game's overall rating of PG-13 goes here. Remember, this is the ONLY place where any content/conversation of that nature will be tolerated.
* CharacterDev - For discussing characters/character concepts, or Character Development Lab ideas.            
* TP-OOC - This channel is for discussing scene or TP ideas with staff and players. If you don't want the details of your TP to be known to everyone, you can page or use JobSys instead.       
* Vent - If there is something that you just feel you really need to get off your chest, or you are just hoping for some sympathy or emotional support from others, that is the place to do it. If you are someone who doesn't mind listening to others' complaints/concerns about life in general, or like to comfort others, then feel free to join it.     
* Group Channels - Please see the Community page for instructions on how to use the Group channels, which include Autobot and Decepticon IC/OOC faction channels. 
All players and staff are expected to adhere to each channel's specific purpose. Failure to do so may result in temporary removal or restriction of access to the channel in question. Therefore, if you are asked to move a conversation to another channel or to pages, please do so immediately.
== Beep ==
=== Commands ===
 +beep <player> - (Hopefully) makes a noise the other player can hear to 
 try and get their attention. Using this excessively could be considered 
 harassment so be polite. You have been warned! 
 
 Not every client will make the noise and it is often disabled. 
== OOC ==
=== OOC Commands ===
These are ALWAYS considered Out-of-character communications.
 osay <speech> - Equivalent to say. 
 +ooc <speech> - alias of osay
== MUSH Mail ==
@mail invokes PennMUSH's hardcoded mail system. It's kind of like email but far simpler.
=== Reading Mail ===
 @mail - list your Inbox. 
 @mail <#> - Show a message. 
=== Sending Mail ===
 @mail <recipient>=<subject>/<message> - Sends <recipient> a message. 
 @mail/fwd <#>=<recipient> - Forward a message to <recipient> 
=== Deleting Mail ===
 @mail/clear <#> - Marks a message for deletion. Will be processed on 
 disconnect. 
 @mail/unclear <#> - Unmarks a message mistakenly marked for deletion. 
 @mail/purge - Force delection of cleared mail NOW instead of at logout. 
PennMUSH supports a great many features with its @mail system, such as sending to many recipients simultaneously or mass-reading/deleting many messages at once. Check its related hardcoded helpfile at help @mail for more information!
== Bulletin Boards ==
The BBS is a global, multi-threaded board with a rich set of features that grew from a rewrite of Myrddin's classical BBS. It shares almost identical command syntax and appearance.
=== Reading Posts ===
 +bbread - Show all message boards. 
 +bbread <board> - Shows a board's messages. <board> can be its name 
 (supports partial matches) or number. 
 +bbread <board>/<list> - Read a message. <list> is comma-seperated. 
 Entries can be single numbers, number ranges (ie. 1-6), and u (for 'all 
 unread'), in any combination or order - duplicates will not be shown. 
 +bbnext - shows first available unread message. 
 +bbnew - Same as +bbnext. 
 +bbcatchup <board> - Mark all messages on a board read. +bbcatchup ALL 
 sets ALL boards 'read.' 
 +bbscan - Lists unread messages. 
=== Writing Posts ===
 +bbpost <board>/<title> - Begins writing a post. 
 +bbwrite <text> - Writes to post in progress. +bb <text> also works. 
 +bbproof - Show post in progress. 
 +bbedit <type>=<search>/<replace> - Edits post in progress. <type> must be
 TEXT or TITLE. Any text matching <search> will be replaced with <replace>.
 +bbtoss - Erases a post in progress. 
 +bbpost - Submits finalized post. 
 +bbpost <board>/<title>=<text> - Quick posts to a board. 
 +bbedit <board>/<#>=<search>/<replace> - Edits a post on the board. Must 
 be original poster or staff. 
 +bbmove <board>/<#>=<board> - Relocates a post. Must be original poster or
 staff. 
 +bbremove <board>/<list> - Removes a list of posts. <list> works like with
 +bbread. Must be original poster or staff. 
=== Board Membership ===
 +bblist - Shows all visible boards. 
 +bbleave <board> - Leave a board. You won't hear notices from it. 
 +bbjoin <board> - Re-join a board you've left. 
=== Timeouts === 
The BBS supports timeouts by global scale, board scale, and individual post scale.
==== Duration Entries ====
 Anything that requires a <duration> lets you use a stringsecs compatible 
 (help stringsecs) entry. Example: 7w 5m (for 7 weeks, 5 minutes) or 30d 
 (30 days). 
==== Global Timeouts ====
 The Global timeouts are configured by staff in +gameconfig. 
==== Board Timeouts ====
These commands are staff only.
 +bbconfig <board>/timeout=<duration> - Default timeout for posts on 
 <board>. Set 0 for no timeout. Set null to use global default. 
==== Post Timeouts ====
 +bbtimeout <board>/<list>=<duration> - Change timeout for a list of posts.
 Players can only change for their own posts, and only less than board's 
 timeout. Admin may change any post's timeout, and set a post static by 
 setting it to 0. 
== Paging ==
Page is Penn's built-in private message system.
=== Commands ===
 page - Show who you last paged. 
 page <recipients>=<speech> - Sends a message to <recipients.> Recipients 
 is a space-seperated list of names. Enclose multi-word names in quotations
 such as "Firstname Lastname". 
 page <speech> - Sends a message to the last people you paged. Note that if
 you include a = it will consider everything before it to be <recipients> 
 like the above command, so you can't use = with this style of paging. 
 reply <text> - Sends a reply to the last character(s) who paged you. 
 Helpful when mass-paged. Also responds to just r 
 repage <text> - Send a Page to the last person you just messaged. While 
 page does this normally, retell lets you do it quickly if you just paged a
 lot of people who've yet to reply. Also responds to rt and retell 
 
 Be careful with these commands because getting paged by surprise might 
 result in mispaging. 
== JobSys ==
+job is used to create support tickets or requests to the Admin.
Aliases: request
=== Creating Jobs ===
 +request - Show all Job categories. 
 +request <title>=<text> - creates a new UNCATEGORIZED job. 
 +request/<category> <title>=<text> - Creates a new job in a specific 
 category 
=== Tracking Jobs ===
 +myjobs - Display all pending jobs you've submitted or have been appointed
 to handle. 
 +myjobs/old - As above, but shows only jobs that are finished. 
 +myjob <id> - Shows details about a job. 
 +myjob/reply <id>=<text> - Add a new message to your job.
=== Handling Jobs ===
The following commands are for staff and privileged players.
 +jobs - List all job categories and stats related to them. 
 +jobs <category> - List all pending jobs in a category. 
 +jobs/old <category> - Show all finished jobs in a category. 
 (use =<page> to show different pages, such as +jobs/old xp=3 to view the 
 third page.) 
 +job <id> - Display a job's details. 
 +job/reply <id>=<text> - Reply to a job. 
 +job/comment <id>=<text> - Add notes to a job that only category handlers 
 and staff can see. 
 +job/attn <id> - Change whether a job is marked as waiting for staff or 
 the player. 
 +job/claim <id> - Claim a job. Many can claim the same job. Use +job/claim
 <id>=<target> to add someone else. 
 +job/unclaim <id> - As /claim. Removes a handler. 
 +job/approve <id>=<text> - Closes a job and sends an approval message. 
 +job/deny <id>=<text> - As /approve. 
 +job/cancel <id>=<text> - As /approve. 
 +job/revive <id>=<text> - Restores a closed job to pending status. 
 +job/due <id>=<newdate> - Sets a new due date for a job. Can be a +1d or 
 similar (adds to current due date using value from a stringsecs() function
 - check the helpfile for stringsecs) or a specific date using convtime(). 
 As an example: +job/due x=+5d or +job/due x=Oct 06 12:11AM GMT 
 +job/scan - List all unread/changed or pending jobs. 
 +job/next - Like +bbnext, read the next unread job you can see. 
 +job/pending - List all pending jobs in categories you manage.
== Radio ==
The Radio System is a customizable series of soft-channels meant to represent in-character radio frequencies, IC chat rooms, and other venues of instant communication.
Aliases: +freq, freq, radio
=== Radio Concepts ===
 slots - A radio slot is a collection of settings used to broadcast and 
 receive messages. Slots are identified by unique words (only alphanumeric 
 characters and hyphens allowed). 
 encryption keys - An encryption key is a password used to scramble (and 
 unscramble) radio messages. They are case-sensitive and must match on both
 ends if set at all! 
 codename - A codename is an alternate name others will see you as for that
 radio slot. Codenames must be unique to a player and can't match player 
 names. 
 frequency - a frequency. Must be <number>.<number> format such as 99.5 or 
 101.1 
=== Basic Commands ===
 +radio - Display your configured channels. 
 +radio/init <slot>=<frequency> - Creates a new Radio Slot and sets it to 
 <frequency>. 
 +radio/freq <slot>=<frequency> - set a slot to a frequency. 
 +radio/key <slot>=<encryption key> - Sets an encryption key for a radio 
 slot. 
 +radio/rename <slot>=<new name> - Assigns a new name to a slot. 
 +radio/codename <slot>=<new codename> - Sets your Codename on a Slot. Set 
 to nothing to clear it. 
 +radio/toggle <slot> - Turns a slot on or off. Disabled slots can't send 
 or receive messages. 
 +radio/wipe <slot> - Erases all of a slot's settings. 
 +radio/title <slot>=<title> - Set a title to appear before your name. Keep
 it short and sweet! 
 +radio/color <slot>=<colorcode> - Set a color for a radio frequency. Enter
 nothing to clear color settings. 
 +radio/nospoof - Toggle whether real names are shown next to codenames if 
 a codename's in use. 
 +radio/who <slot> - See who's listening to a frequency. 
 .<slot>/<switch> <entry> - Equivalent to +radio/<switch> <slot>=<entry> - 
 useful for .<slot>/toggle, etc 
=== Sending Messages ===
 +radio <slot>=<speech> - Send a message over <slot>'s Frequency. 
 .<slot> <speech> - Shortcut for sending messages. Inspired by hardcoded 
 channels. Example: .broadband hello! 
=== Misc ===
 +radio/recall <slot or freq>=<#> - recalls <#> of lines from <slot>'s 
 frequency. Encryption keys needed. If <#> is blank, defaults to 10 lines. 
 If 0, shows ALL recorded messages. 
 +radio/nsrecall <slot or freq>=<#> - Like /recall, but as though nospoof 
 were turned on.
Category:Help