AddonStructure/de - Revision history

RufDerMacht: Inserted geman guide template

2022-02-15T09:31:30Z

Inserted geman guide template

← Older revision		Revision as of 09:31, 15 February 2022
Line 1:		Line 1:
	{{Translations}}		{{Translations}}
	{{Create}}		{{Create/de}}

	'''Innerhalb dieser und anderer Seiten im Wiki wird immer wieder Bezug genommen auf ein Verzeichnis, in denen die benutzerdefinierten Inhalte für Wesnoth gespeichert werden. Es wird hier mit''' ''userdata'' '''bezeichnet, obwohl ein Verzeichnis diesen Namens nicht (mehr) existiert. Die Bezeichnung hat sich aus praktischen Gründen eingebürgert.'''		'''Innerhalb dieser und anderer Seiten im Wiki wird immer wieder Bezug genommen auf ein Verzeichnis, in denen die benutzerdefinierten Inhalte für Wesnoth gespeichert werden. Es wird hier mit''' ''userdata'' '''bezeichnet, obwohl ein Verzeichnis diesen Namens nicht (mehr) existiert. Die Bezeichnung hat sich aus praktischen Gründen eingebürgert.'''

RufDerMacht at 13:46, 14 February 2022

2022-02-14T13:46:33Z

← Older revision		Revision as of 13:46, 14 February 2022
Line 71:		Line 71:
	Für weitere Inhalte, etwa Musik, Sound oder Grafiken, ist es notwendig, entsprechende Ordner anzulegen. Das wird eigentlich auch für alle andere Inhalte empfohlen, um die Übersicht zu wahren.		Für weitere Inhalte, etwa Musik, Sound oder Grafiken, ist es notwendig, entsprechende Ordner anzulegen. Das wird eigentlich auch für alle andere Inhalte empfohlen, um die Übersicht zu wahren.

	=== Die von der Spielengine ~~definierte~~ Verzeichnis-Struktur ===		=== Die von der Spielengine erwartete Verzeichnis-Struktur ===
	Die Ordner, die Code enthalten - wie '''scenarios''' und '''macros''' - müssen nicht zwingend in bestimmter Weise benannt werden, sondern dürfen im Prinzip beliebige Namen erhalten. Allerdings ist es sinnvoll, ~~selbsterklärenden~~ Namen zu wählen. Mit der Zeit haben sich bestimmte Namenskonventionen gebildet die [[		Die Ordner, die Code enthalten - wie '''scenarios''' und '''macros''' - müssen nicht zwingend in bestimmter Weise benannt werden, sondern dürfen im Prinzip beliebige Namen erhalten. Allerdings ist es sinnvoll, selbsterklärende Namen zu wählen. Mit der Zeit haben sich bestimmte Namenskonventionen gebildet, die [[#Die von den Konventionen vorgegebene Verzeichnis-Struktur\|weiter unten]] erläutert werden.

	Die folgenden Ordner '''müssen''' allerdings exakt wie angegeben benannt sein, damit die Spielengine sie findet:		Die folgenden Ordner '''müssen''' allerdings exakt wie angegeben benannt sein, damit die Spielengine sie findet:

RufDerMacht: /* Die von der Spielengine definierte Verzeichnis-Struktur */

2022-02-14T13:43:59Z

Die von der Spielengine definierte Verzeichnis-Struktur

← Older revision		Revision as of 13:43, 14 February 2022
Line 72:		Line 72:

	=== Die von der Spielengine definierte Verzeichnis-Struktur ===		=== Die von der Spielengine definierte Verzeichnis-Struktur ===
	Die Ordner, die Code enthalten - wie '''scenarios''' und '''macros''' - müssen nicht zwingend so benannt werden, sondern dürfen im Prinzip beliebige Namen erhalten. Allerdings ist es sinnvoll, ~~diese~~ selbsterklärenden Namen zu wählen.		Die Ordner, die Code enthalten - wie '''scenarios''' und '''macros''' - müssen nicht zwingend in bestimmter Weise benannt werden, sondern dürfen im Prinzip beliebige Namen erhalten. Allerdings ist es sinnvoll, selbsterklärenden Namen zu wählen. Mit der Zeit haben sich bestimmte Namenskonventionen gebildet die [[

	Die folgenden Ordner '''müssen''' allerdings exakt wie angegeben benannt sein, damit die Spielengine sie findet:		Die folgenden Ordner '''müssen''' allerdings exakt wie angegeben benannt sein, damit die Spielengine sie findet:

RufDerMacht: /* See also */

2022-02-14T13:42:06Z

RufDerMacht: /* Directory structure defined by convention */ translated

2022-02-14T13:41:14Z

Directory structure defined by convention: translated

← Older revision		Revision as of 13:41, 14 February 2022
Line 89:		Line 89:
	Wie die Spielengine genau auf die genannten Verzeichnisse zugreift, wird in [[BinaryPathWML]] erläutert.		Wie die Spielengine genau auf die genannten Verzeichnisse zugreift, wird in [[BinaryPathWML]] erläutert.

	=== ~~Directory structure defined by convention~~ ===		=== Die von den Konventionen vorgegebene Verzeichnis-Struktur ===
			Die Bezeichnungen folgender Ordner sind nicht durch die Spielengine vorgeschrieben, sondern haben sich im Laufe der Zeit als besonders praktikabel ("best practice") durchgesetzt:

	~~The names of these directories are not prescribed by the engine, but the current "best practice" is:~~		*''userdata''/data/add-ons/A_Simple_Addon/'''ai'''<br>Enthält Lua-Dateien für die [[RCA_AI\|künstliche Intelligenz (RCA AI)]].
			*''userdata''/data/add-ons/A_Simple_Addon/'''masks'''<br> Enthält Dateien für [[TerrainMaskWML]].
			*''userdata''/data/add-ons/A_Simple_Addon/'''units'''<br> Enthält Dateien für die Definition von Einheiten.
			*''userdata''/data/add-ons/A_Simple_Addon/'''utils'''<br>Enthält WML-Makros.

	*<b><i>userdata</i>/data/add-ons/A_Simple_Addon/ai</b> Lua files for the RCA_AI		Auch für einige Unterordner des Verzeichnis '''images''' gibt es bestimmte Konventionen:
	*<b><i>userdata</i>/data/add-ons/A_Simple_Addon/masks</b> files for TerrainMaskWML
	*<b><i>userdata</i>/data/add-ons/A_Simple_Addon/units</b>
	*<b><i>userdata</i>/data/add-ons/A_Simple_Addon/utils</b> containing WML macros

	~~The "images" directory is prescribed by the engine, but can also use subdirectories:~~		*''userdata''/data/add-ons/A_Simple_Addon/images/'''halo'''<br>Grafiken zur [https://forums.wesnoth.org/viewtopic.php?t=44389 Halo Era].
			*''userdata''/data/add-ons/A_Simple_Addon/images/'''items'''<br>Gegenstands (Items)-Grafiken.
	*~~<b><i>~~userdata~~</i>~~/data/add-ons/A_Simple_Addon/images/halo~~</b> for~~ '''[~~halo_frame~~]'''~~, etc~~		*''userdata''/data/add-ons/A_Simple_Addon/images/'''portraits'''<br>Portrait-Grafiken ([unit_type]profile=)
	*<b><i>userdata</i>/data/add-ons/A_Simple_Addon/images/items</b>		*''userdata''/data/add-ons/A_Simple_Addon/images/'''story'''<br>Hintergründe für Story-Bildschirme ([story])
	*~~<b><i>~~userdata~~</i>~~/data/add-ons/A_Simple_Addon/images/portraits~~</b> for~~ '''[unit_type]profile='''		*''userdata''/data/add-ons/A_Simple_Addon/images/'''units'''<br>Einheiten-Grafiken ([unit_type]image=)
	*<b><i>userdata</i>/data/add-ons/A_Simple_Addon/images/story~~</b> backgrounds for~~ '''[story]''' ~~screens~~		*''userdata''/data/add-ons/A_Simple_Addon/images/'''misc'''<br>Der üblich Sammelordner, damit man nicht alles ins Hauptverzeichnis (oder sonstwohin) packt.
	*<b><i>userdata</i>/data/add-ons/A_Simple_Addon/images/units~~</b> for~~ '''[unit_type]image='''~~, etc~~

	~~Finally, the customary fallback for not putting stuff in the parent directory:~~

	*<b><i>userdata</i>/data/add-ons/A_Simple_Addon/images/misc</b>

	==See also==		==See also==

RufDerMacht: /* Die von der Spielengine definierte Verzeichnis-Struktur */ translated

2022-02-14T13:08:22Z

Die von der Spielengine definierte Verzeichnis-Struktur: translated

← Older revision		Revision as of 13:08, 14 February 2022
Line 76:		Line 76:
	Die folgenden Ordner '''müssen''' allerdings exakt wie angegeben benannt sein, damit die Spielengine sie findet:		Die folgenden Ordner '''müssen''' allerdings exakt wie angegeben benannt sein, damit die Spielengine sie findet:

	*''userdata''/data/add-ons/A_Simple_Addon/images		*''userdata''/data/add-ons/A_Simple_Addon/'''images'''
	*''userdata''/data/add-ons/A_Simple_Addon/music		*''userdata''/data/add-ons/A_Simple_Addon/'''music'''
	*''userdata''/data/add-ons/A_Simple_Addon/sounds		*''userdata''/data/add-ons/A_Simple_Addon/'''sounds'''

	Das gilt auch für einige Unterverzeichnisse von '''images''':		Das gilt auch für einige Unterverzeichnisse von '''images''':

	*''userdata''/data/add-ons/A_Simple_Addon/images/attacks<br>Enthält die Icons für jeden Angriff, siehe auch [[UnitTypeWML#Attacks]]		*''userdata''/data/add-ons/A_Simple_Addon/images/'''attacks'''<br>Enthält die Icons für jeden Angriff, siehe auch [[UnitTypeWML#Attacks]].
	*''userdata''/data/add-ons/A_Simple_Addon/images/terrain<br>Enthält Grafiken für Terrain		*''userdata''/data/add-ons/A_Simple_Addon/images/'''terrain'''<br>Enthält Grafiken für Terrain, also die grundlegende Grafik für Karten.
	*''userdata''/data/add-ons/A_Simple_Addon/lua<br>Enthält Lua-Module, die in WML-Dateien durch <code>wesnoth.require "''Modul_Name''"</code> eingebunden werden können.		*''userdata''/data/add-ons/A_Simple_Addon/'''lua'''<br>Enthält Lua-Module, die in WML-Dateien durch <code>wesnoth.require "''Modul_Name''"</code> eingebunden werden können.
			*''userdata''/data/add-ons/A_Simple_Addon/'''translations'''<br>Enthält ggf. Übersetzungsdaten, kann aber auch leer sein. Ohne dieses Verzeichnis wird eine Warnung in der Standardfehlerausgabe (stderr) erzeugt. Der Pfad '''muss''' exakt dem innerhalb der <code>[textdomain)</code>-Tags in _main.cfg definierten Pfad entsprechen.

	~~While Lua can be embedded in WML files, the following directory is supported for loading them via Lua's <b>wesnoth.require "<i>module_name</i>"</b>.~~		Wie die Spielengine genau auf die genannten Verzeichnisse zugreift, wird in [[BinaryPathWML]] erläutert.



	If you set up a textdomain, create a <b>translations</b> directory, even if it remains empty. Failure to do so generates a warning in stderr. This path <b>must</b> be the same as specified in the [textdomain] tag.

	*<b><i>userdata</i>/data/add-ons/A_Simple_Addon/translations</b>


	You may name the directories containing code (such as <b>scenarios</b> and <b>macros</b>) anything you like, but the binary content directories listed below <b>must</b> be named as such and be relative to your [binary_path]. This is because when trying to resolve an image path, Wesnoth will look under images/, and likewise for sounds and music, in ~~as explained in the~~ [[BinaryPathWML]] ~~page.~~


	~~Some subdirectories of <b>images</b> are also supported by the engine:~~

	*<b><i>userdata</i>/data/add-ons/A_Simple_Addon/images/attacks</b> Icons for each attack, see [[UnitTypeWML#Attacks]]'s documentation for '''icon'''
	*'''''userdata''/data/add-ons/A_Simple_Addon/images/terrain</b> Terrain graphics

	~~While Lua can be embedded in WML files, the following directory is supported for loading them via Lua's <b>wesnoth.require "<i>module_name</i>"</b>.~~

	*<b><i>userdata</i>/data/add-ons/A_Simple_Addon/lua</b>

	If you set up a textdomain, create a <b>translations</b> directory, even if it remains empty. Failure to do so generates a warning in stderr. This path <b>must</b> be the same as specified in the [textdomain] tag.

	*<b><i>userdata</i>/data/add-ons/A_Simple_Addon/translations</b>

	=== Directory structure defined by convention ===		=== Directory structure defined by convention ===

RufDerMacht: /* Die Verzeichnis-Struktur */ trans

2022-02-14T04:11:38Z

Die Verzeichnis-Struktur: trans

@@ Line 68: / Line 68: @@
 *''userdata''/data/add-ons/A_Simple_Addon/maps
-Alle Datendateien für Karten werden im '''maps'''-Ordner gespeichert, während alle Konfigurationsdateien (mit der Endung '''.cfg''') im '''scenarios'''-Ordner landen. Wür weiterführende Informationen zu diesen Themen siehe [[BuildingMaps]] und [[BuildingScenarios]].<br>
+Alle Datendateien für Karten werden im '''maps'''-Ordner gespeichert, während alle Konfigurationsdateien (mit der Endung '''.cfg''') im '''scenarios'''-Ordner landen. Weiterführende Informationen zu diesen Themen finden sich unter [[BuildingMaps]] und [[BuildingScenarios]].<br>
 Für weitere Inhalte, etwa Musik, Sound oder Grafiken, ist es notwendig, entsprechende Ordner anzulegen. Das wird eigentlich auch für alle andere Inhalte empfohlen, um die Übersicht zu wahren.
 === Die von der Spielengine definierte Verzeichnis-Struktur ===
 You may name the directories containing code (such as <b>scenarios</b> and <b>macros</b>) anything you like, but the binary content directories listed below <b>must</b> be named as such and be relative to your [binary_path]. This is because when trying to resolve an image path, Wesnoth will look under images/, and likewise for sounds and music, in as explained in the [[BinaryPathWML]] page.
 Some subdirectories of <b>images</b> are also supported by the engine:

RufDerMacht: /* The Directory Structure */ translated.

2022-02-13T22:38:17Z

The Directory Structure: translated.

← Older revision		Revision as of 22:38, 13 February 2022
Line 59:		Line 59:
	'''Anmerkung:''' Aus der Datei _main.cfg heraus darf nur '''Code''' eingebunden werden, '''keine''' binären Inhalte (wie etwa Musik, Sounds oder Bilder). Hier wird lediglich mit <code>[binary path]</code> ein Pfad definiert, auf den von anderen Dateien aus verwiesen werden kann.		'''Anmerkung:''' Aus der Datei _main.cfg heraus darf nur '''Code''' eingebunden werden, '''keine''' binären Inhalte (wie etwa Musik, Sounds oder Bilder). Hier wird lediglich mit <code>[binary path]</code> ein Pfad definiert, auf den von anderen Dateien aus verwiesen werden kann.

	== ~~The Directory Structure~~ ==		== Die Verzeichnis-Struktur ==

	~~What to create next depend on what type of content you are creating~~. ~~For example, campaigns or map packs will have <b>~~scenarios~~</b> and <b>~~maps~~</b> directories~~, ~~while a music pack would have only <b>~~music~~</b>~~. ~~Here we will assume you are creating a campaign or single~~-~~scenario add~~-on.		Welche Ordner als nächstes angelegt werden, hängt von den gewünschten neuen Inhalten der Erweiterung ab. So erfordern Kampagnen oder Karten-Pakete '''scenarios'''- und '''maps'''-Ordner, während ein Musik-Paket lediglich den Ordner '''music''' benötigt. In diesem Beispiel-Add-on nehmen wir an, dass eine Kampagne oder ein einzelnes Szenario erzeugt werden soll.

	~~Create the following directories~~:		Wir legen die folgenden Ordner an:

	*~~<b><i>~~userdata~~</i>~~/data/add-ons/A_Simple_Addon/scenarios~~</b>~~		*''userdata''/data/add-ons/A_Simple_Addon/scenarios
	*~~<b><i>~~userdata~~</i>~~/data/add-ons/A_Simple_Addon/maps~~</b>~~		*''userdata''/data/add-ons/A_Simple_Addon/maps

	~~All map files used in scenarios go in <b>~~maps~~</b>~~ (~~see~~ [[BuildingMaps]]~~. All configuration (‘.cfg’) files for scenarios go in <b>scenarios</b> (see~~ [[BuildingScenarios]]).		Alle Datendateien für Karten werden im '''maps'''-Ordner gespeichert, während alle Konfigurationsdateien (mit der Endung '''.cfg''') im '''scenarios'''-Ordner landen. Wür weiterführende Informationen zu diesen Themen siehe [[BuildingMaps]] und [[BuildingScenarios]].<br>
			Für weitere Inhalte, etwa Musik, Sound oder Grafiken, ist es notwendig, entsprechende Ordner anzulegen. Das wird eigentlich auch für alle andere Inhalte empfohlen, um die Übersicht zu wahren.
	~~If you have additional custom content such as images~~, ~~sounds or music~~, ~~it's necessary to create additional directories~~. ~~Even for other custom content~~, ~~creating directories to organise it is recommended~~.

	~~=== Directory structure defined by the engine ===~~

			=== Die von der Spielengine definierte Verzeichnis-Struktur ===
	You may name the directories containing code (such as <b>scenarios</b> and <b>macros</b>) anything you like, but the binary content directories listed below <b>must</b> be named as such and be relative to your [binary_path]. This is because when trying to resolve an image path, Wesnoth will look under images/, and likewise for sounds and music, in as explained in the [[BinaryPathWML]] page.		You may name the directories containing code (such as <b>scenarios</b> and <b>macros</b>) anything you like, but the binary content directories listed below <b>must</b> be named as such and be relative to your [binary_path]. This is because when trying to resolve an image path, Wesnoth will look under images/, and likewise for sounds and music, in as explained in the [[BinaryPathWML]] page.

RufDerMacht: /* Die Datei _main.cfg */ translated

2022-02-13T19:54:34Z

Die Datei _main.cfg: translated

← Older revision		Revision as of 19:54, 13 February 2022
Line 16:		Line 16:

	#Dazu legen wir zunächst das Verzeichnis <code>''userdata''/data/add-ons/A_Simple_Addon</code> an.		#Dazu legen wir zunächst das Verzeichnis <code>''userdata''/data/add-ons/A_Simple_Addon</code> an.
	#Danach erzeugen wir innerhalb des neuen Ordners eine Textdatei namens '''_main.cfg'''~~. Ohne diese Datei wird das Spiel nicht einmal bemerken, dass dein Add-on existiert~~. Der Name der Datei bedeutet in etwa "Hauptkonfigurationsdatei".		#Danach erzeugen wir innerhalb des neuen Ordners eine Textdatei namens '''_main.cfg'''. Der Name der Datei bedeutet in etwa "Hauptkonfigurationsdatei". Die Datei _main.cfg stellt die Verbindung zwischen dem Spiel und dem Add-on her und weist das Spiel an, wie die Inhalte des Add-ons geladen werden sollen.

	~~Die Datei _main.cfg weist das Spiel an, wie die Inhalte des Add-ons geladen werden sollen.~~ Hier ein sehr einfaches Beispiel:		Hier ein sehr einfaches Beispiel für _main.cfg:

	<syntaxhighlight lang=wml>		<syntaxhighlight lang=wml>
Line 36:		Line 36:
	</syntaxhighlight>		</syntaxhighlight>

	~~The~~ [~~textdomain~~] WML ~~tag specifies where the game should look for translations to the strings in the add~~-on. ~~The textdomain should be the add-on's directory name prefixed with <b>"wesnoth-"~~</b>~~, to ensure that it does not conflict with other textdomains that might be specified on a given system and is compatible with [[WesCamp]].~~		<small>Als ein Nutzer ohne jede Programmiererfahrung ist es vermutlich hilfreich, an dieser Stelle zuerst auf das [[WML_for_Complete_Beginners:_Introduction\|WML Tutorial]] zurückzugreifen, denn selbst dieses einfache Beispiel setzt bereits einige Kenntnisse voraus. Ein Nutzer mit entsprechender Vorerfahrung findet weiterführende Informationen in der [[ReferenceWML\|WML-Referenz]].</small>

	<b>~~Note:~~</b> A textdomain ~~is only required if your add~~-~~on contains text meant to be translated~~. ~~In the case of, for example, a music pack, no textdomain is needed~~.		Zunächst wird mit <code>#textdomain wesnoth-A_Simple_Addon</code> bekannt gemacht, wie die aktuell gültige Textdomain heißt. Mit dem nachfolgenden WML-Tag <code>[textdomain]</code> wird die Textdomain definiert: ihr Name und der Pfad zum Ordner mit Übersetzungen. Der Name der Textdomain setzt sich aus dem Präfix '''wesnoth-''' und dem Namen des Add-ons zusammen. Diese Konvention hat sich durchgesetzt und erschwert deutlich das Entstehen von lästigen Namenskonflikten.

	~~All tags save for [campaign] and [textdomain]~~ <b>~~must~~</b> be enclosed in an <b>#ifdef</b> preprocessor conditional - including those substituted through inclusion (see [[PreprocessorRef]] for more information). This is to make sure your content only loads at the correct time and does not conflict with other add-ons. In the example above, ~~the scenarios will be loaded when you enter multiplayer mode~~. ~~In a campaign, you can set up a specific flag to allow your content to only load when that campaign is played~~.		<b>Anmerkung:</b> Eine Textdomain ist nur erforderlich, wenn die Erweiterung Text enthält, der übersetzt werden kann und soll. Ein Musikerweiterung beispielsweise benötigt nicht notwendig eine Textdomain.

	<b>~~Note:~~</~~b> Only <b>~~code~~</b~~> ~~must be included from this file~~. ~~You~~ <b>~~do not~~</b> ~~need to include binary content~~ (~~such as sounds~~, ~~images~~, ~~or music)~~. ~~Those may be referred to simply by path relative to the one specified in [binary_path]. Also, including the~~ <b>~~units~~</b> ~~directory cannot be done by a simple path inclusion; it~~ also ~~must be wrapped in a~~ <b>[units][/units]</b> ~~tag pair, as such~~:		Alle Tags außer [campaign] und [textdomain] '''müssen''' durch eine bedingte Präprozessor-Anweisung der Form <code>#ifdef [andere Tags] #endif</code> umschlossen werden! Das betrifft auch solche Tags, die in anderen Schritten erst eingebunden werden. Diese Vorgehensweise bewirkt, dass bestimmte Inhalte der Erweiterung auch wirklich nur dann eingebunden werden, wenn sie benötigt werden, und verhindert Konflikte mit anderen Add-ons. Für weiterführende Informationen dazu siehe [[PreprocessorRef]].

			Im obigen Beispiel wird das Szenario nur im Multiplayer-Modus geladen. Innerhalb einer Kampagne kann man allerdings auch ein spezifisches Flag setzen, um einen bestimmten Inhalt nur innerhalb des Ablaufs dieser Kampagne zu laden.

			Innerhalb der Tags <code>[binary_path]</code> wird der (relative) Pfad für binäre Daten definiert, den ein Add-on zusätzlich zu den vom Spiel vorgegebenen Standardpfaden nutzen soll. Diese Angabe ist also nur dann notwendig, wenn ein Add-on eigene binäre Daten nutzen möchte.<br>
			Im Anschluss daran wird durch <code>{~add-ons/A_Simple_Addon/scenarios}</code> noch der Pfad für die neuen Szenario-Daten definiert. Auch diese Angabe liegt noch innerhalb der bedingten Präprozessor-Anweisung, wird also nur im Falle eines Multiplayer-Spiels gültig.<br>
			Diese einfache Form der Pfadangabe gilt NICHT für die Angabe des Einheiten-Ordners '''units'''. Diese muss immer von <code>[units]</code>-Tags umschlossen werden:

	<syntaxhighlight lang=wml>		<syntaxhighlight lang=wml>
Line 49:		Line 55:
	[/units]		[/units]
	</syntaxhighlight>		</syntaxhighlight>


			'''Anmerkung:''' Aus der Datei _main.cfg heraus darf nur '''Code''' eingebunden werden, '''keine''' binären Inhalte (wie etwa Musik, Sounds oder Bilder). Hier wird lediglich mit <code>[binary path]</code> ein Pfad definiert, auf den von anderen Dateien aus verwiesen werden kann.

	== The Directory Structure ==		== The Directory Structure ==

RufDerMacht: began to translate. 2B continue

2022-02-13T13:15:55Z

began to translate. 2B continue

← Older revision		Revision as of 13:15, 13 February 2022
Line 2:		Line 2:
	{{Create}}		{{Create}}

	~~In order to create custom content for Wesnoth~~, ~~you need to set up a folder~~ in ~~<i>userdata</i>/data/add-ons/~~. ~~If you have not found your~~ userdata ~~directory yet~~, ~~read [[EditingWesnoth]] and come back here~~. ~~This page will explain the basic directory structure of an add-on and where stuff goes~~.		'''Innerhalb dieser und anderer Seiten im Wiki wird immer wieder Bezug genommen auf ein Verzeichnis, in denen die benutzerdefinierten Inhalte für Wesnoth gespeichert werden. Es wird hier mit''' ''userdata'' '''bezeichnet, obwohl ein Verzeichnis diesen Namens nicht (mehr) existiert. Die Bezeichnung hat sich aus praktischen Gründen eingebürgert.'''

	~~<b>Several pages on this wiki will assume you have done so and refer to relative paths in such~~.~~</b>~~		Wie man den Pfad dieses Verzeichnis herausfindet und darauf zugreift, wird ausführlich unter [[EditingWesnoth/de\|EditingWesnoth]] erklärt.

	~~== The Main File ==~~		Neue, benutzerdefinierte Inhalte, kurz '''UMC''' (User Made Content), werden auch als '''Add-ons''' und im Deutschen auch als '''Erweiterungen''' bezeichnet. Sie werden damit von den Inhalten unterschieden, die bereits vom Spiel mitgebracht werden. Man kann beim Erzeugen neuer Inhalte aber in hohem Maße auf bereits vorhandene Spieldaten zurückgreifen.<br>
			Um neue Inhalte zu erschaffen, ist es zunächst notwendig, im Verzeichnis <code>''userdata''/data/add-ons/</code> ein neues Unterverzeichnis mit einem beliebigen Namen anzulegen. In diesem und allen weiteren Verzeichnisnamen sind KEINE Leerzeichen erlaubt. Statt dessen können Unter_Striche oder Binde-Striche verwendet werden.

	~~For this example, we will assume you are creating an add-on called <b>A Simple Addon</b>.~~		'''In der Folge (und auch auf anderen Seiten im Wiki) wird ein derartiges Unterverzeichnis vorausgesetzt!'''

	*Create the empty directory <b><i>userdata</i>/data/add-ons/A_Simple_Addon</b>.		== Die Datei _main.cfg ==

	~~<b>Important:</b> Remember to use underscores or hyphens in all directory and file names instead of spaces. Failure to do so will result in your content not working properly~~.		Im nachfolgende Beipiel gehen wir davon aus, eine neue Erweiterung namens '''A_Simple_Addon''' zu erzeugen.

	*Create a file called <b>_main.cfg~~</b> inside the A_Simple_Addon folder~~. ~~Without this file~~, ~~the game will not even recognize that your add~~-on ~~exists~~.		#Dazu legen wir zunächst das Verzeichnis <code>''userdata''/data/add-ons/A_Simple_Addon</code> an.
			#Danach erzeugen wir innerhalb des neuen Ordners eine Textdatei namens '''_main.cfg'''. Ohne diese Datei wird das Spiel nicht einmal bemerken, dass dein Add-on existiert. Der Name der Datei bedeutet in etwa "Hauptkonfigurationsdatei".

	~~The~~ _main.cfg ~~file will instruct the game on how to load your content. Here is shown a very simple example of the file~~.		Die Datei _main.cfg weist das Spiel an, wie die Inhalte des Add-ons geladen werden sollen. Hier ein sehr einfaches Beispiel:

	<syntaxhighlight lang=wml>		<syntaxhighlight lang=wml>

← Older revision		Revision as of 13:42, 14 February 2022
Line 106:		Line 106:
	*''userdata''/data/add-ons/A_Simple_Addon/images/'''misc'''<br>Der üblich Sammelordner, damit man nicht alles ins Hauptverzeichnis (oder sonstwohin) packt.		*''userdata''/data/add-ons/A_Simple_Addon/images/'''misc'''<br>Der üblich Sammelordner, damit man nicht alles ins Hauptverzeichnis (oder sonstwohin) packt.

	==~~See also~~==		==Siehe auch==

	* [[Create]]		* [[Create]]