File	Date	Author	Commit
Docs	2013-12-05	Kevin Zheng	[7be8fb] Reorganize directory structure after migration ...
sample	2013-12-05	Kevin Zheng	[7be8fb] Reorganize directory structure after migration ...
src	2013-12-05	Kevin Zheng	[7be8fb] Reorganize directory structure after migration ...
BUGS	2013-12-05	Kevin Zheng	[7be8fb] Reorganize directory structure after migration ...
COPYING	2013-12-05	Kevin Zheng	[7be8fb] Reorganize directory structure after migration ...
DEVELOPERS	2013-12-05	Kevin Zheng	[7be8fb] Reorganize directory structure after migration ...
README	2013-12-05	Kevin Zheng	[7be8fb] Reorganize directory structure after migration ...
changelog	2013-12-05	Kevin Zheng	[7be8fb] Reorganize directory structure after migration ...

Read Me

+--------------------------------------------------------------------+
|                  ____   __    __    ___   ____                     |
|                 l    j |  T__T  T  /   \ |    \                    | 
|                  |  T  |  |  |  | Y     Y|  D  )                   |
|                  |  |  |  |  |  | |  O  ||    /                    |
|                  |  |  l  `  '  ! |     ||    \                    |
|                  j  l   \      /  l     !|  .  Y                   |
|                 |____j   \_/\_/    \___/ l__j\_j                   |
|                                                                    |
|                    Imperfect World Of Robots    ___________        |
+------------------------------------------------[README FILE]-------+
                                                  ¯¯¯¯¯¯¯¯¯¯¯
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+

IWOR is a  game for programmers. The purpose of  this project is study
on  Artificial Intelligence. IWOR  simulate a  world which  robots can
live in it, work, defend the tribe and even born new children!

IWOR 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 3  of the  License, or  (at your
option) any later version. (See COPYING for more information)

+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+
     ___ 
    | __|
    | _|
+---|_| EATURES -----------------------------------------------------+

In  most  of  the  other  programming games,  it  doesn't  matter  how
intelligence your  robots are. The importance is  how intelligence YOU
are! Winning  or losing a game  is  depend on what  strategy a certain
robot uses. If condition changes, it  will fail to win. Long term goal
of  this project  is  to  create a  simulated  environment which  most
intelligence robots live longer, and create a bigger generation.

Here main features of this project:

 - The greatest feature of IWOR among other projects is its ability to
let robots cloning.

 - Using  'socket' to communicate  between robots  and the  server let
robots  run  in  separate  machines  (Even  with  different  operating
systems).

 - Robots and  server communicate with simple messages  which makes it
easy to constructing robots.

 - Although server itself writes in  C++, robots can be constructed in
almost any other languages.

 - New worlds with different rules can be created by the user.

      ___
     / __|
    | (__ 
+--- \___|OMPILING FROM SOURCE CODE ---------------------------------+

Although  IWOR is  compiled  and  tested on  GNU/Linux,  it should  be
compiled on any other Unix  like machines. To compiling IWOR, you need
following packages:

  GCC (GNU Compiler Collection)
  Binutils (The GNU assembler, linker and binary utilities)
  Make (GNU Make, or other make packages)

To compile IWOR from source, enter its directory and Simply run 'make'
on terminal.

To activate  'debugging' mode, you should pass  '-DDEBUG' flag  to the
compiler. To do this, run the following command:

  make CFLAGS=-DDEBUG

COMPILING THE GUI:

There is  a simple 2D  GUI available for  IWOR. For compiling  it, you
must have GCJ installed on your system. (You can find a version of GCJ
along with your GNU/Linux distro.) Then enter 'src' directory and run:

  make gui
     _   _
    | | | |
    | |_| |
+--- \___/ SAGE -----------------------------------------------------+

  iwor [option] /path/to/world/file

To run  IWOR, you need atleast  one argument: a .world  file.  You can
find some sample .world file in the 'sample' directory. Options are:

  -p portnumber : Setting the port number (default is 7200)
  -g portnumber : Set the port number for the GUIs (default is 7250)

IWOR use sockets  for communicating between robots and  the server. So
robots must  run as the  individual process, same  goes for the  GUIs.
For information  about how  to use IWOR,  see 'HandBook.html'  on Docs
directory.   You can  always  find  latest documents  of  IWOR on  its
website: <www.iworproject.org>

NOTE: You  can use  telnet for testing  the program and  send commands
manualy to the  server. For doing this, after  running the server, run
telnet with following command:

  telnet localhost 7200
        _
       /_\
      / _ \
+----/_/ \_\CKNOWLEDGEMENTS -----------------------------------------+

There  are other  people who  helped  this project  grow. Testers  and
programmers who spend their valuable time on this project. Here a list
of them in no particular order:

  - Sadegh Gandomkar: Tester, Also gave some good advice.

      ___
     / __|
    | (__ 
+--- \___|ONTACT INFORMATION ----------------------------------------+

IWOR website:

  <www.iworproject.org>

Administrator of this project  is `Aidin Gharibnavaz'. You can contact
him by this email address:

  <aidin.vf(AT)gmail.com>

Feel free to send any idea,  suggestion, or bug report. It's an hounor
to receive mail from you!

If you  like this project and  want to help it, check out 'developers'
page on its website.

Thank you for downloading and using IWOR.