rb_chess

rb_chess

A chess library written in ruby. It provides all a representation of a chess game with all rules and serialization. It also provides a command line interface for playing the game

Installation

Add this line to your application's Gemfile:

gem 'just_chess'

And then run:

$ bundle

Or install it yourself as:

$ gem install rb_chess

Features

• Supports all chess moves including:
  • En passant.
  • Castling.
  • Pawn promotion.
• The game detects and declares:
  • Checkmate.
  • Stalemate.
  • Insufficient material.
  • Fivefold repetition
  • Seventy five moves rule
• Move generation.
• Move validation.
• Serializing (json and binary).

Usage

The code below plays a random game of chess:

require 'rb_chess'

game = RbChess::Game.new

until game.game_over?
  puts game.board.ascii
  game.make_move(game.all_moves.sample)
end

puts game.board.to_fen

You can find the full example of using this library in the RbChess::CLI class in lib/rb_chess/cli/cli.rb.

Playing

• To start run rb_chess.
• Moves are made by typing in coordinate system i.e e2e4.
• Castling moves are made by typing 0-0 for kingside and 0-0-0 for queenside.
• Promotion moves are made by typing the move with the promotion piece after it e.g a7a8Q.
• To save type save or s.
• To quit the game type exit.

To do

• Support for PGN.
• Support for SAN move format.

License

Distributed under the MIT License. See LICENSE for more information.