Aus PantheonWiki

Inhaltsverzeichnis 1 Einleitung 1.1 Vorraussetzungen 2 Erste Schritte 2.1 Ordner anlegen 2.2 Dateien anlegen 3 Einfügen von Inhalt

Einleitung

Mit der Rollenspielengine von Rastullahs Lockenpracht liefern wir einige Beispielmodule mit. Wie ihr solche Module selber erstellen könnt, wollen wir euch in diesem Tutorial erklären.

Vorraussetzungen

• Für die Definition von unseren Modulen verwenden wir die Skriptsprache Ruby. Daher ist es sinnvoll sich vorher ein wenig in die Sprache einzulesen. Auch sind Programmierkenntnisse hilfreich.
• Zum Erstellen der Modelle können verschiedene 3D-Grafikprogramme benutzt werden. Tutorials für Blender und 3DS Max findet man hier in der Wiki

Erste Schritte

Ordner anlegen

In dem Ordner, wo die Engine liegt, gibt es einen ein Ordner "modules". In diesem Ordner legt ihr einen neuen Ordner für eurer Modul an. Wir nennen diesen Ordner hier "tutorial". In diesem Ordner müssen wieder Ordner erstellt werden, so dass die Struktur eines Moduls entsteht: dialogs, dsa, gui, gui/fonts, gui/imagesets, gui/schemes, gui/windows, maps, materials, materials/textures, models, scripts, scripts/maps, quests, sound

Dateien anlegen

Nun müssen noch für ein komplettes Modul benötigten Dateien erstellt werden:

Im Ordner scripts muss die Datei moduleconfig.rb angelegt werden. Dort fügen wir den Inhalt ein:

class TutorialModule < ContentModule
   def initialize()
       super("tutorial", "Tutorial", false, 200603030)
   end
 
   def getDependencies()
        return ["common"]
   end

   def getTextureLocations()
	return []
   end

   def getModelLocations()
 	return []
   end

   def getSoundLocations()
	return []
   end

   def start()
       $SCRIPT.log("Loaded module Tutorial")
   end
end

CoreSubsystem.getSingleton().registerModule(TutorialModule.new())

Anschließend wechseln wir in den Ordner modules und bearbeiten dort die Datei modules.cfg. Es muss "module=tutorial" hinzugefügt werden.

Nun haben wir ein funktionierendes Modul. Es passiert noch nicht viel. Im Log ist nur eine Nachricht zu sehen: "Loaded module Tutorial"

Einfügen von Inhalt

In diesem Beispiel verwenden wir nur eine Szene und eine Karte. Eine Szene kann aus mehreren Karten bestehen. Somit kann man eine komplexe Szene in mehrere Karten aufteilen, welche sich wesentlich einfacher bearbeiten lassen. Auch kann man eine Karten in anderen Szenen wiederverwenden.

Die Szenendefinitionsdatei hat die Endung .rlscene.

<scene name="tutorial">

<map file="tutoral.rlmap"/>

</scene>

Hier wird definiert, welche Karten verwendet werden sollen. Die Szenendatei wird in dem Ordner "maps" unter dem Dateinamen "tutorial.rlscene" abgespeichert.

Nun wird die Datei "tutorial.rlmap" in dem selben Ordner neu erstellt. Mapformat: http://wiki.team-pantheon.de/Mapformat

hier muss noch weitergeschrieben werden