# The &kmessedwords; Handbook

Primoz
Anzur

    zerokode@yahoo.com

2001
KDE Edutainment team
&FDLNotice;
2001-11-25
0.0.1

&kmessedwords; is the simple mind-training word game

KDE
kdeedu
KMessedWords
mess
words

## Introduction

&kmessedwords; is the game, that is based on the word/letter puzzles that I have played as a child. It is a very simple constructed game, with 3 dificulty levels of play, and each level deserves it's value. It is fully customizable game, that allows you to write in your own words, and set your own look and feel" of the game. It is aimed for children aged 10+, because of the dificulty, but, hey... Everyone is welcome to try. A word is picked in random, and displayed out in the messed order, with dificulty dependant on the chosen level. You have unlimited numbers of tryes, and the scores are kept.

## Using &kmessedwords;

Here's a screenshot of &kmessedwords;
KMessedWords screenshot

### General usage

A word is displayed in the random order of the letters... You guess the entire word at once. If you missed or guessed, the game will tell you.

IMPORTANT : Words are case sensitive, so, that michelle is NOT Michelle...

Each time you start the game, the default level is easy.

There are 3 levels : easy, medium and hard:

As of all levels are completly customizable, you can set the level of difficulty of each level by yourself. And, as the dificulty level of the game is dependant on the length of the word, by default is this:

Easy

  4 letters, everyday words

Medium

  Special 4 letter words, and longer everyday words, up to 7 letters.

Hard

  Words at least 6 letters long, both everyday words and special words.

After a word is guessed, you are prompted for another word and you can either use the Yes or No.

## Game Reference

Here's a screenshot of &kmessedwords;
&kmessedwords; screenshot

### The main &kmessedwords; window

Button Bye!, just as well as &Alt;F4, can exit the game at any time.

Help button will show you this window, containing all of the avaliable help.

Configure button hides 2 options inside: Configuration will popup the main configuration screen to setup the &kmessedwords;, and the Dictionary, where you will be able to write / erase the words.

Scores will show you top 10 scores.

On push on button Messup You will start the game.

Dropdown menu Level will set the level that you are playing.

## Configuring &kmessedwords;

Configuration window of &kmessedwords;
&kmessedwords; configuration window

### Changing themes

&kmessedwords; allows you to change view of the application itself. You do that very simply by selecting which theme you want. just by clicking on the dropdown box. You can also select the parts, which you want to apply to the application; Weither this is just graphical buttons, background or both together, just select the checkboxes under theme name.

By default there is just one theme, called default. In some time, there will probably many more themes to be worked on, but created seperatly.

### Changing player name

Due to some mismatched features and programming problems, the login window from the previous version of the game was dropped and replaced with the splash screen. But now changing users is almost easy as before. In the configuration window you just select the tab named User, change your name and press Ok.

## Setting word dictionary

Wordlist editor of &kmessedwords;
&kmessedwords; dictionary window

### Changing words in &kmessedwords;

To get to the word-editor, you need to choose Configure Dictionary. For each level there is own list of the words, as for easy, medium and hard. The word editor is [for now?] just a plain text editor, that you just put words into them. The separator is a line divider, or press Enter.

The editor will refuse to read blank lines or lines with equal letters and characters. To save the words, just press OK or Save words. You don't need to be a superuser for the program to change the words, because the dictionary files are saved into local user configuration.

## Previewing scores

&kmessedwords; scores window &kmessedwords; scores window

### Checking scores in &kmessedwords;

To check scores, all you have to do is to click on the button scoring in the non-graphical window or on the 3-1-2 stars in the default theme.

## Developer's Guide to &kmessedwords;

### &kmessedwords; &GUI; - The Graphical User Interface

The &kmessedwords;' core is already built in full, for the reading / storing and messing up the words. Now my goal is to make the most easy to use, good looking graphical front-end for that. I am working on that as much as I can, but everything changes in non-stop action with my spare time. I still have some ideas, but I would really like any other opinions, too.

## Questions and Answers

&reporting.bugs; &updating.documentation;

I have an error message telling me the pictures cannot be found.

If you installed the program from the RPM, then I should be the one, that is supposed to fix that rpm file. But if you compiled the application on your own, note, that there is still something with the default prefix. The default prefix will install the app into the `/usr/local/`, so all you have to do is to change the prefix with ``--prefix=path_to_your_kde_dir``

## Credits and License

&kmessedwords;

Idea, main developer, graphics and maintainer: Primoz Anzurzerokode@yahoo.com

Contributors:

- Coding help (engine creation): Waldo bastian bastian@kde.org

- Coding help (includemoc and all that stuff...): Daniel Molkentin molkentin@kde.org

- Coding help (helped making the &kmessedwords; workimg properly under KDE2 and KDE3): Haavard Froeiland haavardf@operamail.com

- Moral support: Anne-Marie Mahfouf annma@kde.org

Documentation copyright 2001 Primoz Anzur and &kde; Edutainment teamzerokode@yahoo.com

&underFDL; &underGPL;

## Installation

### How to obtain &kmessedwords;

&install.intro.documentation;

### Requirements

In order to successfully use &kmessedwords;, you need &kde; 3 and &Qt; 3 on your system.

&kmessedwords; can be found on The &kmessedwords; home page.

### Compilation and installation

&install.compile.documentation;

&documentation.index;