Unciv/README.md

113 lines
4.8 KiB
Markdown
Raw Normal View History

2019-11-21 20:53:23 +00:00
# Unciv - Civ V for Android (+Desktop)
2017-11-30 12:13:43 +00:00
![](https://lh3.googleusercontent.com/l8fuQ2DnNjoD9pFnHLsli1xt8OClfr6O9GSBJJ9w7IIb2VHOyxqKZ9lNZXtMqOabCfyI=w1920-h867-rw)
2019-11-20 21:24:45 +00:00
[![Google Play](https://img.shields.io/badge/Google-Play-black.svg)](https://play.google.com/store/apps/details?id=com.unciv.app)
[![F-Droid](https://img.shields.io/f-droid/v/com.unciv.app)](https://f-droid.org/en/packages/com.unciv.app/)
2019-05-22 18:55:07 +00:00
2019-06-07 08:16:43 +00:00
[![Travis CI w/ Logo](https://img.shields.io/travis/yairm210/UnCiv/master.svg?logo=travis)](https://travis-ci.org/yairm210/UnCiv)
2019-11-20 21:24:45 +00:00
[![Discord Chat](https://img.shields.io/discord/586194543280390151.svg)](https://discord.gg/bjrB4Xw)
[![LibGDX](https://img.shields.io/badge/libgdx-1.9.10-red.svg)](https://libgdx.badlogicgames.com/)
2019-09-03 20:56:58 +00:00
[![Kotlin](https://img.shields.io/badge/kotlin-1.3.50-orange.svg)](http://kotlinlang.org/)
2018-03-03 22:04:55 +00:00
2019-11-20 21:24:45 +00:00
2019-06-07 08:16:43 +00:00
2019-11-05 11:06:36 +00:00
# What is this?
2018-03-03 22:04:55 +00:00
2019-11-16 16:41:02 +00:00
An open-source Android/Desktop port of Civ V,
2018-05-23 20:40:52 +00:00
Made with LibGDX on Android Studio
2018-03-03 22:04:55 +00:00
2019-11-05 11:06:36 +00:00
## What's the roadmap?
2018-03-03 22:04:55 +00:00
2019-10-25 13:42:22 +00:00
Is this order:
* Polish! As you may have noticed, Unciv is fully functional but rough around the edges. This means:
2019-10-24 15:38:56 +00:00
* UI+UX improvements (suggestions welcome!)
2019-11-15 13:25:06 +00:00
* Better automation, AI etc. in-game
* Development and distribution cycle
* Automated tests - done!
* Automated F-droid and Google Play version deployment
* Standalone Desktop executables
* Maybe Itch.io?
* Missing features from Vanilla - Natural wonders, city-state quests, missing civs etc.
2019-10-24 15:38:56 +00:00
* G&K mechanics - religion, faith etc.
* BNW mechanics - trade routes etc.
2019-11-16 16:41:02 +00:00
# Contributing
## How can I help?
2019-12-14 21:31:26 +00:00
If you're a programmer, get started at [here!](https://github.com/yairm210/Unciv/wiki/Getting-Started)
If you want to help with the translation, get started [here!](https://github.com/yairm210/Unciv/wiki/Translating)
2019-12-10 18:34:20 +00:00
You can join us in any of the open issue, or work on improving anything you want - once you're finished, issue a pull request and it'll go into the next version!
2019-11-16 16:41:02 +00:00
If not, you can help by spreading the word - vote for Unciv where you can, mention it on Reddit or Twitter etc, and help us with new ideas of how to get the word out!
If you REALLY want to donate for some reason, I have a Patreon page [here!](https://www.patreon.com/yairm210)
2019-12-07 19:48:57 +00:00
2019-12-10 19:32:08 +00:00
## [Adding a new Civ](https://github.com/yairm210/Unciv/wiki/Making-a-new-Civilization)
2019-06-10 18:45:47 +00:00
2019-06-19 11:47:44 +00:00
# FAQ
2019-06-19 11:48:26 +00:00
## Will you implement {feature}?
2019-06-19 11:47:44 +00:00
If it's in the original Civ V, then yes!
There's a lot left to implement, so it's hard to give an estimation of when exactly each feature will be added, but we're constantly improving!
If not, then the feature won't be added until we've finished all the features from the original Civ - as mentioned, this will take a while!
2019-10-16 06:21:56 +00:00
## Please add {Civilization}
THE most common request, hands down. Everyone wants their favorite Civ in the game, I get that. But there are so many other things to work on - automations, AI, UI, graphics, bugs, and of course other features from the original game that are currently missing. Eventually we'll have them all, but the key word is "eventually".
2019-10-24 15:38:56 +00:00
## Will you implement Civ VI?
Maybe, once we've finished with all of Civ V. But considering how long it took to get this far, Civ VII may be out by then.
## Is there a desktop version?
There are standalone zip files for each operating system in [Releases](https://github.com/yairm210/UnCiv/releases) which contain everything needed for Unciv to run
If you have Java 8, and are familiar with the command line, there are (considerably smaller) JARs in [Releases](https://github.com/yairm210/UnCiv/releases) which you can run with `java -jar Unciv.jar`
Be aware that the game will generate files inside the for where the Jar is located!
2019-11-15 07:33:59 +00:00
If you also have JDK 8 installed, you can compile Unciv on your own by cloning (or downloading and unzipping) the project, opening a terminal in the Unciv folder and run the following commands:
### Windows
Running: `gradlew desktop:run`
Building: `gradlew desktop:dist`
### Linux/Mac OS
Running: `./gradlew desktop:run`
Building: `./gradlew desktop:dist`
2019-11-19 18:20:29 +00:00
If the terminal returns Permission denied or Command not found on Mac/Linux, run `chmod +x ./gradlew` before running `./gradlew`. *This is a one-time procedure.*
2019-11-16 16:41:02 +00:00
Gradle may take up to several minutes to download files. Be patient.
After building, the output .JAR file should be in /desktop/build/libs/Unciv.jar
2019-11-15 07:33:59 +00:00
For actual development, you'll probably need to download Android Studio and build it yourself - see Contributing :)
2019-10-24 15:38:56 +00:00
## How can I learn to play? Where's the wiki?
All the tutorial information is available in-game at menu > civilopedia > tutorials
All the information is included in the amazing [Civ V wiki](https://civilization.fandom.com/wiki/)
Since this is a Civ V clone, you can search Google for how to play Civ V and there are loads of answers =)
Alternatively, you could [join us on Discord](https://discord.gg/bjrB4Xw) and ask there =D
# [Credits and 3rd parties](docs/Credits.md)