Extensions - Versionsgeschichte

Manuel: Bilddarstellung gefixt

2018-09-26T18:22:27Z

Bilddarstellung gefixt

Manuel: Assets-Pipeline Grafik hinzugefügt

2018-09-26T18:20:13Z

Assets-Pipeline Grafik hinzugefügt

Manuel: Falsche Wörter korrigiert

2017-02-27T14:31:52Z

Falsche Wörter korrigiert

Manuel: Andere Typen bis auf Items ergänzt

2017-02-27T14:29:50Z

Andere Typen bis auf Items ergänzt

Manuel: Blöcke und Bäume ergänzt

2017-02-26T18:58:41Z

Blöcke und Bäume ergänzt

Manuel: Beispiellink für Extension

2017-02-26T18:33:56Z

Beispiellink für Extension

Manuel: Typo

2017-02-24T17:59:59Z

Typo

Manuel: ResourcePacks hinzugefügt, Einleitung überarbeitet, Rest auskommentiert.

2017-02-24T17:59:36Z

ResourcePacks hinzugefügt, Einleitung überarbeitet, Rest auskommentiert.

Manuel: Überarbeiten-Hinweis

2016-11-16T17:32:10Z

Überarbeiten-Hinweis

Rave1000 am 14. September 2016 um 18:11 Uhr

2016-09-14T18:11:25Z

@@ Zeile 69: / Zeile 69: @@
 ==ResourcePacks==
-[[Datei:Assets-pipeline.png]]
+[[Datei:Assets-pipeline.png|thumb|700px|Ladereihenfolge für Assets]]
 Wenn einem die Texturen einer Erweiterung nicht gefallen, muss man nicht sofort eine eigene Erweiterung erstellen. Häufig reicht dafür ein ResourcePack aus.

← Nächstältere Version		Version vom 26. September 2018, 18:20 Uhr
Zeile 68:		Zeile 68:

	==ResourcePacks==		==ResourcePacks==
		+
		+	[[Datei:Assets-pipeline.png]]

	Wenn einem die Texturen einer Erweiterung nicht gefallen, muss man nicht sofort eine eigene Erweiterung erstellen. Häufig reicht dafür ein ResourcePack aus.		Wenn einem die Texturen einer Erweiterung nicht gefallen, muss man nicht sofort eine eigene Erweiterung erstellen. Häufig reicht dafür ein ResourcePack aus.

@@ Zeile 33: / Zeile 33: @@
 ====Blocktypen====
-Blocktypen erben implementieren die Basisschnittstelle <code>[http://doc.octoawesome.net/api/develop/OctoAwesome.IBlockDefinition.html IBlockDefinition]</code> oder erben von der Basisklasse <code>[http://doc.octoawesome.net/api/develop/OctoAwesome.BlockDefinition.html BlockDefinition]</code>. Der Vorteil der Basisklasse ist, dass sie bereits viel Standardcode enthält, der nicht in jeden Blocktyp kopiert werden muss.
+Blocktypen implementieren entweder die Basisschnittstelle <code>[http://doc.octoawesome.net/api/develop/OctoAwesome.IBlockDefinition.html IBlockDefinition]</code> oder erben von der Basisklasse <code>[http://doc.octoawesome.net/api/develop/OctoAwesome.BlockDefinition.html BlockDefinition]</code>. Der Vorteil der Basisklasse ist, dass sie bereits viel Standardcode enthält, der nicht in jeden Blocktyp kopiert werden muss.
 Die Texturen des Blocks werden als Array von ''Asset-Referenzen'' (ohne Dateiendung) dem Spiel übergeben. Diese müssen als Bilddatei mit dem gleichen Namen (aber mit Dateiendung) als Eingebettete Ressource im Ordner Assets des jeweiligen Assemblies liegen. Als Unterordner müssen die Namespacenamensteile (jeder Punkt trennt ein Verzeichnis) ohne den Assemblynamen am Anfang verwendet werden. Hat z.B. ein <code>XYZBlock</code> den Namespacenamen <code>OctoAwesome.XYZ.Blocks</code> aus dem Assembly <code>OctoAwesome.XYZ</code> und verwendet die Textur <code>xyz</code>, so muss die Texturdatei den Pfad <code>${PROJEKTVERZEISCHNIS}/Assets/Blocks/xyz.png</code> haben. Alternativ können auch jpg oder bmp Dateien verwendet werden.
@@ Zeile 42: / Zeile 42: @@
 Als weiterer Verweis muss ein Verweis auf <code>OctoAwesome.Basics.dll</code> hinzugefügt werden.
-Blocktypen implementieren entweder die Basisschnittstelle <code>[http://doc.octoawesome.net/api/develop/OctoAwesome.Basics.ITreeDefinition.html ITreeDefinition]</code> oder erben von der Basisklasse <code>[http://doc.octoawesome.net/api/develop/OctoAwesome.Basics.TreeDefinition.html TreeDefinition]</code>.
+Baumtypen implementieren entweder die Basisschnittstelle <code>[http://doc.octoawesome.net/api/develop/OctoAwesome.Basics.ITreeDefinition.html ITreeDefinition]</code> oder erben von der Basisklasse <code>[http://doc.octoawesome.net/api/develop/OctoAwesome.Basics.TreeDefinition.html TreeDefinition]</code>.
 Über <code>MinTemperature</code>, <code>MaxTemperature</code> und <code>GetDensity()</code> werden die Minimal-/Maximaltemperaturen für diesen Baum und die Häufigkeit des Auftretens ermittelt. In der Methode <code>Init()</code> können die benötigten Blocktypen herausgesucht werden und dann schließlich in der Methode <code>PlantTree()</code> zum "Pflanzen" eines Baumes an der angegebenen Position verwendet werden.

@@ Zeile 46: / Zeile 46: @@
 Über <code>MinTemperature</code>, <code>MaxTemperature</code> und <code>GetDensity()</code> werden die Minimal-/Maximaltemperaturen für diesen Baum und die Häufigkeit des Auftretens ermittelt. In der Methode <code>Init()</code> können die benötigten Blocktypen herausgesucht werden und dann schließlich in der Methode <code>PlantTree()</code> zum "Pflanzen" eines Baumes an der angegebenen Position verwendet werden.
 <!--
 ===Map Populators===
-;Benötigte Verweise:
+;Beispielimplementierung:
-: OctoAwesome.dll
+: [https://github.com/OctoAwesome/octoawesome/blob/feature/entities/OctoAwesome/OctoAwesome.Basics/TreePopulator.cs TreePopulator.cs auf GitHub]
-Blocktypen implementieren entweder die Basisschnittstelle <code>[http://doc.octoawesome.net/master/html/T_OctoAwesome_IMapPopulator.htm IMapPopulator]</code> oder erben von der Basisklasse <code>[http://doc.octoawesome.net/master/html/T_OctoAwesome_MapPopulator.htm MapPopulator]</code>.
+MapPopulators implementieren entweder die Basisschnittstelle <code>[http://doc.octoawesome.net/api/develop/OctoAwesome.IMapPopulator.html IMapPopulator]</code> oder erben von der Basisklasse <code>[http://doc.octoawesome.net/api/develop/OctoAwesome.MapPopulator.html MapPopulator]</code>. Sie dienen dazu, automatisch in der Welt (unabhängig von der Generierung) Dinge zu platzieren, z.B. Bäume oder Tiere.
-<code>Order</code> definiert die Reihenfolge, in der die Populatoren auf die Welt angewendet wird. In der Methode <code>Populate()</code> wird ein Chunk mit Dingen versehen.
+<code>Order</code> definiert die Reihenfolge, in der die Populatoren auf die Welt angewendet werden. In der Methode <code>Populate()</code> wird ein Chunk mit Dingen versehen.
 ===Map Generatoren===
-;Benötigte Verweise:
+;Beispielimplementierung:
-: OctoAwesome.dll
+: [https://github.com/OctoAwesome/octoawesome/blob/feature/entities/OctoAwesome/OctoAwesome.Basics/ComplexPlanetGenerator.cs ComplexPlanetGenerator.cs auf GitHub]
-Map Generatoren müssen die Schnittstelle <code>[http://doc.octoawesome.net/master/html/T_OctoAwesome_IMapGenerator.htm IMapGenerator]</code> implementieren.
+Map Generatoren müssen die Schnittstelle <code>[http://doc.octoawesome.net/api/develop/OctoAwesome.IMapGenerator.html IMapGenerator]</code> implementieren.
 ==ResourcePacks==

@@ Zeile 15: / Zeile 15: @@
 * Entitytypen
 * Extender für Entitäten und die Simulation
 ; Beispielimplementierung:
@@ Zeile 20: / Zeile 22: @@
 ''Die Dokumentation zu den einzelnen Typen wird zur Zeit überarbeitet und wird in Kürze wieder online sein.''
-;Benötigte Verweise:
+===Definitonstypen===
-: OctoAwesome.dll
-;Beispielimplementierung(en):
+; Beispielimplementierungen:
-: [https://github.com/OctoAwesome/octoawesome/blob/master/OctoAwesome/OctoAwesome.Basics/Definitions/Blocks/SandBlockDefinition.cs SandBlockDefinition.cs auf GitHub]: Einfacher Blocktyp
+: [https://github.com/OctoAwesome/octoawesome/blob/feature/entities/OctoAwesome/OctoAwesome.Basics/Definitions/Blocks/GrassBlockDefinition.cs Blocktyp (GrassBlockDefintion.cs) auf GitHub]
-: [https://github.com/OctoAwesome/octoawesome/blob/master/OctoAwesome/OctoAwesome.Basics/Definitions/Blocks/GrassBlockDefinition.cs GrassBlockDefinition.cs auf GitHub]: Komplexerer Blocktyp
+: [https://github.com/OctoAwesome/octoawesome/blob/feature/entities/OctoAwesome/OctoAwesome.Basics/Definitions/Items/WauziEggDefinition.cs Item (WauziEggDefinition.cs) auf GitHub]
-Blocktypen erben implementieren die Basisschnittstelle <code>[http://doc.octoawesome.net/master/html/T_OctoAwesome_IBlockDefinition.htm IBlockDefinition]</code> oder erben von der Basisklasse <code>[http://doc.octoawesome.net/master/html/T_OctoAwesome_BlockDefinition.htm BlockDefinition]</code>. Der Vorteil der Basisklasse ist, dass sie bereits viel Standardcode enthält, der nicht in jeden Blocktyp kopiert werden muss.
+Die Methoden <code>GetProperties()</code> und <code>Hit()</code> müssen zwar implementiert werden, werden aber nicht vom Spiel verwendet. Das <code>Icon</code> und der <code>Name</code> werden im Spiel angezeigt, aber nicht zur internen Identifikation eingesetzt, können also lokalisiert werden.
-Die Texturen des Blocks werden als Array von <code>Bitmap</code>s dem Spiel übergeben. Diese können entweder im Dateisystem liegen (besipielsweise im png-Format, wie bei der Basiserweiterung) oder als Resourcen in der dll-Datei des Plugins. Zum Laden aus dem Dateisystem sollte die [[Verzeichnisstruktur]] eingehalten werden. Insbesondere sollte im Assets-Verzeichnis auf die Verwendung des Assemblynamens (ohne Dateiendung) als Unterordner geachtet wird. Unterhalb dieses Ordners dürfen beliebige Ordner verwendet werden.
+====Baumtypen====
-Die Methoden <code>GetPhysicalProperties()</code> und <code>Hit()</code> müssen zwar implementiert werden, werden aber nicht vom Spiel verwendet. Das <code>Icon</code> und der <code>Name</code> werden im Spiel angezeigt, aber nicht zur internen Identifikation eingesetzt, können also lokalisiert werden.
+Blocktypen implementieren entweder die Basisschnittstelle <code>[http://doc.octoawesome.net/api/develop/OctoAwesome.Basics.ITreeDefinition.html ITreeDefinition]</code> oder erben von der Basisklasse <code>[http://doc.octoawesome.net/api/develop/OctoAwesome.Basics.TreeDefinition.html TreeDefinition]</code>.
 ===Map Populators===
@@ Zeile 44: / Zeile 56: @@
 <code>Order</code> definiert die Reihenfolge, in der die Populatoren auf die Welt angewendet wird. In der Methode <code>Populate()</code> wird ein Chunk mit Dingen versehen.
 ===Map Generatoren===

@@ Zeile 3: / Zeile 3: @@
 '''Dieser Artikel beschreibt den neuen Lademechanismus aus dem Branch feature/entities'''
-In diesem Artikel geht es um das Entwickeln von eigenen Erweiterungen für das Projekt OctoAwesome.
+In diesem Artikel geht es um das Entwickeln von eigenen Erweiterungen für das Projekt OctoAwesome, nicht um das Verwalten dieser.
 ==Erweiterungen erstellen==
@@ Zeile 15: / Zeile 15: @@
 * Entitytypen
 * Extender für Entitäten und die Simulation
 ''Die Dokumentation zu den einzelnen Typen wird zur Zeit überarbeitet und wird in Kürze wieder online sein.''

@@ Zeile 74: / Zeile 74: @@
 ; Beispieldateien:
 : [https://github.com/OctoAwesome/octoawesome/blob/develop/OctoAwesome/OctoAwesome.Community/Resources/TomTexturePack/packinfo.xml packinfo.xml]
-; [https://github.com/OctoAwesome/octoawesome/tree/develop/OctoAwesome/OctoAwesome.Community/Resources/TomTexturePack Ordnerstruktur]
+: [https://github.com/OctoAwesome/octoawesome/tree/develop/OctoAwesome/OctoAwesome.Community/Resources/TomTexturePack Ordnerstruktur]

@@ Zeile 1: / Zeile 1: @@
 {{Überarbeiten}}[[Kategorie:Überarbeiten]]
-In diesem Artikel geht es um das Entwickeln von Erweiterungen für das Projekt OctoAwesome.
+'''Dieser Artikel beschreibt den neuen Lademechanismus aus dem Branch feature/entities'''
-Zur Zeit lassen sich (im master-Branch)
+In diesem Artikel geht es um das Entwickeln von eigenen Erweiterungen für das Projekt OctoAwesome.
-* Blocktypen
+==Erweiterungen erstellen==
-* Map Populators
+Erweiterungen müssen in allen Fällen eine eigene .dll Dateien sein, die entweder direkt im Programmverzeichnis oder im Unterverzeichnis <code>Plugins</code> liegen müssen. Zur Entwicklung verwendet man am besten [[VisualStudio]] oder [[MonoDevelop]]. Der Namespace- und Assemblyname sollte im Format <code>OctoAwesome.*</code> oder <code>OctoAwesome.Plugin.*</code> sein. In einer einzelnen Erweiterung können mehrere erweiternde Typen definiert sein.
-durch eigene Erweiterungen ausbauen. Weitere Typen (z.B. Items, Resources, NPCs) sind für die Zukunft geplant.
+Eine Erweiterung ist eine Klasse, die von <code>IExtension</code> abgeleitet ist. Alle solchen Klassen werden beim Programmstart geladen, wenn der Nutzer sie aktiviert hat. Die Erweiterungsklasse enthält Informationen zur Erweiterung und Code für den Anwendungstart. Darüber können mit dem übergebenen <code>IExtensionLoader</code> einzelne Typen für das Spiel registriert werden:
-Erweiterungen müssen in allen Fällen eine eigene .dll Dateien sein, die entweder direkt im Programmverzeichnis oder im Unterverzeichnis <code>Plugins</code> liegen müssen. Zur Entwicklung verwendet man am besten [[VisualStudio]] oder [[MonoDevelop]]. Der Namespace- und Assemblyname sollte im Format <code>OctoAwesome.*</code> oder <code>OctoAwesome.Plugin.*</code> sein. In einer einzelnen Datei können mehrere erweiternde Typen definiert sein.
+* Definitions (= Blocktypen, Items und Baumtypen)
-==Blocktypen==
+''Die Dokumentation zu den einzelnen Typen wird zur Zeit überarbeitet und wird in Kürze wieder online sein.''
 ;Benötigte Verweise:
@@ Zeile 28: / Zeile 31: @@
 Die Methoden <code>GetPhysicalProperties()</code> und <code>Hit()</code> müssen zwar implementiert werden, werden aber nicht vom Spiel verwendet. Das <code>Icon</code> und der <code>Name</code> werden im Spiel angezeigt, aber nicht zur internen Identifikation eingesetzt, können also lokalisiert werden.
-==Map Populators==
+===Map Populators===
 ;Benötigte Verweise:
@@ Zeile 39: / Zeile 42: @@
 <code>Order</code> definiert die Reihenfolge, in der die Populatoren auf die Welt angewendet wird. In der Methode <code>Populate()</code> wird ein Chunk mit Dingen versehen.
-==Baumtypen==
+===Baumtypen===
 ;Benötigte Verweise:
@@ Zeile 51: / Zeile 54: @@
 Über <code>MinTemperature</code>, <code>MaxTemperature</code> und <code>GetDensity()</code> werden die Minimal-/Maximaltemperaturen für diesen Baum und die Häufigkeit des Auftretens ermittelt. In der Methode <code>Init()</code> können die benötigten Blocktypen herausgesucht werden und dann schließlich in der Methode <code>PlantTree()</code> zum "Pflanzen" eines Baumes verwendet werden.
-==Texturepacks==
+===Map Generatoren===
 ;Benötigte Verweise:
@@ Zeile 67: / Zeile 64: @@
 Zur Zeit werden die vorhandenen MapGeneratoren aus Erweiterungen nur bedingt berücksichtigt.-->

← Nächstältere Version		Version vom 16. November 2016, 17:32 Uhr
Zeile 1:		Zeile 1:
		+	{{Überarbeiten}}[[Kategorie:Überarbeiten]]
		+
	In diesem Artikel geht es um das Entwickeln von Erweiterungen für das Projekt OctoAwesome.		In diesem Artikel geht es um das Entwickeln von Erweiterungen für das Projekt OctoAwesome.