Windows
← Older revision
Revision as of 17:30, 2 March 2014
(9 intermediate revisions by one user not shown)
Line 8:
Line 8:
<div class="thumbcaption">Game paths</div></div>
<div class="thumbcaption">Game paths</div></div>
</div>
</div>
+
+
The simplest way to find your game and userdata directories is to go to <b>Preferences → General → Paths</b> (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 <i>How to get there</i> sections below.
== The game data directory ==
== The game data directory ==
−
The data directory will be wherever
you installed the game,
alongside there subdirectories
: <
i
>music, sounds, images</
i
>.
There
are
several others, but these are the important ones. You don
'
t need
to
pay attention to them right now.
+
Wherever
you installed the game,
you will find these folders, among others
: <
b
>
data,
music, sounds, images</
b
>.
The rest
are
unimportant unless you
'
re a developer looking
to
tweak stuff about
the
game itself. Besides
<
b
>data</
b
>,
they
contain resources
used by
the game
, not by
campaigns.
−
+
−
Inside
the <
i
>data</
i
>
folder you will find a folder called <i>core</i>. This folder contains another set of <i>music
,
sounds, images</i> (as well as others) folders. These
contain
all the
resources
shipped with
the game
for use in mainline and UMC
campaigns
. These are the ones you'll usually look for resources in when designing your content.
+
−
+
−
In this wiki, the terms <i>"game data"</i>, <i>wesnoth/data</i>, or <i>./data</i> refer to the wesnoth/data directory. The terms <i>"core folder"</i> or <i>core</i> refer to the wesnoth/data/core director
.
+
−
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
+
Inside the <i>
data
<
/
i> folder you will find
,
among others, these folders: <b>
campaigns, multiplayer,
core<
/
b>. 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 <b>
core
<
/
b>, you will find another set of <b>music, sounds,
images
</b> directories. Look in here to find resources for creating your UMC content.
−
Become familiar with what is in wesnoth/data/campaigns and wesnoth/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
.
+
<b>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
.
</b>
−
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
.
+
In this wiki, the terms <i>"game
data
"<
/
i>, <i>wesnoth
/
data<
/
i>, or <i>
./
data</i> refer
to the
wesnoth/data directory
.
The terms <i>"core folder"</i> or <i>core</i> refer
to
the wesnoth
/
data/core directory
.
=== How to get there ===
=== How to get there ===
Line 27:
Line 25:
====Windows====
====Windows====
−
*
''
X:\Program Files\Battle for Wesnoth <version>\data
'', where X: corresponds to the drive where Windows is installed (normally C:).
+
*
<b>On 32-bit computers:</b>
X:\Program Files\Battle for Wesnoth <version>\data
−
* On 64-bit computers
, it will be in ''
X:\Program Files (x86)\Battle for Wesnoth <version>\data
''.
+
*
<b>
On 64-bit computers
:</b>
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.
+
+
<b>Note:</b> 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 <b>"Find target"</b> button
.
====Mac OS X====
====Mac OS X====
−
*
SourceForge.net bundle or XCode builds:
Control+click on the application icon. Select "Show Package Contents
.
"
Select
"Contents"
, then
"Resources".
+
* Control+click on the application icon. Select
<b>
"Show Package Contents"
</b>, then navigate to
<b>
"Contents"
</b> → <b>
"Resources"
</b>
.
−
* Custom builds: ''/usr/local/share/wesnoth''
+
====Linux====
====Linux====
−
* Custom builds:
''
/usr/local/share/wesnoth
''
+
*
<b>
Custom builds:
</b>
/usr/local/share/wesnoth
−
* Debian/Ubuntu packages, or emerge (Gentoo):
''
/usr/share/games/wesnoth
''
+
*
<b>
Debian/Ubuntu packages, or emerge (Gentoo)
</b>
: /usr/share/games/wesnoth
−
* Red Hat Linux-based distributions in general (openSUSE, Fedora):
''
/usr/share/wesnoth
''
+
*
<b>
Red Hat Linux-based distributions in general (openSUSE, Fedora):
</b>
/usr/share/wesnoth
−
* Mandriva:
''
/usr/share/games/wesnoth
''
+
*
<b>
Mandriva:
</b>
/usr/share/games/wesnoth
−
* Slackware Linux:
''
/usr/local/share/wesnoth
''
+
*
<b>
Slackware Linux:
</b>
/usr/local/share/wesnoth
In a terminal, the command <code>wesnoth --path</code> shows the game data directory.
In a terminal, the command <code>wesnoth --path</code> shows the game data directory.
Line 48:
Line 46:
====BSD====
====BSD====
−
* OpenBSD package:
''
/usr/local/share/wesnoth
''
+
*
<b>
OpenBSD package:
</b>
/usr/local/share/wesnoth
The command <code>wesnoth --path</code> also works.
The command <code>wesnoth --path</code> also works.
Line 81:
Line 79:
====Windows====
====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:
+
*
<b>
Windows 2000/XP:<
/b
> My Documents\My Games\Wesnoth<version>
−
**
Windows 2000/XP: <
code
>My Documents\My Games\Wesnoth<version><
/code
>
+
*
<
b
>Windows Vista/7/8:<
/b
> Documents\My Games\Wesnoth<version>
−
**
Windows Vista/7/8: <
code
>Documents\My Games\Wesnoth<version
></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.
+
<b>
Note
</b> The above only applies if
you
did not select "Store userdata in the install location" when installing
the game
. However
, on
Windows Vista
,
7
,
or 8, writes to the userdata directory in the install location may be silently redirected to
the "Virtual Store
"
,
typically <code
>
C:\Users\<yourname>\AppData\Local\VirtualStore\Program Files\Battle for Wesnoth <version></code
>.
Virtual Store is
hidden
by default; it
can be accessed
by
by typing
<i>
"shell:local appdata"
</i>
in Explorer's address bar.
−
+
−
''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====
====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.
Push
"alt"
(⌥)
and use "Go" to access
the Library then find ''~/Library/Application Support/Wesnoth_1.x/''
+
* ~/Library/Application Support/
Wesnoth_<version>
−
* Custom builds: same as Linux - see below for details
.
+
+
<b>Note:<
/
b>
As of OS X 10.7,
the Library folder
is hidden by default.
Press
"alt" and use "Go" to access
it
.
====Linux====
====Linux====
−
*
Wesnoth 1.10: ''
~/.local/share/wesnoth/
1.10''
+
* ~/.local/share/wesnoth/
<version>
−
* Wesnoth 1.9: ''~/.local/share/wesnoth/1.9''
+
−
* Wesnoth 1.8: ''~/.wesnoth1.8''
+
−
* Older versions: ''~/.wesnoth''
+
In a terminal, the command <code>wesnoth --config-path</code> shows the user data directory.
In a terminal, the command <code>wesnoth --config-path</code> shows the user data directory.