﻿CRISOL FOR MUSHCLIENT

Crisol is a fantasy MUD in Spanish that can also be played entirely in
English, designed from the start to be played with a screen reader. This
package brings the Crisol world already set up, its sounds and a small
plugin. To read the screen, use the usual plugins, the same as in other
muds.


INSTALLING IT

If you don't have MUSHclient yet, better download the complete package
(Crisol-MUSHclient-completo.zip), which brings it already set up: you
extract it, open MUSHclient.exe and play.
https://crisolmud.duckdns.org/en/how-to-play.html

1. Extract this zip wherever you like, for example in Documents. You get a
   folder called Crisol.
2. Open the Crisol.mcl file in that folder: with a double click or, in
   MUSHclient, with File, Open World.

MUSHclient connects to Crisol (crisolmud.duckdns.org, port 4000) and loads
the Crisol plugin by itself.


THE USUAL PLUGINS

If you already have them from another mud, there is nothing else to do. If
not, install them in this order:

1. MushReader (mushreader.xml, by Tyler Spivey): sends what comes in to
   your screen reader (NVDA, JAWS...). https://allinaccess.com/mc/ (the
   mushReader.zip file; all the DLLs inside it go in the MUSHclient
   folder, next to MUSHclient.exe: if one is missing, you get «The
   specified module could not be found»).
2. Auto Repeater (auto_retyping.xml, by Oriol Gomez).
3. Output Functions (output_functions.xml, by Oriol Gomez): go back over
   the last lines with the keyboard.
4. Channel History (channel_history.xml): each channel's chat apart, with
   Alt and the arrows.

Look for the other three by their file name or on MUSHclient's plugins
page: https://www.gammon.com.au/mushclient/plugins/
Output Functions and Channel History also come with Mush-Z, the MUSHclient
set up for blind players.

To make them work in every world, add them in File, Global Preferences,
Plugins, Add button. If you just copy them into MUSHclient's
worlds\plugins folder, the Crisol plugin loads them by itself in this
world.


WHEN YOU LOG IN

Crisol asks for your name. To play in English, type english instead of
your name the first time. If you use a screen reader, type reader the same
way. Both are saved with your character. In the game, screen reader mode
sums up combat and removes columns and colours: help reader explains it
all.


WHAT THE CRISOL PLUGIN DOES

- Channels: the game sends each message apart (through GMCP) and the plugin
  passes it to Channel History in its channel (the game's channels, the
  room, private messages, the group and friends), with the channel's name
  in your language, and also in «all», with everything together. Nothing
  to set up. If Channel History is not there, it
  says so once when the first message arrives.
- Sounds: Crisol plays a sound when you hit, die, gain a level, are spoken
  to and with some ambience lines. They come in the crisol_sonidos folder
  and play by themselves. In the game, sound off turns them off and sound
  on turns them back on; help sound tells you everything.
- Accented letters: the game recognises MUSHclient and sends it Latin-1. If
  it ever doesn't match, the plugin fixes it when you log in and tells you
  in one sentence.
- Warnings: the example triggers of the website's Triggers page (you are
  disarmed, blinded, poisoned, low life, left unarmed, each new ailment
  with its name...). They come turned off; turn on the ones you want. They
  only write a line, which MushReader reads: they never act for you. Type
  crisol warnings to see them, each with its number; crisol warnings and
  the number or name turns one on or off; crisol warnings all or none,
  all at once; crisol warnings threshold 25 warns you below 25% of your
  life. They are remembered from one time to the next.

The world also sets up the numeric keypad to move around, with Num Lock
on: 8 north, 2 south, 4 west, 6 east, 7, 9, 1 and 3 diagonally, 5 look,
- up, + down, * scan.


IF SOMETHING DOESN'T WORK

- If the plugin doesn't load when you open it, check that you open
  Crisol.mcl from the extracted folder and not from inside the zip. If it
  still doesn't, add it by hand: File, Plugins, Add button, and choose
  crisol.xml in the Crisol folder.
- If you see odd characters instead of accented letters, connect again. If
  that doesn't help, type what the plugin tells you (iso or utf8) or, if it
  says nothing, iso.
- If Crisol adds new sounds, download this zip again from the website:
  https://crisolmud.duckdns.org/en/how-to-play.html
- If something goes wrong inside the game, type bug and what happens.


CONTENTS

  Crisol\LEEME.txt                      this file, in Spanish
  Crisol\README.txt                     this file
  Crisol\Crisol.mcl                     the world
  Crisol\crisol.xml                     the Crisol plugin
  Crisol\crisol_sonidos\*.wav           the game's sounds
  Crisol\crisol_sonidos\LICENCIA.txt    the sounds' licence


CREDITS AND LICENCE

The world, the plugin, this text and the synthesised sounds were made by
Crisol. You may use, copy and change the world, the plugin and the texts as
you like. Almost all the sounds are Crisol's own, free (CC0); a few are
recordings, and the dog's comes from Pixabay, under its licence: it is all
in LICENCIA.txt. MushReader, Auto Repeater, Output Functions and Channel
History are not in this package: they belong to their authors and are
downloaded from their site.

MUSHclient is by Nick Gammon (https://www.gammon.com.au/mushclient/).
