The KMessedWords Handbook

The KMessedWords Handbook

The KMessedWords Handbook

Primoz Anzur

Revision 0.0.1

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".

KMessedWords is the simple mind-training word game


Chapter 1. Introduction

Introduction

Chapter 1. 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.

KDE Logo
Chapter 2. Using KMessedWords

Using KMessedWords

Chapter 2. Using 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

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.

KDE Logo
Chapter 3. Game Reference

Game Reference

Chapter 3. Game Reference

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.

KDE Logo
Chapter 4. Configuring KMessedWords

Configuring KMessedWords

Chapter 4. Configuring 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

Changing player name

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.

KDE Logo
KDE Logo
Chapter 5. Setting word dictionary

Setting word dictionary

Chapter 5. Setting word dictionary

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.

KDE Logo
Chapter 6. Previewing scores

Previewing scores

Chapter 6. Previewing scores

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.

KDE Logo
Chapter 7. Developer's Guide to KMessedWords

Developer's Guide to KMessedWords

Chapter 7. 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.

KDE Logo
Chapter 8. Questions and Answers

Questions and Answers

Chapter 8. Questions and Answers

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

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

KDE Logo
Chapter 9. Credits and License

Credits and License

Chapter 9. Credits and License

KMessedWords

Idea, main developer, graphics and maintainer: Primoz Anzur<zerokode@yahoo.com>

Contributors:

Documentation copyright 2001 Primoz Anzur and KDE Edutainment team<zerokode@yahoo.com>

This documentation is licensed under the terms of the GNU Free Documentation License.

This program is licensed under the terms of the GNU General Public License.

KDE Logo
Appendix A. Installation

Installation

Appendix A. Installation

How to obtain KMessedWords

KMessedWords is part of the KDE project http://www.kde.org/.

KMessedWords can be found in the kdeedu package on ftp://ftp.kde.org/pub/kde/, the main FTP site of the KDE project.

Requirements

Requirements

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.

KDE Logo
Compilation and installation

Compilation and installation

Compilation and installation

In order to compile and install KMessedWords on your system, type the following in the base directory of the KMessedWords distribution:

% ./configure
% make
% make install

Since KMessedWords uses autoconf and automake you should have no trouble compiling it. Should you run into problems please report them to the KDE mailing lists.

KDE Logo
KDE Logo
KDE Logo