& 78
@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

& ORG SYSTEM
& +ORG

  The Org System is used for managing organisations, members of organisations,
  and wages. These "organisations" can vary from anything to companies
  and employees run by boards of directors, to ancient kingdoms with knights
  and townspeople, run by a king, to an army commanded by generals with
  different ranks of soldiers at different payrates.

  These switches are available to all players:
  APPLY, DEPOSIT, LIST

  These switches can only be used by members of an org:
  ACTIVITY, MEMBER, MOTD, PAYCHECK, PAYROLL, QUIT, RANKS, ROSTER, WHO

  These switches can only be used by leaders or primary leaders of an org:
  ACCEPT, ADDRANK, BALANCE, BOOT, CONTACT, DELRANK, RANK, REJECT, SETDESC,
  SETMOTD, SETPAY, SETWELCOME, TITLE, WAITING, WITHDRAW

  These switches can only be used by primary org leaders:
  LEADER, PRIMARY, RETIRE

  These switches are restricted to admins:
  ALIAS, APPOINT, CLEANUP, FORM, LEADERS, NUKE, PARENT, RENAME, UNPARENT

  For more info on any switch, see HELP +ORG/<switch>.

  See also: ORG FUNCTIONS

& ORG FUNCTIONS

  The following functions can be used to get information on the org system:

  orgs()          orgmatch()           orginfo()

& ORGS()

  ORGS(<player>[, <names?>])

  This function returns a list of all the organisations that <player> belongs
  to. You must control <player> or be able to examine him. If <names?> is not
  given, or is false, the list is a space-separated list of org id numbers.
  When <names?> is true, the function returns a |-separated list of org names.

  See also: orginfo(), orgmatch()

& ORGMATCH()

  ORGMATCH(<string>)

  This function attempts to match <string> against the names, aliases and org
  ids of all existing organisations, and returns the org id for the matching
  organisation if one is found, or 0 otherwise.

  See also: orginfo(), orgs()

& ORGINFO()

  ORGINFO(<orginisation>, <type>)

  The orginfo() function returns information about an organisation. <organisation>
  is the name, alias or id number of an org. <type> must be one of "name", "alias"
  or "contact".

  See also: orgmatch(), orgs()

& +ORG/APPLY

  +ORG/APPLY <org>

  This command allows players to apply to join <orgname>. They must then
  wait for a leader of the organisation to accept or reject them.

  See also: +org/list, +org/waiting, +org/approve, +org/reject

& +ORG/DEPOSIT

  +ORG/DEPOSIT <org>=<commodities>

  This command lets you give money and commodities to an organisation. Any
  player can give any amount to any organisation; you don't need to be a
  member.

  See also: IC MONEY, +org/list, +org/balance, +org/withdraw

& +ORG/LIST

  +ORG/LIST[/all] [<org1>[, <orgN>]]
  +ORG/LIST/MEMBER[/all] [<player>]

  This command can be used to get a list of the organisations on the game,
  as well as their aliases and contact information, if you need to get in
  touch with the leaders of the organisation.

  If the /member switch is given, the command shows only organisations you
  are a member of. Staff can give a <player> arg to see someone else's
  organisation membership. With /all, the full tree (including all children)
  for orgs you're in is shown. Otherwise, it will only list up to the level
  of which you're a member.

  Otherwise, it shows a list of all the orgs. You can also give a list of
  comma-separated organisation names and/or aliases to filter the list. With
  /all, you get the full org tree, including all children. Without it, you
  only see enough levels to view the given <orgs>, or the top level of orgs
  if no <org> arguments were given.

  Organisations which you belong to directly are highlighted.

& +ORG/ACTIVITY

  +ORG/ACTIVITY <org>

  This command lists all members in <org>, sorted by most recently to least
  recently connected. It also shows the date/time of their last connect.
  Org leaders are shown in red, and primary org leaders in gold.

  See also: +org/who

& +ORG/MEMBER

  +ORG/MEMBER [<player>]

  This command lists all the orgs that you're a member of. Admins can specify a
  <player> to see the orgs that person is a member of.

  See also: +org/list

& +ORG/MOTD

  +ORG/MOTD <org>

  Use this command to see the current MotD (Message of the Day) for an org you're
  a member of.

  See also: +org/setmotd

& +ORG/PAYCHECK

  +ORG/PAYCHECK <org>

  Use this command to collect your weekly pay from <org>. To see how much you'll
  get, use the +ORG/PAYROLL command. You can collect your pay once every real-life
  week.

  See also: +org/payroll, +org/setpay, +org/setrank, +org/addrank

& +ORG/PAYROLL

  +ORG/PAYROLL[/all] <org>

  This command shows you how much your weekly pay from <org> is. Org leaders can
  give the /all switch to see the payrolls of all members of the org, along with
  a weekly total.

  See also: +org/paycheck, +org/setpay

& +ORG/QUIT

  +ORG/QUIT <org>

  This command lets you resign from any organistion you're a member of.

& +ORG/RANKS

  +ORG/RANKS <org>

  This command lists all the ranks in <org>, along with their default paychecks.
  It can only be used by members of the org.

  See also: +org/addrank, +org/setrank, +org/delrank

& +ORG/ROSTER 

  +ORG/ROSTER <org>

  This command lists all members of <org> in a concise, three-column format.
  Org leaders are shown in red, and primary org leaders in gold. It is restricted
  to org members.

  See also: +org/activity, +org/who

& +ORG/WHO

  +ORG/WHO <org>

  This command shows online members of <org>, with leaders in red and primary leaders
  in gold. It can only be used by org members.

  See also: +org/activity, +org/roster

& +ORG/ACCEPT

  +ORG/ACCEPT <player>=<org>

  This command is restricted to org leaders and admins. It accepts the
  application made by <player> with +org/apply to join the organisation <org>.
  <player> is added to the org with the rank "New Member".

  See also: +org/reject, +org/apply

& +ORG/ADDRANK

  +ORG/ADDRANK <org>=<rank>/<commodities>

  This command adds the rank <rank> to <org>, with a weekly paycheck of
  <commodities>. If the rank already exists, the paycheck is updated.
  Any players of the rank who don't have custom paylevels will automatically
  have their pay updated. It can only be used by org leaders.

  See also: +org/setrank, +org/delrank

& +ORG/BALANCE

  +ORG/BALANCE <org>

  Checks the balance of <org>. You must be an org leader to use this command.

& +ORG/BOOT

  +ORG/BOOT <player>=<org>

  This command boots a player from an organisation. You must be an org
  leader to use it.

& +ORG/CONTACT

  +ORG/CONTACT <org>=<info>

  This command, restricted to org leaders, updates the contact info shown
  for an org on +ORG/LIST.

  See also: +org/list, +org/setwelcome

& +ORG/DELRANK

  +ORG/DELRANK <org>=<rank>

  This command deletes a rank from an organisation. Any players of this rank
  who do not have custom pay levels set will not be able to draw wages unless
  their rank is changed, a custom pay level is set for them, or the rank is
  re-added with +org/addrank.

  This command can only be used by org leaders.

  See also: +org/addrank, +org/setpay

& +ORG/RANK
& +ORG/TITLE

  +ORG/RANK <player>=<org>/<rank>

  This command sets <player>'s rank in the <org> organisation to <rank>.
  If the player has no custom paycheck set, and <rank> is listed in the
  ranks table (+ORG/RANKS) for <org>, his paycheck will automatically be set
  to the standard wages for the rank. Otherwise, he will receive any custom
  paycheck set for him.

  This command can only be used by org leaders.

  See also: +org/addrank, +org/setpay

& +ORG/REJECT

  +ORG/REJECT <player>=<org>

  This command, restricted to org leaders, rejects an application from a
  player to join an org. Whenever an application is rejected, the player
  should be contacted, preferably both ICly and OOCly, and told why his
  application was rejected.

  See also: +org/apply, +org/accept

& +ORG/SETDESC

  +ORG/SETDESC <org>=<desc>

  This leader-only command sets the description for an organisation. Since
  this description is currently not used anywhere, it's utterly pointless.

& +ORG/SETMOTD

  +ORG/SETMOTD <org>=<motd>

  This command sets the MotD (Message of the Day) for an organisation.
  Members of the org can check the MotD with +ORG/MOTD, and should do so
  regularly. It's restricted to org leaders.

  See also: +org/motd

& +ORG/SETPAY

  +ORG/SETPAY <player>=<org>/<commodities>

  This command sets the paycheck that <player> receives from <org> to
  <commodities>. This paylevel will override the default paylevel a player
  may receive from his rank. The command can only be used by org leaders.

  See also: +org/ranks, +org/setrank

& +ORG/SETWELCOME

  +ORG/SETWELCOME <org>=<message>

  This command sets the welcome message for an organisation. This is the
  message mailed to a player when they are accepted into the org. It can only
  be used by org leaders.

& +ORG/WAITING

  +ORG/WAITING <org>

  This command lists all players who have applied to join <org> but have
  not currently been accepted or rejected. It can only be used by org
  leaders.

  See also: +org/apply, +org/accept, +org/reject

& +ORG/WITHDRAW

  +ORG/WITHDRAW <org>=<commodities>

  This command lets org leaders withdraw <commodities> from the account
  of <org>.

  See also: +org/balance, +org/deposit

& +ORG/LEADER
 
  +ORG/LEADER <player>=<org>

  This command makes <player> an org leader in <org>. It can only be used by
  primary org leaders.

  See also: +org/roster, +org/leaders, +org/primary, +org/retire

& +ORG/PRIMARY

  +ORG/PRIMARY <player>=<org>

  This command makes <player> a primary org leader in <org>. It can only be
  used by current primary leaders.

  See also: +org/roster, +org/leader, +org/retire

& +ORG/RETIRE

  +ORG/RETIRE <player>=<org>/<type>

  This command can be used to retire a player from leadership of an
  organisation. It can only be used by a primary org leader. <type> should
  be one of "leader" or "primary".

  See also: +org/leader, +org/primary

& +ORG/ALIAS

  +ORG/ALIAS <org>=<alias>

  This command changes the alias for an org. The alias can be used in place
  of the org's name in all commands, and should be short and easy to type.
  Only admins can use this command.

& +ORG/APPOINT

  +ORG/APPOINT <player>=<org>

  This command can be used by admins to join a player to an organisation
  without him needing to apply.

  See also: +org/apply, +org/waiting

& +ORG/CLEANUP

  +ORG/CLEANUP <org>

  This admin-only command clears up data from purged players still stored
  for <org>. It should be run for each org after a player purge.

& +ORG/FORM

  +ORG/FORM <name>=<alias>

  This command will create a new organisation called <name> with the alias
  <alias>. It can only be used by admins. The player who uses this command
  to form the organisation will automatically be added as a primary leader
  and leader for the org. They can then appoint other leaders or primary
  leaders if appropriate.

  See also: +org/primary, +org/leader, +org/retire, +org/nuke

& +ORG/LEADERS

  +ORG/LEADERS

  This command shows a list of all primary leaders and org leaders on the
  game, grouped by organisation. It can only be used by admins.

  See also: +org/primary, +org/leader, +org/retire

& +ORG/NUKE

  +ORG/NUKE <org>

  This command removes an organisation and all the data associated with it.
  It cannot easily be undone, so please use it carefully. The command is
  restricted to admins.

& +ORG/PARENT

  +ORG/PARENT <org>=<parent-org>

  This command parents one organisation to another. Leaders of a parent org
  are automatically considered primary leaders of the child organisations,
  and members of a parent org are automatically members of the children,
  though you must be a direct member of an org to draw a paycheck from it.

  See also: +org/unparent

& +ORG/RENAME

  +ORG/RENAME <org>=<new name>

  This command changes the name of an existing organisation. It can only
  be used by admins.

  See also: +org/form, +org/alias

& +ORG/UNPARENT

  +ORG/UNPARENT <org>

  This command unparents an organisation.

  See also: +org/parent

& ORG VERSION
& ORG CHANGES
& ORG 1.2c

  Version 1.2c - May 28 2008

  * +org/list/member was incorrectly restricted. Report by qa'toq.

& ORG 1.2b

  Version 1.2b - May 27 2008

  * Extra space in +org/payroll/all.
  * Now sets the command object WIZARD if safer_ufun is on, after comment
    from qa'toq@M*U*S*H
  * Bug in +org/leaders. Reported by qa'toq.
  * When looking to see if you're a member of an org, the system now looks
    at it's parent orgs, too.
  * +org/list improved with better display and an expanded syntax. Based on
    suggestions from qa'toq.

& ORG 1.1

  Version 1.1 - June 15 2007

  * Initial release.

& 78
@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@