Freeciv Web Client Edit
The Freeciv web client is a version of Freeciv which can be played online in a web browser, and can be found on http://play.freeciv.org/
Freeciv-web is an open-source turn-based strategy game. It’s built entirely in HTML5 and features in-depth game-play and a wide variety of game modes and options. Your goal is to build cities, collect resources, organize your government, and build an army, with the ultimate goal of creating the best civilization. You can play online against other players (multiplayer) or play by yourself against the computer.
The source code of Freeciv-web is developed in Github using a git distributed development model. This means that you can easily fork one of the main development repostories on github, and implement your improvement, and send a pull request to get your change accepted. These are the main git repositories for freeciv-web:
- http://github.com/freeciv/freeciv-web (actively developed)
To check out the code, use the following command:
Bug reports Please submit bugreports on the Freeciv Gna project page , using the "freeciv-web" category for bugs. cazfi posted some notes in May 2012 on the state of the codebase and possibilities of reconciling it with the upstream codebase.
More info about the source code Edit
Freeciv-web consists of five main software modules:
- freeciv - a fork of the main Freeciv C client and server.
- freeciv-proxy - a HTTP proxy which allows web client users to connect to Freeciv civservers. The proxy is a HTTP and WebSocket server, and proxy between web browsers and civservers.
- publite2 - a simple way to launch multiple civservers.
This is also a useful resource for developers interested in Freeciv-web.
Setting up Freeciv-web using Vagrant on VirtualBoxEdit
Freeciv-web can be setup using Vagrant on VirtualBox to quickly create a local developer image running Freeciv-web on Ubuntu 13.10 on your host operating system such as Windows, OSX or Linux.
1. Install VirtualBox: https://www.virtualbox.org/
2. Install Vagrant: http://www.vagrantup.com/
3. Install Git: http://git-scm.com/ then check out Freeciv-web from git to a directory on your computer, by running these two git commands:
git config --global core.autocrlf false git clone https://github.com/freeciv/freeciv-web.git
4. Run Vagrant with the following commands in your Freeciv-web directory from step 3:
vagrant plugin install vagrant-vbguest vagrant up
This will build, compile, install and run Freeciv-web on the virtual server image. Wait for the installation process to complete, watching for any error messages in the logs.
5. (Skip this step if you run Windows) For Linux or OS X, then you need to setup a SSH tunnel to port 80 like this:
sudo ssh -p 2222 -gNfL 80:localhost:80 vagrant@localhost -i ~/.vagrant.d/insecure_private_key
Then test Freeciv-web by pointing your browser to http://localhost/ on your host operating system.
To log in to your Vagrant server, run the command: vagrant ssh
Note that running Freeciv-web using Vagrant requires about 4Gb of memory and 3 Gb of harddisk space.
Freeciv-web runs on a server which is hosted based on funding from donations to the Freeciv project. So if you like this project, then please support it by donating!