Unciv README

The project's README from github.com/yairm210/Unciv. As one markdown file: README.md.

Unciv - Civ V remake for Android & Desktop

Google Play F-Droid itch.io Flathub AUR pi-apps Brew Chocolatey scoop-games

Build status Discord

What is this?

An open source, moddability-focused Android and Desktop remake of Civ V, made with LibGDX.

Is this any good?

Depends what you're looking for. If you're in the market for high-res graphics, amazing soundtracks, animations etc, I highly recommend Firaxis's Civ-V-like game, "Civilization V".

If you want a small, fast, moddable, FOSS, in-depth 4X that can still run on a potato, you've come to the right place :)

How do I install?

What's the roadmap?

In this order:

Contributing

Programmers start here!

Translators start here! Language completion status here

Modders start here!

You can join us in any of the open issues, or work on improving anything you want - once you're finished, issue a pull request and it'll go into the next version!

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!

FAQ

How about iOS?

I'm not planning on it. It means paying money to Apple, yet another release path, and since I don't have an iOS device it means I can't test it properly.

Steam release?

Steam has decided that they don't want to host Unciv, they probably don't want to risk legal issues with Firaxis (although those should be non-existent, see below).

Will you implement {feature}?

If it's in the original Civ V, then yes!

If not, then the feature won't be added to the base game - possibly it will be added as a way to mod the game, which is constantly expanding.

Why not? This is its own game, why not add features that weren't in Civ V?

Having a clear vision is important for actually getting things done.

Anyone can make a suggestion. Not all are good, viable, or simple. Not many can actually implement stuff.

As an open source project, this stuff is done in our spare time, of which there isn't much.

We need a clear-cut criteria to decide what to work on and what not to work on.

Will you implement Civ VI?

Considering how long it took to get this far, no.

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

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 and ask there =D

According to the US Copyright Office FL-108, intellectual property rights do not apply to mechanics - as I'm sure you know, there are a billion Flappy Bird knockoffs.

It is definitely illegal:

It is probably illegal (no solid sources on this):

Interestingly, Civilization is a registered trademark, but it looks like it's only that particular logo which is trademarked, so technically you could make another game called "Civilization" and it'll stick. In any case we're not going there :)

Run with Docker Docker

If you have docker compose installed:

$ docker compose build && docker compose up

and then goto http://localhost:6901/vnc.html?password=headless

If just docker:

$ docker build . -t unciv && docker run -d -p 6901:6901 -p 5901:5901 unciv

Or just use our already built one:

$ docker run -d -p 6901:6901 -p 5901:5901 ghcr.io/yairm210/unciv

and then goto http://localhost:6901/vnc.html?password=headless

Licensing and credits

This game is available under the MPL 2.0 (see LICENSE. The media files are authored by many people, available under a mix of CC BY-SA 4.0, CC BY 3.0/4.0, CC0, Public Domain (see docs/Credits.md).

Unciv (yairm210/Unciv)

Searching Database…

11.5K ·GitHub
Unciv
What is this?Unciv is an open-source remake of Civilization V for Android and Desktop, built with LibGDX, focused on moddability.
Is this a full game or just a mod/engine?It's a standalone, free game that reimplements Civ V's mechanics from scratch, not a mod for the original game.
Do I need Java or anything else to run it?If you use the standalone jar release you need Java to run it (java -jar Unciv.jar); the Docker option bundles everything needed.
Will it get Civ VI features or run on iOS/Steam?No iOS version is planned (the author has no iOS device to test on and doesn't want to pay Apple), there's no Steam release since Steam didn't want to host it, and Civ VI mechanics won't be ported — only features that existed in Civ V get added.
Which platforms does it run on?Android, Windows, Linux, macOS, and Raspberry Pi are all supported, with jar releases and Docker builds as alternatives.
Is it legal to clone Civilization V like this?Game mechanics aren't copyrightable, so the clone itself is legal, but using Firaxis's original assets (images, sounds) would not be, and using the Civilization trademark/logo is avoided to stay safe.
How can I learn to play if I don't know Civ V?In-game tutorials are available under Civilopedia, the official Civ V wiki covers the same mechanics, and the community is reachable on Discord for questions.
Can I run it with Docker?Yes, there's a docker-compose setup as well as a prebuilt Docker image you can run directly instead of building from source.
What's planned next for the game?The roadmap prioritizes UI/UX polish, better AI automation, then Gods & Kings mechanics, followed by Brave New World features like trade routes and the World Congress.
What are similar projects?libgdx, statecraft-israel, bgfx, luanti, Mindustry, benilla, TheSimpsonsGameRecomp, OpenCE
Which topics is it in?game-engine, raspberry-pi, game, kotlin, gaming, java, desktop, android, desktop-app, docker, cross-platform, windows
Creator
yairm210
Size
1.3 GB
Stars
11.5K
Updated
CommitOct 16Release4.22.11Oct 16
Age
8y
Commits · 90 Days