About this project
RetroChess is a Chess plugin for RetroShare, intended for playing chess with your RetroShare friends and contacts. The README describes the plugin as compatible with RetroShare 0.6.
Building and installing
The recommended layout is to place or clone the RetroChess directory into RetroShare/plugins/. The build uses qmake and make:
cd ${YOUR_DIR}/RetroShare/plugins/RetroChess/
mkdir build
cd build
qmake ..
make
On Windows, the resulting RetroChess.dll is copied to Data/extensions6, after which RetroShare is restarted. Once loaded, a chess logo appears in the chat dialog's tool-bar or in the home tool-bar.
Usage
Games begin by sending an invitation through chat. The plugin presents a game window driven by a ChessBoard input widget and a ChessPosition rules/state class.
Standalone chessboard debugger
RetroChess also includes a small standalone Qt application for reproducing and debugging chess-rule problems without starting RetroShare, creating a tunnel, or connecting a second player. It reuses the same ChessBoard input widget and ChessPosition rules/state class as the plugin's game window.
The debugger supports:
- Click-to-move and drag-and-drop moves.
- Loading and copying complete FEN positions.
- Resetting to the initial position.
- Testing legal moves, castling, en-passant and promotion.
- A timestamped log of accepted and rejected moves.
- A deterministic SHA-256 hash for comparing positions.
Building the debugger is done from plugins/RetroChess/debug with qmake .. followed by make; on the documented Windows path the binary is started as ./release/RetroChessBoardDebug.exe.
The debugger is independent of RetroShare services and does not send moves over the network. A suggested workflow for a reported problem: copy the FEN from a game or debug report, paste it into the FEN position field, select Load FEN, and play the move that caused the issue; the event log records the result and the resulting position hash. The README notes that this standalone debugger is an additional development tool and does not replace or disable invitations, network games, game history, or the normal RetroChess game window.
Other notes
A screenshot is referenced in the repository's screenshot directory. The README states the project is based on earlier RetroChess work at github.com/Texas-C/RetroChess and github.com/chozabu/RetroChess.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.