Difference between revisions of "EditingWesnoth"
m (→Mac OS X) |
m |
||
Line 38: | Line 38: | ||
* <b>Custom builds:</b> /usr/local/share/wesnoth | * <b>Custom builds:</b> /usr/local/share/wesnoth | ||
* <b>Debian/Ubuntu packages, or emerge (Gentoo)</b>: /usr/share/games/wesnoth | * <b>Debian/Ubuntu packages, or emerge (Gentoo)</b>: /usr/share/games/wesnoth | ||
− | * <b>Red Hat Linux-based distributions in general (openSUSE, Fedora):</b> | + | * <b>Red Hat Linux-based distributions in general (openSUSE, Fedora):</b> /usr/share/wesnoth |
* <b>Mandriva:</b> /usr/share/games/wesnoth | * <b>Mandriva:</b> /usr/share/games/wesnoth | ||
* <b>Slackware Linux:</b> /usr/local/share/wesnoth | * <b>Slackware Linux:</b> /usr/local/share/wesnoth | ||
Line 86: | Line 86: | ||
====Mac OS X==== | ====Mac OS X==== | ||
− | * ~/Library/Application Support/Wesnoth_<version> | + | * ~/Library/Application Support/Wesnoth_<version> |
<b>Note:</b> As of OS X 10.7, the Library folder is hidden by default. Press "alt" and use "Go" to access it. | <b>Note:</b> As of OS X 10.7, the Library folder is hidden by default. Press "alt" and use "Go" to access it. |
Revision as of 17:01, 2 March 2014
Template:EditingWesnoth/Translations
In order to create custom content for Wesnoth, you need to know where the game's resources are and where to put your own. This page will explain how to find both the data (core game resources) and userdata (custom content) directories, as well as an explanation as to working with each one.
The simplest way to find your game and userdata directories is to go to Preferences → General → Paths (shown on the right). From here you can copy respective the paths to your clipboard or open them in your platform's file manager. If you want more detailed explanations on the specific locations for your specific system, you can read the How to get there sections below.
Contents
The game data directory
Wherever you installed the game, you will find these folders, among others: data, music, sounds, images. The rest are unimportant unless you're a developer looking to tweak stuff about the game itself. Besides data, they contain resources used by the game, not by campaigns.
Inside the data folder you will find , among others, these folders: campaigns, multiplayer, core. These contain the mainline campaigns, the multiplayer maps and scenarios, and all the resources used in add-ons. You may examine the contents of the former for reference on how the campaigns and maps included in mainline are coded. In core, you will find another set of music, sounds, images directories. Look in here to find resources for creating your UMC content.
NOTE: These folders are NOT the place to put your own resources when creating an add-on. You should keep them in your add-on's folder the userdata directory, as detailed below.
In this wiki, the terms "game data", wesnoth/data, or ./data refer to the wesnoth/data directory. The terms "core folder" or core refer to the wesnoth/data/core directory.
How to get there
Windows
- On 32-bit computers: X:\Program Files\Battle for Wesnoth <version>\data
- On 64-bit computers: X:\Program Files (x86)\Battle for Wesnoth <version>\data
Note: X refers to the drive Windows is installed on, usually C. 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. 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.
Mac OS X
- Control+click on the application icon. Select "Show Package Contents", then navigate to "Contents" → "Resources".
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.
The user data directory
The user data directory in particular is the most important to a content creator. Inside are your preferences file, custom maps, saved games, the WML cache and data files corresponding to user-created content. In this wiki, "user data" and userdata/ refer to this directory.
The user data directory can do a lot of things. The game looks here for several things:
- userdata/data/add-ons - add-ons you have installed via the built-in add-on manager or are designing yourself
- userdata/editor/maps - multiplayer standalone maps (map data only)
The add-ons directory is particularly useful. In order to work with custom scenarios or campaigns, you will need to have your own add-on set up here. Several pages on this wiki will assume you have done so and refer to relative paths in such.
The following files and directories are mandatory for a simple add-on (assuming your add-on is called MyCampaign):
- 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/maps
The following are optional, and are used if you create your own custom units, images, etc:
- 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/macros
How to get there
Windows
- Windows 2000/XP: My Documents\My Games\Wesnoth<version>
- Windows Vista/7/8: Documents\My Games\Wesnoth<version>
Note If you selected "Store userdata in the install location" when installing the game, the userdata folder will be in the userdata subdirectory of the install location. However, on Windows Vista, 7, or 8, 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>
. 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
- ~/Library/Application Support/Wesnoth_<version>
Note: As of OS X 10.7, the Library folder is hidden by default. Press "alt" and use "Go" to access it.
Linux
- ~/.local/share/wesnoth/<version>
In a terminal, the command wesnoth --config-path
shows the user data directory.
BSD
- Same place as Linux.