# Nibbles Manual

Nibbles is a worm game for GNOME. The player controls a 2D worm while trying to get food. Getting food gives points, but hitting anything causes a loss of points. When all points are lost, the player loses.

2000
Kevin Breit
GNOME Documentation Project

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this link or in the file COPYING-DOCS distributed with this manual.

This manual is part of a collection of GNOME manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the license to the manual, as described in section 6 of the license.

Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and the members of the GNOME Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.

DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE WITH THE FURTHER UNDERSTANDING THAT:

1. DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND

2. UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR, OR ANY DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.

Kevin
Breit
GNOME Documentation Project

     battery841@mypad.com

Nibbles Manual V2.20
May 2007

Kevin Breit battery841@mypad.com

GNOME Documentation Project

This manual describes version 2.20 of Nibbles.

## Odziv

To report a bug or make a suggestion regarding the Nibbles application or this manual, follow the directions in the GNOME Feedback Page.

## Uvod

Nibbles is a game where the user controls a worm. The worm moves around the board, eating diamonds while avoiding the walls placed around it.

To run Nibbles, select Games Nibbles from the Applications menu, or type `gnibbles` on the command line.

Nibbles is included in the `gnome-games` package, which is part of the GNOME desktop environment. This document describes version 2.20 of Nibbles.

## Nibbles Objective

The objective of Nibbles is quite simple. You control the worm and if the worm runs into a wall or runs into itself, you die. You get ten lives before your game is over. You win by either beating your own high score (or a friend's) or by completing all the levels. It is also possible to play against worms with artificial intelligence.

Nibbles also features multiplayer support with up to six competing human players in hotseat mode.

## Using Nibbles

Nibbles is a simple game to play. The only keys that are needed are the arrow keys.

### Basic usage

Starting Nibbles opens the main window shown below.

#### Nibbles Introduction Window

Nibbles Introduction Window.

To start the game, select Game New Game.

When the game starts, the worm will come out of the left side of the screen. You use the up arrow to make the direction of the worm go up. Use the right arrow to turn the worm right, left arrow to turn the worm left, and down arrow to turn the worm down.

#### Nibbles During Gameplay

Nibbles During Gameplay.

### Menus

The menu bar, located at the top of the Main Window, contains the following menus:

Game

  This menu contains:

  - Ctrl+N New Game This starts a new game of Nibbles.

  - Scores This shows the high scores.

  - Pause game This will pause your game. Click on the Pause Game menu option to resume game.

  - End Game End the current game and return to the title screen.

  - Ctrl-Q Exit This quits the application.

View

  This menu contains:

  - Fullscreen This toggles your game window to be fullscreen.

Settings

  This menu contains:

  - Preferences This opens your window to edit preferences.

Help

  This menu contains:

  - F1 Contents Display this manual.

    About This opens the About dialog which shows basic information about Nibbles, such as the author's name, the version number of the game.

### Diamonds

Nibbles has numerous different diamonds to eat. They are each a different color and serve a different function. Only the pale purple diamond is guaranteed to be around long enough for you to eat it (in fact, you have to eat them to finish the level). The other diamonds are all bonuses, but they only stick around for a short time. We'll leave it up to you to discover just what the bonus each colour gives, but they all affect either the score, the length of the worm, or both. Be careful when going for these bonus diamonds, don't cut yourself off from the ordinary diamonds that you need to finish the level.

## Customization

To change the application settings, select Settings Preferences . This opens the Preferences dialog. All preferences are automatically saved and applied as you change them.

### Game Preferences Tab

Game Preferences Tab.

The properties in the Game tab are:

Speed

  This controls the speed of the worm.

Play levels in random order

  Selecting this causes the level advancement to happen in random order.

Enable fake bonuses

  When enabled, this allows for two blue diamonds on the screen at a time. One diamond makes you shrink instead of grow when eaten.

Enable sounds

  Controls the use of sound in the game.

Starting level

  Which level to start with. Use this if you want to jump immediately to a challenging level.

Number of human players

  There is room for up to six players.

Number of AI players

  There is room for up to six AI players. Note that the total number of human and AI players must be less than or equal to six.

### Worm Preferences Tab

Worm Preferences Tab.

The properties in the Worm 1 through Worm 6 tabs let you set individual preferences for the different worms.

Keyboard controls

  This list let you change the keyboard controls for the given worm. To change a control, double click on the appropriate entry and then press the key you want to use for that control.

Use relative motion

  Rather than left sending your worm toward the left of the screen, right toward the right and so on, the left and right keys make the worm perform a left or right turn. For example, if the worm is moving to the left and you press the left control it turns to head toward the bottom of the screen.

Worm color

  Customize the color of your worm so you can tell it from your opponent's worm in multi-player mode.

## Authors

Nibbles was written by Sean MacIsaac sjm@acm.org and Ian Peters itp@gnu.org. This manual was written by Kevin Breit battery841@mypad.com. Nibbles was updated with network support by Andreas Røsdal andreasr@gnome.org. To report a bug or make a suggestion regarding this application or this manual, follow the directions in this document.

## License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

A copy of the GNU General Public License is included as an appendix to the GNOME Users Guide. You may also obtain a copy of the GNU General Public License from the Free Software Foundation by visiting their Web site or by writing to

        Free Software Foundation, Inc.
        59 Temple Place - Suite 330
        Boston, MA 02111-1307
        USA