Wikia

Freeciv

FreecivWebClient

Talk0
620pages on
this wiki

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. 

Freeciv-web-screenshot-2014

Freeciv-Web Screenshot

Development Edit

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:

To check out the code, use the following command:

git clone https://github.com/freeciv/freeciv-web.git


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.
  • freeciv-web - a Java web application for the Freeciv web client. This application is a AJAX application which consists of HTML,  Javascript, images and JSP files which make up the application  viewed in each user's web browser.
  • freeciv-img-extract - extracts the images of the Freeciv tileset,  and generates a version for the web. This produces a tileset PNG  and Javascript. Run this to sync with the upstream Freeciv SVN  repository.
  • publite2 - a simple way to launch multiple civservers. 


This is also a useful resource for developers interested in Freeciv-web.

Freeciv-web overview page on github

Freeciv-web on github

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.


Donations

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!

Around Wikia's network

Random Wiki