Frequently Asked Questions (FAQ)

Last modified: Winter 2022/23

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 cache, config, logs, mods, replays and screenshots

See wiki/GameDataPaths

Crash when starting the game/
No replay files are generated

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

Crash when starting a match

Disable Post-processing in the game options.

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, try to locate your user.cfg file (see wiki/GameDataPaths) and either backup and then delete it or search for mod.enabledmods. Replace this line with:
      mod.enabledmods = "mod public"
    
  3. 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?

Settings => Options => Graphics(general) => GUI scale

How can I change the maximum/minimum camera zoom?

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

  view.zoom.min = "30"
  view.zoom.max = "300"

By decreasing view.zoom.min you can zoom in closer and by increasing view.zoom.max you can zoom out further. The default values of the game are 50 and 200. With a larger zoom max more things have to be drawn, expect reduced performance, especially on weak GPU's.

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.

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. You can check your RTT (aka Round Trip Time/ Ping) with different hosts by pressing F11 or Alt+F11 and toggle through until you see the Network host/client statistics panel.

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
    • Antialiasing: FXAA has no performance impact, MSAA only for good GPU's. Must be disabled for macOS, see Platform-specific.
    • Set Model Quality to the lowest value.
    • Disable Shadows or choose Low Quality from the dropdown menu and a low value for Cutoff distance.
    • Enable Water Effects, but disable High-quality water effects and Water refractions.
    • Texture Quality - Low
    • Texture anisotropic filter - 1x
  3. Game Setup
    • Play on smaller maps and limit population to 600 units across the map for all players. Rendering, simulation (for example 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. By toggling the wiki/In-GameProfiler with F11 or Alt+F11 you can see which processes take the most time, often it is the render process and in large battle scenes also the sim update.

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.

No sound, no audio, or 0 A.D. is the only app with sound

There are some settings in the game related to volume levels. From the main menu, click Settings, Options, Sound.

If you connect a sound device, or plug in an audio jack, after you start 0 A.D. then it is necessary to configure your operating system to use it as the default sound device, then restart 0 A.D. in order for it to be detected.

Assuming that sound works for other apps while 0 A.D. is not running then troubleshooting the sound output of 0 A.D. likely involves troubleshooting OpenAL on your system. This is because 0 A.D. uses the OpenAL sound system for audio output. It can be useful to test other games that use OpenAL, such as chromium-bsu, supertux, supertuxkart, dustracing2d, scorched3d, lugaru, warzone2100, ioquake3, and rtcw.

Check the OpenAL configuration, which on Linux and Mac is stored at /etc/openal/alsoft.conf, and on Windows is stored in %AppData%\alsoft.ini. If it does not already exist then download alsoftrc.sample, rename it to the appropriate name for your OS and store it in the correct location, listed earlier.

Ensure that the correct "driver", also known as "audio backend", is being used by OpenAL. There are reports from users where unexpected drivers were used by OpenAL, for example trying to use jack, failing, next using alsa instead of Pulseaudio. The only documentation easily found about the OpenAL configuration is in the comments within alsoft.conf. When referencing drivers in the OpenAL configuration, use the name of the audio backend within the quote marks at alc.cpp.

Recommended OpenAL drivers configuration statement:

  • Linux: drivers = pulse,alsa,
  • Mac: drivers = core,
  • Windows: drivers = wasapi,

Note that OpenAL driver availability depends on your operating system and compile-time choices for your copy of the OpenAL library. The openal-info utility lists detected devices. If you are using Linux then openal-info may be available for your distribution in a package called, for example, openal-info.

For further help with OpenAL, contact the OpenAL developers via the means specified on their website.

Note that OpenAL can only work as well as the audio backend or driver that it is configured to use, so that is another area to consider during troubleshooting.

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.

Mouse cannot change screen on multiple displays e.g. 5120x1440

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

  borderless.fullscreen = "false"

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.

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, for example Alt.

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

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

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.

Or, watch this video to see a demonstration of how to create a new 0 A.D. lobby account.

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.

"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.

The Game Lobby is empty or nearly empty. Or, I can't see my friend in the lobby, but we are definitely both logged in.

You may be using an older version of the game. Each major version of 0ad has a separate lobby. See play0ad.com/download for the latest version, or https://releases.wildfiregames.com/ for archived versions. Ensure that you are using the same version as your friends in order to join games together.

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 for the Host of the game:

  • Set up a password.
  • In the Options under Networking/Lobby find Observer limit and 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. Use the Tab key to autocomplete player names.

I was kicked, muted or banned from the lobby. Why, and how do I rejoin?

We hope that you too want to support an enjoyable environment for everyone in the lobby. Please be aware of the conduct that is against the rules by reading through the lobby legal terms, especially the Terms of Use.

Lobby moderators watch the chat messages in the public lobby, game room names, and player names. Misconduct is punished with kicks, mutes or bans, typically on a reactive basis that may be delayed by hours. So, don't assume that the messages you sent just before being muted were the cause of the mute.

If you were simply kicked then you are able and allowed to reconnect to the lobby immediately. There are four English swearwords that cause the profanity filter bot to punish players. Initially, the bot will kick a user from the lobby for using profanity. With subsequent infractions the bot will mute a player for 2 days.

If you were manually muted or banned then it is usually intentional, and you can privately contact a lobby moderator, via the forum or IRC chat, in order to ask about the reason for the mute/ban or engage in the appeal process. Please include in the message your lobby username, the approximate time and date that it happened, and a description of what happened.

You are not allowed to publicly complain about or even publicly discuss a ban. This helps to avoid spamming public chat with heated argument, and it ensures that there is an atmosphere conducive to a judicial process, Instead, the appeal process must be done through private communication with the lobby moderators.

Lobby moderators include admins, moderators and helpers. The current lobby admin is user1. Current lobby helpers are Norse_Harold, Ginnungagap, Pemulis, seeh, Defc0n/Rossenburg , and ("only in an emergency") Dunedan.

Gameplay

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

Read these 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 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 or Melee), certain values of the unit are boosted. Move the mouse cursor over the rank icon in the HUD to see the benefits of each rank. The Rank icon and Experience status bar can be toggled on/off in the Options on the Game Session tab.

reduced file size

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?

Most effective are units that deal Hack or Crush damage, such as axemen, macemen, swordsmen, war elephants and rams themselves. Ranged units primarily deal Pierce damage, and are therefore ineffective against rams and siege towers. Large numbers of female workers can also be utilized, but they have a low HP and should therefore only be used as a last resort.

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, for example 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.

reduced file size

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:

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 maps be scripted to feel more like a mission?

Triggers can change the state of a unit directly, or they can be used to send the usual commands that users send through the user interface, see the wiki article for more information. Some standard maps that use triggers are Danubius, Polar Sea or Jebel Barkal.

NOTE: Triggers must be programmed in JavaScript, there is no graphical interface for them.

Can you recommend a video?

See How to easily turn ANY Country into a 0AD Map! - 0AD Map Making (28/Mar/21)

Modding

How to get started?

The game itself is developed to be highly modifiable, to get started see:

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.

How to enable mods?

See wiki/Modding_Guide

Where can i find mods?

You can find and download mods in the following places:

  • In-game: Settings => Mod Selection => Download Mods
    • easiest to install, and can filter game version compatible mods only.
  • Downloads from these sources require a manual installation and may be outdated (see wiki/Mod_List#HowToInstallMods):
    • Github - largest list of mods.
    • 0 A.D. mod.io - same list as the in-game downloader if you uncheck the filter valid mods only option within the in-game 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.

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?

See 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?

See the links below for instructions:

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.

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 12 days ago Last modified on Jan 16, 2023, 10:07:09 PM

Attachments (22)

Note: See TracWiki for help on using the wiki.