# The &kappname; Handbook

Mick
Kappenburg

    ksudoku@kappenburg.net

Eugene
Trounev

    eugene.trounev@gmail.com

Ian
Wadham

    iandw.au@gmail.com

2007
Mick Kappenburg
2011
Ian Wadham
&FDLNotice;
2011-11-24
&kappversion; &kde; 4.8

This documentation describes the game of &kappname; version &kappversion;

KDE
kdegames
game
ksudoku
logic
board
one player
puzzle

## Introduction

### Gametype:

Logic, Board

### Number of possible players:

One

&kappname; is a logic-based symbol placement puzzle.

The player has to fill a grid with symbols so that each column, row and block on the game board contains only one instance of each symbol. In &kappname; the symbols are usually the numbers 1 to 9, but may be the letters A to P or A to Y in larger puzzles. Puzzles start with the board partially filled and it is your job to fill in the rest.

When you start a game, you can choose from several Sudoku types and sizes. You can then have &kappname; generate a puzzle for you to solve or you can start with an empty board and enter in a puzzle from another source, such as a newspaper, then get &kappname; to check it and maybe solve it.

There are many variations of Sudoku in existence and &kappname; provides a good selection of them. The most common variant has a 9x9 square grid and uses Arabic numerals 1 to 9 as symbols. The grid has 9 rows and 9 columns and is divided into 9 blocks of 3x3 squares. The problem is – each symbol can only be used once per row, column or block.

It takes time and concentration to complete a game. However, solving Sudoku puzzles helps to increase overall brain activity and therefore is highly recommended.

## How to Play

### Objective:

Fill the grid so that each column, row and block contains only one instance of each symbol.

When the game starts you are prompted to choose which game type and board size you are interested in. You can enter in a puzzle from another source or have &kappname; generate a puzzle. The generator has several difficulty settings and some symmetry settings, which affect the pattern in which the puzzle is generated. Your game experience will depend on which of all these options you choose.

When the puzzle board appears, take a look at the left hand side. There is a selection list which contains all the symbols available in the current game. The set of symbols depends on the size of game you choose. Games may have 4, 9, 16 or 25 symbols. The first two sets use the numbers 1 to 4 or 1 to 9: the others use the letters A to P or A to Y.

First, note the boundaries in the game board. The thick lines outline the blocks. Each of these blocks has to be completed using the symbols available and each symbol must be used once and only once within the block. The same is true of the rows and columns in the board.

Now you can start entering symbols into the vacant squares on the board. To do that, select the symbol you wish to enter from the selection list on the left, then use the mouse to click on a vacant square in the board. Alternatively, you can hover with the mouse over a vacant square or use the cursor keys to move around, then use the keyboard to enter a symbol.

In Roxdoku (three-dimensional) puzzles, always use the mouse to set a small cube to a value and use a double click. When you rotate the large cube, by clicking and dragging with the mouse, it is easier to see what values are on the small cubes in the background if you click between the small cubes, not on them.

It is useful sometimes to enter markers or notes, which are tiny symbols within a square. These have no influence on the solution, but they can help you keep track of ideas you have had, especially when there is a choice between two alternatives and you do not yet have enough information to decide between them. To enter a marker or note, click with the right mouse button or hold down the &Shift; key when using the keyboard.

To clear symbols from a square, hover over the square with the mouse and hit Delete or Backspace on the keyboard or click with the &RMB; on the square.

Notice that the squares change color while you hover the mouse over them. This is to help you keep up with the rules of &kappname;. Use the vertical and horizontal lines to check if the symbol you are about to enter into a vacant spot is already in use anywhere in the vertical or horizontal line that square is a part of. The coloring also highlights the block which, if you remember, must also contain only one instance of each symbol. If you do not need the highlighting, you can use the Settings Configure &kappname;... menu item to turn it off.

Keep entering symbols in accordance with the rules until the whole game field is filled up. At this point &kappname; will check if all the entries are valid and will either correct you or accept your solution.

## Game Rules, Strategies and Tips

### General Game Rules

The rules of &kappname; are quite simple.

- Depending on the size of the game board, the type of puzzle and the difficulty level chosen an individual &kappname; puzzle may take from a few minutes to a few hours to solve.

- Each square may hold one and only one symbol.

- Each horizontal row (as defined by the game board) can contain each symbol exactly once.

- Each vertical column (as defined by the game board) can contain each symbol exactly once.

- Each block (as defined by the game board) can contain each symbol exactly once

#### Note:

The set of symbols depends on the size of game you choose.

- Knowledge of mathematics or language is not required to solve &kappname; puzzles.

- The symbols already on the game board when the puzzle starts cannot be changed.

- You can only modify the symbols you have previously entered.

- Puzzles generated by &kappname; have one solution only.

- Puzzles you enter in might have no solution or more than one solution, but if they are from a published source this probably means you have made a data-entry error.

### &kappname; Variations

- The Standard 9x9 Sudoku puzzle has 9 rows, 9 columns and 9 square blocks of size 3x3.

- Other sizes of Standard Sudoku are 4x4 (very easy), 16x16 and 25x25 (not so easy).

- The Jigsaw variation is the same as Standard Sudoku except that some blocks are not square.

- The XSudoku variation is exactly the same as Standard Sudoku with an additional requirement: the two main diagonals must also each contain the symbols 1 to 9 once and once only. &kappname; highlights the diagonals to make this easier to see.

- The Roxdoku variations are based on cubes in three dimensions, but are easier than they sound. There are no rows or columns. A 3x3x3 Roxdoku puzzle has 27 small cubes arranged into a larger 3x3x3 cube. This contains nine slices, each containing 3x3 small cubes, and these are the square blocks that must be filled with the numbers 1 to 9. A 4x4x4 Roxdoku has twelve 4x4 slices and a 5x5x5 Roxdoku has fifteen 5x5 slices.

- The Samurai Sudoku consists of five Standard Sudoku puzzles of 9x9 squares each, overlapping at the corners by four 3x3 blocks. Each of the five puzzles has 9 rows and 9 columns to solve, but there are only 41 blocks to solve, rather than 45, because of the overlap.

- The Tiny Samurai Sudoku consists of five 4x4 puzzles, overlapping at the corners by four squares. Each of the five puzzles has 4 rows, 4 columns and 4 blocks to solve.

### Strategies and Tips

- Take your time and do not rush. &kappname; is not a quick game.

- Pay attention to the row, column, and block colorings. They are there to help you.

- Make sure that no duplicate symbol exists already in the row, column or block where you are entering a symbol.

- If in doubt, try to foresee if a square you are entering a symbol into may be needed by some other symbol, which otherwise cannot go anywhere else due to the row, column and block rules.

- Use the Internet to search for general hints and strategies for solving Sudoku puzzles.

- Use marker moves when you spot a square or squares that have just a few alternatives but you cannot decide between them immediately. Markers will save you time and memory effort later, when more squares have been filled in. See How to Play for details of how to use markers.

- If you are having trouble, try to retrace your steps and see exactly where you have made an error. You can use the Move Undo and Move Redo menu items, repeatedly if necessary, and there is a setting in Settings Configure &kappname;... that highlights errors.

- Even though &kappname; provides a 'Hint' option for you, try not to use it often. Remember, solving the puzzle all by yourself enhances your brain activity, while using the 'Hint' feature too often is cheating.

- If you have too much trouble solving a certain puzzle and simply must use the 'Hint' feature, then maybe you should try decreasing the difficulty level, or try a simpler, more basic puzzle.

- Some puzzle layouts feature very specific game board shapes. It is a good idea to have the highlighting option enabled even if you consider yourself an experienced player.

## Interface Overview

### The Welcome Screen

The Welcome Screen is the first thing you see when you start &kappname; or use the toolbar or menu to request a new game. It has a list of all the puzzle types and sizes and you can click on one of them to make a selection.

If you click the button marked Enter In A Puzzle, an empty board of the selected type and size appears. Here you can use the mouse or keyboard to enter in a puzzle from another source, such as a newspaper. When you have finished, use the Check action, on toolbar or menu, to check the puzzle. It should have just one solution. If so, you can start solving the puzzle or perhaps get &kappname; to solve it. If there is no solution or more than one solution, it probably means you have made a data-entry error somewhere.

If you click the button marked Generate A Puzzle, &kappname; will display a board with some squares already filled in. It is up to you to fill in the rest.

Before you generate a puzzle, check that the settings of the Difficulty and Symmetry buttons are to your liking. You can change them during a game, but then they will have no effect until the next puzzle is generated.

If you cannot see the Difficulty and Symmetry buttons, use the Settings Show Statusbar menu item to make sure that the statusbar is visible.

The Difficulty button provides six levels of difficulty, from Very Easy up to Hard, Diabolical and Unlimited. The easier levels may take a few minutes to solve on a 9x9 board. The Hard and Diabolical levels may take an hour or so and are intended to be equivalent to difficult grades appearing in newspapers. Samurai puzzles and 16x16 or 25x25 sizes of puzzles will take longer to solve, simply because there are more rows, columns and blocks and more squares to fill in.

The Diabolical level typically requires one or more guesses, with backtracking if you guess wrong. Lower levels can usually be solved by logic alone. The Unlimited level has no limits on the number of guesses required, how soon the first guess is needed or how complex the logic might be. It is provided for the interest of expert players, but tends to generate uninteresting 'inhuman' puzzles and is not recommended for general use.

The Symmetry button provides seven types of symmetry, including No Symmetry. This controls the layout and appearance of the squares that are filled in at the start of a puzzle and has mainly aesthetic effect, except that puzzles with no symmetry tend to be slightly harder than those with high symmetry and it is less likely that &kappname; can generate a puzzle with high difficulty and high symmetry combined.

### The Game Menu

&Ctrl;N Game New

  Starts a new game.

&Ctrl;O Game Load...

  Loads a saved game.

&Ctrl;S Game Save

  Saves the current game as a default save file.

Game Save As...

  Saves the current game as a file of your choice.

&Ctrl;Q Game Quit

  Quits &kappname;.

### The Move Menu

&Ctrl;Z Move Undo

  Undo your last move, repeatedly if required.

&Ctrl;&Shift;Z Move Redo

  Redo a move that was undone, repeatedly if required.

H Move Hint

  Give a Hint by filling in a vacant square.

Move Solve

  Instantly solve the puzzle.

Move Check

  Check an entered puzzle for validity. If it has only one solution, it becomes available for play. If it has no solution or more than one solution, there has probably been an error in the data-entry.

### The Settings Menu

Settings Toolbars Main Toolbar

  Show or hide the Main Toolbar.

Settings Toolbars Actions Toolbar

  Show or hide the Actions Toolbar.

Settings Show Statusbar

  Show or hide the Statusbar.

Settings Configure Shortcuts...

  Display a standard &kde; shortcut configuration dialog to change the keyboard shortcuts for &kappname;.

Settings Configure Toolbars...

  Display a standard &kde; dialog where you can configure the toolbar icons.

Settings Configure &kappname;...

  Open a dialog to configure &kappname;. See Game Configuration section for details.

### The Help Menu

&kappname; has a default &kde; Help menu as described below:

&help.menu.documentation;

## Frequently asked questions

I want to change the way this game looks. Can I?

Sudoku games are traditionally played using a square grid. Themes do not make much sense here, but you can select some color schemes and backgrounds. To do so use Settings Configure &kappname;... on the menubar.

Can I use the keyboard to play this game?

Yes. In &kappname; keyboard play is always enabled. Please use the cursor keys to move the selection, numeric or alphabetic characters to enter the symbols and the &Shift; key to apply markers.

Where are the high scores?

&kappname; does not have this feature.

## Game Configuration

### GameOptions

Show Highlights

  Toggle the &kappname; highlight option.

  #### Note:

  Having this option enabled is recommended even for the most experienced players, as it helps to see the actual game board constraints.

Show Errors

  Toggle the invalid entry highlight.

## Credits and License

&kappname;

Copyright 2005-2007 Francesco Rossi redsh@email.it

Copyright 2006-2007 Mick Kappenburg ksudoku@kappenburg.net, Johannes Bergmeier johannes.bergmeier@gmx.net

Copyright 2011 Ian Wadham iandw.au@gmail.com

New solver and generator algorithms 2011 David Bau, see website.

Documentation copyright 2005 Francesco Rossi redsh@email.it

Documentation copyright 2007 Mick Kappenburg ksudoku@kappenburg.net, Eugene Trounev eugene.trounev@gmail.com

Documentation copyright 2011 Ian Wadham iandw.au@gmail.com

&underFDL; &underGPL;

## Installation

&install.intro.documentation;

### Compilation and Installation

&install.compile.documentation;

&documentation.index;