Difference between revisions of "EditingWesnoth"

From The Battle for Wesnoth Wiki
(Windows)
(Where is my user data directory?: Reorganize Windows subsection, maybe make the nuances easier to pick up)
Line 43: Line 43:
 
====Windows====
 
====Windows====
  
* Windows 2000/XP (1.8 and later): ''My Documents\My Games\Wesnoth1.8''
+
* BfW 1.8 and later, if you did not choose "Store userdata in the install location" when installing the game and you launch the game using the start menu shortcut:
* Windows Vista/7 (1.8 and later): ''Documents\My Games\Wesnoth1.8''
+
** Windows 2000/XP: <code>My Documents\My Games\Wesnoth1.8</code>
* General (before 1.8): ''X:\Program Files\Battle for Wesnoth <version>\userdata'', where X: corresponds to the drive where Windows is installed (normally C:).
+
** Windows Vista/7: <code>Documents\My Games\Wesnoth1.8</code>
 +
* If any of the above does not apply:
 +
** The <code>userdata</code> subdirectory of the install location (usually <code>C:\Program Files\Battle for Wesnoth <version>\userdata</code>).
 +
** ''Note (Windows Vista/7):'' Writes to this directory may be silently redirected to the "Virtual Store", typically <code>C:\Users\<yourname>\AppData\Local\VirtualStore\Program Files\Battle for Wesnoth <version></code>
  
''Note: If you don't remember where you installed the game, right click on the game's shortcut, open properties, and click on the "Find target" button, then search for the "data" folder.''
+
''Note:'' If you don't remember where you installed the game, right click on the game's shortcut, open properties, and click on the "Find target" button.
  
''Note: If you chose "Store userdata in the install location" during installation you will find your userdata as mentioned above under "General". This will also apply if you launch wesnoth.exe directly instead of using the start menu shortcut.''
+
''Note:'' To find the Virtual Store using Windows Explorer, you need to make hidden files visible. This can be done from Explorer's "Folder Options" menu option -> "View" tab -> "Show hidden files, folders, and drives". Alternatively, the hidden directory can be accessed by typing "shell:local appdata" in Explorer's address bar.
 
 
''Note: If your userdata folder is located in the install location (for the reasons mentioned above) and you are not an administrator on this machine Windows Vista/7 will silently redirect any write access to the so called Virtual Store. You can find your userdata folder in e.g. C:\Users\<yourname>\AppData\Local\VirtualStore\Program Files (x86)\Battle for Wesnoth <version>''
 
 
 
''Note: The AppData folder might not be visible, you can either change the default Folder Options (Control Panel / Appearance and Personalization / Folder Options, check "Show hidden files and folders") or open a new Windows Explorer window, click in the address bar and type "shell:local appdata" (without the quotes)''
 
  
 
====Mac OS X====
 
====Mac OS X====

Revision as of 06:52, 2 June 2013

Template:EditingWesnoth/Translations

Game and User Directories

Wherever you install the game, there will be a game data directory that contains, of course, the game's data. This directory should have the following subdirectories: data, music, sounds, and images. There are several others, but these are the important ones. In this wiki, the terms "game data", wesnoth/data, or ./data refers to the wesnoth/data directory. You normally should not modify these files, but you can if you want to modify a unit or something.

The user data directory holds your preferences file, custom maps, saved games, the WML cache and data files corresponding to user-created content (add-ons/maps). In this wiki, "user data" and userdata/ refer to this directory.

The paths to the game data and user data directories vary according to the operating system and packager.

Where is my game data directory?

Windows

  • X:\Program Files\Battle for Wesnoth <version>\data, where X: corresponds to the drive where Windows is installed (normally C:).
  • On 64-bit computers, it will be in X:\Program Files (x86)\Battle for Wesnoth <version>\data.
  • The path may be different if you originally chose to install the game in a different location. In such case, look for the data folder in the folder where you installed the game.

Mac OS X

  • SourceForge.net bundle: Control+click on the application icon. Select "Show Package Contents." Select "Contents", then "Resources".
  • Custom builds: /usr/local/share/wesnoth

Linux

  • Custom builds: /usr/local/share/wesnoth
  • Debian/Ubuntu packages, or emerge (Gentoo): /usr/share/games/wesnoth
  • Red Hat Linux-based distributions in general (openSUSE, Fedora): /usr/share/wesnoth
  • Mandriva: /usr/share/games/wesnoth
  • Slackware Linux: /usr/local/share/wesnoth

In a terminal, the command wesnoth --path shows the game data directory.

BSD

  • OpenBSD package: /usr/local/share/wesnoth

The command wesnoth --path also works.

Where is my user data directory?

Windows

  • BfW 1.8 and later, if you did not choose "Store userdata in the install location" when installing the game and you launch the game using the start menu shortcut:
    • Windows 2000/XP: My Documents\My Games\Wesnoth1.8
    • Windows Vista/7: Documents\My Games\Wesnoth1.8
  • If any of the above does not apply:
    • The userdata subdirectory of the install location (usually C:\Program Files\Battle for Wesnoth <version>\userdata).
    • Note (Windows Vista/7): Writes to this directory may be silently redirected to the "Virtual Store", typically C:\Users\<yourname>\AppData\Local\VirtualStore\Program Files\Battle for Wesnoth <version>

Note: If you don't remember where you installed the game, right click on the game's shortcut, open properties, and click on the "Find target" button.

Note: To find the Virtual Store using Windows Explorer, you need to make hidden files visible. This can be done from Explorer's "Folder Options" menu option -> "View" tab -> "Show hidden files, folders, and drives". Alternatively, the hidden directory can be accessed by typing "shell:local appdata" in Explorer's address bar.

Mac OS X

  • SourceForge.net bundle: ~/Library/Application Support/Wesnoth_1.x/ (1.8 and later), or ~/Library/Preferences/Wesnoth (older versions). As of OS X 10.7, this location is hidden by default.
  • Custom builds: same as Linux - see below for details.

Linux

  • Wesnoth 1.10: ~/.local/share/wesnoth/1.10
  • Wesnoth 1.9: ~/.local/share/wesnoth/1.9
  • Wesnoth 1.8: ~/.wesnoth1.8
  • Older versions: ~/.wesnoth

In a terminal, the command wesnoth --config-path shows the user data directory.

BSD

  • Same place as Linux.

Game Data

The major directories you need to know about are wesnoth/data, wesnoth/data/core/units, wesnoth/data/campaigns, wesnoth/data/multiplayer, wesnoth/images and wesnoth/data/core/images

Become familiar with what is in ./data/campaigns and ./data/multiplayer/scenarios. These have the officially distributed campaigns and multiplayer maps. If you ever want to examine or edit one of the scenario configuration files, this is where you would go. For example, a common question is how a new player can give himself more turns or gold in scenario X. This is where you would go to do that.

Two very important directories are ./data/core/units/ and ./images. You have the ability to drop new units or images in these directories and have the game recognize them. When specifying an image for something, you do so relative to ./images.

User Data

The user data directory can do a lot of things. The game looks here for several things:

  • userdata/data/add-ons - campaign configuration files and subdirectories
  • userdata/editor/maps - multiplayer standalone maps (map data only)

The userdata/data/add-ons directory is particularly useful. A single configuration file here can selectively point to an entire subdirectory tree of units, images, sounds, scenarios, and macros. This allows you to wall off parts. Content included in the userdata units or images directories will be available globally whether you want it or not.

For example, assume you have a campaign called MyCampaign. This is what the userdata/data/add-ons directory might look like:

  • userdata/data/add-ons/MyCampaign/ - your campaign's directory
  • userdata/data/add-ons/MyCampaign/_main.cfg - a text file containing your instructions for the game about how to load the campaign
    • userdata/data/add-ons/MyCampaign/scenarios
    • userdata/data/add-ons/MyCampaign/units
    • userdata/data/add-ons/MyCampaign/images
    • userdata/data/add-ons/MyCampaign/music
    • userdata/data/add-ons/MyCampaign/sounds
    • userdata/data/add-ons/MyCampaign/utils

See Also