Frequently Asked Questions (FAQ)

Last modified: Spring 2022

Troubleshooting

NOTE: If the problem remains ask for help either on the Forum or via IRC #0ad/ #0ad-dev(1), the game is maintained by volunteers who do all sorts of tasks, be patient.

General

Storage location for replays, screenshots, mods and configuration files

See wiki/GameDataPaths

Crash when starting the game

Do you have any antivirus software running? Try disabling it or add an exception for 0AD.
For Windows users, see also the Platform-Specific section below.

Crash when starting a match

Try to disable Post-processing in the game options, while leaving Prefer GLSL on.

No replay files are generated

Do you have any antivirus software running? Try disabling it temporarily or add an exception for 0AD.

Errors are displayed/
Game crashes on startup/
Permanently black screen

  1. Try to disable all mods not compatible with the new version via the Mod Selection page.
  2. If you cannot access the Mod Selection page, you should locate your user.cfg file (see wiki/GameDataPaths) and either delete it or search for mod.enabledmods. Replace this line with mod.enabledmods = "mod public".

  1. In some cases after disabling old mods, you might also have to delete the contents of your /0ad/mods/user folder. The wiki article wiki/GameDataPaths should tell you where to find it.

Why does the screen keep going black for a short time?

Try disabling FreeSync on the monitor to fix the black screen issue.

How do I increase or decrease the user interface?

Add gui.scale = "1.2" to your user.cfg file (see wiki/GameDataPaths), you can increase or decrease this number if you like.

NOTE: This will become an option with the release of Alpha XXVI - Zhuangzi.

How can I change the maximum/minimum camera zoom?

Add view.zoom.max = "300" view.zoom.min = "30" to your user.cfg file (see wiki/GameDataPaths). Increasing view.zoom.max will let you zoom out further, decreasing the value for view.zoom.min will let you zoom in closer. The game's default values are 200 and 50.

In single player mode, you can open the developer overlay with Alt + D and toggle the Restrict camera option so that you can adjust the camera zoom to your preferences.

Game is lagging

Network latency:
The lobby is hosted by us, but all the games you play connect you directly to the game's host. Depending on your location and internet quality, you may experience a high Ping/ latency with certain players. You can check your RTT (also known as Ping) with different hosts by pressing F11 or Alt+F11 and toggle through until you see the Network statistics panel.

NOTE: If you suffer from a consistently high Ping time, you will cause lag for all other players. Using an Ethernet cable can help a little.

Computation lag:
This is a common problem with the game. The main factors that determine how smoothly 0 A.D. runs are primarily the CPU speed (as the game is not yet multi-threaded), the amount of RAM available, the type of graphics card in your computer, the game options and the game's setup settings you choose. If you are unhappy with the performance of the game on your computer, there are some things you can do to improve it, but be aware that the lag for large battle scenes will likely be noticeable regardless of your settings or PC specifications.

  1. Before Launching 0 A.D.
    • It is recommended to close all other applications as they consume resources and affect the overall performance of the system.
  2. Game Options
    • Enable Prefer GLSL
    • Enable FXAA (no performance impact) or MSAA (disable for very weak GPUs)
    • Set Models to the lowest values
    • Disable Shadows or set the Cutoff distance to a low value.
    • Enable Water Effects, but disable other water effects (reflection, refractions)
    • More Options will be added with Alpha XXVI - Zhuangzi
  3. Game Setup
    • Play on smaller maps and limit population to 600 units across the map for all players. Rendering, simulation (e.g. gathering / attacking), and the pathfinder all have an impact on performance. If you have more units, more things need to be drawn, which affects rendering, more things to calculate for unit activity affects simulation, and larger map sizes cause longer paths, which affects the pathfinder.

NOTE: Multiplayer games are calculated on all computers simultaneously, with the slowest PC determining the game speed. If your computer is a bit outdated, you should follow the guidelines listed above. This might make the game faster for everyone.

Wiki/GamePerformance summarizes the problems, that need to be solved, to improve performance.

Frame rate - CPU and GPU workload

  1. Every frame that is calculated by the GPU is "prepared" by the CPU, one of them will limit your frame rate (FPS). When you select graphics effects, you create additional workloads for your GPU and CPU, causing your framerate to drop. Current PCs are mostly CPU limited in 0 A.D. because the game is not yet multi-threaded. That means they usually only use 1 core. Since graphics effects mostly affect the GPU, you can (on newer PCs) choose the higher graphics effects without sacrificing performance.
  2. Thermal throttling is especially known for mobile PCs. If the hardware gets too hot, it throttles its performance until the hardware cools down again. Therefore, a limited but constant frame rate is usually better than a frame rate that fluctuates due to thermal throttling.
  3. VSync will also limit the framerate to the framerate of the monitor.

Platform-Specific

https://img.shields.io/badge/Linux-green

Game does not capture the left ctrl key press.

The left ctrl problem seems to be a result of the show cursor functionality of gnome-tweak.

Game fails to launch on Ubuntu.

If snap doesn't work, you can try the PPA (Ubuntu's Personal Packaged Application), see link below.

Mouse cursor is missing

Try to locate your user.cfg file (see wiki/GameDataPaths) and add the following lines to it:

  cursorbackend = "system"
  nohwcursor = "true"

Triple screen, 0AD doesn't span over all screens!

Workaround it with windowed mode and xfce4 fullscreen.

https://img.shields.io/badge/macOS-blue

0 A.D. cannot be opened because the developer cannot be verified.

The reason for this message is that 0 A.D. would need to be signed with a developer AppleID, which costs an annual subscription. At the moment, this problem can be bypassed for the installation by right-clicking and clicking Open.

All but player silhouettes and menus are just white.

Disable the graphics option Antialiasing.

A red line runs from the top left to the center of the screen.

Enable the graphics options Prefer GLSL.

NOTE: This issue will be fixed with the release of Alpha XXVI - Zhuangzi.

Batch size adjustment by Shift clicking does not work.

The default batch adjustment hotkey (Shift) seems to not work correctly on non-Apple mice, set it to another, e.g. Alt.

https://img.shields.io/badge/Windows-orange

Game crashes on startup.

error while dumping stack: No stack frames found
errno = 13 (Insufficient access rights to open file)
OS error = 0 (no error code was set)

Perhaps the wrong GPU is simply being used. For a detailed explanation of how to set it up correctly, see the following wiki article: wiki/SwitchingToYourPCsDedicatedGPU.

NOTE: This issue will be fixed with the release of Alpha XXVI - Zhuangzi.

unhandled exception (std::out_of_range("invalid bitset<N> position"))

NOTE: This issue will be fixed with the release of Alpha XXVI - Zhuangzi.

Game does not render correctly/
Rainbow colors

You need to adjust the property settings of the 0 A.D. application, see the link below.

Mouse cursor disappearing

Go to the Graphics (general) settings tab and switch to Windowed mode. After restarting the game, the mouse cursor should be visible all the time.

Do I have to uninstall the old version when updating?

Windows is the only operating system that requires you to uninstall the old version of 0 A.D. when you try to upgrade to a new release.

Multiplayer

Registering for the Game Lobby does not work:

- "The server's certificate could not be verified or the TLS handshake did not complete successfully."
- "Certificate expired"
- "The stream has been closed by the server"
- "An I/O error occurred"

Try to disable TLS via Settings => Options => Networking / Lobby

NOTE: There is a limit to the number of accounts you can submit per hour; if it doesn't work, try again later.

How to play online?

Go to Multiplayer --> Game Lobby --> Create a new account, then you should see this page, now you can join a game or set one up yourself via Host Game.

The Game Lobby is empty.

You are probably using an older version of the game, see play0ad.com/download for the latest version.

"Authentication failed."

This message usually appears, when you have got a typo in your password or username. If you are sure both are correct, you could create a forum account and contact user1.

I forgot my Game Lobby password.

Resetting is currently not possible via the user interface, you would need to create an account on the Forum and contact user1.

My friend cannot join my game and I cannot join their game.

Firewall:
Try disabling it or add an exception for 0AD.

Router:
If you forward the port, everyone will be able to join you. If you use STUN when hosting, probably many but not everyone will be able to join you. If you can't join someone else's game, there's nothing you can do about it other than informing the host that he should port forward or host your own game.

Failed to connect to the server. UDP port 20595 not being forwarded.

This error message is almost always caused by an incorrect network configuration on the host side, not by a bug in the game. Please ensure that the host has the UDP port 20595 forwarded at their router to their private IP address.

How to do port forwarding?

Port forwarding is a way to make a computer on your network accessible to computers on the Internet, even though they are behind a firewall/router. This is commonly used when playing games or downloading files. If you have forwarded a port in your router settings, it is referred to as an open port. 0 A.D. uses UDP 20595 by default.

How to play via LAN?

See this forum thread with detailed instructions - Multiplayer on LAN (16/Jan/17).

Can I host my own lobby/ server?

Comprehensive instructions for hosting a lobby can be found in this Github repository: github.com/0ad/lobby-bots. So far, there is no way to run a game on a central server. One of the players is always the host.

NOTE: Don't forget to modify your user.cfg file to connect to the correct lobby.

How can I ban observers in multiplayer mode?

Possibilities:

  • You can set up a password when you host a game.
  • In the settings under General, find Observer limit, set it to zero and no one can join after the game starts.
  • Open the chat window and type /kick (person can rejoin) or /ban (person can't rejoin) followed by the user nickname. Only the host can kick out observers.

Gameplay

How to beat the AI and get better in this game?

Read these forum threads and you will defeat the AI and most likely become a competitive player in the Game Lobby:

Alternatively, you can watch Youtube replays (see Miscellaneous below) of pro players or download their replays to better see their build order and which tech upgrades they focus on.

What are the differences between Random, Skirmish and Scenarios maps?

See wiki/Mod_Layout#maps

What does the triangular icon above my unit indicate?

It shows the current rank of your unit. The bar normally increases during combat by gaining experience points, once a certain threshold is reached, the unit moves up a rank. Depending on the type of unit (Healer, Ranged, Melee), certain values of the unit are boosted. The Rank icon and Experience status bar can be toggled on/off in the Settings on the Game Session tab.

NOTE: Starting with Alpha XXVI - Zhuangzi, you can hover over the rank icon in the HUD to see the benefits of each rank.

NOTE: Units can also gain experience points when garrisoned in certain military buildings that have Rigorous Training.

Do you get the specified loot amount when you kill an enemy unit?

If you kill an enemy unit or building, you get the specified loot and all resources that the unit had on it. You do not get this loot if you delete one of your own units/ buildings.

How to interpret these resistance numbers in the tooltip?

There are three major types of damage:

  1. Hack damage is usually inflicted in close combat by infantry or cavalry units.
  2. Pierce damage is dealt by ranged units, either infantry archers or skirmishers or even special siege units such as bolt shooters.
  3. Crush damage is caused by siege units such as catapults or rams.

The combat system works by matching the attack type with the resistance type. In the image below, the Gallic Mercenary Cavalry has a 6.5 Hack attack and the Athenian Hoplite has a 5 Hack resistance level. The value in brackets is the effective resistance percentage, calculated like this 1-0.9resistance level (1-0.95 = 41%). For each attack made by the Gallic Mercenary Cavalry, 59% of their Hack attack will deal damage to the Athenian Hoplite.
Attack damage and resistance levels can be increased through technology upgrades, unit ranks or auras.

In addition, there are Status Effects that can cause various (temporary) effects. As of Alpha XXV - Yaunā, this is a small feature that is limited to two effects (Fire and Poison) and two units (the Iberian Champion Cavalry and the Mauryan Guard Archer) that they can inflict on their opponents. All entities vulnerable to Fire and Poison attacks suffer exactly the same damage.

How to defeat rams and siege towers?

The most effective defense against rams are units that are in the "swordsman" class. This can include certain cavalry and champion units. Female workers can also be used, but they have a low HP so should only be used as a last resort. All these units are effective because they deal "hack" damage, not "pierce", and rams block almost all pierce damage. Crush damage is also effective: elephants and clubmen are also both very effective against rams. Since ranged units tend to deal pierce damage, they are mostly powerless against rams and siege towers.

Is training units in batches more efficient than training one at a time?

As a rule of thumb, training units with batches is more efficient the longer you do it and the larger the batch is.

NOTE: If you press the Batch production key (Shift by default) and use the mouse wheel, you can change the batch size when the mouse is over the unit icon; alternatively, you can set the batch size in the options.

Can I order my units to run?

The unit only runs when it flees or when it is called into formation. There is no special command with which you can order a unit to run.

What do the different formations do?

Your units are positioned in a certain way, e.g. in the Box formation your melee troops are on the edge and your ranged units in the middle. Apart from that, there is no bonus that derives from forming a formation.

How do you destroy a building instead of capturing it?

Click with the right mouse button while holding down the ctrl key on the building you want to destroy.

How does capturing work?

The buildings have capture points for all players. If a player reaches 100% of the capture points for that building that player gains control over that building. Capture points can be gained by ordering units to capture that building or by that building standing inside a players area of influence (the player-coloured borders).

Where can I find all keyboard combinations for the game?

  • Either in the game itself via the GUI Hotkeys button or
  • see wiki/HotKeys.

How do I select idle units?

You can assign a specific Hotkey via the GUI for selecting:

  • Builders (unit that can construct buildings)
  • Workers (unit that can gather resources)
  • Warriors (unit suited for fighting)
  • Any idle unit

In addition, press the Include offscreen key, by default the Alt key, to select all.

How do you select only military units?

Press Alt and draw a rectangle over your units.

Can you make groups of units?

Select a bunch of units and then press Ctrl + 1, you can make more multiple groups by using different numbers. To select this group, press the 1 key or another number key to which you have assigned your group.

How does trade work?

Either you build two markets and have traders run from one to the other or you send your traders from your market to one of your allies, the latter being more lucrative. Docks can also be used as market destinations.
Via the menu Barter&Trade you can set what is traded by clicking on the up or down arrows for each resource.

Does the game have cheat codes?

See wiki/Manual_Cheats

How can I get units to move as individuals and not in formation?

Click with the right mouse button on the symbol at the top left, the small indicator changes the symbol.

How do I get a Game Lobby rating and how is it calculated?

Currently, only 1v1 matches are rated, and this option can be turned on or off by the host of the game. When the option is turned on, it will be displayed at the bottom of the game settings page. You will start with a score of 1200, which will increase if you win and decrease if you lose. After your first rated game, the rating will be visible.

NOTE: The rating adjustment is calculated with a simplified ELO algorithm, the exact details can be found here: elo.py.

How do I report a user who quits a rated game without resigning?

You need to find the correct replay file (see wiki/GameDataPaths) and upload it here: Ratings Disputes and Offence Reporting (11/Jun/21).

How are the points for total, economy, military and exploration calculated?

  1. Total: Sum of economy, military and exploration score
  2. Economy: Resources gathered + trade income, divided by 10
  3. Military: Sum of enemyUnitsKilledValue, unitsCapturedValue, enemyBuildingsDestroyedValue and buildingsCapturedValue, divided by 10
  4. Exploration: percentMapExplored, multiplied with 10

Contributing

Main game

How can I contribute?


We can always use another helping hand for this project. There are several ways to help and contribute:

For more details, check the wiki/GettingStarted article. Contact us through the Forum or via our IRC #0ad/ #0ad-dev(1) channels.

If I find a solution to a bug, what should I do?

Phabricator (aka Phab) is used to manage patches. You can upload your solution there and request a review of your patch. If the developers accept it, it will be added to the development version and later ends up in the bundled release version. Details on how to submit patches can be found here: wiki/SubmittingPatches.

NOTE: The only thing that gets a patch committed is a team member who pauses work on their own feature to review something. So if you feel you are not being heard, you may need to nag a developer, the best way is usually via IRC #0ad/ #0ad-dev(1).

Where and how should I report bugs?

Guidance on how to report bugs correctly can be found here: wiki/ReportingErrors.
Before creating a ticket, you are encouraged to do a quick search, as the issue may already be known. You can use the search box below to search all tickets (open and closed) by title.

Map making

How to get started?

The game comes with a Scenario Editor (aka Atlas) for information see wiki/Atlas_Manual and Scenario Design/Map making in our forum.

How can I play my self-created maps from the Scenario Editor?

Depending on which options you enabled/disabled when saving the map, you should find them under the correct map filter.

NOTE: Post your creation in the Scenario Design/Map making subforum, if it is well received it may even be included in the main game or become part of the community-maps-2 mod.

Can you recommend a video?

This tutorial was made by a Youtuber called Tom0ad

Modding

How to enable mods?

See wiki/Modding_Guide

Where can i find mods?

You can find and download mods in the following places:

  • Ingame at the main menu -> settings -> mod selection -> download mods screen - easiest to install, and can filter game version compatible mods only.
  • Downloads from these sources require a manual installation* and may be outdated:
    • Github - largest list of mods.
    • 0 A.D. mod.io - same list as the ingame downloader if you uncheck the filter valid mods only option within the ingame download mods screen.
    • Forum - some mods are on the forum and can't be found anywhere else, it's worth snooping around.
    • Trac - list is in it's starting up phase.

* How To Install Mods

How to get started?

The game itself is developed to be highly modifiable, to get started see wiki/Modding_Guide and wiki/Mod_Layout.
Taking a look at small existing mods (e.g ffm_visibility or Battle Mod) might help to better understand how things work.
Some total-conversion mods are: Hyrule Conquest, Delenda Est or 0AD City Builder.

What to do if I need help?

You can ask via IRC #0ad/ #0ad-dev(1), or you might find old threads in the Game Modification subforum answering your questions, otherwise you can create a topic and ask for help there.

Can I use the game assets?

As long as you abide with the 0AD license.
"0 A.D. is released as open source: you can freely use, copy, modify and distribute the game's source code and data files, as long as you include attribution to Wildfire Games and let anyone freely modify and distribute any of your own modifications to the game's files."

Where to find the source code?

Here you can find all the information on how to get the source code and build the game: wiki/BuildInstructions.

NOTE: For autocompletion and notes about implemented functions from the 0ad source code, you can take advantage of the created typescript files from the Autociv mod. The notes were made around the Alpha XXIII - Ken Wood codebase and are not complete. Simply copy the .ts and tsconfig.json files from the src, gui and simulation folders into your project.

Is there a documentation for editing the XML files of entities?

This page lists the components that can be added to entities and the XML syntax for their initialisation data.

Can I add my mod to the in-game download area?

Simply follow the instructions below.

Miscellaneous

When will the next version be released?

When it will be ready. Unfortunately we can't be much more specific than that, there are too many things we just don't know. We're working on the game in our spare time, so we don't know how much time we'll have to make the game.

Why is this game still in alpha?

A developer wrote (21/Mar/21): "0 A.D. is also still quite laggy, and needs a fair few improvements before I think it's ready for a more mainstream audience. I would push towards dropping the 'alpha' from the name, but that doesn't mean it's quite ready."

Will you put the game on Steam?

We're going to look at putting the game on Steam to make it easier for people to find out about it, but not until we get to the beta stage at the earliest. We want the game to be as good as possible so people don't miss it among all the other games that are there.

Is the website up to date?

Yes, but gameplay related infos (Features, Factions, Game Manual) are a bit outdated. This needs to be fixed, if you want to help us, raise your voice either via the Forum or through IRC #0ad/ #0ad-dev(1).

How to keep up with the game?

For casual players there is no channel that summarizes progress. From time to time there are some social media posts and a development report, but they are rare.
For players with technical background, you can read the wiki/Changelogs, check committed patches on Phabricator or the timeline on Trac.

Does 0AD use any social media accounts?

You can find a list of all accounts at the bottom of our homepage play0ad.com.

Are there Youtube channels about this game?

The four most popular channels are:

Does 0AD have a Discord?

There is no official Discord, however there are some unofficial servers run by members of the community.

How about more factions?

There are mods that add more factions to the game (see github.com/0ADMods), see the forum links below for some likely candidates.

The concerns, for adding new factions, mainly revolve around balancing all the factions so that they are equally strong, but still different from each other and to be historically accurate.

NOTE: The Han Chinese will be added to the game with the release of Alpha XXVI - Zhuangzi.

Will you add support for single-player campaigns?

It has been added to Alpha XXV - Yaunā. For more information, see the links below.

NOTE: Mapmakers who are willing to work on a campaign, please contact us (via the Forum or IRC #0ad/ #0ad-dev(1)), we would appreciate your contribution to the implementation of a campaign.

Does the game have an in-game store, is it freemium or pay-to-win?

The game is completely free and open source. We only use donations to pay for server hosting, etc.

Would it be possible to have access to old versions of 0AD?

On this page - releases.wildfiregames.com - you can find all released versions and some statistics about how many times each version has been downloaded recently.

NOTE: Additional statistics from users who have enabled the Feedback setting in the 0ad app can be found here: feedback.wildfiregames.com/results.

Can you recommend a presentation or video about 0ad?

Who are the team members?

You will find a list of names in the Wildfire Games Team Wiki and in the Forum's Staff Directory.

What to do if I have a question that is not part of this FAQ?

Join IRC #0ad/ #0ad-dev(1) or check the Help & Feedback subforum where many questions have already been answered. You may also ask any new questions there.

Footnote

(1) Most active team members are in the CET time zone. The chat is logged irclogs.wildfiregames.com.

Last modified 4 weeks ago Last modified on Sep 5, 2022, 6:27:59 PM

Attachments (22)

Note: See TracWiki for help on using the wiki.