SphereWiki - User contributions [en]

Tr:Main Page

2010-12-28T10:24:20Z

Sco:

{{Languages|Main_Page}}

Hoşgeldin Taran's ünlü geri almak için "[http://www.cs.rit.edu/ ~ djr7581 / Dummies öğreticiler için Sphere Scripting]" ve bilgiler. Onun öğretici, ama Sphere 55i için yapıldı hakkında onun öğreticiler yeniden yazmak ve son değişiklik ve eklemeler yansıtacak şekilde bilgilerinizi güncellemek karar çıkacak Sphere 56b şimdi ki.

'''Nereden başlamalıyım?'''

bölüm | sen Sphere 56b için script öğrenmek istiyorsanız [Sphere] Kurma Sphere Ayarlama [#] okuyarak ilk başlamalısınız. Bu nasıl yol başlatmak için bir temel boş dünya kurmak için size öğretecektir. Eğer [[# Rehberler | Rehberler]] okuma denemelisiniz Bundan sonra, yavaş gitmek, onu okumak ve tam her şeyi anlamak zaman alıyor gibi bir gün her şeyi geçmesi çalışmayın.

'''Ben script nasıl öğrendim! Ve şimdi?'''

Eğer 10 bölüm bitmiş olursa, tutortials ve diğer eşyaların altında okumanızı öneririz. Onlar, diğerleri kadar önemli olmayabilir ama yine de oldukça yararlıdır ve pek çok faydalı bilgiyi içerir. [http://www.sphereserver.net/index.php SphereServer Forum] de başkaları ile kendi betikleri ve paylaşım yaparak deneyin. kendiniz bir şey çözemez durumda da yardım isteyebilirsiniz. kullanmayı unutmayın [[# Referans Compendium | Referans Compendium]] aşağıya gerçekten yararlı olduğu gibi.

'''Ben katkıda bulunmak istiyorum!'''

Bu sitedeki bilgiler bakımı yapmak zaman var çalışmak çok büyük bir miktar değil, çoğumuz içerir. Eğer yardım etmek istiyorsanız bunun için çekinmeyin! İhtiyacınız olan tek şey başlamak için yapmaktır [[Special: UserLogin | Hesap] yaratmak] Bunu zaten yapmadıysanız. Eğer ROP sağ köşedeki "Düzenle" bağlantısını kullanarak herhangi bir sayfasını düzenleyebilirsiniz. Bunu gitmeden önce, [[Katkı Kılavuzu]] okuyarak başlamak isteyebilirsiniz.

'''Için teşekkür etmek istiyorum:'''

[[WhoIsWho | Ben, Cloud_Br, Ellessar, Jdog, Lord Zerofiz, Mordaunt, Nazghul-ll, RanXerox, Rattlehead, Sandman, Sharlenwar, ShiryuX, thelegbra, Maximus ve WarAngel]], içerik eklemek yardımlarınız için.

[[WhoIsWho | Daleth]], Küre Referans Projesi, ve [[WhoIsWho | Mordaunt]] yazmak için. Için chm format dönüştürme için.

[[WhoIsWho | Tracker]], Sphereserver.net yılında Küre 56 İzleme Değişiklikleri yazmak için

[[WhoIsWho | Taran]], Dummies öğreticiler için ve şimdi ünlü orijinal Sphere Scripting ve [[WhoIsWho | MrSugarCube]] yazmak için doğrudan kaynağından güncel o kadar getirdiğin için.

[[WhoIsWho | Furio, Parlak, Vjaka, Nazghul-ll, Ellessar, Torfo, Shadow Dragon ve MrSugarCube]] için bir çok özelleştirilebilir güçlü Ultima Online içine Sphere geliştirmeye devam emülatör.

[[WhoIsWho | CRIUS]], orijinal SphereWiki için barındırma sağlamak için, ve [[WhoIsWho | Torfo]] sağlamak için barındırma geçerli.

----

== Sphere kurma ==

* [Nerede Sphere] almak için []
* [[Sphere] yükleme]
* [[Sphere.ini] yapılandırılması]

== Rehberler ==

Burada Sphere56b güncelledi Taran orijinal özet olan bölümleri şunlardır:

* [[Bölüm 1]]''(Sayılar, DEFNAME, ITEMDEF, CHARDEF)''
* [[Bölüm 2]]''(Sphere açıkladı dosyaları)''
* [[Bölüm 3]]''(Scripting NPC'ler ve öğeleri, Cool komutları)''
* [[Bölüm 4]]''(Objects, operatörler, konuşma)''
* [[Bölüm 5]]''(Etiketler, Vars, Yerel, Fonksiyonlar)''
* [[Bölüm 6]]''(LINKs, zamanlayıcılar, Hedeflerin)''
* [[Bölüm 7]]''(Döngüler ve güçlü fonksiyonları)''
* [[Bölüm 8]]''(SKILLMENUs, menüler, Gumps)''
* [[Bölüm 9]]''(Events)''
* [[10. Bölüm]]''(String Handling)''

Bunlara ek olarak diğer üyeler tarafından katkısı vardır biraz daha gelişmiş örnekler bulunuyor. Bu daha fazla bilgi edinmek için bir kez sen okumak isteyebilirsiniz yukarıda 10 öğreticiler okudum:

* [[Ortak Hatalar | Ortak Hatalar Açıklaması]]''(Maximus's öğretici forumlarında bir revizyon ve Taran's Yanılgıları yazının devamı)''
* [[Internet ve Küre]]''(Peki bunların doğru kullanımı için)''
(Kendi dil sistemi script) * [[Diller Eğitimi]]''''
* (Ne yapmak ve özelleştirmek beceri)''[kendi Becerileri] Yapımı []''
* [Eğitim Yama [Mul | Eğitim] Patching Nazghul's Mul] (mul yama ve özelleştirme sunucu ile ilgili bir belge) [http://sorea.profitux.cz/patching/ harici link]''''
* [[Geçersiz kılmak Hardcoded Commands]]''(Nasıl kodlanmış komutları ve işlevleri geçersiz kılmak için)''
* [[Tarifeli Reboot]]''(Nasıl Sistem açılış programı için)''
* [MySQL] Kullanımı []''(MySQL kullanmak için)''

== Referans Compendium ==

* [[: Kategori: Tanımlar | Tanımlar]]
** [[CHARDEF | Karakterleri]]
** [[DIALOG | Dialogs]]
** [[OLAYLAR | Etkinlikler]]
** [[ITEMDEF | Öğeler]]
** [[MENU | Menüler]]
** [[REGIONRESOURCE | Bölge Kaynaklar]]
** [[REGIONTYPE | Bölge Türleri]]
** [[AREADEF | Bölgeler]]
** [[ROOMDEF | Odalar]]
** [[SKILLCLASS | Beceri Sınıfları]]
** [[SKILLMENU | Beceri Menüler]]
** [[YETENEK | Becerileri]]
** [[SPAWN | Gruplar] Spawn]
** [[Büyü | Sihirler]]
** [[Typedef | Tipleri]]
* [[: Kategori: Nesneler | Nesneler]]
** [[] Hesaplar]
** [[Karakter]]
** [[Database]]
** [[] Files]
** [[GM sayfalar]]
** [[Öğeler]]
*** [[Özel Ürünler]]
** [[Harita Puanlar]]
** [[Taraf]]
** [[Bölgeler]]
** [[Odalar]]
** [[Sektörler]]
** [[Server]]
* [[: Kategori: Scripts | Script]]
** [[: Kategori: Fonksiyonlar | Fonksiyonlar ve Tetikleyiciler]]
** [[: Kategori: Değişkenler | Genel Fonksiyonlar, Özellikleri ve Referanslar]]
** [[İçsel Fonksiyonları]]
** [[: Kategori: Tablolar | Tablolar]]

== Diğer Makaleler ==

* [[Armor Hesaplama]]
* [[Müşteri Değişiklikleri]]
* [[Genel Scripting Yanılgıları]]
* [[Özel Nesnesi Özellikleri]]
* [[Hata Kodları]]
* [[Deneyim Sistemi]]
* [[Savaş] Nasıl Çalışır]
* [[Occam's Razor]]
* [[Optimizasyonu | Optimizasyon Teorisi]]
* [[TAG] Override]
* [[Düzeltmeler] Changelog]
* [[Sendpacket]]
* [[Beceri Kazanç Teorisi]]
* [] Scripting Süreci []

== Dış Bağlantılar ==

* [Http://www.sphereserver.net/ Resmi SphereServer Sitesi]
* [Http://prerelease.sphereserver.net/ Resmi Sphere 56b Dosyalar]
* [Http://scriptsharing.dv-team.de/ ScriptSharing]
* [Http://www.cs.rit.edu/ ~ djr7581 / Dummies (Sphere 55i) için Taran's Scripting]
* [Http://uo.torfo.org/packetguide/ Jerrith's UO Paket Rehberi]
* [Http://uo.torfo.org/packetguideKR/ Wyatt & Kons's UOKR Paket Rehberi]

[[Kategori: Navigasyon]]
[[De: Ana Sayfa / de]]

Template:Languages

2010-12-28T10:23:35Z

Sco:

<includeonly>{{ {{{2|Languages/Interface}}}

|{{LanguageExisting|de|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|de|{{{1|{{PAGENAME}}}}}}}

|{{LanguageExistingEn|{{{1|{{PAGENAME}}}}}}} = {{LanguageLinkEn|{{{1|{{PAGENAME}}}}}}}

|{{LanguageExisting|es|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|es|{{{1|{{PAGENAME}}}}}}}

|{{LanguageExisting|fr|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|fr|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|tr|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|tr|{{{1|{{PAGENAME}}}}}}}
}}</includeonly><noinclude>
'''Note: This is a test for a language toolbar. The template is taken from the openstreetmap-wiki.'''

'''Do not edit this template too often. This template is linked from many pages, when you renew it, the wiki-server starts to rebuild database of link connections. It takes about 20 seconds for each page.'''

Instructions were moved to [[Wiki Translation]]:
{{Languages|Wiki Translation}}

[[Category:Template:Internationalisation]]
</noinclude>

De:Database

2010-12-28T10:21:55Z

Sco:

{{Languages|Database}}

__FORCETOC__
Mit dem [[DB]]-Objekt können Skripte auf eine externe MySQL Datenbank zugreifen. Folgende Tabelle beschreibt die verschiedenen Eigenschaften des DB-Objekts in Sphere.

'''Anm:''' Um das DB-Objekt zu nutzen, muss in der Sphere.ini zunächst MySQL aktiviert und konfiguriert werden.

==Eigenschaften und Funktionen==
Hier eine Auflistung aller Datenbankeigenschaften und -funktioen. Falls eine Funktion als lesbar (mit einem R für readable) markiert ist, dann liefert sie einen Wert zurück, wenn sie in der Form von <KEY> benutzt wird. Um Beispiele und detaillierte Informationen zu erhalten, kann jeweils der Name angeklickt werden. Wenn auf eine Eigenschaft zugegriffen wird, die nicht existiert, dann wird Sphere versuchen auf ein [[ITEMDEF]] zuzugreifen.

{| border="1" cellspacing="4" cellpadding="4"
| '''Name''' || '''Lesbar(R)/Schreibbar(W)''' || '''Beschreibung'''
|-
| [[AEXECUTE]] ''function, command'' || R || Führt in einem Hintergrundthread einen SQL-Befehl aus und ruft ''function'' auf, wenn dieser Vorgang abgeschlossen ist. Liefert 1, wenn der Befehl erfolgreich in die Abarbeitungswarteschlange eingereiht wurde.
|-
| [[AQUERY]] ''function, command'' || R || Führt einen SQL-Befehl in einem Hintergrundthread aus, ruft dann ''function'' auf, wenn das geschehen ist. Liefert 1, wenn der Befehl erfolgreich in die Abarbeitungswarteschlange eingereiht wurde.
|-
| [[CLOSE]] || W || Schliesst die Verbindung zum Datenbankserver.
|-
| [[CONNECT]] || W || Öffnet eine Verbindung zum Datenbankserver mit den Einstellungen aus der Sphere.ini.
|-
| [[CONNECTED]] || R || Liefert 1, wenn die Verbindung zur Datenbank besteht.
|-
| [[ESCAPEDATA]] ''text'' || R || Liefert ''text'' als escaped SQL-String (einige Sonderzeichen werden umgewandelt, um bspw SQL-Injection zu vermeiden).
|-
| [[EXECUTE]] ''command'' || W || Führt einen SQL-Befehl aus, der kein Ergebnis liefert.
|-
| [[QUERY]] ''command'' || W || Führt einen SQL-Befehl aus, der ein Ergebnis liefert.
|-
| [[ROW]].NUMCOLS || R || Liefert die Anzahl der Spalten der letzten Abfrage.
|-
| [[ROW]].NUMROWS || R || Liefert die Anzahl der Zeilen der letzten Abfrage.
|-
| [[ROW]]''.n.col_index'' || R || Liefert den Wert in der Spalte ''col_index'' und der Zeile n (beginnend bei 0)
|-
| [[ROW]]''.n.col_name'' || R || Liefert den Wert einer Spalte, die den Namen ''col_name'' trägt, in der Zeile n (beginnend bei 0)
|}

[[Category: Reference Compendium]]
[[Category: Objects]]

De:Database

2010-12-28T10:20:59Z

Sco: Created page with '{{Languages|Database}} __FORCETOC__ Mit dem DB OBjekt können Skripte auf eine externe MySQL Datenbank zugreifen. Folgende Tabelle beschreibt die verschiedenen Eigenschaften...'

{{Languages|Database}}

__FORCETOC__
Mit dem [[DB]] OBjekt können Skripte auf eine externe MySQL Datenbank zugreifen. Folgende Tabelle beschreibt die verschiedenen Eigenschaften des DB-Objekts in Sphere.

'''Anm:''' Um das DB-Objekt zu nutzen, muss in der Sphere.ini zunächst MySQL aktiviert und konfiguriert werden.

==Eigenschaften und Funktionen==
Hier eine Auflistung aller Datenbankeigenschaften und -funktioen. Falls eine Funktion als lesbar (mit einem R für readable) markiert ist, dann liefert sie einen Wert zurück, wenn sie in der Form von <KEY> benutzt wird. Um Beispiele und detaillierte Informationen zu erhalten, kann jeweils der Name angeklickt werden. Wenn auf eine Eigenschaft zugegriffen wird, die nicht existiert, dann wird Sphere versuchen auf ein [[ITEMDEF]] zuzugreifen.

{| border="1" cellspacing="4" cellpadding="4"
| '''Name''' || '''Lesbar(R)/Schreibbar(W)''' || '''Beschreibung'''
|-
| [[AEXECUTE]] ''function, command'' || R || Führt in einem Hintergrundthread einen SQL-Befehl aus und ruft ''function'' auf, wenn dieser Vorgang abgeschlossen ist. Liefert 1, wenn der Befehl erfolgreich in die Abarbeitungswarteschlange eingereiht wurde.
|-
| [[AQUERY]] ''function, command'' || R || Führt einen SQL-Befehl in einem Hintergrundthread aus, ruft dann ''function'' auf, wenn das geschehen ist. Liefert 1, wenn der Befehl erfolgreich in die Abarbeitungswarteschlange eingereiht wurde.
|-
| [[CLOSE]] || W || Schliesst die Verbindung zum Datenbankserver.
|-
| [[CONNECT]] || W || Öffnet eine Verbindung zum Datenbankserver mit den Einstellungen aus der Sphere.ini.
|-
| [[CONNECTED]] || R || Liefert 1, wenn die Verbindung zur Datenbank besteht.
|-
| [[ESCAPEDATA]] ''text'' || R || Liefert ''text'' als escaped SQL-String (einige Sonderzeichen werden umgewandelt, um bspw SQL-Injection zu vermeiden).
|-
| [[EXECUTE]] ''command'' || W || Führt einen SQL-Befehl aus, der kein Ergebnis liefert.
|-
| [[QUERY]] ''command'' || W || Führt einen SQL-Befehl aus, der ein Ergebnis liefert.
|-
| [[ROW]].NUMCOLS || R || Liefert die Anzahl der Spalten der letzten Abfrage.
|-
| [[ROW]].NUMROWS || R || Liefert die Anzahl der Zeilen der letzten Abfrage.
|-
| [[ROW]]''.n.col_index'' || R || Liefert den Wert in der Spalte ''col_index'' und der Zeile n (beginnend bei 0)
|-
| [[ROW]]''.n.col_name'' || R || Liefert den Wert einer Spalte, die den Namen ''col_name'' trägt, in der Zeile n (beginnend bei 0)
|}

[[Category: Reference Compendium]]
[[Category: Objects]]

De:Chapter 1

2010-12-24T22:44:42Z

Sco: /* Zahlen */

{{Languages|Chapter_1}}

==Zahlen==

Als erstes wird die verschiedenartige Art und Weise zur Verwendung von Zahlen innerhalb der Sphere Skripte behandelt. Da Zahlen naturgemäß sehr wichtig für einen Sphereskripter sind, ist dies der erste Abschnitt überhaupt. Am Ende dieser Einheit wird hoffentlich jeder über ein allgemeines Verständnis über hexadezimale, dezimale und binäre Zahlensysteme und die Verwendung in Sphere Skripten besitzen. Zudem wird noch vermittelt, wie einerseits Zufallszahlen innerhalb eines Zahlenbereichs oder aus einer Liste von Zahlen generiert werden können.

Es muss zunächst verstanden werden: wie wir zählen ist nicht die einzige Art zu zählen. Unser Zahlensystem enthält zehn Ziffern (0, 1, 2, 3, 4, 5, 6, 7, 8, und 9). Ab der zehnten Zahl wird eine weitere Ziffer angehängt und die letzte Stelle auf 0 gesetzt (1, 2, 3, 4, 5, 6, 7, 8, 9, 10). Deshalb funktioniert unser Zahlensystem wie es funktioniert.

Im Dezimalsystem, ohne dass wir davon Notiz nehmen, schreiben wir diese Zahlen immer als Zehnerpotenzen. Beispielsweise die beliebige Zahl 17282 aufgeteilt in Zehnerpotenzen:

{| border="1"
| Zehnerpotenz || 4 || 3 || 2 || 1 || 0
|-
| 10 hoch Zehnerpotenz || 10000 || 1000 || 100 || 10 || 1
|-
| Ziffer || 1 || 7 || 2 || 8 || 2
|}

Um zur Zahl 17282 zu gelangen, wird immer 10 hoch Zehnerpotenz mal der Ziffer in der untersten Zeile berechnet und am Ende alle Ergebnisse addiert. Das Ergebnis: 10000 + 7000 + 200 + 80 + 2. Offensichtlich ist das sehr einfach und jeder tut das ständig ohne davon Notiz zu nehmen. Du fragst dich sicherlich jetzt "Richtig, warum schrieb Taran das alles?" Die Sache ist die, dass unser Zahlensystem nicht das einzige ist.

Computer zählen beispielsweise komplett anders. Sie kennen nur zwei Ziffern (1 und 0) und das wird dann Binärsystem genannt. Binäre Zahlen sehen beispielsweise so aus: 101011101101. Oftmals tauchen sie in der Werbung für Computer auf. Ziffern im Binärsystem werden Bit genannt (kurz für BInary digiT). Binärzahlen im Kopf zu Dezimalzahlen zu berechnen ist meist nicht ohne weiteres möglich, hierfür braucht es ein wenig Mathematik.

Binärsysteme funktionieren wie Dezimalsysteme, es wird eine Potenz einer Zahl addiert. Da Binarzählen nur aus zwei Ziffern bestehen, handelt es sich hierbei um Zweierpotenzen. Manchen wird die folgende Tabelle sicher bekannt vorkommen:

{| border="1"
| Zweierpotenz || Binärzahl || Dezimalzahl
|-
| 0 || 1 || 1
|-
| 1 || 10 || 2
|-
| 2 || 100 || 4
|-
| 3 || 1000 || 8
|-
| 4 || 10000 || 16
|-
| 5 || 100000 || 32
|-
| 6 || 1000000 || 64
|-
| 7 || 10000000 || 128
|-
| 8 || 100000000 || 256
|-
| 9 || 1000000000 || 512
|-
| 10 || 10000000000 || 1024
|}

Spannend oder? :)

Wir brauchen ein besseres System! Der Grund, dass seltsame Ergebnisse auftreten, liegt daran, dasss 10 keine Potenz von 2 ist. Wir brauchen deshalb ein System, das eine Zweierpotenz als Basis hat. Das am meisten genutzte System ist ein 16er System, auch hexadezimal genannt. Im Sphere-Forum sieht man das Wort hex sicherlich an der ein oder andren Stelle, das ist kein Fluch und auch kein böser Zauber. Es ist eine Kurzform für "hexadecimal".

{| border="1"
| Binär || Dezimal || Hexadezimal
|-
| 1 || 1 || 1
|-
| 10 || 2 || 2
|-
| 11 || 3 || 3
|-
| 100 || 4 || 4
|-
| 101 || 5 || 5
|-
| 110 || 6 || 6
|-
| 111 || 7 || 7
|-
| 1000 || 8 || 8
|-
| 1001 || 9 || 9
|-
| 1010 || 10 || A
|-
| 1011 || 11 || B
|-
| 1100 || 12 || C
|-
| 1101 || 13 || D
|-
| 1110 || 14 || E
|-
| 1111 || 15 || F
|-
| 10000 || 16 || 10
|}

Ersichtlich, wie das funktioniert? Es gibt sechs Ziffern, die zusätzlich am Ende des Systems herangezogen werden müssen, es werden üblicherweise hierfür die ersten 6 Buchstaben des Alphabets verwendet.

Innerhalb von Sphere Skripten wird beinahe NIE mit Binärzahlen gearbeitet, die KEINE Potenz von zwei sind und wenn, dann kann jeder herkömmliche Taschenrechner benutzt werden, um sie umzurechnen. Mit Hexadezimalzahlen ist das um einiges einfacher.

(This is the last table, I promise!!)
{| border="1"
| Binär || Hexadezimal
|-
| 000000001 (1) || 01
|-
| 000000010 (2) || 02
|-
| 000000100 (3) || 04
|-
| 000001000 (4) || 08
|-
| 000010000 (5) || 010
|-
| 000100000 (6) || 020
|-
| 001000000 (7) || 040
|-
| 010000000 (8) || 080
|-
| 100000000 (9) || 0100
|}

Wie in der Tabelle ersichtlich gibt es ein Muster in der Hexadezimalspalte. Man könnte meinen, dass da ein Muster in den Zahlen 1, 2, 4 und 8 auftritt. Das stimmt auch. Ein weiteres Detail sind die führenden 0en für Hexadezimalzahlen (0100 statt nur 100). In Sphere bedeutet eine solche führende 0: "Diese Zahl ist eine Hexadezimalzahl!" und dementsprechend sind 100 und 0100 völlig verschiedene Zahlen.

Angenommen in einem Sphere Skript wird das 13. bit in einer Zahl benötigt (FLAGS beispielsweise), dann würde so etwas verwendet werden:

'''SRC.FLAGS |= 8192'''

Allerdings: merkt man sich wirklich, dass 8192 das Ergebnis von 2 hoch 13 ist? Das tut man nicht, es ist viel einfacher diese Liste durch zu gehen, bis man zur 13. Zahl kommt (wichtig: Zählen beginnt immer bei 0!).

{| border="1"
| 01 || 02 || 04 || 08 || 010 || 020 || 040 || 080 || 0100 || 0200 || 0400 || 0800 || 01000 || 02000
|-
| 2^0 || 2^1 || 2^2 || 2^3 || 2^4 || 2^5 || 2^6 || 2^7 || 2^8 || 2^9 || 2^10 || 2^11 || 2^12 || 2^13
|}

Und hier sind sie: die ersten 14 Zweierpotenzen in Hexadezimal.

'''SRC.FLAGS |= 02000'''

Diese Zeile ist identisch zur obigen, nur dass 8192 (dezimal) GLEICH 02000 (hexadezimal) ist.

'''8192 = 02000'''

Nun könnte man sagen "Wie weiß ich, dass das nicht frei erfunden ist?". Nunja, schon der windowseigene Microsofttaschenrechner beherrscht die Umrechnung zwischen Binär-, Hexadezimal-, Dezimal und Oktalzahlen (ein weiteres, aber in Sphere nutzloses Zahlensystem). Der Taschenrechner von Windows befindet sich im Startmenü unter Programme im Zubehör. Im Taschenrechner wird im Menü Ansicht auf Wissenschaftlich umgestellt. Die Oberfläche des Taschenrechners verändert sich dann ziemlich. Um damit eine Zahl zwischen den Systemen umzurechnen, muss nur die originale Zahl eingegeben werden und dann kann zwischen den verschiedenen Zahlensystemen (Hex, Dez, Okt, Bin) umgeschaltet werden. Eine 0 vorne an eine Hexadezimalzahl gehängt und Sphere interpretiert sie als auch als eine hexadezimale Zahl.

Das war vermutlich das schwierigste in allen Sphere Skripten. Glücklicherweise, wegen des nächsten Abschnitts, muss sich ab jetzt niemand mehr mit angsteinflössenden Zahlen beschäftigen. Wenn du nach dieser Einheit noch dabei bist, wird sicher alles gut!

Weiter gehts mit: Skripten für Sphere!

==Defnames==

Hier eine Liste angsteinflössender Zahlen, die man innerhalb von Sphere Skripten antrifft:

{| border="1"
| angsteinflössende Zahl || Was sie bedeutet
|-
| 0eed || ID einer Goldmünze
|-
| 0dda || ID eines roten Moongates
|-
| 1650,1440 || Koordinaten von Britain
|-
| 021 || Farbcode für die Farbe "rot"
|-
| 04000 || Farbcode für unsichtbar
|-
| 04000efad || Eindeutige serielle Nummer eines Gegestands
|-
| 4 || Das PLEVEL eines GMs
|-
| 2048 (or 0800) || Flag für den Unsichtbarkeitszauber
|-
| 010 (or 16) || Memory type für Aggressoren
|}

Offensichtlich will solche Zahlen niemand auswendig kennen. Aber in frühesten Versionen, weit vor Sphere und TUS (vor .50 Sphere) und tief im Nebel von Grayworld (vor .41 TUS), musste jeder Skripter diese Zahlen kennen. I kenne diese Zahlen (ausser die serielle Nummer, die frei erfunden ist) und noch ein paar weitere, allesamt tief verinnerlicht. Glücklicherweise hat sich für jeden, der nicht gern Zahlen auswendig kennen will, Sphere dazu entwickelt, dass Namen statt Zahlen verwendet werden können.

Zwar wird alles mögliche immer noch mit Zahlen verknüpft, aber diese Zahlen sind mittlerweile mit Namen verknpft worden.

Gib im Spiel .add 0eed ein und drücke die Returntaste. Ein Zielcursor taucht auf und es kann eine Goldmünze erschaffen werden.

Nun gib .add i_gold ein und drücke Return. Es passiert genau das selbe.

Natürlich kann man sich i_gold leichter als 0eed merken. Aber wie funktioniert das? Dazu muss die Skriptdefinition von einer Goldmünze angesehen werden. Dieses Skript muss an dieser Stelle noch nicht verstanden werden, Itemskripte werden später genauer behandelt. Dieser Skriptausschnitt findet sich in der Datei sphere_item_resources.scp.

<tt>[ITEMDEF 0eed] 
//gold coin 
DEFNAME=i_gold 
TYPE=T_GOLD 
VALUE=1 
CATEGORY=Provisions - Miscellaneous 
SUBSECTION=Coins 
DESCRIPTION=Gold Coin 
DUPELIST=0eee,0eef </tt>

Die rotmarkierte Zeile ist für diese Lektion von Belang. Ansonsten ist noch die erste Zeile, die 0eed enthält, inteessant, aber der Rest kann getrost ignoriert werden vorerst. Die 0eed ist die Nummer des Items, diese Nummern werden im nächsten Abschnitt behandelt.

Wirklich interessant ist allerdings DEFNAME=i_gold. Diese Zeile legt im Server fest: "Ab jetzt wird 0eed mit i_gold identifiziert". Wird vor dieser Zeile irgendwo innerhalb eines Skripts i_gold verwendet, wird der Server einen Fehler melden (siehe [[Chapter 2|Kapitel 2]] über die Reihenfolge von Skripten), aber jetzt ist ihm bekannt, worauf i_gold verweist und es kann in Skripten oder im Spiel frei verwendet werden.

Es sollte IMMER ein solcher Name mit DEFNAME erstellt werden, wenn ein Item geskriptet wird. Normalerweise wird dieser defname in [ITEMDEF] selbst festgelegt (mehr darüber später), aber wenn unbedingt Zahlen verwendet werden sollen, sollte zudem noch ein einfach zu zu merkender Name verwendet werden (bspw nicht goldenes_gulasch für ein Schwert). Es macht das Leben einfacher, als Zahlen zu benutzen.

Eine zweite Möglichkeit, DEFNAME zu nutzen, ist die Nutzung eines [DEFNAME]-Abschnitts. Hier ein Beispiel dafür:

<tt>[DEFNAME colors] 
color_blue 02 
color_red 021 
color_green 041 </tt>

Ein ähnliches Skript steht in spheredefs.scp, eine weitere Datei, die ganz am Anfang geladen werden sollte.

Hier eine Aufschlüsselung dieses Skripts, Zeile für Zeile:

'''Zeile 1''': Hier wird der Typ des Skripts festgelegt und der Name dafür (Colors in diesem Fall). Hier wird dem Server vermittelt, dass von dieser Zeile bis zum nächsten Identifier (das sind die Zeilen die von eckigen Klammern eingerahmt sind) eine bestimmte Art von Skript enthalten ist. Alle Identifier haben dieses Format. Der erste Parameter legt dabei den Skripttyp fest und davon gibt es mehrere, die in den weiteren Kapiteln abgehandelt werden. Der zweite Parameter ist entweder eine Zahl als ID oder ein Defname. In den meisten Fällen wird in selbst geschriebenen Skripten wird hier ein Defname stehen. Die einzige Ausnahme besteht dann, wenn neue Items in die Clientdateien eingefügt werden.

'''Zeilen 2-4''': Diese Zeilen enthalten individuelle Teile. Es wird festgelegt, dass color_blue gleich 02, color_red gleich 021 und color_green gleich 041 ist. Zwischen dem Namen und dem Wert können beliebig viele Leerzeichen enthalten sein. Die Definitionen in spheredefs.scp sind so ziemlich die nützlichsten auf die man treffen kann, da sie es unnötig machen, viele angsteinflössende Zahlen zu verwenden. In spheredefs.scp werden deshalb Namen für Flags, für Attribute von Items, für verschiedene Töne und Klänge, für Memory Types und viele andere Dinge festgelegt. Einen Blick in diese Datei zu werfen ist sicherlich zuweilen ganz ratsam.

Das wars mit DEFNAMES. Weiteres taucht später in allen möglichen Skripten auf.

Jetzt werden Items abgehandelt.

==ITEMDEF==
Oder: wie macht man aus einem Maulwurfshügel einen Berg auf Sphere-Art.

Die meisten machen sich Itemskripte schwieriger, als es nötig ist. Für die Zwecke dieses Tutorials, da es noch ein weit fortgeschritteneres später gibt, werden hier nur einfach die Grundlagen eines ITEM Skripts behandelt, Zeile für Zeile. Wir werden das Goldskript vom vorherigen Absatz verwenden, vorausgesetzt ich finde es ...

Ok, hier ist es, mit Farbe unterlegt, damit es schöner anzusehen ist!

<spherescript>[ITEMDEF 0eed]
//gold coin
DEFNAME=i_gold
TYPE=T_GOLD
VALUE=1
CATEGORY=Provisions - Miscellaneous
SUBSECTION=Coins
DESCRIPTION=Gold Coin
DUPELIST=0eee,0eef</spherescript>

Das ist das einfachste aller Itemskripts, da es weiteres Verhalten, als einfach nur zu existieren benötigt. Es wird nun jede Zeile erklärt und was es damit auf sich hat:

'''Zeile 1''': [ITEMDEF 0eed]

Die erste Zeile eines Itemskripts ist die wichtigste. Grundsätzlich bedeutet diese Zeile für den Server "Hey, das ist ein Item und es soll 0eed heißen!". Der Server sieht sich dann die Clientdateien an (vor allem art.idx), und gleicht ab, ob das Item eins der eingebauten ist. Ich glaube, alle Items mit Nummern unter 04500 gelten als eingebaut, deshalb sollte nie ein neues Item mit einer Zahl definiert werden, die darunter liegt. Bei Eingabe dieser Zeile, wird der Server wissen, dass ein Itemskript folgt. Außerdem wird 0eed als gültiges Item festgelegt, was später nützlich ist, wenn die Spieler Gold brauchen!

'''Zeile 2''': // gold coin

Das ist die Sphereversion eines Kommentars. C-Programmierer kennen das Format (Anmerkung des Übersetzers: eigentlich kennt man das erst ab C++). Jede Zeile, die mit // beginnt ist eine Kommentarzeile und alles, was in einer Kommentarzeile enthalten ist, wird nicht vom Server interpretiert oder gelesen. Diese Kommentare können aber auch an beliebiger Stelle innerhalb einer Zeile beginnen um am Ende einer Zeile eine Erklärung einzufügen. Auf jeden Fall sind Kommentare nicht für die Funktion des Skriptes relevant, sondern können sie unter Umständen verständlicher machen.

'''Zeile 3''': DEFNAME=i_gold

Du solltest jetzt wissen, was diese Zeile bedeutet. Wenn nicht, dann sollte die vorherige Einheit nochmal wiederholt werden. Es legt im Server fest, dass i_gold und 0eed das selbe sind. In Itemskripten sind alle alle Parameter nach diesem Format spezifiziert:

variable=wert

Später, wenn es um Skripte geht, wird ersichtlicher, dass dieses Format sehr hilfreich ist. Items haben einige Variablen, die belegt werden können, unter anderem:

* DEFNAME
* ID
* TYPE
* VALUE
* RESOURCES
Andere Variablen sind wiederum vom Wert von TYPE abhängig.

'''Zeile 4''': TYPE=t_gold

"Was ist t_gold?" Auch das ist nur ein DEFNAME. Also eine Zahl, in diesem Fall 72. In spheredefs.scp steht diese Zahl, also hätte TYPE=72 den selben Effekt.

Momentan gibt es 183 eingebaute Itemtypen. Sie sind hardcoded (=fest in Sphere implementiert) und enthalten vordefinierte Verwendungszwecke für einen Gegenstand. Hat ein Gegenstand keinen Typ, dann erhält man eine "You cannot think of a way to use that item"-Nachricht, wenn man im Spiel das Item anklickt. Es gibt eine vollständige Liste von Itemtypen und wie sie genutzt werden. Der Typ t_gold hat nur einen Effekt: der Gegenstand wird behandelt wie eine Goldmünze (d.h: es können damit Dinge gekauft werden!). Andere Gegenstände den Typ t_gold zu geben würde den Server dazu veranlassen auch diese Dinge als Währung heran zu ziehen. Ich habe das nie versucht, aber es könnte eine interessanter Weg sein einzigartige Währungen zu haben ...

'''Zeile 5''': VALUE=1

Diese Zeile legt fest, wie viel ein Item wert ist, wenn es gekauft wird - in Gold. Natürlich ist eine Goldmünze eine Goldmünze wert, deshalb wird der Wert hier auf 1 gesetzt.

'''Zeilen 6-8''': CATEGORY, SUBSECTION, DESCRIPTION

Diese Zeilen werden nur von Spheres GM-Tool, Axis, benutzt, das es unnötig macht, im Spiel ".add i_gold" einzugeben. Wichtiger noch, es übernimmt solche Aufgaben auch für Items, die keinen DEFNAME haben, sondern nur eine Nummer.

'''Zeile 9''': DUPEITEM

Es wäre viel Arbeit für das Sphereteam alle 8000 Items im Spiel zu definieren, vor allem, wenn viele eigentlich ein und das selbe sind. (Beispielsweise kann eine Tür mit dem Befehl .xflip gedreht werden. Dieser Befehl läuft durch alle DUPEITEMS, die für ein Item angegeben sind.) Die Liste von Nummern sind Itemnummern, die vielleicht noch nicht definiert wurden. Hier wäre das Skript für 0eee:

<spherescript>[ITEMDEF 0eee]
//gold coins
DUPEITEM=0eed
CATEGORY=Provisions - Miscellaneous
SUBSECTION=Coins
DESCRIPTION=Gold Coins</spherescript>

In diesem Skript gibt es nur einen Parameter für das Item. Es verweist den Server auf das DUPEITEM, das unter 0eed (oder i_gold) angelegt wurde, um die Informationen von dort, wie TYPE und VALUE zu verwenden. DUPEITEM spart Tipparbeit, wahrscheinlich wird es selten benutzt.

==CHARDEF==
Oder was es braucht, einen nackten Mann zu machen, der rumstehen und "Huh?" sagen kann.

NPCs machen die Welt lebendig. Sie sind das, was UO zu einem einzigartigen Multiplayer Spiel macht. Die Monster und NPCs die du skriptest machen den Server einzigartig im Vergleich zu jedem anderen. Dieser Abschnitt des ersten Kapitels wird beinhalten, wie ein einfacher nackter Mann geskriptet wird, der herumwandern und ein wenig mehr als "Huh?" (oder "Halt Dieb!", wenn man so will) sagen kann.

Als erstens sehen wir uns das SKript eines einfachen nackten Mannes an. Es befindet sich in spherechar_human.scp.

<spherescript>[CHARDEF 0190]
DEFNAME=c_man
Name=Man
ICON=i_pet_MAN
CAN=MT_EQUIP|MT_WALK|MT_RUN|MT_USEHANDS
RESOURCES=i_flesh_head, i_flesh_torso, i_flesh_right_arm, i_flesh_left_arm
FOODTYPE=15 t_food, t_fruit
DESIRES=i_gold,e_notoriety
AVERSIONS=t_TRAP,t_eerie_stuff
SHELTER=r_house
BLOODCOLOR=0

TSPEECH=spk_human_prime
TSPEECH=spk_human_default
TEVENTS=e_Human_HearUnk
DESCRIPTION=Man
SUBSECTION=Miscellaneous
CATEGORY=Civilized</spherescript>

Wie ersichtlich sieht es sehr viel anders aus als die Skripte der vorherigen Abschnitte. Es werden eine ganze Menge an Variablen gesetzt, die gleich sind wie der DEFNAME, DESCRIPTION und die anderen Axis Variablen.

Aber es gibt auch eine Menge neuer Dinge hier, die der Reihe nach und Zeile für Zeile betrachtet werden! Und es ist länger diesmal! Let the good times roll! (Entschuldigung an alle Nichtamerikaner, alle amerikanischen Cliches sind vermutlich irritierend!)

'''Zeile 1''': [CHARDEF 0190]

Überraschung! Ein Identifier, der dem Server mitteilt, dass hier ein Charakter bis zum zum nächsten Identifier definiert wird. Und zudem wird für diesen Charakter bzw. NPC die ID 0190 gesetzt. Der Server kennt diese ID, da es eine eingebaute ist. In der Tat gehört diese ID zum nackten Mann. Des weiteren steht 0190 als hexadezimale Zahl natürlich für 400, nicht wahr? :) Warum weißt du das nicht? OK, nur ein Witz, das muss man natürlich nicht wissen.

'''Zeile 2''': DEFNAME=c_man

Nichts neues. c_man entspricht hiermit 0190. Die meisten DEFNAMES für Charaktere beginnen mit c und dann folgt ein _ wie oben.

'''Zeile 3''': Name=Man

Hier ist etwas neues. Items haben einen vorgebenen Namen, der im Server bekannt ist. Charaktere nicht. Deshalb muss ein Name zugewiesen werden. Es kann im Grunde jeder Name zugewiesen werden, den man hier haben möchte, aber da das kein spezifischer Mann ist, heißt er einfach nur Man.

'''Zeile 4''': ICON=i_pet_man

Ich brauchte eine Weile, um das herauszufinden. ICON legt ein kleines Bildchen fest, das man bei benutzung des Tracking Skills sieht und diese kleinen ICONs tauchen im Menü dort auf. Eigentlich sind diese Bildchen Items. Um herauszufinden, wie dieses Bildchen aussieht, kann der Mann einfach im Spiel mit .addnpc c_man erstellt werden und dann der .shrink Befehl auf ihn angewendet werden. Die ID dieses Items wird dann zum i_pet Item.

'''Zeile 5''': CAN=mt_*

(Falls * nicht bekannt ist: * heisst "alles mögliche" für diejenigen, die Linux nutzen.)

Das ist eine der wichtigsten Zeilen im Character Skript, neben der ID die in der ersten Zeile vergeben wird. Sie lässt uns festlegen, was ein NPC tun kann und was nicht. Es gibt nur ein paar wenige Möglichkeiten für mt_*, die alle in der spheredefs.scp definiert sind. Für unsere Zwecke sind sie hier hin kopiert worden.

<spherescript>MT_NONMOVER 0 // We can't move at all
MT_GHOST 01 // We can walk through doors and such, like a ghost
MT_SWIM 02 // I can swim! (Water elementals, dolphins, etc)
MT_WALK 04 // I can move. Set this if you want your creature to move.
MT_FLY 010 // Moves through (supposed to be over) trees
MT_FIRE_IMMUNE 020 // Immune to damage by fire. Setting this on a player is bad. :)
MT_EQUIP 00100 // Can equip things
MT_USEHANDS 00200 // Can use his hands to carry things (or open doors)
MT_MALE 0 // Is a male
MT_FEMALE 00800 // Is a female
MT_NONHUM 01000 // Non-human. I'm not sure what this does.
MT_RUN 02000 // Can move really fast!</spherescript>

Nach dieser Tabelle wird klar, dass ein NPC ohne CAN Flags ein MT_Male und MT_NONMOVER (zweimal 0) ist. Die Flags können durch ein | (Alt Gr + <) getrennt in einer Liste angegeben werden, so dass ein NPC mehrere solcher Flags erhalten kann. In diesem Fall erlauben wir unserem Mann, dass er etwas ausrüsten (oder anziehen), gehen, rennen und seine Hände benutzen kann. (Interessant ist, dass sogar Kreaturen ohne Hände ihre Hände nutzen können und damit bspw. Lichtquellen tragen können. Feuerelementare tun das beispielsweise, deshalb leuchten sie.)

'''Zeile 6''': RESOURCES

Die Resources sind etwas morbide als Bezeichnung. Vor allem für Personen, denn sie enthalten die Items, die herauskommen, wenn man im Spiel eine Leiche aufschneidet. Gruslig, hm?

'''Zeile 7-10''': FOODTYPE, DESIRES, AVERSIONS

'''FOODTYPE''': Legt fest, welche Art von Essen der NPC essen würde und wenn NPC_AI_FOOD aktiviert ist, sucht der NPC nach so einem Essen wenn er hungrig wird.

'''DESIRES''': Legt fest, welche Art von Items ihn interessieren und wenn NPC_AI_EXTRA aktiviert ist, dann wird ein NPC aus Spielerleichen diese Gegenstände holen oder, falls diese Gegenstände am Boden liegen, zu ihnen hingehen.

'''AVERSIONS''': Das ist nicht ganz klar. Ich nehme an, dass diese Option angibt, was der NPC am liebsten angreift. Beispielsweise: Ich habe ein Pferd mit dem Event e_horse und einen Imp mit AVERSIONS=e_horse, dann würde im Falle eines Kampfs der IMP wohl vorziehen gegen das Pferd zu kämpfen.

'''Zeile 11''': BLOODCOLOR

Jemals vorgehabt den Spielern grünes Blut zu verpassen? Das geht hiermit. Eine Nummer für eine Farbe oder ein DEFNAME funktioniert hier. (Für Farben sollte man versuchen die Zahlen zu lernen, das macht es einfacher.)

Der Rest: TSPEECH and TEVENTS

Diese beiden Zeilen erhalten eigene Kapitel. Sie sind sehr komplex und mitunter die komplexesten Dinge beim Skripten! (Wie oft ich das wohl sagen werde, bis das wirklich wahr ist?)

''Einige andere Dinge:''

Auf 56B gibt es weitere Variablen wie MOVERATE, RESLEVEL, RESDISPDNID and RESDISPDNHUE. Sie klingen schwierig und seltsam, aber das sind sie nicht. Hier ist eine Erklärung:

'''MOVERATE''': Diese Einstellung (die nur innerhalb eines CHARDEF Blocks sein kann) legt fest, wie schnell sich ein NPC bewegt. Je kleiner der Wert, desto schneller ist ein NPC. Beispielsweise für ein Pferd mit vorgegebener MOVERATE von 100, wäre ein anderer NPC mit MOVERATE von 60 schneller als das Pferd. Das ist ganz gut, um schwierige Monster zu skripten, die nur schwer zu erlegen sind.

'''RESLEVEL''': Das sagt Sphere aus welcher Version von UO das Monster abstammt, Beispielsweise hat ein "Wanderer of the Void" RESLEVEL=3 (3 ist AOS) (siehe spheredefs.scp für eine Liste), so dass nur Accounts mit RESDISP 3 oder größer das Monster so sehen, wie es wirklich aussieht.

''NOTE'': Setzt man einen zu niedrigen Wert für RESLEVEL und der Spieler hat die passende Animation nicht, führt das zum Absturz seines Clients.

'''RESDISPDNID''': Wie wahrscheinlich bemerkt, sagte ich oft nun "wie er wirklich" ist, genau wegen dieser Einstellung. Das legt fest, wie ein Monster für einen Spieler aussieht, hat er die Animation nicht. Beispielsweise wird der Wanderer of the Void für jeden mit ACCOUNT.RESDISP=3 oder großer auch wie ein Wanderer of the Void aussehen, aber für alle anderen sieht er wie ein c_spectre aus (wenn es so eingestellt wurde).

'''RESDISPDNHUE''': Das legt fest, welche Farbe für den Spieler das Monster hat, wenn die RESDISPDNID angezeigt wird (und sein account.resdisp kleiner als reslevel dieses Charakters ist).

Hier ist ein Beispiel für diese neuen Einstellungen:

<spherescript>[CHARDEF 310]
DEFNAME=c_Wailing_Banshee
NAME=Wailing Banshee
SOUND=snd_monster_zombie1
ICON=i_pet_wailingbanshee
DAM=11,16
RESDISPDNID=c_spectre
RESLEVEL=3
RESDISPDNHUE=01
ARMOR=20
CAN=MT_WALK|MT_FLY
DESIRES=i_gold,e_notoriety,e_horses,c_man,c_woman,t_corpse
CATEGORY=New Monsters
SUBSECTION=AOS
DESCRIPTION=Wailing Banshee

ON=@Create
NPC = brain_monster
FAME = {100 3000}
KARMA = {-5000 -6999}
STR = {126 166}
INT = {86 115}
DEX = {41 75}
MAGICRESISTANCE = {75.0 95.0}
TACTICS = {45.0 75.0}
WRESTLING = {50.0 70.0}

ON=@NpcRestock
ITEM = i_gold, {50 100}
ITEM = i_reag_daemon_bone, {2 6}</spherescript>

Und das wars. Einfache Charakterskripte und ein paar neue Dinge. Es gibt dazu noch ein spezielles Kapitel nur über das Skripten von NPCs später.

==TEMPLATE==
Oder wie man eine große Menge serverbelastender Items in einen nichtserverbelastenden Container packt.

Jeder hat sie schon gesehen. Die Shards, die keine TEMPLATEs benutzen. Wird beispielsweise ein Drache auf diesen Shards erlegt und lootet man ihn dann, dann findet man statt schön abgepackte Behälter ein paar 100 Tränke im Lootfenster verteilt. Nicht nur das, alle magischen Gegenstände sind auch noch darunter vergraben!

Wie wird das Problem gelöst? Sphere hat ein sehr handhabbares Werkzeug: die TEMPLATES. Sie erlauben, dass Container Items definiert werden und die Items in diesen Containern ebenfalls und zwar gleichzeitig. Das ist doch toll? I dachte es mir, als ich heraus fand, was sie sind. Deshalb wieder eine Zeile für Zeile Aufschlüsselung, diesmal mit einem TEMPLATE aus spheretemp_loot.scp.

<tt>[TEMPLATE 101505] 
DEFNAME=backpack_poor 
CATEGORY=Item Templates 
SUBSECTION=Loot Templates 
DESCRIPTION=Poor Backpack 
CONTAINER=i_backpack 
ITEM={ random_food 1 0 3 },{ 1 3 } 
ITEM={ random_bottle 1 0 8 } 
ITEM={ random_light 1 0 8 } 
ITEM={ random_male_tops 1 0 4 } 
COLOR=colors_all 
ITEM={ random_male_pants 1 0 4 } 
COLOR=colors_all 
ITEM=POOR_GOLD_PILE </tt>

Sieht verwirrend aus. Aber kein Problem, das wird schon alles klar werden, was das bedeutet!

[TEMPLATE 101505]: Als erstes wird die Kopfzeile des templates betrachtet. Interessant an Templates ist, dass der Itemname kein DEFNAME sein kann, sondern eine sehr hohe Zahl sein muss.

DEFNAME=backpack_poor: Natürlich sind die Sphere Entwickler nicht bösartig und haben deshalb hier noch die Möglichkeit eines DEFNAMEs eingeführt.

CATEGORY, SUBSECTION, DESCRIPTION: Der übliche Axiskram. Optional natürlich. In den vorherigen Abschnitten wird das genauer erklärt.

CONTAINER=i_backpack: Ok, nun gehts runter bis aufs Eingemachte. Das ist der Container, der benutzt wird und alle anderen Items landen in diesem. Wenn der Container im Spiel erstellt wird, dann sieht man ihn. In diesem Fall ist das ein Rucksack. Ganz einfach. Hier kann nur ein gültiger Container vom Typ t_container oder t_container_locked angegeben werden.

ITEM={ random_food 1 0 3},{1 3} Das sieht ziemlich kryptisch aus. Deshalb wird diese Zeile ein wenig eingehender beleuchtet.

Als erstes muss ZUFALLSAUSWAHL behandelt werden! Klingt nach Spaß, nicht? Nun ja, klingt auch für mich nicht danach, aber es ist unbedingt notwendig, um einen guten Shard zu bauen.

Sie sind einfache grundlegende Mechanismen, um mit einem Befehl eine zufällige Zahl zu erhalten. Was wäre das schon für ein Shard, auf dem jeder getötete Drache auch eine Platemail of Magic Stuff und ein Super Duper Sword of Power liefern würde? Jeder würde damit herumlaufen, deshalb braucht es etwas Variabilität.

Es gibt zwei Arten von Zufallsauswahlen: gewichtete und bereichsweise Auswahl. Gewichtete Auswahlen funktionieren so: "OK, 1 mal von 10 nimm Nummer A, 3 mal von 10 nimm Nummer B und 6 mal von 10 nimm Nummer C". Bereichsweise Auswahlen funktionieren so: "Wähle eine zufällige Zahl zwischen zwei Zahlen, die ich festlege".

Unser Beispiel nutzt beides - sowohl bereichsweisen als auch gewichteten Zufall. Der Reihe nach:

{ random_food 1 0 3}

Das ist eine gewichtete Auswahl. Um das richtig zu verstehen, wird der Ausdruck zwischen den Klammern in zwei Teile zerlegt:

random_food 1
0 3

Addiert man die letzte Zahl in den beiden Zeilen, erhält man 4. Das sagt Sphere "OK, 1 von 4 Mal, will ich random_food und 3 von 4 Mal wähle ich 0." Man kann auch Zufallsauswahlen verschachteln, aber das wird dann verwirrend.

{ { random_food 1 0 3} 1 random_clothing 1}

Klar, was das heisst?

random_clothing 1
{ random_food 1 0 3} 1

2 ist hier die magische Zahl. Einmal von 2 nimmt Sphere random_clothing und einmal von 2 nimmt Sphere den vorherigen Auswähler, der dann aus seinen eigenen Optionen eins auswählt. Wenn du jetzt schon verwirrt bist, keine Sorge. Das ist sehr selten, aber es wird sich zeigen, wie TEMPLATES diese Probleme lösen können.

Ich habe erwähnt, dass es noch einen weiteren Zufallswähler gibt. Und dieser ist hier:

{1 3}

Anmerkung: Leerzeichen sind hier wichtig. Hier dürfen keine Leerzeichen zwischen { und der ersten Zahl oder } und der letzten Zahl sein. Ansonsten kommt seltsames Verhalten dabei heraus.

Das weist Sphere an "Nimm eine beliebige Zahl zwischen 1 und 3, inklusive". Inklusive heißt, dass Sphere auch 1 und 3 wählen kann oder eben jede Zahl dazwischen. In diesem Fall ist der Bereich sehr beschränkt. Sphere wird eine 1, 2 oder eine 3 liefern. Bereichsweise Auswähler werden oftmals in gewichteten Auswählern benutzt.

{ {1 3} 3 {4 9} 1}

"Einmal aus 4, nimm eine Zahl zwischen 4 und 9. Dreimal von 4, nimm eine Zahl zwischen 1 und 3."

Nachdem wir das nun hinter uns haben, sehen wir uns die Zeile des Skripts von oben an. Der Teil mit ITEM= 
Das legt im Skript fest "Ok, wir werden jetzt ein Item zum Container hinzufügen". Alles nach dem = legt fest, was genau das ist und in welcher Menge. Es kann natürlich geskriptete werden ITEM=i_platemail_chest oder sonst was ohne die mysteriösen { } Auswähler, aber der Grund, warum TEMPLATES so interessant sind, ist die große Variabilität, die sie bringen.

{ random_food 1 0 3}

Das ist das Item, das erstellt wird. Aus der Einheit über gewichtete Zufallsauswahlen, 1 von 4 Mal, wird das random_food sein und 3 von 4 Mal, wird das 0 sein. Wenn ein Item 0 ist, dann wird nichts erstellt. Das bedeutet: "Hier gibt es eine 1 zu 4 Chance, dass random_food im Container auftaucht." Was random_food ist? Das ist ein weiteres TEMPLATE, das in spheretemplate.scp definiert wurde ... glaube ich.

{1 3} Ist die Menge des Items, die erstellt wird. Das ist eine zufällige Bereichsauswhl. Sphere nimmt eine Zahl zwischen 1 und 3 und setzt dann die Menge im Container. Natürlich: ist das Item zuvor 0 geworden, dann wird auch die Menge daran nichts ändern, denn 3 mal 0 ist weiterhin 0.

Das war grundlegend das Template Skript. Hier können noch so viele Items eingefügt werden, wie man Lust hat. Ausserdem ist noch folgendes Konstrukt dann interessant:

ITEM=i_sword_long,R11

Das ist eine Kurzform von:

ITEM={ i_sword_long 1 0 10 }

R11 bedeutet: "1 zu 11 Chance, dass das Item gefunden wird". Und zusätzlich kann noch eine Mengenauswahl hinten angehängt werden, was es ziemlich seltsam aussehen lässt:

ITEM=i_sword_long,R11,{4 5}

Aber warum würde man 4 oder 5 Langschwerter haben wollen? Das wäre noch seltsamer. :)

Das wars von Templates. Gratulation, das erste Kapitel ist hiermit durch. Jetzt sollten die Beispiele im nächsten Abschnitt nicht schwierig zu verstehen sein. Du könntest auch einige fragen haben, die hier allerdings ohnehin nicht beantwortet werden. Einfach weiterlesen, es wird noch vieles in den folgenden Kapiteln abgehandelt.

''(Ein Template Beispiel von Belgar)''

<tt>[TEMPLATE tm_necromancer] 
CONTAINER=i_bag 
ITEM=random_necro_scroll 
ITEM=random_necro_scroll 
ITEM=random_necro_reagent, {5 12} 
ITEM=random_reagent, {5 12} 
ITEM=random_necro_reagent, {5 12} </tt>

==Beispiele==
Oder ... naja, glaub es gibt kein anderes Wort für "Beispiele".

Das soll mein Versuch sein, einfachste simpelste Items zu erstellen. Du wirst hier einige DInge in diesen Beispielen sehen, die in den Tutorials nicht behandelt wurden. Hauptsächlich gibts hier ein ON=@create das im 2. Kapitel abgehandelt wird. Für die Beispiele ist nur wichtig, dass die Farbe der Dinge im Spiel geändert werden kann und dass das unter on=@create passieren muss.

'''Beispiel 1''': Ein rotes Schwert

<tt>[ITEMDEF i_sword_red] 
ID=i_sword_viking 
TYPE=t_weapon_sword 
NAME=Das rote Schwert 
CATEGORY=Weapons 
SUBSECTION=New Swords 
DESCRIPTION=Red Sword 

ON=@Create
:COLOR=colors_red // Das ist ein Kommentar. Kommentare werden von Sphere ignoriert. </tt>

Moment ... was heisst das // an dieser Stelle? Das ist ein Kommentar, er wird gänzlich von Sphere ignoriert, deshalb kann hier alles stehen, solange es hinter den // steht. Es gibt in Sphere keine mehrzeiligen Kommentare, solange man nicht jede Zeile mit // beginnen lässt. Deshalb sollte man das gar nicht versuchen, sonst wird Sphere viele Fehler ausgeben und man darf sie suchen.

'''Beispiel 2''': Ein blauer Ettin

<tt>[CHARDEF c_ettin_blue] 
ID=02 // Hier kann auch c_ettin benutzt werden natürlich. 
NAME=Mein blauer Ettin 
 
 
ON=@Create 
:COLOR=02 // Das ist dunkelblau. Wird oft für Counselorroben benutzt. Merken. </tt>

'''Beispiel 3''': Ein Template aus einer der Dateien, weil ich zu faul bin eins selbst zu schreiben

<tt>[TEMPLATE 101521] 
DEFNAME=goodie_meager_1 
CATEGORY=Item Templates 
SUBSECTION=Loot Templates 
DESCRIPTION=Meager Goodie 1 
ITEM={ meager_gold_pile 1 backpack_meager 1 pouch_meager 1 } 
ITEM={ random_boots 1 0 4 } 
ITEM={ random_gorget 1 0 4 } 
ITEM={ random_staff 1 0 4 } 
ITEM={ random_necklace 1 0 4 } 
ITEM={ i_cape 1 0 9 } 
COLOR=colors_all </tt>

Bemerkenswert ist hier etwas neues (das speziell in rot hervorgehoben ist) und ja, das kann man so schreiben. Alle Zeilen zwischen ITEM= Zeilen betreffen das zuvor erstelle Item. COLOR= bezieht sich also auf die Zeile

ITEM={ i_cape 1 0 9 }

Der beste Weg diese Art von Skripten zu lernen, liegt darin, dass man die Skripte in den Dateien wie beispielsweise sphereitem_colorarm.scp und sphereitem_beers.scp liest.

[[Category:Tutorials]]

De:Intrinsic Functions

2010-12-08T08:58:50Z

Sco:

{{Languages|Intrinsic_Functions}}

Intrinsic Funktionen sind spezielle Funktionen, die nur innerhalb von "evals", wie bspw. [[EVAL]], [[FEVAL]], [[FVAL]] und [[HVAL]] benutzt werden können. Manche der eingebauten Funktionen sind sehr speziell und können automatisch übergebene Paramater automatisch evaluieren, wie bspw [[IF]] und [[WHILE]], wodurch in solchen Fällen Intrinsics nicht innerhalb eines "evals" benutzt werden müssen.

Anders als die normale Syntax für Funktionen (<FUNCTION args>), ist die Syntax bei der Verwendung eines Intrinsics:

<tt>FUNCTION(''args'') </tt>

Folgende Tabelle listet alle in Sphereserver verfügbaren Instricfunktionen auf:

{| border="1" cellspacing="4" cellpadding="4"
| '''Name''' || '''Description'''
|-
| [[COS]](''value'') || Berechnet den Kosinus von ''value''.
|-
| [[ID]](''defname'') || Berechnet die ID eines ''defname''s.
|-
| [[ISOBSCENE]](''text'') || Liefert 1, wenn der ''text'' Wörter aus der OBSCENE-Liste enthält (siehe [[De:Chapter 2|Kapitel 2]]).
|-
| [[ISNUMERIC]](''value'') || Liefert 1, wenn ''value'' eine Zahl ist.
|-
| [[LOGARITHM]](''value'') || Liefert den Logarithmus von ''value'' zur Basis 10.
|-
| [[LOGARITHM]](''value'', ''base'') || Liefert den Logarithmus von ''value'' zur Basis ''base''. Für die Basis kann "e", "pi" oder ein beliebiger Zahlenwert angegeben werden.
|-
| [[NAPIERPOW]](''value'') || Liefert e (2.7182818) hoch ''value''.
|-
| [[QVAL]](''a, b, kleiner_als, gleich, größer_als'') || Liefert ''kleiner_als'', wenn ''a'' kleiner als ''b'', ''gleich'' wenn ''a'' gleich ''b'' und ''größer_als'' wenn ''a'' größer als ''b'' ist.
|-
| [[RAND]](''value'') || Liefert eine Zufallszahl zwischen 0 und ''value'' - 1.
|-
| [[RAND]](''min, max'') || Liefert eine Zufallszahl zwischen ''min'' und ''max''.
|-
| [[RANDBELL]](''value, variance'') || Berechnet eine Zufallszahl basierend auf einer Glockenkurve (siehe: [http://de.wikipedia.org/wiki/Normalverteilung Normalverteilung]).
|-
| [[SIN]](''value'') || Liefert den Sinus von ''value''.
|-
| [[STRCMP]](''string1, string2'') || Vergleicht ''string1'' mit ''string2'' und liefert das Ergebnis. Unterscheidet zwischen Groß- und Kleinschreibung. (<= 1 = ''string1'' kleiner als ''string2'', 0 = ''string1'' gleich ''string2'', >= 1 = ''string1'' größer als ''string2'')
|-
| [[STRCMPI]](''string1, string2'') || Vergleicht ''string1'' mit ''string2'' und liefert das Ergebnis. Unterscheidet nicht zwischen Groß- und Kleinschreibung. (<= 1 = ''string1'' kleiner als ''string2'', 0 = ''string1'' gleich ''string2'', >= 1 = ''string1'' größer als ''string2'')
|-
| [[STRINDEXOF]](''text, search, n'') || Liefert den Index von eines ersten Auftreten von ''search'' innerhalb von ''text'', beginnend beim ''n''ten Buchstaben. (0 ist der erste Buchstabe)
|-
| [[STRLEN]](''text'') || Liefert die Länge von ''text''.
|-
| [[STRMATCH]](''pattern, text'') || Liefert 1, wenn ''text'' zum angegebenen Wildcard ''pattern'' passt.
|-
| [[STRREGEX]](''pattern, text'') || Liefert 1, wenn 1 if ''text'' zum angegebenen regulären Ausdruck ''pattern'' passt.
|-
| [[SQRT]](''value'') || Liefert die Quadratwurzel von ''value''.
|-
| [[TAN]](''value'') || Liefert den Tangens von ''value''.
|}

[[Category: Reference Compendium]]
[[Category: Scripts]]

De:Intrinsic Functions

2010-12-08T08:57:24Z

Sco:

{{Languages|Intrinsic_Functions}}

Intrinsic Funktionen sind spezielle Funktionen, die nur innerhalb von "evals", wie bspw. [[EVAL]], [[FEVAL]], [[FVAL]] und [[HVAL]] benutzt werden können. Manche der eingebauten Funktionen sind sehr speziell und können automatisch übergebene Paramater automatisch evaluieren, wie bspw [[IF]] und [[WHILE]], wodurch in solchen Fällen Intrinsics nicht innerhalb eines "evals" benutzt werden müssen.

Anders als die normale Syntax für Funktionen (<FUNCTION args>), ist die Syntax bei der Verwendung eines Intrinsics:

<tt>FUNCTION(''args'') </tt>

Folgende Tabelle listet alle in Sphereserver verfügbaren Instricfunktionen auf:

{| border="1" cellspacing="4" cellpadding="4"
| '''Name''' || '''Description'''
|-
| [[COS]](''value'') || Berechnet den Kosinus von ''value''.
|-
| [[ID]](''defname'') || Berechnet die ID eines ''defname''s.
|-
| [[ISOBSCENE]](''text'') || Liefert 1, wenn der ''text'' Wörter aus der OBSCENE-Liste enthält (siehe [[De:Chapter 2|Kapitel 2]]).
|-
| [[ISNUMERIC]](''value'') || Liefert 1, wenn ''value'' eine Zahl ist.
|-
| [[LOGARITHM]](''value'') || Liefert den Logarithmus von ''value'' zur Basis 10.
|-
| [[LOGARITHM]](''value'', ''base'') || Liefert den Logarithmus von ''value'' zur Basis ''base''. Für die Basis kann "e", "pi" oder ein beliebiger Zahlenwert angegeben werden.
|-
| [[NAPIERPOW]](''value'') || Liefert e (2.7182818) hoch ''value''.
|-
| [[QVAL]](''a, b, kleiner_als, gleich, größer_als'') || Liefert ''kleiner_als'', wenn ''a'' kleiner als ''b'', ''gleich'' wenn ''a'' gleich ''b'' und ''größer_als'' wenn ''a'' größer als ''b'' ist.
|-
| [[RAND]](''value'') || Liefert eine Zufallszahl zwischen 0 und ''value'' - 1.
|-
| [[RAND]](''min, max'') || Liefert eine Zufallszahl zwischen ''min'' und ''max''.
|-
| [[RANDBELL]](''value, variance'') || Berechnet einen Wert basierend auf einer Glockenkurve (siehe: [http://de.wikipedia.org/wiki/Normalverteilung Normalverteilung]).
|-
| [[SIN]](''value'') || Liefert den Sinus von ''value''.
|-
| [[STRCMP]](''string1, string2'') || Vergleicht ''string1'' mit ''string2'' und liefert das Ergebnis. Unterscheidet zwischen Groß- und Kleinschreibung. (<= 1 = ''string1'' kleiner als ''string2'', 0 = ''string1'' gleich ''string2'', >= 1 = ''string1'' größer als ''string2'')
|-
| [[STRCMPI]](''string1, string2'') || Vergleicht ''string1'' mit ''string2'' und liefert das Ergebnis. Unterscheidet nicht zwischen Groß- und Kleinschreibung. (<= 1 = ''string1'' kleiner als ''string2'', 0 = ''string1'' gleich ''string2'', >= 1 = ''string1'' größer als ''string2'')
|-
| [[STRINDEXOF]](''text, search, n'') || Liefert den Index von eines ersten Auftreten von ''search'' innerhalb von ''text'', beginnend beim ''n''ten Buchstaben. (0 ist der erste Buchstabe)
|-
| [[STRLEN]](''text'') || Liefert die Länge von ''text''.
|-
| [[STRMATCH]](''pattern, text'') || Liefert 1, wenn ''text'' zum angegebenen Wildcard ''pattern'' passt.
|-
| [[STRREGEX]](''pattern, text'') || Liefert 1, wenn 1 if ''text'' zum angegebenen regulären Ausdruck ''pattern'' passt.
|-
| [[SQRT]](''value'') || Liefert die Quadratwurzel von ''value''.
|-
| [[TAN]](''value'') || Liefert den Tangens von ''value''.
|}

[[Category: Reference Compendium]]
[[Category: Scripts]]

De:Intrinsic Functions

2010-12-08T08:55:08Z

Sco: Created page with '{{Languages|Intrinsic_Functions}} Intrinsic Funktionen sind spezielle Funktionen, die nur innerhalb von "evals", wie bspw. EVAL, FEVAL, [[FVAL und HVAL benutzt werde...'

{{Languages|Intrinsic_Functions}}

Intrinsic Funktionen sind spezielle Funktionen, die nur innerhalb von "evals", wie bspw. [[EVAL]], [[FEVAL, [[FVAL]] und [[HVAL]] benutzt werden können. Manche eingebauten Funktionen sind sehr speziell und können automatisch übergebene Paramater aufotmatisch evaluieren, wie bspw [[IF]] und [[WHILE]], wodurch Intrinsics nicht innerhalb eines "evals" benutzt werden müssen.

Anders als die normale Syntax für Funktionen (<FUNCTION args>), ist die Syntax bei der Verwendung eines Intrinsics:

<tt>FUNCTION(''args'') </tt>

Folgende Tabelle listet alle in Sphereserver verfügbaren Instricfunktionen auf:

{| border="1" cellspacing="4" cellpadding="4"
| '''Name''' || '''Description'''
|-
| [[COS]](''value'') || Berechnet den Kosinus von ''value''.
|-
| [[ID]](''defname'') || Berechnet die ID eines ''defname''s.
|-
| [[ISOBSCENE]](''text'') || Liefert 1, wenn der ''text'' Wörter aus der OBSCENE-Liste enthält (siehe [[De:Chapter 2|Kapitel 2]]).
|-
| [[ISNUMERIC]](''value'') || Liefert 1, wenn ''value'' eine Zahl ist.
|-
| [[LOGARITHM]](''value'') || Liefert den Logarithmus von ''value'' zur Basis 10.
|-
| [[LOGARITHM]](''value'', ''base'') || Liefert den Logarithmus von ''value'' zur Basis ''base''. Für die Basis kann "e", "pi" oder ein beliebiger Zahlenwert angegeben werden.
|-
| [[NAPIERPOW]](''value'') || Liefert e (2.7182818) hoch ''value''.
|-
| [[QVAL]](''a, b, kleiner_als, gleich, größer_als'') || Liefert ''kleiner_als'', wenn ''a'' kleiner als ''b'', ''gleich'' wenn ''a'' gleich ''b'' und ''größer_als'' wenn ''a'' größer als ''b'' ist.
|-
| [[RAND]](''value'') || Liefert eine Zufallszahl zwischen 0 und ''value'' - 1.
|-
| [[RAND]](''min, max'') || Liefert eine Zufallszahl zwischen ''min'' und ''max''.
|-
| [[RANDBELL]](''value, variance'') || Berechnet einen Wert basierend auf einer Glockenkurve (siehe: [http://de.wikipedia.org/wiki/Normalverteilung Normalverteilung]).
|-
| [[SIN]](''value'') || Liefert den Sinus von ''value''.
|-
| [[STRCMP]](''string1, string2'') || Vergleicht ''string1'' mit ''string2'' und liefert das Ergebnis. Unterscheidet zwischen Groß- und Kleinschreibung. (<= 1 = ''string1'' kleiner als ''string2'', 0 = ''string1'' gleich ''string2'', >= 1 = ''string1'' größer als ''string2'')
|-
| [[STRCMPI]](''string1, string2'') || Vergleicht ''string1'' mit ''string2'' und liefert das Ergebnis. Unterscheidet nicht zwischen Groß- und Kleinschreibung. (<= 1 = ''string1'' kleiner als ''string2'', 0 = ''string1'' gleich ''string2'', >= 1 = ''string1'' größer als ''string2'')
|-
| [[STRINDEXOF]](''text, search, n'') || Liefert den Index von eines ersten Auftreten von ''search'' innerhalb von ''text'', beginnend beim ''n''ten Buchstaben. (0 ist der erste Buchstabe)
|-
| [[STRLEN]](''text'') || Liefert die Länge von ''text''.
|-
| [[STRMATCH]](''pattern, text'') || Liefert 1, wenn ''text'' zum angegebenen Wildcard ''pattern'' passt.
|-
| [[STRREGEX]](''pattern, text'') || Liefert 1, wenn 1 if ''text'' zum angegebenen regulären Ausdruck ''pattern'' passt.
|-
| [[SQRT]](''value'') || Liefert die Quadratwurzel von ''value''.
|-
| [[TAN]](''value'') || Liefert den Tangens von ''value''.
|}

[[Category: Reference Compendium]]
[[Category: Scripts]]

De:Chapter 2

2010-12-05T11:01:52Z

Sco: /* Sphere.ini */

{{Languages|Chapter_2}}

==spheretables.scp==

Spheretables.scp ist die allererste Datei, die beim Start von Sphere genau nach der Sphere.ini eingelesen wird. Deshalb ist sie äusserst wichtig. Viele weitere Einstellungen werden innerhalb dieser Datei vorgenommen und das macht sie so wichtig. Deshalb wird diese Datei hier nun erklärt und aufgeschlüsselt:

<nowiki>==</nowiki> [RESOURCES] ==

Öffnet man diese Datei, fällt einem als erstes eine Liste von Dateien ins Auge. Diese Liste ist durch das [RESOURCE]-Tag markiert und sieht so aus:

<tt>[RESOURCES] 
scripts/sphere_defs.scp 
scripts/sphere_book.scp 
scripts/sphere_backward_compatibility.scp 
scripts/sphere_events_human.scp 
scripts/sphere_events_npcs.scp 
scripts/npcs/ 
... </tt>

Hier wird eingestellt, welche und in welcher Reihenfolge Skriptdateien von Sphere geladen werden. Manchmal sollten hier Änderungen mit äusserster Vorsicht vorgenommen werden. Dateien mit DEFNAMES, REGIONS und anderen global benutzten Einstellungen sollten als erstes geladen werden, um Fehler beim Start von Sphere zu vermeiden (obgleich diese Fehler oftmals den Server nicht beeinträchtigen). Beispielsweise wurde in [[De:Chapter 1|Kapitel 1]] das Goldskript behandelt:

TYPE=t_gold

Weiss Sphere aus der nicht, was t_gold bedeutet, dann wird eine Fehlermeldung ausgegeben. Deshalb sollte vor dem Goldskript auf alle Fälle zuerst sphere_defs.scp geladen werden, in der t_gold definiert wurde.

Skripte mit Itemdefinitionen sollten von Skripten mit Templatedefinitionen geladen werden und danach dann Characterdefinitionen. Andere Dateien folgen danach, aber diese Dateien sollten auf jeden Fall in dieser Reihenfolge sein. Der Loot von Monstern benötigt Templates und die wiederum Items und solange Sphere keine Dateien mit Templates oder Items geladen hat, werden hunderte Fehler ausgegeben, die dann korrigiert werden müssen.

'''Anmerkung''': ''Es können ganze Ordner angegeben werden, es muss nicht jede einzelne Datei in der Liste aufgeführt werden. Deshalb enthält die Liste beispielsweise scripts/ am ende von [RESOURCE], damit alle Skripte dieses Ordner geladen werden, die noch nicht aufgeführt wurden.''

<nowiki>==</nowiki> [OBSCENE] ==

Die nächste Sektion ist selbsterklären: [OBSCENE]. Hier werden unerlaubte Namen aufgeführt. Versucht ein Spieler seinem Charakter einen Namen aus der Liste zu geben, dann wird ihm mitgeteilt, dass er einen anderen wählen soll.

<nowiki>==</nowiki> [NOTOTITLES] ==

Hier werden Titel definiert, die basierend auf dem Karmawert eines Spielers angezeigt werden. Diese Sektion sollte nicht angerührt werden, denn fehlt hier eine Zeile wird Sphere nicht mehr starten - diese Zeilen sollten höchstens geändert werden.
This defines the title that will be shown related to the player's karma. Do not touch this section. If you remove a line inadvertently, your server WILL NOT RUN. Only change them.

<nowiki>==</nowiki> [PLEVEL X] ==

Dieser Abschnitt legt fest, welche Befehle mit welchen Accountrechten (PLEVEL) ausgeführt werden können. Jeder nichtgelistete Befehl wird automatisch mit PLEVEL 4 eingeordnet. Das gilt auch für selbstgeschriebene Funktionen (siehe [[De:Chapter 6|Kapitel 6]]). Wie man sieht, gibt es eine große Liste an Befehlen und Funktionen.

'''Anmerkung''': Es muss nicht jede selbstgeschriebene Funktion in diese Liste, da jederzeit weitere [PLEVEL]-Sektionen in anderen Skripten angelegt werden können, obgleich es natürlich organisatorisch besser wäre, diese würden zentral gehalten.

<nowiki>==</nowiki> [RUNES] ==

Das ist die Liste der Worte, die gesagt werden, wenn ein Spruch gezaubert wird (An, Lor, In, usw.). Sie können geändert werden, aber das kann durchaus sehr verwirren. =P

==Sphere.ini==

Sphere.ini enthält alle internen Einstellungen des Sphere Emulators. Um einen Shard zu konfigurieren sollte hier begonnen werden. Um die Datei besser zu erklären, wurden Kommentare in '''fetter Schrift''' eingefügt.

<tt>//**************************************************************************** 
// SPHERE by : Menasoft 1997-2003 
// www.sphereserver.com 
// All SPHERE script files and formats are copyright Menasoft & Partners. 
// This file may be freely edited for personal use, but may not be distributed 
// in whole or in part, in any format without express written permission from 
// Menasoft & Partners. All donations and contributions 
// become the property of Menasoft & Partners. 
//**************************************************************************** 
 
/////////////////////////////////////////////////////////////// 
//////// General Information 
/////////////////////////////////////////////////////////////// 
 
[SPHERE] 
// Name of your Sphere shard 
ServName='''WarAngel's Test Centre''' 
// The IP of your server, this will be 127.0.0.1 almost always 
ServIP=127.0.0.1 
// The port of your server, this is 2593 by default 
ServPort=2593 
 
// Admin's contact email 
AdminEmail='''warangel999@msn.com''' 
// Web page for this server 
URL=www.myshard.com Replace www.myshard.com with your shard's URL' 
// GMT offset, from -12 to +12 [London=0, EST=5, etc] 
TimeZone='''-5 Östliche Zeitzone (US & Canada). Sollte passend eingestellt werden.''' 
 
// Official staff language 
Lang=English 
// Start this as a system service on Win2000, XP, NT 
NTService=0 '''Wird diese Einstellung aktiviert, ist kein Zugriff auf die Konsole mehr möglich.''' 
 
// MySql configuration. 
//MYSQL=0 '''Auf =1 wird MySQL aktiviert.''' 
//MySqlHost='''localhost Wird fast immer localhost sein, ausser MySQL läuft auf einen anderen Rechner als der Shard.''' 
//MySqlUser= 
//MySqlPassword= 
//MySqlDatabase= 
 
/////////////////////////////////////////////////////////////// 
//////// File Locations 
/////////////////////////////////////////////////////////////// 
// Directory where spheretables.scp is located, from there we will 
// load any additional scripts 
ScpFiles=scripts/ 
 
// Where your sphereworld.scp and spherechars.scp are located 
WorldSave=save/ 
 
// Where your sphereaccu.scp and sphereacct.scp is located 
AcctFiles=accounts/ 
 
// Where your UO installation is located. This need: map0.mul, statics0.mul, 
// staidx0.mul, multi.mul, multi.idx, hues.mul, tiledata.mul. 
// Optional files: verdata.mul, mapX.mul/staticsX.mul/staidxX.mul for higher 
// maps support (Malas, etc). 
// 
// Note that if not set, sphere will scan windows registry to auto-detect it 
//MulFiles=mul/ 
 
// Where your log files will be saved by sphere 
Log=logs/ 
 
/////////////////////////////////////////////////////////////// 
//////// World Save Information 
/////////////////////////////////////////////////////////////// 
// How often for Sphere to save your world (minutes) 
SavePeriod=20 
 
// How many backup levels to keep. Each level means 7 backups done for it. 
// So, 10*7 = 70 backup saves will be storied. 
BackupLevels=10 
 
// On would save in the background quietly over a longer period of time, and not interrupt the game 
// Off would notify "World save has been initiated" and save faster, but pause the game momentarily 
SaveBackground=0 
 
/////////////////////////////////////////////////////////////// 
//////// Account Management 
/////////////////////////////////////////////////////////////// 
//Code for servers account application process 
// 0=Closed, // Closed. Not accepting more. 
// 2=Free, // Anyone can just log in and create a full account. 
// 3=GuestAuto, // You get to be a guest and are automatically sent email with u're new password. 
// 4=GuestTrial, // You get to be a guest til u're accepted for full by an Admin. 
// 6=Unspecified, // Not specified. 
// To enable auto account you must set this to 2 
AccApp=0 
 
// Store password hashed with MD5 '''MD5 ist eine Verschlüsselungsmethode zur Speicherung von Passwörtern. Mehr Information: [http://de.wikipedia.org/wiki/MD5 hier]''' 
Md5Passwords=0 
 
// local ip is assumed to be the admin 
LocalIPAdmin=1 
 
// Number of chars allowed per account 
MaxCharsPerAccount=5 
 
// Min time for a char to exist before delete allowed (in seconds) 
MinCharDeleteTime=3*24*60 
 
// Max number of Guest accounts allowed 
GuestsMax=0 
 
/////////////////////////////////////////////////////////////// 
//////// Client Management 
/////////////////////////////////////////////////////////////// 
// What client protocol version used 
// Comment out the ClientVersion line to allow any client that is supported. 
//ClientVersion=2.0.3 
 
// Set this to 0 to block login to encrypted clients '''Normalerweise benutzen Clients Verschlüsselung.''' 
UseCrypt=1 
 
// Set this to 1 to allow login to unencrypted clients '''Klappt mit Tools wie bspw.: [http://stud4.tuwien.ac.at/~e9425109/UO_RICE.htm UO Rice] und [http://www.uogateway.com/ UOGateway] die Verschlüsselung eines Clients zu entfernen''' 
UseNoCrypt=0 
 
// Maximum total open connections to server 
ClientMax=256 
 
// Maximum open connections to server per IP 
ClientMaxIP=16 
 
// Maximum total (not-in-game) connections to server 
ConnectingMax=32 
 
// Maximum total simultaneous (not-in-game) connections to server per IP 
ConnectingMax=8 
 
// How long logged out clients linger in seconds 
ClientLinger=15 
 
// Walk limiting code: buffer size (in tenths of second) 
WalkBuffer=75 
 
// Walk limiting code: regen speed (%) 
WalkRegen=25 
 
// Only commands issued by this plevel and higher will be logged 
CommandLog=0 '''0 bedeutet, dass alle Befehle geloggt werden.''' 
 
// Prefix for ingame commands 
CommandPrefix=. 
 
// Use the built in http server 
UseHttp=1 
 
// Use the built in god port 
UseGodPort=0 '''This is for use with the God client''' 
 
// Default setting for all accounts specifying default resdisp. Recommended 
// specifying at least 1 (T2A) here. 
//AutoResDisp=0 '''0=autmatisch herausfinden, 1=T2A, 2=LBR, 3=AoS, 4=SE, 5=ML''' 
 
// Default setting for new accounts specifying default priv level 
//AutoPrivFlags=010 
 
/////////////////////////////////////////////////////////////// 
//////// Game Mechanics 
/////////////////////////////////////////////////////////////// 
// Do not allow entering under roof being on horse? 
MountHeight=0 
 
// Archery does not work if too close (0 = not checked) 
ArcheryMinDist=2 
 
// Maximum Distance for Archery 
ArcheryMaxDist=15 
 
// Speed scale factor for weapons '''Formel ist: VERZÖGERUNG = SPEEDSCALEFACTOR /((DEX + 100) * SPEED)''' 
SpeedScaleFactor=15000 
 
// This is the percent of max weight at which stamina is lost half the time 
// (200 = no effect) 
StaminaLossAtWeight=150 
 
// Weight penalty for running +N% of max carry weight (0 = no effect) 
RunningPenalty=50 
 
// Show people joining/leaving the server 
ArriveDepartMsg=1 
 
// Are house and boat keys newbied automatically 
AutoNewbieKeys=1 
 
// Maximum number of items allowed in bank 
BankMaxItems=1000 
 
// Maximum weight in stones allowed in bank 
BankMaxWeight=1000 
 
// If 1 vendors will take gold only from backpack 
PayFromPackOnly=0 '''Wenn 0, dann nehmen Händler auch Geld vom Bankfach.''' 
 
// Disable weather effects? 
NoWeather=1 
 
// Default light level in dungeons 
DungeonLight=27 '''0 ist am helssten, 30 ist am dunkelsten''' 
 
// Day light level 0-30 '''0 ist am helssten, 30 ist am dunkelsten''' 
LightDay=0 
 
// Night light level 0-30 
LightNight=25 
 
// Wool Regen Time (in minutes) 
WoolGrowthTime=30 
 
// Suppress player speech with 75% of capital letters 
SuppressCapitals=0 
 
// Extra combat flags to control the fight (default:0, 0.55i compatible) 
// COMBAT_NODIRCHANGE 00001 // not rotate player when fighting (like was in 0.51a) 
// COMBAT_FACECOMBAT 00002 // allow faced combat only (recommended) 
//CombatFlags=0 '''Sind beide aktiviert, dann bedeutet das, dass der Spieler den Gegner ansehen muss, um ihn zu treffen.''' 
 
/////////////////////////////////////////////////////////////// 
//////// NPC/Item/Player Management 
/////////////////////////////////////////////////////////////// 
// Distance in tiles before an NPC that's wandered too far from it's home will teleport back 
LostNPCTeleport=50 
 
// Wether PCs get a resurrection robe when they get resurrected. 
NoResRobe=0 
 
// Time for a NPC corpse to decay mins 
CorpseNPCDecay=10 
 
// Time for a playercorpse to decay mins 
CorpsePlayerDecay=15 
 
// Base decay time in minutes for items 
DecayTimer=30 
 
// Put [NPC] tags over chars '''oder [TAME], wenn der NPC gezähmt wurde''' 
CharTags=0 
 
// Flip dropped items 
FlipDroppedItems=0 
 
// Monsters run when scared of death 
MonsterFear=0 
 
// Monsters may fight each other 
MonsterFight=0 
 
// Percent setting of the all NPC move rate, default 100 
MoveRate=100 
 
// Do players receive sounds 
GenericSounds=1 
 
// Max number of items to sell to one person at once 
VendorMaxSell=255 
 
// Max level npc trainers can go 
NPCTrainMax=300 '''300 ist 30.0 skill''' 
 
// Percent of own ability npcs can train to 
NPCTrainPercent=30 
 
// Max level of skill trainable on dummies, archery butte ect.. 
SkillPracticeMax=300 '''300 ist 30.0 skill''' 
 
// Max skill player's will start with on skills they haven't chosen during char create 
MaxBaseSkill=200 '''Hier eine 0, damit Spieler mit keinen Skills ausser den gewählten beginnen.''' 
 
// Time in seconds for hitpoint regeneration 
Regen0=40 
 
// Time in seconds for mana regeneration 
Regen1=20 
 
// Time in seconds for stamina regeneration 
Regen2=10 
 
// Time in minutes for food regeneration 
// 1*60*24 = 1 day of real life time 
Regen3=1*60*24 
 
// Speech block associated to players 
SpeechSelf=spk_player 
 
// Speech block associated to pets 
SpeechPet=spk_pet 
 
// When player skills/stats goes this times more than skillclass allowed, drop 
// them to skillclass level. Setting this to 0 disables the action. 
OverSkillMultiply=2 
 
// NPC AI settings 
// NPC_AI_PATH 0001 NPC pathfinding 
// NPC_AI_FOOD 0002 NPC food search (objects + grass) '''Sorgt dafür, dass NPCs nach Essen bzw Gras suchen (siehe FOODTYPE)''' 
// NPC_AI_EXTRA 0004 NPC magics, combat, etc 
//NPCAI=0 
 
/////////////////////////////////////////////////////////////// 
//////// Crime/Murder/Karma/Fame/Guard Settings 
/////////////////////////////////////////////////////////////// 
// Karma when player goes from good to neutral (from -10000 to 10000) 
PlayerNeutral=-2000 
 
// How many minutes are criminals flagged for 
CriminalTimer=3 
 
// Times a player can snoop before becoming a criminal 
SnoopCriminal=20 
 
// Seconds time to decay a murder count (default 8*60*60 is 8 hours) 
MurderDecayTime=8*60*60 
 
// Amount of murders before we get title 
MurderMinCount=1 
 
// Looting or carving a blue player is a crime 
LootingIsaCrime=1 
 
// Flag players criminal for helping criminals? 
HelpingCriminalsIsaCrime=1 
 
// How long do guards linger about in minutes 
GuardLinger=3 
 
// Will guards kill instantly or follow normal combat rules 
GuardsInstantKill=1 
 
// Limits the MAXHITS/MAXMANA/MAXSTAM changes 
// STAT_FLAG_NORMAL 0x00 // MAX* status allowed (default) 
// STAT_FLAG_DENYMAX 0x01 // MAX* denied 
// STAT_FLAG_DENYMAXP 0x02 // .. for players 
// STAT_FLAG_DENYMAXN 0x04 // .. for npcs 
StatsFlags=0 
 
/////////////////////////////////////////////////////////////// 
//////// Server Mechanics 
/////////////////////////////////////////////////////////////// 
// Experimental flags 
// Flags for options that affect server behaviour and which might affect compatibility 
// See the revisions.txt file for more details on this 
// EF_DiagonalWalkCheck = 00000001 
// EF_UNICODE = 00000002 // No on Linux '''Bringt UNICODE Korrekturen''' 
// EF_Scripts_Ret_Strings = 00000004 
// EF_New_Triggers = 00000008 
// EF_Scripts_Parse_Verbs = 00000010 
// EF_Intrinsic_Locals = 00000020 //'''Erlaubt locals anders zu nutzen. Beispielsweise kann statt <local.x> auch nur <x> benutzt werden.''' 
// EF_Item_Strict_Comparison = 00000040 //'''Sorgt dafür, dass gleiche Items nicht mehr verglichen werden, wie Stoff, Leder, Fell, Holz, Bretter, Pfeile und Bolzen.''' 
// EF_WalkCheck = 00000100 '''//Behebt viele Hauseinbruchsbugs und ähnliche Probleme.''' 
// EF_Script_Profiler = 00000400 
// EF_Size_Optimise = 00000800 
// EF_Minimize_Triggers = 00001000 //Minimize trigger calls (use only 0.51 triggers) 
Experimental=00000 
 
// Option flags 
// Flags for options that affect server behaviour but not compatibility 
// See the revisions.txt file for more details on this 
// OF_Magic_IgnoreAR = 00000001 //'''Magieschaden ignoriert Rüstung (AR)?''' 
// OF_Magic_CanHarmSelf = 00000002 //'''Kann sich ein Spieler mit Magie selbst verletzen? (einen Magic Arrow auf sich abfeuern, um Lähmung (Paralyze) zu beenden?)''' 
// OF_Magic_StackStats = 00000004 
// OF_Archery_CanMove = 00000010 //'''Kann ein Spieler laufen und schiessen gleichzeitig?''' 
// OF_Magic_PreCast = 00000020 //'''Funktionieren Zauber mit pre-cast oder ist der Spieler solange er zaubert unfähig herumzulaufen?''' 
// OF_Items_AutoName = 00000040 
// OF_FileCommands = 00000080 //'''Aktiviert Befehle zur Dateiverarbeitung, wie writefile usw''' 
// OF_NoItemNaming = 00000100 //'''Verhindert die Benennung von Gegenständen mit "crafted by"''' 
// OF_NoHouseMuteSpeech = 00000200 //'''Können sich spieler in und ausserhalb von Häusern gegenseitig hören?''' 
// OF_Multithreaded = 00000400 //'''Nicht setzen, solange der Server läuft!!! (Macht *Nix Server instabil) Lässt die Verarbeitung von Accounts auf einem anderen Thread laufen''' 
// OF_Advanced_LOS = 00000800 
// OF_Flood_Protection = 00001000 
OptionFlags=0200 
 
// FeatureT2A, used to control T2A expansion features ( default 03 ) 
// FEATURE_T2A_UPDATE 01 // Monster and Lost lands 
// FEATURE_T2A_CHAT 02 // In game chat 
FeatureT2A = 03 
 
// FeatureLBR, used to control LBR expansion features ( default 0 ) 
// FEATURE_LBR_UPDATE 01 // Lbr Monsters 
// FEATURE_LBR_SOUND 02 // MP3 instead of MIDI 
FeatureLBR = 0 
 
// FeatureAOS, used to control AOS expansion features ( default 0 ) 
// Enabling one of them automagically enables AoS basic features 
// FEATURE_AOS_UPDATE 01 // Basic AoS feature 
// FEATURE_AOS_POPUP 02 // Popup infos 
// FEATURE_AOS_DAMAGE 04 // Damage shown on hit 
// FEATURE_AOS_PALNECRO 08 // Fightbook and Paladin/Necro on char creation 
// FEATURE_AOS_TOOLTIP 010 // Tooltips 
FeatureAOS = 0 
 
// FeatureSE, used to control SE expansion features ( default 0 ) 
// FEATURE_SE_UPDATE 01 // Basic SE features 
// FEATURE_SE_NINJASAM 02 // Ninja and Samurai 
FeatureSE = 0 
 
// FeatureML, used to control ML expansion features ( default 0 ) 
// FEATURE_ML_UPDATE 01 // Basic ML features 
FeatureML = 0 
 
// In game effects to turn on and off 
// Messages echoed to the server console while in debug mode 
// DEBUGF_NPC_EMOTE = 0x0001 
// DEBUGF_ADVANCE_STATS = 0x0002 
// DEBUGF_WALKCODES = 0x0080 // try the new walk code checking stuff 
// DEBUGF_NPCAI = 0x0100 // some NPC AI debugging 
// DEBUGF_EXP = 0x0200 // experience gain/loss 
// DEBUGF_LEVEL = 0x0400 // experience level changes 
DebugFlags=0 
 
// Console Hears all that is said on the server 
HearAll=1 
 
// Secure mode attempts to ignore errors, protect from accidently shutdowns 
Secure=1 
 
// Value from 1 to 32, set sectors inactive when unused to conserve resources 
SectorSleep=10 
 
// Disconnect inactive socket in x min 
DeadSocketTime=5 
 
// Always force a full garbage collection on save 
ForceGarbageCollect=1 
 
// Time before restarting when server appears hung (in seconds) 
FreezeRestartTime=60 
 
// Length of the game world minute in real world in seconds 
GameMinuteLength=60 
 
// Bit Mask of the subjects you want to log when logging is on 
// LOGM_ACCOUNTS 0x00080 
// LOGM_SAVE 0x00200 // world save status. 
// LOGM_CLIENTS_LOG 0x00400 // all clients as they log in and out. 
// LOGM_GM_PAGE 0x00800 // player gm pages. 
// LOGM_PLAYER_SPEAK 0x01000 // All that the players say. 
// LOGM_GM_CMDS 0x02000 // Log all GM commands. 
// LOGM_CHEAT 0x04000 // Probably an exploit ! 
// LOGM_KILLS 0x08000 // Log player combat results. 
// LOGM_HTTP 0x10000 
// 01ffff log everything 
LogMask=01ec80 
 
// Amount of time to keep map data cached in sec 
MapCacheTime=120 
 
// Max NPC chars for a sector to prevent lag 
MaxComplexity=32 
 
// Amount of items in one tile so start showing "too many items here" 
MaxItemComplexity=25 
 
// Amount of items in one sector to start showing "x items too complex" 
MaxSectorComplexity=1024 
 
// Limit the number of cycles the while/for loop can proceed. Setting this to 
// zero disables the limitation 
MaxLoopTimes=0 
 
/////////////////////////////////////////////////////////////// 
//////// Magic/Effects Settings 
/////////////////////////////////////////////////////////////// 
 
// Allow casting while equipped 
EquippedCast=1 
 
// Words of power for player using magic 
WOPPlayer=1 
 
// Words of power for staff using magic 
WOPStaff=0 
 
// Reagents lost if magic fails 
ReagentLossFail=0 
 
// Magic requires reagents 
ReagentsRequired=0 
 
// What % of hitpoints players will resurrect with. Note, that if you set this 
// too low, people with little STR will have problems resurrecting. 
HitPointPercentOnRez=33 
 
// How many % of hits will the character loose when starving. 0 disables 
//HitsHungerLoss=0 
 
// Amount of skill of lock picking needed to unlock a magically locked door 
MagicUnlockDoor=900 
 
// Teleport effect for GMs and players. Setting 0 disables the effect 
TeleportEffectStaff=03709 
TeleportEffectPlayers=0372a 
 
/////////////////////////////////////////////////////////////// 
//////// Experience and Level system 
/////////////////////////////////////////////////////////////// 
 
// Enable experience system 
//ExperienceSystem=0 
 
// Experience system settings: 
// 0001 gain experience in combat 
// 0002 gain experience in crafts 
// 0004 allow experience to go down 
// 0008 limit experience decrease by a range witheen a current level 
// 0010 auto-init EXP/LEVEL for NPCs if not set in @Create 
// 0020 allow trigger @ExpChange 
// 0040 allow trigger @ExpLevelChange 
//ExperienceMode=0 
 
// If combat experience gain is allowed, use these percents for gaining exp in 
// Player versus Monster and Player versus Player combats. Value 0 disables gain. 
//ExperienceKoefPVM=100 
//ExperienceKoefPVP=100 
 
// Enable levels system (as a part of experience system) 
//LevelSystem=0 
 
// Level system settings: 
// linear = 0 (each NextLevelAt exp will give a level up) 
// double = 1 (you need (NextLevelAt * (level+1)) to get a level up) 
//LevelMode=1 
 
// Amount of experience to raise to the next level 
//LevelNextAt=0 
 
/////////////////////////////////////////////////////////////// 
//////// Webpage Settings 
/////////////////////////////////////////////////////////////// 
 
// Note, that you can catch error codes by creating sphere404.htm and so on 
// for all HTTP error codes sphere support. 
 
[WEBPAGE 1] 
// Determines what html file is used as base for the status page 
WebPageSrc=scripts\web\spherestatusbase.html 
// Determines where the status page is saved 
WebPageFile=scripts\web\status.html 
// In seconds, how often the status file is updated 
WebPageUpdate=60 
// Required PLevel to view this page (0 = anyone, 6 = admins only) 
PLevel=0 
 
/////////////////////////////////////////////////////////////// 
//////// Abuse Control 
/////////////////////////////////////////////////////////////// 
 
// Block these ips from the server 
// 255 is a wildcard, so 255.255.255.255 disables anyone connecting. 
[BlockIP] 
//123.34.45.56 
//123.45.56.78 
 
/////////////////////////////////////////////////////////////// 
//////// Connection Information 
/////////////////////////////////////////////////////////////// 
 
//First line should be the name of your shard (this is what people see when they connect) 
//Second line should be the IP of your shard (this is almost always 127.0.0.1) 
//Third line should be the port of your shard (this should be whatever ServPort is set to) 
 
//Uncomment next 3 lines below this if you have a router 
//First line should be a name different than your shard name above this 
//Second line should be your real/external IP (www.whatismyip.com) 
//Third line should be the shard port (this should be whatever ServPort is set to) 
[SERVERS] 
'''WarAngel's Test Centre''' 
127.0.0.1 
2593 
 
//External 
//my.ip.goes.here 
//2593 
 
[EOF] </tt>

'''MAPx''' Ist zwar nicht in sphere.ini, kann aber genutzt weden (siehe REVISIONS.txt). Und zwar so:

MAPx=max_x,max_y,sector_size,real_map_number.

Beispiel: MAP1=7168,4096,512,-1

setzt die Größe von map1 auf 7168,4096, die Sektorgröße von map1 auf 512 und die -1 bedeutet, dass die Standarddatei für diese map benutzt wird.

Anderes Beispiel:

MAP50=7168,4096,64,3

Aktiviert die Map mit nummer 50, die eine Größe von 7168,4096, eine Sektorgröße von 64 hat und map3.mul, statics3.mul und staidx3.mul als Dateien benutzt.

==sphere_region.scp==

Dieses Skript stellt Orte auf der Karte ein und defniert, was bspw. dort an Metallen oder Holz abgebaut werden kann, was passiert, wenn diese Orte betreten werden und weiteres. Es enthält zudem Resource-Sektionen, die so aufgebaut sind:

<tt>[REGIONRESOURCE x]</tt>

Diese Sektion enthält den Skill, der benötigt wird, um diese Resource abzubauen, welche Resource der Spieler erhält und wie lange es dauert, damit sie "nachwächst". Ein Beispiel hierfür (es gibt einen Kommentar mit "//t_tree", der aber klar sein sollte, wenn das vorherige Kapitel über defnames gelesen wurde).

<tt>[REGIONRESOURCE mr_tree] 
// lumberjacking default 
// t_tree 
SKILL=1.0,80.0 
AMOUNT=9,30 
REAP=i_log 
REGEN=60*60*10 </tt>

Diese Sektion definiert eine Resource, etwas das gesammelt werden kann. Es vergleicht Skill und Menge. Das bedeutet, dass mit Skill 1.0 maximal 9 i_log und mit Skill 80.ß maximal 30 i_log gesammelt werden können. Alles danach ist nur eine Erhöhung der Chance auf 30 i_log. In der SKILL-Zeile wird also eine Unter- und eine Obergrenze festgelegt, die AMOUNT-Zeile macht selbiges für die Mengen.
Was bringt uns das? Die Zeile: REAP=i_log. Das sagt dem Server, er soll i_log Items erstellen, wenn diese Resource gebraucht wird. Es kann hier alles stehen, was man auf seinem Shard sammelbar machen möchte.
Die nächste Zeile, REGEN, legt in Sekunden fest, wie lange es dauert, damit diese Resource wieder neu abgebaut werden kann. In diesem Beispiel sind das 60*60*10 Sekunden, also 10 Stunden. Als GM können die Punkte wahrgenommen werden, an denen Spieler geschürft oder abgeholz haben, denn dort liegen kleine Kristalle am Boden. Sie sehen wie Spawnpunkte aus, aber sind in Wahrheit Resourcenmarkierungen. Sie markieren, wo eine spezielle Resource geholt werden kann, wie viel geholt werden kann und welchen Typ die Resource hat. Sie haben zudem einen TIMER, der runterzählt (von bspw 36000) und der dann dafür sorgt, dass der Kristall bei 0 gelöscht wird.

<tt>[REGIONTYPE r_default_rock t_rock] 
//Random rocks 
RESOURCES=100.0 mr_nothing 
RESOURCES=500.0 mr_iron 
//RESOURCES=6.0 mr_rusty 
//RESOURCES=6.0 mr_old_copper 
//RESOURCES=6.0 mr_dull_copper 
//RESOURCES=4.5 mr_bronze 
RESOURCES=5.0 mr_copper 
RESOURCES=2.0 mr_gold 
RESOURCES=1.0 mr_rose 
RESOURCES=2.0 mr_agapite 
RESOURCES=1.0 mr_bloodrock 
RESOURCES=1.0 mr_silver 
RESOURCES=0.5 mr_verite 
RESOURCES=0.2 mr_Valorite 
RESOURCES=0.1 mr_mytheril 
RESOURCES=0.1 mr_blackrock 
RESOURCES=0.1 mr_diamond </tt>

Wow? Was sind das für Dinge? mr_iron, mr_agapite? Das ist nirgendwo in der Datei. Auch in sphere_defs.scp findet man diese Definitionen nicht, man muss in sphereitem_ore.scp nachsehen.

<tt>RESOURCES=50.0 mr_iron</tt>

Das sieht irgendwie bekannt aus. Würde es noch mehr, wenns so aussehen würde?

<tt>RESOURCES={ mr_iron 50 mr_copper 5 mr_gold 2 mr_rose 2 ...etc... }</tt>

Möchte wetten, dass es das würde, wenn die vorherigen Lektionen in Kapitel 1 gelesen wurden. Das ist eine gewichtete Liste von Resourcen. In einem etwas anderen Format, als die für Template genutzte Version, aber sie funktioniert genau so. Das ist der einzige Ort in allen Skripten, in denen Kommazahlen genutzt werden können, wie bspw 0.1 und 0.2. Eigentlich stimmt das nur halb, aber Sphere verdeckt erfolgreich, solange in jeder RESOURECE-Zeile eine Kommazahl steht. (Im übrigen sollte nicht ein RESOURCES mit einer Zufallsauswahl geskriptet werden. Sphere wird das nicht richtig auswerten, es sollte dieses Format genutzt werden.)

[REGIONTYPE r_default_rock t_rock] ''Bedeutet:'' r_default t_rock legt einen Defname für einen REGIONTYPE fest, der in anderen Skripten benutzt werden kann (im nächsten Abschnitt bspw. =P). t_rock ist ein Defname (siehe sphere_defs.scp) für Stein, was für Sphere festlegt wo Spieler welche Resource sammeln können (sollte es auf t_water geändert werden, kann im Wasser Erz geschürft werden, was sicher nicht ganz so beabsichtigt ist.)

Hoffentlich erklärt das sphere-resion.scp für jeden. Im nächsten Abschnitt wird gezeigt, wie REGIONTYPE-Einstellungen benutzt werden, damit die Resourcen auch wirklich im Spiel vorhanden sind.

==sphere_mapX.scp==

Willkommen zur einfachsten Datei in Sphere: spheremap.scp. Diese Datei ist vollständig fertiggestellt für die Standardmap. Es ist sehr selten, dass diese Datei verändert werden muss.

Eine Anmerkung, die gleich zu Anfang gesagt werden muss: wird diese Datei verändert, muss der Server neu gestartet werden, damit die Änderung auch übernommen wird. Sollte das innerhalb eine Resyncs passieren, wirds viele Fehler geben.

Diese Sektion zeigt, wie neue Regionen erstellt werden können, zu denen man mit dem .go Befehl reisen kann.

Es gibt momentan 5 Dateien in den Standardskripten, eine für jede Map (Felucca, Trammel, Ilshenar, Malas und Tokuno) die von 0 bis 4 durchnummeriert sind (sphere_map0.scp, sphere_map1.scp usw).

Ich benutze die Region Felucca als ein Beispiel für dieses Tutorial und hier das Skript dafür:

<tt>[AREADEF a_world] 
NAME=Felucca 
EVENTS=r_default,r_default_rock,r_default_water,r_default_tree,r_default_grass 
GROUP=ALLMAP 
P=1323,1624,55,0 
RECT=0,0,6144,4096,0 </tt>

Diese Zeilen bedeuten:

'''[AREADEF somedef]''': Wie in allen anderen Skripten ist das ein Defname - nur hier für eine Region auf dem Server.

'''Name''': Diese Zeile enthält einen Namen für die Region, der angezeigt wird, wenn der .where Befehl im Spiel benutzt wird. Zudem kann .go "Region Name" dafür benutzt werden, um dort hin zu reisen (keine zwei Regionen sollten den selben Namen haben, ansonsten wird hier einiges an Fehlern produziert).

'''Events''': Hier wird festgelegt, was alles in der Regeion passiert und welche Resourcen hier abbaubar sind (siehe den Abschnitt über REGEIONTYPE - diese können hier als EVENT benutzt werden). Neben den Resourcen können hier auch Trigger benutzt werden, die von den EVENTS aufgerufen werden können (wahrscheinlich bemerkt man hier, dass die REGIONTYPE-Sektionen nur Ereignisse für Regionen sind :P), wie beispielsweise @Enter und andere (siehe [[Triggers]]).

'''Group''': Das ist eine Axiseinstellung, die im Travelmenü Regionen gruppiert.

'''P''': Das ist der Ort, an den man mit .go "Region Name" gelangt. Jede Region hat eine solche Angabe und sie liegt normalerweise mitten in der Region oder an einem passenden ort. Wenn eine eigene Region erstellt wird, sollte ein solcher Punkt angegeben werden.

'''RainChance''': Legt die Chance auf Regeion in der Region fest (Rainchance=50 gibt eine 50% Wahrescheinlichkeit) der Rest bedeutet, dass es zu 50% schneit.

'''Rect''': Gibt die Grenzen der Region als Koordinaten an. Die ersten zwei Zahlen sind die Koordinaten des oberen linken Punktes und die zweiten der untere linke Punkt eines Rechtecks. Im Fall von Felucca ist das 0,0 bis 6144,4096 (RECT=0,0,6144,4096). Mit 56b kann auch ein fünfter Wert angegeben werden, nämlich die Karte, auf der die Region liegt, also RECT=0,0,6144,4096,0 (kann auch weggelassen werden, dann wird standardmäßig 0 verwendet - soll das nicht Map 0 sein, dann muss ein Wert angegeben werden, sonst gibts Fehler).

'''Flags''': Regionenflags bestimmen, was in einer Region los ist. Sie beschreiben, ob eine Region bewacht ist, welche Magie genutzt werden kann, wer hier wen verletzen kann und ob es hier regnen kann. Soll das verwendet werden, dann so:

Diese Zeile hinzufügen:

FLAGS=#

Natürlich sollte statt # eine Zahl verwendet werden! Wo diese nummern stehen? Es gibt vordefinierte, aber es gibt eine Liste.

Beispielsweise für eine bewachte und gesicherte Region, sehen sie so aus:

<tt>
::region_flag_safe (02000) 
:+ 
::region_flag_guarded (04000) 
:= 
::06000 </tt>

Das wars. Die FLAGS werden auf 06000 gesetzt. "Aber, aber ... hiess es nicht, dass DEFNAMEs die Eingabe von Zahlen unnötig machen?" (siehe [[De:Chapter 1|Kapitel 1]].) Natürlich, deshalb geht das auch ohne Zahlen und zwar so:

<tt>FLAGS=region_flag_safe|region_flag_guarded</tt>

Das wars. Die Region ist bewacht und sicher.

Aus Sicht eines Admins ist das aber keine gute Idee. Eine derartige Region verhindert, dass Wachen wirklich jemanden töten können, sie rufen sich gegenseitig und werden zu keiner Handlung fähig sein und letztendlich Lag verursachen. Einfach glauben und keine Region mit diesen beiden Flags erstellen.

Hier ist die Liste der möglichen Flags (stehen auch in sphere_defs.scp und können sich von Zeit zu Zeit ändern):

<tt>[DEFNAME region_flags] 
region_antimagic_all 00001 // keine Magie möglich hier. 
region_antimagic_recall_in 00002 // kein Teleport,Recall hier her, keine Markierung von Runen. 
region_antimagic_recall_out 00004 // kein Recall nach draussen von hier aus. 
region_antimagic_gate 00008 // keine Gatezauber hier hin oder hier raus. 
region_antimagic_teleport 00010 // kein Teleport hier her. 
region_antimagic_damage 00020 // Keine "böse" Magie hier. 
region_flag_ship 00040 // Das hier ist ein Schiff - Schiffsbefehle klappen hier. 
region_flag_nobuilding 00080 // kein Gebäude in diesem Areal 
region_flag_globalname 00100 // Sicherstellen, dass der Name global gilt. 
region_flag_announce 00200 // Ankündigung an alle, dass diese Region betreten wird. 
region_flag_insta_logout 00400 // Instant Logout erlaubt. (Hotel?) 
region_flag_underground 00800 // Dungeon Areal. (kein Wetter) 
region_flag_nodecay 01000 // Items am Boden werden nie gelöscht. 
region_flag_safe 02000 // Diese Region sichert vor jedem Schaden. 
region_flag_guarded 04000 // siehe tag.guardowner 
region_flag_no_pvp 08000 // Spieler können sich nicht direkt Schaden. </tt>

Und das wars mit der sphere_mapX.scp Datei.

==sphere_book.scp==
Spherebook.scp ist eine der sinnlosesten Dateien, die zu finden ist. Wie oft liest man schon die Tips auf einem Shard, wenn man einloggt? Ich weiss, dass die meisten Spieler diese Rollen einfach wegklicken. Aber der Inhalt ist in dieser Datei festgelegt. Und Bücher - hab ich die erwähnt? Diese fast-unmöglich-zu-schreiben, selten benutzten Speicherverschwender?

<tt>'''[SCROLL SCROLL_MOTD]''' 
'''[SCROLL SCROLL_NEWBIE]''' 
'''[SCROLL SCROLL_GUEST]''' </tt>

Das sind die Sektionen, die Nachrichten definiert, wenn man einloggt. Alles, das hier nach diesen Tags steht, wird in einer Nachricht auftauchen. Welche Leerzeichen wo gebraucht werden, muss mit vielen Tests herausgefunden werden. Braucht etwas Zeit und es gibt keine echte Möglichkeit das gut zu erklären. Einfach versuchen. Achtung: es gibt hier keine Zeilenumbrüche - oder zumindest gabs in der Vergangenheit keine.

<tt>'''[TIP X]''' </tt>

Richtig. Das sind Tips, die es beim Start gibt. "Krieg ist für Kinder und alles Leben ungesund." ist einer davon. Sehr passend.

<tt>'''[BOOK title]''' 
'''[BOOK title x]''' </tt>

Erstellt ein Buch mit DEFNAME Titel. Es legt eine Seitenzahl x nach dem DEFNAME fest und fügt Text auf einer bestimmten Seite hinzu. Sieht man die Beispielbücher an, kann man erahnen, wie das klappt. Die größte Schwierigkeit dieser Bücher ist die benutzte Schriftart im Spiel, so dass man nicht wirklich weiss, wieviele Zeichen es für eine Zeile oder Seite braucht. Beispielsweise passen mehr 'i's als 'w's oder 'm's in eine Zeile, weil diese Buchstaben größer sind. Ein Absatz kann mit der TAB Taste eingefügt werden.

==sphere_name.scp==

Eine einfache Datei. Es enthält eine Liste von Namen unter Sektionen mit verschiedenen DEFNAMEs. Die Namen sind wichtig, nicht der Inhalt, da man wahrscheinlich nie eine eigene Liste von Namen anlegen wird. Ich benutze diesen Emulator seit Jahren und habe nie diese Datei verändert.

Um auf die Liste der Namen zugreifen zu können, benutzt man das hier:

'''NAME=#NAMES_HUMANMALE'''

Das ersetzt automatisch auf einen Zufallsnamen aus der Liste '''NAMES_HUMANMALE'''.

Um eine Liste von Namen zu erstellen, sieht das so aus:

<tt>[NAMES EIN_DEFNAME] 
ANZAHL_DER_NAMEN 
NAMEN </tt>

Beispielsweise:

<tt>[NAMES NAMES_SPECIAL] 
2 
Hil 
Hol </tt>

Schwierig, hm? Eigentlich wollte ich dafür keinen Abschnitt schreiben ...

==sphere_newb.scp==
Ich habs getan - kein eitler Humor unter diesem Titel! :)

Auf jeden Fall ist diese Datei oft Gegenstand vieler Fragen. "Wie sorge ich dafür, dass meine Spieler mit 10000 Gold anfangen?" oder "Wie gebe ich allen Schmieden 800 Barren?" Ich sag nicht, dass das sinnvoll wäre, aber in dieser Datei können solche Dinge geregelt werden.

<tt>[NEWBIE MALE_DEFAULT] 
// Male Generic Starting Clothes 
ITEMNEWBIE=i_shirt_plain 
COLOR=colors_all 
ITEMNEWBIE=random_pants 
COLOR=colors_neutral 
ITEMNEWBIE=random_shoes 
COLOR=colors_neutral 
ITEMNEWBIE=i_dagger 
ITEMNEWBIE=i_candle 
ITEMNEWBIE=i_book_sm 
ITEMNEWBIE=i_gold,100 </tt>

So sieht ein typisches Skript aus. Wie eine große Template, nicht wahr? Dafür gibts einen Grund. Es ist ein Template, es steht nur '''ITEMNEWBIE''' statt '''ITEM''' drin. In Kapitel 1 steht über Templates alles, was man wissen muss und genau so funktioniert das auch hier.

Das einzige wichtige in diesen Sektionen ist: alles MUSS einen eindeutigen Namen haben, den der Server finden kann. Es kann keine weitere Newbie-Sektion hinzugüfgt werden, so sehr das auch gewollt werden würde - sorry.

==sphere_skill.scp (SKILLCLASSES)==
Skill Klassen legen fest, wie weit Skills/Stats gesteigert werden können und es können zudem Trigger angelegt werden. Ein Skillclass Skript sieht so aus:

<tt>[SKILLCLASS 0] 
// undeclared class. 
// max skills for players of this skill class. 
// might want this to be all 50.0 to make people declare a class? 
DEFNAME=Class_undeclared 
NAME=undeclared 
// EVENTS=e_ClassUndeclared 
STATSUM=300 
SKILLSUM=10000.0 
STR=100 
INT=100 
DEX=100 
ALCHEMY=100.0 
ANATOMY=100.0 
ITEMID=100.0 
ARMSLORE=100.0 
and so on... </tt>

Um es zu verstehen:

'''EVENTS''': Bedeutet, dass jeder mit dieser Skillclass auch die hier angegebenen Ereignisse auslöst. (mehrere EVENTS werden mit Komma getrennt, bspw: EVENTS=e_1,e_2 usw).

'''STATSUM''': Gibt eine Obergrenze für die Summe der Stats an. Bspw: ich hab 100 Str, 100 Dex und 100 Int, dann hab ich 300 und damit STATSUM erreicht, ich kann nicht mehr erreichen (außer mit magischen Gegenständen und sowas).

'''SKILLSUM''': Wie STATSUM, nur für Skills.

'''STR/DEX/INT''': Obergrenze für einen spezifischen Stat (außer mit magischen Gegenständen und sowas).

'''ALCHEMY''': Wie STR/DEX/INT, nur für Skills (in diesem Fall Alchemy, aber kann auch jeder andere sein).

==sphere_serv_triggers.scp==
Diese Datei enthält spezielle Trigger "Functions", die vom Server bei bestimmten Ereignissen aufgerufen werden. Darunter gibt es eine Liste von Funktionen, die in dieser Datei gefunden werden und manche haben auch eine Erklärung dabei:

'''f_onaccount_login'''

Wird aufgerufen, wenn ein Client das Passwort eingegeben hat.

:ARGS --> Benutzername des Clients, der einloggen möchte
:ARGO --> Referenz zum Client selbst
:RETURN 0 --> nichts tun (also Login weiterlaufen lassen)
:RETURN 1 --> die Verbindung zum Client trennen

'''f_onaccount_delete'''

Diese Funktion wird aufgerufen, bevor ein Account gelöscht wird.

:ARGS --> Benutername des Accounts
:RETURN 0 --> Löschen zulassen
:RETURN 1 --> Löschen verhindern

'''f_onchar_create'''

'''f_onchar_delete'''

'''f_onserver_start'''

'''f_onserver_save'''

'''f_onserver_save_ok'''

'''f_onserver_save_fail'''

'''f_onserver_save_finished'''

'''f_onserver_exit'''

'''f_onserver_blockip'''

[[Category:Tutorials]]

De:Chapter 2

2010-12-05T10:27:58Z

Sco: Created page with '{{Languages|Chapter_2}} ==spheretables.scp== Spheretables.scp ist die allererste Datei, die beim Start von Sphere genau nach der Sphere.ini eingelesen wird. Deshalb ist sie ä...'

{{Languages|Chapter_2}}

==spheretables.scp==

Spheretables.scp ist die allererste Datei, die beim Start von Sphere genau nach der Sphere.ini eingelesen wird. Deshalb ist sie äusserst wichtig. Viele weitere Einstellungen werden innerhalb dieser Datei vorgenommen und das macht sie so wichtig. Deshalb wird diese Datei hier nun erklärt und aufgeschlüsselt:

<nowiki>==</nowiki> [RESOURCES] ==

Öffnet man diese Datei, fällt einem als erstes eine Liste von Dateien ins Auge. Diese Liste ist durch das [RESOURCE]-Tag markiert und sieht so aus:

<tt>[RESOURCES] 
scripts/sphere_defs.scp 
scripts/sphere_book.scp 
scripts/sphere_backward_compatibility.scp 
scripts/sphere_events_human.scp 
scripts/sphere_events_npcs.scp 
scripts/npcs/ 
... </tt>

Hier wird eingestellt, welche und in welcher Reihenfolge Skriptdateien von Sphere geladen werden. Manchmal sollten hier Änderungen mit äusserster Vorsicht vorgenommen werden. Dateien mit DEFNAMES, REGIONS und anderen global benutzten Einstellungen sollten als erstes geladen werden, um Fehler beim Start von Sphere zu vermeiden (obgleich diese Fehler oftmals den Server nicht beeinträchtigen). Beispielsweise wurde in [[De:Chapter 1|Kapitel 1]] das Goldskript behandelt:

TYPE=t_gold

Weiss Sphere aus der nicht, was t_gold bedeutet, dann wird eine Fehlermeldung ausgegeben. Deshalb sollte vor dem Goldskript auf alle Fälle zuerst sphere_defs.scp geladen werden, in der t_gold definiert wurde.

Skripte mit Itemdefinitionen sollten von Skripten mit Templatedefinitionen geladen werden und danach dann Characterdefinitionen. Andere Dateien folgen danach, aber diese Dateien sollten auf jeden Fall in dieser Reihenfolge sein. Der Loot von Monstern benötigt Templates und die wiederum Items und solange Sphere keine Dateien mit Templates oder Items geladen hat, werden hunderte Fehler ausgegeben, die dann korrigiert werden müssen.

'''Anmerkung''': ''Es können ganze Ordner angegeben werden, es muss nicht jede einzelne Datei in der Liste aufgeführt werden. Deshalb enthält die Liste beispielsweise scripts/ am ende von [RESOURCE], damit alle Skripte dieses Ordner geladen werden, die noch nicht aufgeführt wurden.''

<nowiki>==</nowiki> [OBSCENE] ==

Die nächste Sektion ist selbsterklären: [OBSCENE]. Hier werden unerlaubte Namen aufgeführt. Versucht ein Spieler seinem Charakter einen Namen aus der Liste zu geben, dann wird ihm mitgeteilt, dass er einen anderen wählen soll.

<nowiki>==</nowiki> [NOTOTITLES] ==

Hier werden Titel definiert, die basierend auf dem Karmawert eines Spielers angezeigt werden. Diese Sektion sollte nicht angerührt werden, denn fehlt hier eine Zeile wird Sphere nicht mehr starten - diese Zeilen sollten höchstens geändert werden.
This defines the title that will be shown related to the player's karma. Do not touch this section. If you remove a line inadvertently, your server WILL NOT RUN. Only change them.

<nowiki>==</nowiki> [PLEVEL X] ==

Dieser Abschnitt legt fest, welche Befehle mit welchen Accountrechten (PLEVEL) ausgeführt werden können. Jeder nichtgelistete Befehl wird automatisch mit PLEVEL 4 eingeordnet. Das gilt auch für selbstgeschriebene Funktionen (siehe [[De:Chapter 6|Kapitel 6]]). Wie man sieht, gibt es eine große Liste an Befehlen und Funktionen.

'''Anmerkung''': Es muss nicht jede selbstgeschriebene Funktion in diese Liste, da jederzeit weitere [PLEVEL]-Sektionen in anderen Skripten angelegt werden können, obgleich es natürlich organisatorisch besser wäre, diese würden zentral gehalten.

<nowiki>==</nowiki> [RUNES] ==

Das ist die Liste der Worte, die gesagt werden, wenn ein Spruch gezaubert wird (An, Lor, In, usw.). Sie können geändert werden, aber das kann durchaus sehr verwirren. =P

==Sphere.ini==

Sphere.ini enthält alle internen Einstellungen des Sphere Emulators. Um einen Shard zu konfigurieren sollte hier begonnen werden. Um die Datei besser zu erklären, wurden Kommentare in '''fetter Schrift''' eingefügt.

<tt>//**************************************************************************** 
// SPHERE by : Menasoft 1997-2003 
// www.sphereserver.com 
// All SPHERE script files and formats are copyright Menasoft & Partners. 
// This file may be freely edited for personal use, but may not be distributed 
// in whole or in part, in any format without express written permission from 
// Menasoft & Partners. All donations and contributions 
// become the property of Menasoft & Partners. 
//**************************************************************************** 
 
/////////////////////////////////////////////////////////////// 
//////// General Information 
/////////////////////////////////////////////////////////////// 
 
[SPHERE] 
// Name of your Sphere shard 
ServName='''WarAngel's Test Centre''' 
// The IP of your server, this will be 127.0.0.1 almost always 
ServIP=127.0.0.1 
// The port of your server, this is 2593 by default 
ServPort=2593 
 
// Admin's contact email 
AdminEmail='''warangel999@msn.com''' 
// Web page for this server 
URL=www.myshard.com Replace www.myshard.com with your shard's URL' 
// GMT offset, from -12 to +12 [London=0, EST=5, etc] 
TimeZone='''-5 Östliche Zeitzone (US & Canada). Sollte passend eingestellt werden.''' 
 
// Official staff language 
Lang=English 
// Start this as a system service on Win2000, XP, NT 
NTService=0 '''Wird diese Einstellung aktiviert, ist kein Zugriff auf die Konsole mehr möglich.''' 
 
// MySql configuration. 
//MYSQL=0 '''Auf =1 wird MySQL aktiviert.''' 
//MySqlHost='''localhost Wird fast immer localhost sein, ausser MySQL läuft auf einen anderen Rechner als der Shard.''' 
//MySqlUser= 
//MySqlPassword= 
//MySqlDatabase= 
 
/////////////////////////////////////////////////////////////// 
//////// File Locations 
/////////////////////////////////////////////////////////////// 
// Directory where spheretables.scp is located, from there we will 
// load any additional scripts 
ScpFiles=scripts/ 
 
// Where your sphereworld.scp and spherechars.scp are located 
WorldSave=save/ 
 
// Where your sphereaccu.scp and sphereacct.scp is located 
AcctFiles=accounts/ 
 
// Where your UO installation is located. This need: map0.mul, statics0.mul, 
// staidx0.mul, multi.mul, multi.idx, hues.mul, tiledata.mul. 
// Optional files: verdata.mul, mapX.mul/staticsX.mul/staidxX.mul for higher 
// maps support (Malas, etc). 
// 
// Note that if not set, sphere will scan windows registry to auto-detect it 
//MulFiles=mul/ 
 
// Where your log files will be saved by sphere 
Log=logs/ 
 
/////////////////////////////////////////////////////////////// 
//////// World Save Information 
/////////////////////////////////////////////////////////////// 
// How often for Sphere to save your world (minutes) 
SavePeriod=20 
 
// How many backup levels to keep. Each level means 7 backups done for it. 
// So, 10*7 = 70 backup saves will be storied. 
BackupLevels=10 
 
// On would save in the background quietly over a longer period of time, and not interrupt the game 
// Off would notify "World save has been initiated" and save faster, but pause the game momentarily 
SaveBackground=0 
 
/////////////////////////////////////////////////////////////// 
//////// Account Management 
/////////////////////////////////////////////////////////////// 
//Code for servers account application process 
// 0=Closed, // Closed. Not accepting more. 
// 2=Free, // Anyone can just log in and create a full account. 
// 3=GuestAuto, // You get to be a guest and are automatically sent email with u're new password. 
// 4=GuestTrial, // You get to be a guest til u're accepted for full by an Admin. 
// 6=Unspecified, // Not specified. 
// To enable auto account you must set this to 2 
AccApp=0 
 
// Store password hashed with MD5 '''MD5 ist eine Verschlüsselungsmethode zur Speicherung von Passwörtern. Mehr Information: [http://de.wikipedia.org/wiki/MD5 here]''' 
Md5Passwords=0 
 
// local ip is assumed to be the admin 
LocalIPAdmin=1 
 
// Number of chars allowed per account 
MaxCharsPerAccount=5 
 
// Min time for a char to exist before delete allowed (in seconds) 
MinCharDeleteTime=3*24*60 
 
// Max number of Guest accounts allowed 
GuestsMax=0 
 
/////////////////////////////////////////////////////////////// 
//////// Client Management 
/////////////////////////////////////////////////////////////// 
// What client protocol version used 
// Comment out the ClientVersion line to allow any client that is supported. 
//ClientVersion=2.0.3 
 
// Set this to 0 to block login to encrypted clients '''Normalerweise benutzen Clients Verschlüsselung.''' 
UseCrypt=1 
 
// Set this to 1 to allow login to unencrypted clients '''Klappt mit Tools wie bspw.: [http://stud4.tuwien.ac.at/~e9425109/UO_RICE.htm UO Rice] und [http://www.uogateway.com/ UOGateway] to remove encryption on a client''' 
UseNoCrypt=0 
 
// Maximum total open connections to server 
ClientMax=256 
 
// Maximum open connections to server per IP 
ClientMaxIP=16 
 
// Maximum total (not-in-game) connections to server 
ConnectingMax=32 
 
// Maximum total simultaneous (not-in-game) connections to server per IP 
ConnectingMax=8 
 
// How long logged out clients linger in seconds 
ClientLinger=15 
 
// Walk limiting code: buffer size (in tenths of second) 
WalkBuffer=75 
 
// Walk limiting code: regen speed (%) 
WalkRegen=25 
 
// Only commands issued by this plevel and higher will be logged 
CommandLog=0 '''0 bedeutet, dass alle Befehle geloggt werden.''' 
 
// Prefix for ingame commands 
CommandPrefix=. 
 
// Use the built in http server 
UseHttp=1 
 
// Use the built in god port 
UseGodPort=0 '''This is for use with the God client''' 
 
// Default setting for all accounts specifying default resdisp. Recommended 
// specifying at least 1 (T2A) here. 
//AutoResDisp=0 '''0=autmatisch herausfinden, 1=T2A, 2=LBR, 3=AoS, 4=SE, 5=ML''' 
 
// Default setting for new accounts specifying default priv level 
//AutoPrivFlags=010 
 
/////////////////////////////////////////////////////////////// 
//////// Game Mechanics 
/////////////////////////////////////////////////////////////// 
// Do not allow entering under roof being on horse? 
MountHeight=0 
 
// Archery does not work if too close (0 = not checked) 
ArcheryMinDist=2 
 
// Maximum Distance for Archery 
ArcheryMaxDist=15 
 
// Speed scale factor for weapons '''Formel ist: VERZÖGERUNG = SPEEDSCALEFACTOR /((DEX + 100) * SPEED)''' 
SpeedScaleFactor=15000 
 
// This is the percent of max weight at which stamina is lost half the time 
// (200 = no effect) 
StaminaLossAtWeight=150 
 
// Weight penalty for running +N% of max carry weight (0 = no effect) 
RunningPenalty=50 
 
// Show people joining/leaving the server 
ArriveDepartMsg=1 
 
// Are house and boat keys newbied automatically 
AutoNewbieKeys=1 
 
// Maximum number of items allowed in bank 
BankMaxItems=1000 
 
// Maximum weight in stones allowed in bank 
BankMaxWeight=1000 
 
// If 1 vendors will take gold only from backpack 
PayFromPackOnly=0 '''Wenn 0, dann nehmen Händler auch Geld vom Bankfach.''' 
 
// Disable weather effects? 
NoWeather=1 
 
// Default light level in dungeons 
DungeonLight=27 '''0 ist am helssten, 30 ist am dunkelsten''' 
 
// Day light level 0-30 '''0 ist am helssten, 30 ist am dunkelsten''' 
LightDay=0 
 
// Night light level 0-30 
LightNight=25 
 
// Wool Regen Time (in minutes) 
WoolGrowthTime=30 
 
// Suppress player speech with 75% of capital letters 
SuppressCapitals=0 
 
// Extra combat flags to control the fight (default:0, 0.55i compatible) 
// COMBAT_NODIRCHANGE 00001 // not rotate player when fighting (like was in 0.51a) 
// COMBAT_FACECOMBAT 00002 // allow faced combat only (recommended) 
//CombatFlags=0 '''Sind beide aktiviert, dann bedeutet das, dass der Spieler den Gegner ansehen muss, um ihn zu treffen.''' 
 
/////////////////////////////////////////////////////////////// 
//////// NPC/Item/Player Management 
/////////////////////////////////////////////////////////////// 
// Distance in tiles before an NPC that's wandered too far from it's home will teleport back 
LostNPCTeleport=50 
 
// Wether PCs get a resurrection robe when they get resurrected. 
NoResRobe=0 
 
// Time for a NPC corpse to decay mins 
CorpseNPCDecay=10 
 
// Time for a playercorpse to decay mins 
CorpsePlayerDecay=15 
 
// Base decay time in minutes for items 
DecayTimer=30 
 
// Put [NPC] tags over chars '''oder [TAME], wenn der NPC gezähmt wurde''' 
CharTags=0 
 
// Flip dropped items 
FlipDroppedItems=0 
 
// Monsters run when scared of death 
MonsterFear=0 
 
// Monsters may fight each other 
MonsterFight=0 
 
// Percent setting of the all NPC move rate, default 100 
MoveRate=100 
 
// Do players receive sounds 
GenericSounds=1 
 
// Max number of items to sell to one person at once 
VendorMaxSell=255 
 
// Max level npc trainers can go 
NPCTrainMax=300 '''300 ist 30.0 skill''' 
 
// Percent of own ability npcs can train to 
NPCTrainPercent=30 
 
// Max level of skill trainable on dummies, archery butte ect.. 
SkillPracticeMax=300 '''300 ist 30.0 skill''' 
 
// Max skill player's will start with on skills they haven't chosen during char create 
MaxBaseSkill=200 '''Hier eine 0, damit Spieler mit keinen Skills ausser den gewählten beginnen.''' 
 
// Time in seconds for hitpoint regeneration 
Regen0=40 
 
// Time in seconds for mana regeneration 
Regen1=20 
 
// Time in seconds for stamina regeneration 
Regen2=10 
 
// Time in minutes for food regeneration 
// 1*60*24 = 1 day of real life time 
Regen3=1*60*24 
 
// Speech block associated to players 
SpeechSelf=spk_player 
 
// Speech block associated to pets 
SpeechPet=spk_pet 
 
// When player skills/stats goes this times more than skillclass allowed, drop 
// them to skillclass level. Setting this to 0 disables the action. 
OverSkillMultiply=2 
 
// NPC AI settings 
// NPC_AI_PATH 0001 NPC pathfinding 
// NPC_AI_FOOD 0002 NPC food search (objects + grass) '''Sorgt dafür, dass NPCs nach Essen bzw Gras suchen (siehe FOODTYPE)''' 
// NPC_AI_EXTRA 0004 NPC magics, combat, etc 
//NPCAI=0 
 
/////////////////////////////////////////////////////////////// 
//////// Crime/Murder/Karma/Fame/Guard Settings 
/////////////////////////////////////////////////////////////// 
// Karma when player goes from good to neutral (from -10000 to 10000) 
PlayerNeutral=-2000 
 
// How many minutes are criminals flagged for 
CriminalTimer=3 
 
// Times a player can snoop before becoming a criminal 
SnoopCriminal=20 
 
// Seconds time to decay a murder count (default 8*60*60 is 8 hours) 
MurderDecayTime=8*60*60 
 
// Amount of murders before we get title 
MurderMinCount=1 
 
// Looting or carving a blue player is a crime 
LootingIsaCrime=1 
 
// Flag players criminal for helping criminals? 
HelpingCriminalsIsaCrime=1 
 
// How long do guards linger about in minutes 
GuardLinger=3 
 
// Will guards kill instantly or follow normal combat rules 
GuardsInstantKill=1 
 
// Limits the MAXHITS/MAXMANA/MAXSTAM changes 
// STAT_FLAG_NORMAL 0x00 // MAX* status allowed (default) 
// STAT_FLAG_DENYMAX 0x01 // MAX* denied 
// STAT_FLAG_DENYMAXP 0x02 // .. for players 
// STAT_FLAG_DENYMAXN 0x04 // .. for npcs 
StatsFlags=0 
 
/////////////////////////////////////////////////////////////// 
//////// Server Mechanics 
/////////////////////////////////////////////////////////////// 
// Experimental flags 
// Flags for options that affect server behaviour and which might affect compatibility 
// See the revisions.txt file for more details on this 
// EF_DiagonalWalkCheck = 00000001 
// EF_UNICODE = 00000002 // No on Linux '''Bringt UNICODE Korrekturen''' 
// EF_Scripts_Ret_Strings = 00000004 
// EF_New_Triggers = 00000008 
// EF_Scripts_Parse_Verbs = 00000010 
// EF_Intrinsic_Locals = 00000020 //'''Erlaubt locals anders zu nutzen. Beispielsweise kann statt <local.x> auch nur <x> benutzt werden.''' 
// EF_Item_Strict_Comparison = 00000040 //'''Sorgt dafür, dass gleiche Items nicht mehr verglichen werden, wie Stoff, Leder, Fell, Holz, Bretter, Pfeile und Bolzen.''' 
// EF_WalkCheck = 00000100 '''//Behebt viele Hauseinbruchsbugs und ähnliche Probleme.''' 
// EF_Script_Profiler = 00000400 
// EF_Size_Optimise = 00000800 
// EF_Minimize_Triggers = 00001000 //Minimize trigger calls (use only 0.51 triggers) 
Experimental=00000 
 
// Option flags 
// Flags for options that affect server behaviour but not compatibility 
// See the revisions.txt file for more details on this 
// OF_Magic_IgnoreAR = 00000001 //'''Magieschaden ignoriert Rüstung (AR)?''' 
// OF_Magic_CanHarmSelf = 00000002 //'''Kann sich ein Spieler mit Magie selbst verletzen? (einen Magic Arrow auf sich abfeuern, um Lähmung (Paralyze) zu beenden?)''' 
// OF_Magic_StackStats = 00000004 
// OF_Archery_CanMove = 00000010 //'''Kann ein Spieler laufen und schiessen gleichzeitig?''' 
// OF_Magic_PreCast = 00000020 //'''Funktionieren Zauber mit pre-cast oder ist der Spieler solange er zaubert unfähig herumzulaufen?''' 
// OF_Items_AutoName = 00000040 
// OF_FileCommands = 00000080 //'''Aktiviert Befehle zur Dateiverarbeitung, wie writefile usw''' 
// OF_NoItemNaming = 00000100 //'''Verhindert die Benennung von Gegenständen mit "crafted by"''' 
// OF_NoHouseMuteSpeech = 00000200 //'''Können sich spieler in und ausserhalb von Häusern gegenseitig hören?''' 
// OF_Multithreaded = 00000400 //'''Nicht setzen, solange der Server läuft!!! (Macht *Nix Server instabil) Lässt die Verarbeitung von Accounts auf einem anderen Thread laufen''' 
// OF_Advanced_LOS = 00000800 
// OF_Flood_Protection = 00001000 
OptionFlags=0200 
 
// FeatureT2A, used to control T2A expansion features ( default 03 ) 
// FEATURE_T2A_UPDATE 01 // Monster and Lost lands 
// FEATURE_T2A_CHAT 02 // In game chat 
FeatureT2A = 03 
 
// FeatureLBR, used to control LBR expansion features ( default 0 ) 
// FEATURE_LBR_UPDATE 01 // Lbr Monsters 
// FEATURE_LBR_SOUND 02 // MP3 instead of MIDI 
FeatureLBR = 0 
 
// FeatureAOS, used to control AOS expansion features ( default 0 ) 
// Enabling one of them automagically enables AoS basic features 
// FEATURE_AOS_UPDATE 01 // Basic AoS feature 
// FEATURE_AOS_POPUP 02 // Popup infos 
// FEATURE_AOS_DAMAGE 04 // Damage shown on hit 
// FEATURE_AOS_PALNECRO 08 // Fightbook and Paladin/Necro on char creation 
// FEATURE_AOS_TOOLTIP 010 // Tooltips 
FeatureAOS = 0 
 
// FeatureSE, used to control SE expansion features ( default 0 ) 
// FEATURE_SE_UPDATE 01 // Basic SE features 
// FEATURE_SE_NINJASAM 02 // Ninja and Samurai 
FeatureSE = 0 
 
// FeatureML, used to control ML expansion features ( default 0 ) 
// FEATURE_ML_UPDATE 01 // Basic ML features 
FeatureML = 0 
 
// In game effects to turn on and off 
// Messages echoed to the server console while in debug mode 
// DEBUGF_NPC_EMOTE = 0x0001 
// DEBUGF_ADVANCE_STATS = 0x0002 
// DEBUGF_WALKCODES = 0x0080 // try the new walk code checking stuff 
// DEBUGF_NPCAI = 0x0100 // some NPC AI debugging 
// DEBUGF_EXP = 0x0200 // experience gain/loss 
// DEBUGF_LEVEL = 0x0400 // experience level changes 
DebugFlags=0 
 
// Console Hears all that is said on the server 
HearAll=1 
 
// Secure mode attempts to ignore errors, protect from accidently shutdowns 
Secure=1 
 
// Value from 1 to 32, set sectors inactive when unused to conserve resources 
SectorSleep=10 
 
// Disconnect inactive socket in x min 
DeadSocketTime=5 
 
// Always force a full garbage collection on save 
ForceGarbageCollect=1 
 
// Time before restarting when server appears hung (in seconds) 
FreezeRestartTime=60 
 
// Length of the game world minute in real world in seconds 
GameMinuteLength=60 
 
// Bit Mask of the subjects you want to log when logging is on 
// LOGM_ACCOUNTS 0x00080 
// LOGM_SAVE 0x00200 // world save status. 
// LOGM_CLIENTS_LOG 0x00400 // all clients as they log in and out. 
// LOGM_GM_PAGE 0x00800 // player gm pages. 
// LOGM_PLAYER_SPEAK 0x01000 // All that the players say. 
// LOGM_GM_CMDS 0x02000 // Log all GM commands. 
// LOGM_CHEAT 0x04000 // Probably an exploit ! 
// LOGM_KILLS 0x08000 // Log player combat results. 
// LOGM_HTTP 0x10000 
// 01ffff log everything 
LogMask=01ec80 
 
// Amount of time to keep map data cached in sec 
MapCacheTime=120 
 
// Max NPC chars for a sector to prevent lag 
MaxComplexity=32 
 
// Amount of items in one tile so start showing "too many items here" 
MaxItemComplexity=25 
 
// Amount of items in one sector to start showing "x items too complex" 
MaxSectorComplexity=1024 
 
// Limit the number of cycles the while/for loop can proceed. Setting this to 
// zero disables the limitation 
MaxLoopTimes=0 
 
/////////////////////////////////////////////////////////////// 
//////// Magic/Effects Settings 
/////////////////////////////////////////////////////////////// 
 
// Allow casting while equipped 
EquippedCast=1 
 
// Words of power for player using magic 
WOPPlayer=1 
 
// Words of power for staff using magic 
WOPStaff=0 
 
// Reagents lost if magic fails 
ReagentLossFail=0 
 
// Magic requires reagents 
ReagentsRequired=0 
 
// What % of hitpoints players will resurrect with. Note, that if you set this 
// too low, people with little STR will have problems resurrecting. 
HitPointPercentOnRez=33 
 
// How many % of hits will the character loose when starving. 0 disables 
//HitsHungerLoss=0 
 
// Amount of skill of lock picking needed to unlock a magically locked door 
MagicUnlockDoor=900 
 
// Teleport effect for GMs and players. Setting 0 disables the effect 
TeleportEffectStaff=03709 
TeleportEffectPlayers=0372a 
 
/////////////////////////////////////////////////////////////// 
//////// Experience and Level system 
/////////////////////////////////////////////////////////////// 
 
// Enable experience system 
//ExperienceSystem=0 
 
// Experience system settings: 
// 0001 gain experience in combat 
// 0002 gain experience in crafts 
// 0004 allow experience to go down 
// 0008 limit experience decrease by a range witheen a current level 
// 0010 auto-init EXP/LEVEL for NPCs if not set in @Create 
// 0020 allow trigger @ExpChange 
// 0040 allow trigger @ExpLevelChange 
//ExperienceMode=0 
 
// If combat experience gain is allowed, use these percents for gaining exp in 
// Player versus Monster and Player versus Player combats. Value 0 disables gain. 
//ExperienceKoefPVM=100 
//ExperienceKoefPVP=100 
 
// Enable levels system (as a part of experience system) 
//LevelSystem=0 
 
// Level system settings: 
// linear = 0 (each NextLevelAt exp will give a level up) 
// double = 1 (you need (NextLevelAt * (level+1)) to get a level up) 
//LevelMode=1 
 
// Amount of experience to raise to the next level 
//LevelNextAt=0 
 
/////////////////////////////////////////////////////////////// 
//////// Webpage Settings 
/////////////////////////////////////////////////////////////// 
 
// Note, that you can catch error codes by creating sphere404.htm and so on 
// for all HTTP error codes sphere support. 
 
[WEBPAGE 1] 
// Determines what html file is used as base for the status page 
WebPageSrc=scripts\web\spherestatusbase.html 
// Determines where the status page is saved 
WebPageFile=scripts\web\status.html 
// In seconds, how often the status file is updated 
WebPageUpdate=60 
// Required PLevel to view this page (0 = anyone, 6 = admins only) 
PLevel=0 
 
/////////////////////////////////////////////////////////////// 
//////// Abuse Control 
/////////////////////////////////////////////////////////////// 
 
// Block these ips from the server 
// 255 is a wildcard, so 255.255.255.255 disables anyone connecting. 
[BlockIP] 
//123.34.45.56 
//123.45.56.78 
 
/////////////////////////////////////////////////////////////// 
//////// Connection Information 
/////////////////////////////////////////////////////////////// 
 
//First line should be the name of your shard (this is what people see when they connect) 
//Second line should be the IP of your shard (this is almost always 127.0.0.1) 
//Third line should be the port of your shard (this should be whatever ServPort is set to) 
 
//Uncomment next 3 lines below this if you have a router 
//First line should be a name different than your shard name above this 
//Second line should be your real/external IP (www.whatismyip.com) 
//Third line should be the shard port (this should be whatever ServPort is set to) 
[SERVERS] 
'''WarAngel's Test Centre''' 
127.0.0.1 
2593 
 
//External 
//my.ip.goes.here 
//2593 
 
[EOF] </tt>

'''MAPx''' Ist zwar nicht in sphere.ini, kann aber genutzt weden (siehe REVISIONS.txt). Und zwar so:

MAPx=max_x,max_y,sector_size,real_map_number.

Beispiel: MAP1=7168,4096,512,-1

setzt die Größe von map1 auf 7168,4096, die Sektorgröße von map1 auf 512 und die -1 bedeutet, dass die Standarddatei für diese map benutzt wird.

Anderes Beispiel:

MAP50=7168,4096,64,3

Aktiviert die Map mit nummer 50, die eine Größe von 7168,4096, eine Sektorgröße von 64 hat und map3.mul, statics3.mul und staidx3.mul als Dateien benutzt.

==sphere_region.scp==

Dieses Skript stellt Orte auf der Karte ein und defniert, was bspw. dort an Metallen oder Holz abgebaut werden kann, was passiert, wenn diese Orte betreten werden und weiteres. Es enthält zudem Resource-Sektionen, die so aufgebaut sind:

<tt>[REGIONRESOURCE x]</tt>

Diese Sektion enthält den Skill, der benötigt wird, um diese Resource abzubauen, welche Resource der Spieler erhält und wie lange es dauert, damit sie "nachwächst". Ein Beispiel hierfür (es gibt einen Kommentar mit "//t_tree", der aber klar sein sollte, wenn das vorherige Kapitel über defnames gelesen wurde).

<tt>[REGIONRESOURCE mr_tree] 
// lumberjacking default 
// t_tree 
SKILL=1.0,80.0 
AMOUNT=9,30 
REAP=i_log 
REGEN=60*60*10 </tt>

Diese Sektion definiert eine Resource, etwas das gesammelt werden kann. Es vergleicht Skill und Menge. Das bedeutet, dass mit Skill 1.0 maximal 9 i_log und mit Skill 80.ß maximal 30 i_log gesammelt werden können. Alles danach ist nur eine Erhöhung der Chance auf 30 i_log. In der SKILL-Zeile wird also eine Unter- und eine Obergrenze festgelegt, die AMOUNT-Zeile macht selbiges für die Mengen.
Was bringt uns das? Die Zeile: REAP=i_log. Das sagt dem Server, er soll i_log Items erstellen, wenn diese Resource gebraucht wird. Es kann hier alles stehen, was man auf seinem Shard sammelbar machen möchte.
Die nächste Zeile, REGEN, legt in Sekunden fest, wie lange es dauert, damit diese Resource wieder neu abgebaut werden kann. In diesem Beispiel sind das 60*60*10 Sekunden, also 10 Stunden. Als GM können die Punkte wahrgenommen werden, an denen Spieler geschürft oder abgeholz haben, denn dort liegen kleine Kristalle am Boden. Sie sehen wie Spawnpunkte aus, aber sind in Wahrheit Resourcenmarkierungen. Sie markieren, wo eine spezielle Resource geholt werden kann, wie viel geholt werden kann und welchen Typ die Resource hat. Sie haben zudem einen TIMER, der runterzählt (von bspw 36000) und der dann dafür sorgt, dass der Kristall bei 0 gelöscht wird.

<tt>[REGIONTYPE r_default_rock t_rock] 
//Random rocks 
RESOURCES=100.0 mr_nothing 
RESOURCES=500.0 mr_iron 
//RESOURCES=6.0 mr_rusty 
//RESOURCES=6.0 mr_old_copper 
//RESOURCES=6.0 mr_dull_copper 
//RESOURCES=4.5 mr_bronze 
RESOURCES=5.0 mr_copper 
RESOURCES=2.0 mr_gold 
RESOURCES=1.0 mr_rose 
RESOURCES=2.0 mr_agapite 
RESOURCES=1.0 mr_bloodrock 
RESOURCES=1.0 mr_silver 
RESOURCES=0.5 mr_verite 
RESOURCES=0.2 mr_Valorite 
RESOURCES=0.1 mr_mytheril 
RESOURCES=0.1 mr_blackrock 
RESOURCES=0.1 mr_diamond </tt>

Wow? Was sind das für Dinge? mr_iron, mr_agapite? Das ist nirgendwo in der Datei. Auch in sphere_defs.scp findet man diese Definitionen nicht, man muss in sphereitem_ore.scp nachsehen.

<tt>RESOURCES=50.0 mr_iron</tt>

Das sieht irgendwie bekannt aus. Würde es noch mehr, wenns so aussehen würde?

<tt>RESOURCES={ mr_iron 50 mr_copper 5 mr_gold 2 mr_rose 2 ...etc... }</tt>

Möchte wetten, dass es das würde, wenn die vorherigen Lektionen in Kapitel 1 gelesen wurden. Das ist eine gewichtete Liste von Resourcen. In einem etwas anderen Format, als die für Template genutzte Version, aber sie funktioniert genau so. Das ist der einzige Ort in allen Skripten, in denen Kommazahlen genutzt werden können, wie bspw 0.1 und 0.2. Eigentlich stimmt das nur halb, aber Sphere verdeckt erfolgreich, solange in jeder RESOURECE-Zeile eine Kommazahl steht. (Im übrigen sollte nicht ein RESOURCES mit einer Zufallsauswahl geskriptet werden. Sphere wird das nicht richtig auswerten, es sollte dieses Format genutzt werden.)

[REGIONTYPE r_default_rock t_rock] ''Bedeutet:'' r_default t_rock legt einen Defname für einen REGIONTYPE fest, der in anderen Skripten benutzt werden kann (im nächsten Abschnitt bspw. =P). t_rock ist ein Defname (siehe sphere_defs.scp) für Stein, was für Sphere festlegt wo Spieler welche Resource sammeln können (sollte es auf t_water geändert werden, kann im Wasser Erz geschürft werden, was sicher nicht ganz so beabsichtigt ist.)

Hoffentlich erklärt das sphere-resion.scp für jeden. Im nächsten Abschnitt wird gezeigt, wie REGIONTYPE-Einstellungen benutzt werden, damit die Resourcen auch wirklich im Spiel vorhanden sind.

==sphere_mapX.scp==

Willkommen zur einfachsten Datei in Sphere: spheremap.scp. Diese Datei ist vollständig fertiggestellt für die Standardmap. Es ist sehr selten, dass diese Datei verändert werden muss.

Eine Anmerkung, die gleich zu Anfang gesagt werden muss: wird diese Datei verändert, muss der Server neu gestartet werden, damit die Änderung auch übernommen wird. Sollte das innerhalb eine Resyncs passieren, wirds viele Fehler geben.

Diese Sektion zeigt, wie neue Regionen erstellt werden können, zu denen man mit dem .go Befehl reisen kann.

Es gibt momentan 5 Dateien in den Standardskripten, eine für jede Map (Felucca, Trammel, Ilshenar, Malas und Tokuno) die von 0 bis 4 durchnummeriert sind (sphere_map0.scp, sphere_map1.scp usw).

Ich benutze die Region Felucca als ein Beispiel für dieses Tutorial und hier das Skript dafür:

<tt>[AREADEF a_world] 
NAME=Felucca 
EVENTS=r_default,r_default_rock,r_default_water,r_default_tree,r_default_grass 
GROUP=ALLMAP 
P=1323,1624,55,0 
RECT=0,0,6144,4096,0 </tt>

Diese Zeilen bedeuten:

'''[AREADEF somedef]''': Wie in allen anderen Skripten ist das ein Defname - nur hier für eine Region auf dem Server.

'''Name''': Diese Zeile enthält einen Namen für die Region, der angezeigt wird, wenn der .where Befehl im Spiel benutzt wird. Zudem kann .go "Region Name" dafür benutzt werden, um dort hin zu reisen (keine zwei Regionen sollten den selben Namen haben, ansonsten wird hier einiges an Fehlern produziert).

'''Events''': Hier wird festgelegt, was alles in der Regeion passiert und welche Resourcen hier abbaubar sind (siehe den Abschnitt über REGEIONTYPE - diese können hier als EVENT benutzt werden). Neben den Resourcen können hier auch Trigger benutzt werden, die von den EVENTS aufgerufen werden können (wahrscheinlich bemerkt man hier, dass die REGIONTYPE-Sektionen nur Ereignisse für Regionen sind :P), wie beispielsweise @Enter und andere (siehe [[Triggers]]).

'''Group''': Das ist eine Axiseinstellung, die im Travelmenü Regionen gruppiert.

'''P''': Das ist der Ort, an den man mit .go "Region Name" gelangt. Jede Region hat eine solche Angabe und sie liegt normalerweise mitten in der Region oder an einem passenden ort. Wenn eine eigene Region erstellt wird, sollte ein solcher Punkt angegeben werden.

'''RainChance''': Legt die Chance auf Regeion in der Region fest (Rainchance=50 gibt eine 50% Wahrescheinlichkeit) der Rest bedeutet, dass es zu 50% schneit.

'''Rect''': Gibt die Grenzen der Region als Koordinaten an. Die ersten zwei Zahlen sind die Koordinaten des oberen linken Punktes und die zweiten der untere linke Punkt eines Rechtecks. Im Fall von Felucca ist das 0,0 bis 6144,4096 (RECT=0,0,6144,4096). Mit 56b kann auch ein fünfter Wert angegeben werden, nämlich die Karte, auf der die Region liegt, also RECT=0,0,6144,4096,0 (kann auch weggelassen werden, dann wird standardmäßig 0 verwendet - soll das nicht Map 0 sein, dann muss ein Wert angegeben werden, sonst gibts Fehler).

'''Flags''': Regionenflags bestimmen, was in einer Region los ist. Sie beschreiben, ob eine Region bewacht ist, welche Magie genutzt werden kann, wer hier wen verletzen kann und ob es hier regnen kann. Soll das verwendet werden, dann so:

Diese Zeile hinzufügen:

FLAGS=#

Natürlich sollte statt # eine Zahl verwendet werden! Wo diese nummern stehen? Es gibt vordefinierte, aber es gibt eine Liste.

Beispielsweise für eine bewachte und gesicherte Region, sehen sie so aus:

<tt>
::region_flag_safe (02000) 
:+ 
::region_flag_guarded (04000) 
:= 
::06000 </tt>

Das wars. Die FLAGS werden auf 06000 gesetzt. "Aber, aber ... hiess es nicht, dass DEFNAMEs die Eingabe von Zahlen unnötig machen?" (siehe [[De:Chapter 1|Kapitel 1]].) Natürlich, deshalb geht das auch ohne Zahlen und zwar so:

<tt>FLAGS=region_flag_safe|region_flag_guarded</tt>

Das wars. Die Region ist bewacht und sicher.

Aus Sicht eines Admins ist das aber keine gute Idee. Eine derartige Region verhindert, dass Wachen wirklich jemanden töten können, sie rufen sich gegenseitig und werden zu keiner Handlung fähig sein und letztendlich Lag verursachen. Einfach glauben und keine Region mit diesen beiden Flags erstellen.

Hier ist die Liste der möglichen Flags (stehen auch in sphere_defs.scp und können sich von Zeit zu Zeit ändern):

<tt>[DEFNAME region_flags] 
region_antimagic_all 00001 // keine Magie möglich hier. 
region_antimagic_recall_in 00002 // kein Teleport,Recall hier her, keine Markierung von Runen. 
region_antimagic_recall_out 00004 // kein Recall nach draussen von hier aus. 
region_antimagic_gate 00008 // keine Gatezauber hier hin oder hier raus. 
region_antimagic_teleport 00010 // kein Teleport hier her. 
region_antimagic_damage 00020 // Keine "böse" Magie hier. 
region_flag_ship 00040 // Das hier ist ein Schiff - Schiffsbefehle klappen hier. 
region_flag_nobuilding 00080 // kein Gebäude in diesem Areal 
region_flag_globalname 00100 // Sicherstellen, dass der Name global gilt. 
region_flag_announce 00200 // Ankündigung an alle, dass diese Region betreten wird. 
region_flag_insta_logout 00400 // Instant Logout erlaubt. (Hotel?) 
region_flag_underground 00800 // Dungeon Areal. (kein Wetter) 
region_flag_nodecay 01000 // Items am Boden werden nie gelöscht. 
region_flag_safe 02000 // Diese Region sichert vor jedem Schaden. 
region_flag_guarded 04000 // siehe tag.guardowner 
region_flag_no_pvp 08000 // Spieler können sich nicht direkt Schaden. </tt>

Und das wars mit der sphere_mapX.scp Datei.

==sphere_book.scp==
Spherebook.scp ist eine der sinnlosesten Dateien, die zu finden ist. Wie oft liest man schon die Tips auf einem Shard, wenn man einloggt? Ich weiss, dass die meisten Spieler diese Rollen einfach wegklicken. Aber der Inhalt ist in dieser Datei festgelegt. Und Bücher - hab ich die erwähnt? Diese fast-unmöglich-zu-schreiben, selten benutzten Speicherverschwender?

<tt>'''[SCROLL SCROLL_MOTD]''' 
'''[SCROLL SCROLL_NEWBIE]''' 
'''[SCROLL SCROLL_GUEST]''' </tt>

Das sind die Sektionen, die Nachrichten definiert, wenn man einloggt. Alles, das hier nach diesen Tags steht, wird in einer Nachricht auftauchen. Welche Leerzeichen wo gebraucht werden, muss mit vielen Tests herausgefunden werden. Braucht etwas Zeit und es gibt keine echte Möglichkeit das gut zu erklären. Einfach versuchen. Achtung: es gibt hier keine Zeilenumbrüche - oder zumindest gabs in der Vergangenheit keine.

<tt>'''[TIP X]''' </tt>

Richtig. Das sind Tips, die es beim Start gibt. "Krieg ist für Kinder und alles Leben ungesund." ist einer davon. Sehr passend.

<tt>'''[BOOK title]''' 
'''[BOOK title x]''' </tt>

Erstellt ein Buch mit DEFNAME Titel. Es legt eine Seitenzahl x nach dem DEFNAME fest und fügt Text auf einer bestimmten Seite hinzu. Sieht man die Beispielbücher an, kann man erahnen, wie das klappt. Die größte Schwierigkeit dieser Bücher ist die benutzte Schriftart im Spiel, so dass man nicht wirklich weiss, wieviele Zeichen es für eine Zeile oder Seite braucht. Beispielsweise passen mehr 'i's als 'w's oder 'm's in eine Zeile, weil diese Buchstaben größer sind. Ein Absatz kann mit der TAB Taste eingefügt werden.

==sphere_name.scp==

Eine einfache Datei. Es enthält eine Liste von Namen unter Sektionen mit verschiedenen DEFNAMEs. Die Namen sind wichtig, nicht der Inhalt, da man wahrscheinlich nie eine eigene Liste von Namen anlegen wird. Ich benutze diesen Emulator seit Jahren und habe nie diese Datei verändert.

Um auf die Liste der Namen zugreifen zu können, benutzt man das hier:

'''NAME=#NAMES_HUMANMALE'''

Das ersetzt automatisch auf einen Zufallsnamen aus der Liste '''NAMES_HUMANMALE'''.

Um eine Liste von Namen zu erstellen, sieht das so aus:

<tt>[NAMES EIN_DEFNAME] 
ANZAHL_DER_NAMEN 
NAMEN </tt>

Beispielsweise:

<tt>[NAMES NAMES_SPECIAL] 
2 
Hil 
Hol </tt>

Schwierig, hm? Eigentlich wollte ich dafür keinen Abschnitt schreiben ...

==sphere_newb.scp==
Ich habs getan - kein eitler Humor unter diesem Titel! :)

Auf jeden Fall ist diese Datei oft Gegenstand vieler Fragen. "Wie sorge ich dafür, dass meine Spieler mit 10000 Gold anfangen?" oder "Wie gebe ich allen Schmieden 800 Barren?" Ich sag nicht, dass das sinnvoll wäre, aber in dieser Datei können solche Dinge geregelt werden.

<tt>[NEWBIE MALE_DEFAULT] 
// Male Generic Starting Clothes 
ITEMNEWBIE=i_shirt_plain 
COLOR=colors_all 
ITEMNEWBIE=random_pants 
COLOR=colors_neutral 
ITEMNEWBIE=random_shoes 
COLOR=colors_neutral 
ITEMNEWBIE=i_dagger 
ITEMNEWBIE=i_candle 
ITEMNEWBIE=i_book_sm 
ITEMNEWBIE=i_gold,100 </tt>

So sieht ein typisches Skript aus. Wie eine große Template, nicht wahr? Dafür gibts einen Grund. Es ist ein Template, es steht nur '''ITEMNEWBIE''' statt '''ITEM''' drin. In Kapitel 1 steht über Templates alles, was man wissen muss und genau so funktioniert das auch hier.

Das einzige wichtige in diesen Sektionen ist: alles MUSS einen eindeutigen Namen haben, den der Server finden kann. Es kann keine weitere Newbie-Sektion hinzugüfgt werden, so sehr das auch gewollt werden würde - sorry.

==sphere_skill.scp (SKILLCLASSES)==
Skill Klassen legen fest, wie weit Skills/Stats gesteigert werden können und es können zudem Trigger angelegt werden. Ein Skillclass Skript sieht so aus:

<tt>[SKILLCLASS 0] 
// undeclared class. 
// max skills for players of this skill class. 
// might want this to be all 50.0 to make people declare a class? 
DEFNAME=Class_undeclared 
NAME=undeclared 
// EVENTS=e_ClassUndeclared 
STATSUM=300 
SKILLSUM=10000.0 
STR=100 
INT=100 
DEX=100 
ALCHEMY=100.0 
ANATOMY=100.0 
ITEMID=100.0 
ARMSLORE=100.0 
and so on... </tt>

Um es zu verstehen:

'''EVENTS''': Bedeutet, dass jeder mit dieser Skillclass auch die hier angegebenen Ereignisse auslöst. (mehrere EVENTS werden mit Komma getrennt, bspw: EVENTS=e_1,e_2 usw).

'''STATSUM''': Gibt eine Obergrenze für die Summe der Stats an. Bspw: ich hab 100 Str, 100 Dex und 100 Int, dann hab ich 300 und damit STATSUM erreicht, ich kann nicht mehr erreichen (außer mit magischen Gegenständen und sowas).

'''SKILLSUM''': Wie STATSUM, nur für Skills.

'''STR/DEX/INT''': Obergrenze für einen spezifischen Stat (außer mit magischen Gegenständen und sowas).

'''ALCHEMY''': Wie STR/DEX/INT, nur für Skills (in diesem Fall Alchemy, aber kann auch jeder andere sein).

==sphere_serv_triggers.scp==
Diese Datei enthält spezielle Trigger "Functions", die vom Server bei bestimmten Ereignissen aufgerufen werden. Darunter gibt es eine Liste von Funktionen, die in dieser Datei gefunden werden und manche haben auch eine Erklärung dabei:

'''f_onaccount_login'''

Wird aufgerufen, wenn ein Client das Passwort eingegeben hat.

:ARGS --> Benutzername des Clients, der einloggen möchte
:ARGO --> Referenz zum Client selbst
:RETURN 0 --> nichts tun (also Login weiterlaufen lassen)
:RETURN 1 --> die Verbindung zum Client trennen

'''f_onaccount_delete'''

Diese Funktion wird aufgerufen, bevor ein Account gelöscht wird.

:ARGS --> Benutername des Accounts
:RETURN 0 --> Löschen zulassen
:RETURN 1 --> Löschen verhindern

'''f_onchar_create'''

'''f_onchar_delete'''

'''f_onserver_start'''

'''f_onserver_save'''

'''f_onserver_save_ok'''

'''f_onserver_save_fail'''

'''f_onserver_save_finished'''

'''f_onserver_exit'''

'''f_onserver_blockip'''

[[Category:Tutorials]]

De:Chapter 1

2010-11-28T11:10:06Z

Sco: Created page with '{{Languages|Chapter_1}} ==Zahlen== Als erstes wird die verschiedenartige Art und Weise zur Verwendung von Zahlen innerhalb der Sphere Skripte behandelt. Da Zahlen naturgemäß ...'

{{Languages|Chapter_1}}

==Zahlen==

Als erstes wird die verschiedenartige Art und Weise zur Verwendung von Zahlen innerhalb der Sphere Skripte behandelt. Da Zahlen naturgemäß sehr wichtig für einen Sphere Skripte sind, ist dies der erste Abschnitt überhaupt. Am Ende dieser Einheit wird hoffentlich jeder über ein allgemeines Verständnis über hexadezimale, dezimale und binäre Zahlensysteme und die Verwendung in Sphere Skripten besitzen. Zudem wird noch vermittelt, wie einerseits Zufallszahlen innerhalb eines Zahlenbereichs oder aus einer Liste von Zahlen generiert werden können.

Es muss zunächst verstanden werden: wie wir zählen ist nicht die einzige Art zu zählen. Unser Zahlensystem enthält zehn Ziffern (0, 1, 2, 3, 4, 5, 6, 7, 8, und 9). Ab der zehnten Zahl wird eine weitere Ziffer angehängt und die letzte Stelle auf 0 gesetzt (1, 2, 3, 4, 5, 6, 7, 8, 9, 10). Deshalb funktioniert unser Zahlensystem wie es funktioniert.

Im Dezimalsystem, ohne dass wir davon Notiz nehmen, schreiben wir diese Zahlen immer als Zehnerpotenzen. Beispielsweise die beliebige Zahl 17282 aufgeteilt in Zehnerpotenzen:

{| border="1"
| Zehnerpotenz || 4 || 3 || 2 || 1 || 0
|-
| 10 hoch Zehnerpotenz || 10000 || 1000 || 100 || 10 || 1
|-
| Ziffer || 1 || 7 || 2 || 8 || 2
|}

Um zur Zahl 17282 zu gelangen, wird immer 10 hoch Zehnerpotenz mal der Ziffer in der untersten Zeile berechnet und am Ende alle Ergebnisse addiert. Das Ergebnis: 10000 + 7000 + 200 + 80 + 2. Offensichtlich ist das sehr einfach und jeder tut das ständig ohne davon Notiz zu nehmen. Du fragst dich sicherlich jetzt "Richtig, warum schrieb Taran das alles?" Die Sache ist die, dass unser Zahlensystem nicht das einzige ist.

Computer zählen beispielsweise komplett anders. Sie kennen nur zwei Ziffern (1 und 0) und das wird dann Binärsystem genannt. Binäre Zahlen sehen beispielsweise so aus: 101011101101. Oftmals tauchen sie in der Werbung für Computer auf. Ziffern im Binärsystem werden Bit genannt (kurz für BInary digiT). Binärzahlen im Kopf zu Dezimalzahlen zu berechnen ist meist nicht ohne weiteres möglich, hierfür braucht es ein wenig Mathematik.

Binärsysteme funktionieren wie Dezimalsysteme, es wird eine Potenz einer Zahl addiert. Da Binarzählen nur aus zwei Ziffern bestehen, handelt es sich hierbei um Zweierpotenzen. Manchen wird die folgende Tabelle sicher bekannt vorkommen:

{| border="1"
| Zweierpotenz || Binärzahl || Dezimalzahl
|-
| 0 || 1 || 1
|-
| 1 || 10 || 2
|-
| 2 || 100 || 4
|-
| 3 || 1000 || 8
|-
| 4 || 10000 || 16
|-
| 5 || 100000 || 32
|-
| 6 || 1000000 || 64
|-
| 7 || 10000000 || 128
|-
| 8 || 100000000 || 256
|-
| 9 || 1000000000 || 512
|-
| 10 || 10000000000 || 1024
|}

Spannend oder? :)

Wir brauchen ein besseres System! Der Grund, dass seltsame Ergebnisse auftreten, liegt daran, dasss 10 keine Potenz von 2 ist. Wir brauchen deshalb ein System, das eine Zweierpotenz als Basis hat. Das am meisten genutzte System ist ein 16er System, auch hexadezimal genannt. Im Sphere-Forum sieht man das Wort hex sicherlich an der ein oder andren Stelle, das ist kein Fluch und auch kein böser Zauber. Es ist eine Kurzform für "hexadecimal".

{| border="1"
| Binär || Dezimal || Hexadezimal
|-
| 1 || 1 || 1
|-
| 10 || 2 || 2
|-
| 11 || 3 || 3
|-
| 100 || 4 || 4
|-
| 101 || 5 || 5
|-
| 110 || 6 || 6
|-
| 111 || 7 || 7
|-
| 1000 || 8 || 8
|-
| 1001 || 9 || 9
|-
| 1010 || 10 || A
|-
| 1011 || 11 || B
|-
| 1100 || 12 || C
|-
| 1101 || 13 || D
|-
| 1110 || 14 || E
|-
| 1111 || 15 || F
|-
| 10000 || 16 || 10
|}

Ersichtlich, wie das funktioniert? Es gibt sechs Ziffern, die zusätzlich am Ende des Systems herangezogen werden müssen, es werden üblicherweise hierfür die ersten 6 Buchstaben des Alphabets verwendet.

Innerhalb von Sphere Skripten wird beinahe NIE mit Binärzahlen gearbeitet, die KEINE Potenz von zwei sind und wenn, dann kann jeder herkömmliche Taschenrechner benutzt werden, um sie umzurechnen. Mit Hexadezimalzahlen ist das um einiges einfacher.

(This is the last table, I promise!!)
{| border="1"
| Binär || Hexadezimal
|-
| 000000001 (1) || 01
|-
| 000000010 (2) || 02
|-
| 000000100 (3) || 04
|-
| 000001000 (4) || 08
|-
| 000010000 (5) || 010
|-
| 000100000 (6) || 020
|-
| 001000000 (7) || 040
|-
| 010000000 (8) || 080
|-
| 100000000 (9) || 0100
|}

Wie in der Tabelle ersichtlich gibt es ein Muster in der Hexadezimalspalte. Man könnte meinen, dass da ein Muster in den Zahlen 1, 2, 4 und 8 auftritt. Das stimmt auch. Ein weiteres Detail sind die führenden 0en für Hexadezimalzahlen (0100 statt nur 100). In Sphere bedeutet eine solche führende 0: "Diese Zahl ist eine Hexadezimalzahl!" und dementsprechend sind 100 und 0100 völlig verschiedene Zahlen.

Angenommen in einem Sphere Skript wird das 13. bit in einer Zahl benötigt (FLAGS beispielsweise), dann würde so etwas verwendet werden:

'''SRC.FLAGS |= 8192'''

Allerdings: merkt man sich wirklich, dass 8192 das Ergebnis von 2 hoch 13 ist? Das tut man nicht, es ist viel einfacher diese Liste durch zu gehen, bis man zur 13. Zahl kommt (wichtig: Zählen beginnt immer bei 0!).

{| border="1"
| 01 || 02 || 04 || 08 || 010 || 020 || 040 || 080 || 0100 || 0200 || 0400 || 0800 || 01000 || 02000
|-
| 2^0 || 2^1 || 2^2 || 2^3 || 2^4 || 2^5 || 2^6 || 2^7 || 2^8 || 2^9 || 2^10 || 2^11 || 2^12 || 2^13
|}

Und hier sind sie: die ersten 14 Zweierpotenzen in Hexadezimal.

'''SRC.FLAGS |= 02000'''

Diese Zeile ist identisch zur obigen, nur dass 8192 (dezimal) GLEICH 02000 (hexadezimal) ist.

'''8192 = 02000'''

Nun könnte man sagen "Wie weiß ich, dass das nicht frei erfunden ist?". Nunja, schon der windowseigene Microsofttaschenrechner beherrscht die Umrechnung zwischen Binär-, Hexadezimal-, Dezimal und Oktalzahlen (ein weiteres, aber in Sphere nutzloses Zahlensystem). Der Taschenrechner von Windows befindet sich im Startmenü unter Programme im Zubehör. Im Taschenrechner wird im Menü Ansicht auf Wissenschaftlich umgestellt. Die Oberfläche des Taschenrechners verändert sich dann ziemlich. Um damit eine Zahl zwischen den Systemen umzurechnen, muss nur die originale Zahl eingegeben werden und dann kann zwischen den verschiedenen Zahlensystemen (Hex, Dez, Okt, Bin) umgeschaltet werden. Eine 0 vorne an eine Hexadezimalzahl gehängt und Sphere interpretiert sie als auch als eine hexadezimale Zahl.

Das war vermutlich das schwierigste in allen Sphere Skripten. Glücklicherweise, wegen des nächsten Abschnitts, muss sich ab jetzt niemand mehr mit angsteinflössenden Zahlen beschäftigen. Wenn du nach dieser Einheit noch dabei bist, wird sicher alles gut!

Weiter gehts mit: Skripten für Sphere!

==Defnames==

Hier eine Liste angsteinflössender Zahlen, die man innerhalb von Sphere Skripten antrifft:

{| border="1"
| angsteinflössende Zahl || Was sie bedeutet
|-
| 0eed || ID einer Goldmünze
|-
| 0dda || ID eines roten Moongates
|-
| 1650,1440 || Koordinaten von Britain
|-
| 021 || Farbcode für die Farbe "rot"
|-
| 04000 || Farbcode für unsichtbar
|-
| 04000efad || Eindeutige serielle Nummer eines Gegestands
|-
| 4 || Das PLEVEL eines GMs
|-
| 2048 (or 0800) || Flag für den Unsichtbarkeitszauber
|-
| 010 (or 16) || Memory type für Aggressoren
|}

Offensichtlich will solche Zahlen niemand auswendig kennen. Aber in frühesten Versionen, weit vor Sphere und TUS (vor .50 Sphere) und tief im Nebel von Grayworld (vor .41 TUS), musste jeder Skripter diese Zahlen kennen. I kenne diese Zahlen (ausser die serielle Nummer, die frei erfunden ist) und noch ein paar weitere, allesamt tief verinnerlicht. Glücklicherweise hat sich für jeden, der nicht gern Zahlen auswendig kennen will, Sphere dazu entwickelt, dass Namen statt Zahlen verwendet werden können.

Zwar wird alles mögliche immer noch mit Zahlen verknüpft, aber diese Zahlen sind mittlerweile mit Namen verknpft worden.

Gib im Spiel .add 0eed ein und drücke die Returntaste. Ein Zielcursor taucht auf und es kann eine Goldmünze erschaffen werden.

Nun gib .add i_gold ein und drücke Return. Es passiert genau das selbe.

Natürlich kann man sich i_gold leichter als 0eed merken. Aber wie funktioniert das? Dazu muss die Skriptdefinition von einer Goldmünze angesehen werden. Dieses Skript muss an dieser Stelle noch nicht verstanden werden, Itemskripte werden später genauer behandelt. Dieser Skriptausschnitt findet sich in der Datei sphere_item_resources.scp.

<tt>[ITEMDEF 0eed] 
//gold coin 
DEFNAME=i_gold 
TYPE=T_GOLD 
VALUE=1 
CATEGORY=Provisions - Miscellaneous 
SUBSECTION=Coins 
DESCRIPTION=Gold Coin 
DUPELIST=0eee,0eef </tt>

Die rotmarkierte Zeile ist für diese Lektion von Belang. Ansonsten ist noch die erste Zeile, die 0eed enthält, inteessant, aber der Rest kann getrost ignoriert werden vorerst. Die 0eed ist die Nummer des Items, diese Nummern werden im nächsten Abschnitt behandelt.

Wirklich interessant ist allerdings DEFNAME=i_gold. Diese Zeile legt im Server fest: "Ab jetzt wird 0eed mit i_gold identifiziert". Wird vor dieser Zeile irgendwo innerhalb eines Skripts i_gold verwendet, wird der Server einen Fehler melden (siehe [[Chapter 2|Kapitel 2]] über die Reihenfolge von Skripten), aber jetzt ist ihm bekannt, worauf i_gold verweist und es kann in Skripten oder im Spiel frei verwendet werden.

Es sollte IMMER ein solcher Name mit DEFNAME erstellt werden, wenn ein Item geskriptet wird. Normalerweise wird dieser defname in [ITEMDEF] selbst festgelegt (mehr darüber später), aber wenn unbedingt Zahlen verwendet werden sollen, sollte zudem noch ein einfach zu zu merkender Name verwendet werden (bspw nicht goldenes_gulasch für ein Schwert). Es macht das Leben einfacher, als Zahlen zu benutzen.

Eine zweite Möglichkeit, DEFNAME zu nutzen, ist die Nutzung eines [DEFNAME]-Abschnitts. Hier ein Beispiel dafür:

<tt>[DEFNAME colors] 
color_blue 02 
color_red 021 
color_green 041 </tt>

Ein ähnliches Skript steht in spheredefs.scp, eine weitere Datei, die ganz am Anfang geladen werden sollte.

Hier eine Aufschlüsselung dieses Skripts, Zeile für Zeile:

'''Zeile 1''': Hier wird der Typ des Skripts festgelegt und der Name dafür (Colors in diesem Fall). Hier wird dem Server vermittelt, dass von dieser Zeile bis zum nächsten Identifier (das sind die Zeilen die von eckigen Klammern eingerahmt sind) eine bestimmte Art von Skript enthalten ist. Alle Identifier haben dieses Format. Der erste Parameter legt dabei den Skripttyp fest und davon gibt es mehrere, die in den weiteren Kapiteln abgehandelt werden. Der zweite Parameter ist entweder eine Zahl als ID oder ein Defname. In den meisten Fällen wird in selbst geschriebenen Skripten wird hier ein Defname stehen. Die einzige Ausnahme besteht dann, wenn neue Items in die Clientdateien eingefügt werden.

'''Zeilen 2-4''': Diese Zeilen enthalten individuelle Teile. Es wird festgelegt, dass color_blue gleich 02, color_red gleich 021 und color_green gleich 041 ist. Zwischen dem Namen und dem Wert können beliebig viele Leerzeichen enthalten sein. Die Definitionen in spheredefs.scp sind so ziemlich die nützlichsten auf die man treffen kann, da sie es unnötig machen, viele angsteinflössende Zahlen zu verwenden. In spheredefs.scp werden deshalb Namen für Flags, für Attribute von Items, für verschiedene Töne und Klänge, für Memory Types und viele andere Dinge festgelegt. Einen Blick in diese Datei zu werfen ist sicherlich zuweilen ganz ratsam.

Das wars mit DEFNAMES. Weiteres taucht später in allen möglichen Skripten auf.

Jetzt werden Items abgehandelt.

==ITEMDEF==
Oder: wie macht man aus einem Maulwurfshügel einen Berg auf Sphere-Art.

Die meisten machen sich Itemskripte schwieriger, als es nötig ist. Für die Zwecke dieses Tutorials, da es noch ein weit fortgeschritteneres später gibt, werden hier nur einfach die Grundlagen eines ITEM Skripts behandelt, Zeile für Zeile. Wir werden das Goldskript vom vorherigen Absatz verwenden, vorausgesetzt ich finde es ...

Ok, hier ist es, mit Farbe unterlegt, damit es schöner anzusehen ist!

<spherescript>[ITEMDEF 0eed]
//gold coin
DEFNAME=i_gold
TYPE=T_GOLD
VALUE=1
CATEGORY=Provisions - Miscellaneous
SUBSECTION=Coins
DESCRIPTION=Gold Coin
DUPELIST=0eee,0eef</spherescript>

Das ist das einfachste aller Itemskripts, da es weiteres Verhalten, als einfach nur zu existieren benötigt. Es wird nun jede Zeile erklärt und was es damit auf sich hat:

'''Zeile 1''': [ITEMDEF 0eed]

Die erste Zeile eines Itemskripts ist die wichtigste. Grundsätzlich bedeutet diese Zeile für den Server "Hey, das ist ein Item und es soll 0eed heißen!". Der Server sieht sich dann die Clientdateien an (vor allem art.idx), und gleicht ab, ob das Item eins der eingebauten ist. Ich glaube, alle Items mit Nummern unter 04500 gelten als eingebaut, deshalb sollte nie ein neues Item mit einer Zahl definiert werden, die darunter liegt. Bei Eingabe dieser Zeile, wird der Server wissen, dass ein Itemskript folgt. Außerdem wird 0eed als gültiges Item festgelegt, was später nützlich ist, wenn die Spieler Gold brauchen!

'''Zeile 2''': // gold coin

Das ist die Sphereversion eines Kommentars. C-Programmierer kennen das Format (Anmerkung des Übersetzers: eigentlich kennt man das erst ab C++). Jede Zeile, die mit // beginnt ist eine Kommentarzeile und alles, was in einer Kommentarzeile enthalten ist, wird nicht vom Server interpretiert oder gelesen. Diese Kommentare können aber auch an beliebiger Stelle innerhalb einer Zeile beginnen um am Ende einer Zeile eine Erklärung einzufügen. Auf jeden Fall sind Kommentare nicht für die Funktion des Skriptes relevant, sondern können sie unter Umständen verständlicher machen.

'''Zeile 3''': DEFNAME=i_gold

Du solltest jetzt wissen, was diese Zeile bedeutet. Wenn nicht, dann sollte die vorherige Einheit nochmal wiederholt werden. Es legt im Server fest, dass i_gold und 0eed das selbe sind. In Itemskripten sind alle alle Parameter nach diesem Format spezifiziert:

variable=wert

Später, wenn es um Skripte geht, wird ersichtlicher, dass dieses Format sehr hilfreich ist. Items haben einige Variablen, die belegt werden können, unter anderem:

* DEFNAME
* ID
* TYPE
* VALUE
* RESOURCES
Andere Variablen sind wiederum vom Wert von TYPE abhängig.

'''Zeile 4''': TYPE=t_gold

"Was ist t_gold?" Auch das ist nur ein DEFNAME. Also eine Zahl, in diesem Fall 72. In spheredefs.scp steht diese Zahl, also hätte TYPE=72 den selben Effekt.

Momentan gibt es 183 eingebaute Itemtypen. Sie sind hardcoded (=fest in Sphere implementiert) und enthalten vordefinierte Verwendungszwecke für einen Gegenstand. Hat ein Gegenstand keinen Typ, dann erhält man eine "You cannot think of a way to use that item"-Nachricht, wenn man im Spiel das Item anklickt. Es gibt eine vollständige Liste von Itemtypen und wie sie genutzt werden. Der Typ t_gold hat nur einen Effekt: der Gegenstand wird behandelt wie eine Goldmünze (d.h: es können damit Dinge gekauft werden!). Andere Gegenstände den Typ t_gold zu geben würde den Server dazu veranlassen auch diese Dinge als Währung heran zu ziehen. Ich habe das nie versucht, aber es könnte eine interessanter Weg sein einzigartige Währungen zu haben ...

'''Zeile 5''': VALUE=1

Diese Zeile legt fest, wie viel ein Item wert ist, wenn es gekauft wird - in Gold. Natürlich ist eine Goldmünze eine Goldmünze wert, deshalb wird der Wert hier auf 1 gesetzt.

'''Zeilen 6-8''': CATEGORY, SUBSECTION, DESCRIPTION

Diese Zeilen werden nur von Spheres GM-Tool, Axis, benutzt, das es unnötig macht, im Spiel ".add i_gold" einzugeben. Wichtiger noch, es übernimmt solche Aufgaben auch für Items, die keinen DEFNAME haben, sondern nur eine Nummer.

'''Zeile 9''': DUPEITEM

Es wäre viel Arbeit für das Sphereteam alle 8000 Items im Spiel zu definieren, vor allem, wenn viele eigentlich ein und das selbe sind. (Beispielsweise kann eine Tür mit dem Befehl .xflip gedreht werden. Dieser Befehl läuft durch alle DUPEITEMS, die für ein Item angegeben sind.) Die Liste von Nummern sind Itemnummern, die vielleicht noch nicht definiert wurden. Hier wäre das Skript für 0eee:

<spherescript>[ITEMDEF 0eee]
//gold coins
DUPEITEM=0eed
CATEGORY=Provisions - Miscellaneous
SUBSECTION=Coins
DESCRIPTION=Gold Coins</spherescript>

In diesem Skript gibt es nur einen Parameter für das Item. Es verweist den Server auf das DUPEITEM, das unter 0eed (oder i_gold) angelegt wurde, um die Informationen von dort, wie TYPE und VALUE zu verwenden. DUPEITEM spart Tipparbeit, wahrscheinlich wird es selten benutzt.

==CHARDEF==
Oder was es braucht, einen nackten Mann zu machen, der rumstehen und "Huh?" sagen kann.

NPCs machen die Welt lebendig. Sie sind das, was UO zu einem einzigartigen Multiplayer Spiel macht. Die Monster und NPCs die du skriptest machen den Server einzigartig im Vergleich zu jedem anderen. Dieser Abschnitt des ersten Kapitels wird beinhalten, wie ein einfacher nackter Mann geskriptet wird, der herumwandern und ein wenig mehr als "Huh?" (oder "Halt Dieb!", wenn man so will) sagen kann.

Als erstens sehen wir uns das SKript eines einfachen nackten Mannes an. Es befindet sich in spherechar_human.scp.

<spherescript>[CHARDEF 0190]
DEFNAME=c_man
Name=Man
ICON=i_pet_MAN
CAN=MT_EQUIP|MT_WALK|MT_RUN|MT_USEHANDS
RESOURCES=i_flesh_head, i_flesh_torso, i_flesh_right_arm, i_flesh_left_arm
FOODTYPE=15 t_food, t_fruit
DESIRES=i_gold,e_notoriety
AVERSIONS=t_TRAP,t_eerie_stuff
SHELTER=r_house
BLOODCOLOR=0

TSPEECH=spk_human_prime
TSPEECH=spk_human_default
TEVENTS=e_Human_HearUnk
DESCRIPTION=Man
SUBSECTION=Miscellaneous
CATEGORY=Civilized</spherescript>

Wie ersichtlich sieht es sehr viel anders aus als die Skripte der vorherigen Abschnitte. Es werden eine ganze Menge an Variablen gesetzt, die gleich sind wie der DEFNAME, DESCRIPTION und die anderen Axis Variablen.

Aber es gibt auch eine Menge neuer Dinge hier, die der Reihe nach und Zeile für Zeile betrachtet werden! Und es ist länger diesmal! Let the good times roll! (Entschuldigung an alle Nichtamerikaner, alle amerikanischen Cliches sind vermutlich irritierend!)

'''Zeile 1''': [CHARDEF 0190]

Überraschung! Ein Identifier, der dem Server mitteilt, dass hier ein Charakter bis zum zum nächsten Identifier definiert wird. Und zudem wird für diesen Charakter bzw. NPC die ID 0190 gesetzt. Der Server kennt diese ID, da es eine eingebaute ist. In der Tat gehört diese ID zum nackten Mann. Des weiteren steht 0190 als hexadezimale Zahl natürlich für 400, nicht wahr? :) Warum weißt du das nicht? OK, nur ein Witz, das muss man natürlich nicht wissen.

'''Zeile 2''': DEFNAME=c_man

Nichts neues. c_man entspricht hiermit 0190. Die meisten DEFNAMES für Charaktere beginnen mit c und dann folgt ein _ wie oben.

'''Zeile 3''': Name=Man

Hier ist etwas neues. Items haben einen vorgebenen Namen, der im Server bekannt ist. Charaktere nicht. Deshalb muss ein Name zugewiesen werden. Es kann im Grunde jeder Name zugewiesen werden, den man hier haben möchte, aber da das kein spezifischer Mann ist, heißt er einfach nur Man.

'''Zeile 4''': ICON=i_pet_man

Ich brauchte eine Weile, um das herauszufinden. ICON legt ein kleines Bildchen fest, das man bei benutzung des Tracking Skills sieht und diese kleinen ICONs tauchen im Menü dort auf. Eigentlich sind diese Bildchen Items. Um herauszufinden, wie dieses Bildchen aussieht, kann der Mann einfach im Spiel mit .addnpc c_man erstellt werden und dann der .shrink Befehl auf ihn angewendet werden. Die ID dieses Items wird dann zum i_pet Item.

'''Zeile 5''': CAN=mt_*

(Falls * nicht bekannt ist: * heisst "alles mögliche" für diejenigen, die Linux nutzen.)

Das ist eine der wichtigsten Zeilen im Character Skript, neben der ID die in der ersten Zeile vergeben wird. Sie lässt uns festlegen, was ein NPC tun kann und was nicht. Es gibt nur ein paar wenige Möglichkeiten für mt_*, die alle in der spheredefs.scp definiert sind. Für unsere Zwecke sind sie hier hin kopiert worden.

<spherescript>MT_NONMOVER 0 // We can't move at all
MT_GHOST 01 // We can walk through doors and such, like a ghost
MT_SWIM 02 // I can swim! (Water elementals, dolphins, etc)
MT_WALK 04 // I can move. Set this if you want your creature to move.
MT_FLY 010 // Moves through (supposed to be over) trees
MT_FIRE_IMMUNE 020 // Immune to damage by fire. Setting this on a player is bad. :)
MT_EQUIP 00100 // Can equip things
MT_USEHANDS 00200 // Can use his hands to carry things (or open doors)
MT_MALE 0 // Is a male
MT_FEMALE 00800 // Is a female
MT_NONHUM 01000 // Non-human. I'm not sure what this does.
MT_RUN 02000 // Can move really fast!</spherescript>

Nach dieser Tabelle wird klar, dass ein NPC ohne CAN Flags ein MT_Male und MT_NONMOVER (zweimal 0) ist. Die Flags können durch ein | (Alt Gr + <) getrennt in einer Liste angegeben werden, so dass ein NPC mehrere solcher Flags erhalten kann. In diesem Fall erlauben wir unserem Mann, dass er etwas ausrüsten (oder anziehen), gehen, rennen und seine Hände benutzen kann. (Interessant ist, dass sogar Kreaturen ohne Hände ihre Hände nutzen können und damit bspw. Lichtquellen tragen können. Feuerelementare tun das beispielsweise, deshalb leuchten sie.)

'''Zeile 6''': RESOURCES

Die Resources sind etwas morbide als Bezeichnung. Vor allem für Personen, denn sie enthalten die Items, die herauskommen, wenn man im Spiel eine Leiche aufschneidet. Gruslig, hm?

'''Zeile 7-10''': FOODTYPE, DESIRES, AVERSIONS

'''FOODTYPE''': Legt fest, welche Art von Essen der NPC essen würde und wenn NPC_AI_FOOD aktiviert ist, sucht der NPC nach so einem Essen wenn er hungrig wird.

'''DESIRES''': Legt fest, welche Art von Items ihn interessieren und wenn NPC_AI_EXTRA aktiviert ist, dann wird ein NPC aus Spielerleichen diese Gegenstände holen oder, falls diese Gegenstände am Boden liegen, zu ihnen hingehen.

'''AVERSIONS''': Das ist nicht ganz klar. Ich nehme an, dass diese Option angibt, was der NPC am liebsten angreift. Beispielsweise: Ich habe ein Pferd mit dem Event e_horse und einen Imp mit AVERSIONS=e_horse, dann würde im Falle eines Kampfs der IMP wohl vorziehen gegen das Pferd zu kämpfen.

'''Zeile 11''': BLOODCOLOR

Jemals vorgehabt den Spielern grünes Blut zu verpassen? Das geht hiermit. Eine Nummer für eine Farbe oder ein DEFNAME funktioniert hier. (Für Farben sollte man versuchen die Zahlen zu lernen, das macht es einfacher.)

Der Rest: TSPEECH and TEVENTS

Diese beiden Zeilen erhalten eigene Kapitel. Sie sind sehr komplex und mitunter die komplexesten Dinge beim Skripten! (Wie oft ich das wohl sagen werde, bis das wirklich wahr ist?)

''Einige andere Dinge:''

Auf 56B gibt es weitere Variablen wie MOVERATE, RESLEVEL, RESDISPDNID and RESDISPDNHUE. Sie klingen schwierig und seltsam, aber das sind sie nicht. Hier ist eine Erklärung:

'''MOVERATE''': Diese Einstellung (die nur innerhalb eines CHARDEF Blocks sein kann) legt fest, wie schnell sich ein NPC bewegt. Je kleiner der Wert, desto schneller ist ein NPC. Beispielsweise für ein Pferd mit vorgegebener MOVERATE von 100, wäre ein anderer NPC mit MOVERATE von 60 schneller als das Pferd. Das ist ganz gut, um schwierige Monster zu skripten, die nur schwer zu erlegen sind.

'''RESLEVEL''': Das sagt Sphere aus welcher Version von UO das Monster abstammt, Beispielsweise hat ein "Wanderer of the Void" RESLEVEL=3 (3 ist AOS) (siehe spheredefs.scp für eine Liste), so dass nur Accounts mit RESDISP 3 oder größer das Monster so sehen, wie es wirklich aussieht.

''NOTE'': Setzt man einen zu niedrigen Wert für RESLEVEL und der Spieler hat die passende Animation nicht, führt das zum Absturz seines Clients.

'''RESDISPDNID''': Wie wahrscheinlich bemerkt, sagte ich oft nun "wie er wirklich" ist, genau wegen dieser Einstellung. Das legt fest, wie ein Monster für einen Spieler aussieht, hat er die Animation nicht. Beispielsweise wird der Wanderer of the Void für jeden mit ACCOUNT.RESDISP=3 oder großer auch wie ein Wanderer of the Void aussehen, aber für alle anderen sieht er wie ein c_spectre aus (wenn es so eingestellt wurde).

'''RESDISPDNHUE''': Das legt fest, welche Farbe für den Spieler das Monster hat, wenn die RESDISPDNID angezeigt wird (und sein account.resdisp kleiner als reslevel dieses Charakters ist).

Hier ist ein Beispiel für diese neuen Einstellungen:

<spherescript>[CHARDEF 310]
DEFNAME=c_Wailing_Banshee
NAME=Wailing Banshee
SOUND=snd_monster_zombie1
ICON=i_pet_wailingbanshee
DAM=11,16
RESDISPDNID=c_spectre
RESLEVEL=3
RESDISPDNHUE=01
ARMOR=20
CAN=MT_WALK|MT_FLY
DESIRES=i_gold,e_notoriety,e_horses,c_man,c_woman,t_corpse
CATEGORY=New Monsters
SUBSECTION=AOS
DESCRIPTION=Wailing Banshee

ON=@Create
NPC = brain_monster
FAME = {100 3000}
KARMA = {-5000 -6999}
STR = {126 166}
INT = {86 115}
DEX = {41 75}
MAGICRESISTANCE = {75.0 95.0}
TACTICS = {45.0 75.0}
WRESTLING = {50.0 70.0}

ON=@NpcRestock
ITEM = i_gold, {50 100}
ITEM = i_reag_daemon_bone, {2 6}</spherescript>

Und das wars. Einfache Charakterskripte und ein paar neue Dinge. Es gibt dazu noch ein spezielles Kapitel nur über das Skripten von NPCs später.

==TEMPLATE==
Oder wie man eine große Menge serverbelastender Items in einen nichtserverbelastenden Container packt.

Jeder hat sie schon gesehen. Die Shards, die keine TEMPLATEs benutzen. Wird beispielsweise ein Drache auf diesen Shards erlegt und lootet man ihn dann, dann findet man statt schön abgepackte Behälter ein paar 100 Tränke im Lootfenster verteilt. Nicht nur das, alle magischen Gegenstände sind auch noch darunter vergraben!

Wie wird das Problem gelöst? Sphere hat ein sehr handhabbares Werkzeug: die TEMPLATES. Sie erlauben, dass Container Items definiert werden und die Items in diesen Containern ebenfalls und zwar gleichzeitig. Das ist doch toll? I dachte es mir, als ich heraus fand, was sie sind. Deshalb wieder eine Zeile für Zeile Aufschlüsselung, diesmal mit einem TEMPLATE aus spheretemp_loot.scp.

<tt>[TEMPLATE 101505] 
DEFNAME=backpack_poor 
CATEGORY=Item Templates 
SUBSECTION=Loot Templates 
DESCRIPTION=Poor Backpack 
CONTAINER=i_backpack 
ITEM={ random_food 1 0 3 },{ 1 3 } 
ITEM={ random_bottle 1 0 8 } 
ITEM={ random_light 1 0 8 } 
ITEM={ random_male_tops 1 0 4 } 
COLOR=colors_all 
ITEM={ random_male_pants 1 0 4 } 
COLOR=colors_all 
ITEM=POOR_GOLD_PILE </tt>

Sieht verwirrend aus. Aber kein Problem, das wird schon alles klar werden, was das bedeutet!

[TEMPLATE 101505]: Als erstes wird die Kopfzeile des templates betrachtet. Interessant an Templates ist, dass der Itemname kein DEFNAME sein kann, sondern eine sehr hohe Zahl sein muss.

DEFNAME=backpack_poor: Natürlich sind die Sphere Entwickler nicht bösartig und haben deshalb hier noch die Möglichkeit eines DEFNAMEs eingeführt.

CATEGORY, SUBSECTION, DESCRIPTION: Der übliche Axiskram. Optional natürlich. In den vorherigen Abschnitten wird das genauer erklärt.

CONTAINER=i_backpack: Ok, nun gehts runter bis aufs Eingemachte. Das ist der Container, der benutzt wird und alle anderen Items landen in diesem. Wenn der Container im Spiel erstellt wird, dann sieht man ihn. In diesem Fall ist das ein Rucksack. Ganz einfach. Hier kann nur ein gültiger Container vom Typ t_container oder t_container_locked angegeben werden.

ITEM={ random_food 1 0 3},{1 3} Das sieht ziemlich kryptisch aus. Deshalb wird diese Zeile ein wenig eingehender beleuchtet.

Als erstes muss ZUFALLSAUSWAHL behandelt werden! Klingt nach Spaß, nicht? Nun ja, klingt auch für mich nicht danach, aber es ist unbedingt notwendig, um einen guten Shard zu bauen.

Sie sind einfache grundlegende Mechanismen, um mit einem Befehl eine zufällige Zahl zu erhalten. Was wäre das schon für ein Shard, auf dem jeder getötete Drache auch eine Platemail of Magic Stuff und ein Super Duper Sword of Power liefern würde? Jeder würde damit herumlaufen, deshalb braucht es etwas Variabilität.

Es gibt zwei Arten von Zufallsauswahlen: gewichtete und bereichsweise Auswahl. Gewichtete Auswahlen funktionieren so: "OK, 1 mal von 10 nimm Nummer A, 3 mal von 10 nimm Nummer B und 6 mal von 10 nimm Nummer C". Bereichsweise Auswahlen funktionieren so: "Wähle eine zufällige Zahl zwischen zwei Zahlen, die ich festlege".

Unser Beispiel nutzt beides - sowohl bereichsweisen als auch gewichteten Zufall. Der Reihe nach:

{ random_food 1 0 3}

Das ist eine gewichtete Auswahl. Um das richtig zu verstehen, wird der Ausdruck zwischen den Klammern in zwei Teile zerlegt:

random_food 1
0 3

Addiert man die letzte Zahl in den beiden Zeilen, erhält man 4. Das sagt Sphere "OK, 1 von 4 Mal, will ich random_food und 3 von 4 Mal wähle ich 0." Man kann auch Zufallsauswahlen verschachteln, aber das wird dann verwirrend.

{ { random_food 1 0 3} 1 random_clothing 1}

Klar, was das heisst?

random_clothing 1
{ random_food 1 0 3} 1

2 ist hier die magische Zahl. Einmal von 2 nimmt Sphere random_clothing und einmal von 2 nimmt Sphere den vorherigen Auswähler, der dann aus seinen eigenen Optionen eins auswählt. Wenn du jetzt schon verwirrt bist, keine Sorge. Das ist sehr selten, aber es wird sich zeigen, wie TEMPLATES diese Probleme lösen können.

Ich habe erwähnt, dass es noch einen weiteren Zufallswähler gibt. Und dieser ist hier:

{1 3}

Anmerkung: Leerzeichen sind hier wichtig. Hier dürfen keine Leerzeichen zwischen { und der ersten Zahl oder } und der letzten Zahl sein. Ansonsten kommt seltsames Verhalten dabei heraus.

Das weist Sphere an "Nimm eine beliebige Zahl zwischen 1 und 3, inklusive". Inklusive heißt, dass Sphere auch 1 und 3 wählen kann oder eben jede Zahl dazwischen. In diesem Fall ist der Bereich sehr beschränkt. Sphere wird eine 1, 2 oder eine 3 liefern. Bereichsweise Auswähler werden oftmals in gewichteten Auswählern benutzt.

{ {1 3} 3 {4 9} 1}

"Einmal aus 4, nimm eine Zahl zwischen 4 und 9. Dreimal von 4, nimm eine Zahl zwischen 1 und 3."

Nachdem wir das nun hinter uns haben, sehen wir uns die Zeile des Skripts von oben an. Der Teil mit ITEM= 
Das legt im Skript fest "Ok, wir werden jetzt ein Item zum Container hinzufügen". Alles nach dem = legt fest, was genau das ist und in welcher Menge. Es kann natürlich geskriptete werden ITEM=i_platemail_chest oder sonst was ohne die mysteriösen { } Auswähler, aber der Grund, warum TEMPLATES so interessant sind, ist die große Variabilität, die sie bringen.

{ random_food 1 0 3}

Das ist das Item, das erstellt wird. Aus der Einheit über gewichtete Zufallsauswahlen, 1 von 4 Mal, wird das random_food sein und 3 von 4 Mal, wird das 0 sein. Wenn ein Item 0 ist, dann wird nichts erstellt. Das bedeutet: "Hier gibt es eine 1 zu 4 Chance, dass random_food im Container auftaucht." Was random_food ist? Das ist ein weiteres TEMPLATE, das in spheretemplate.scp definiert wurde ... glaube ich.

{1 3} Ist die Menge des Items, die erstellt wird. Das ist eine zufällige Bereichsauswhl. Sphere nimmt eine Zahl zwischen 1 und 3 und setzt dann die Menge im Container. Natürlich: ist das Item zuvor 0 geworden, dann wird auch die Menge daran nichts ändern, denn 3 mal 0 ist weiterhin 0.

Das war grundlegend das Template Skript. Hier können noch so viele Items eingefügt werden, wie man Lust hat. Ausserdem ist noch folgendes Konstrukt dann interessant:

ITEM=i_sword_long,R11

Das ist eine Kurzform von:

ITEM={ i_sword_long 1 0 10 }

R11 bedeutet: "1 zu 11 Chance, dass das Item gefunden wird". Und zusätzlich kann noch eine Mengenauswahl hinten angehängt werden, was es ziemlich seltsam aussehen lässt:

ITEM=i_sword_long,R11,{4 5}

Aber warum würde man 4 oder 5 Langschwerter haben wollen? Das wäre noch seltsamer. :)

Das wars von Templates. Gratulation, das erste Kapitel ist hiermit durch. Jetzt sollten die Beispiele im nächsten Abschnitt nicht schwierig zu verstehen sein. Du könntest auch einige fragen haben, die hier allerdings ohnehin nicht beantwortet werden. Einfach weiterlesen, es wird noch vieles in den folgenden Kapiteln abgehandelt.

''(Ein Template Beispiel von Belgar)''

<tt>[TEMPLATE tm_necromancer] 
CONTAINER=i_bag 
ITEM=random_necro_scroll 
ITEM=random_necro_scroll 
ITEM=random_necro_reagent, {5 12} 
ITEM=random_reagent, {5 12} 
ITEM=random_necro_reagent, {5 12} </tt>

==Beispiele==
Oder ... naja, glaub es gibt kein anderes Wort für "Beispiele".

Das soll mein Versuch sein, einfachste simpelste Items zu erstellen. Du wirst hier einige DInge in diesen Beispielen sehen, die in den Tutorials nicht behandelt wurden. Hauptsächlich gibts hier ein ON=@create das im 2. Kapitel abgehandelt wird. Für die Beispiele ist nur wichtig, dass die Farbe der Dinge im Spiel geändert werden kann und dass das unter on=@create passieren muss.

'''Beispiel 1''': Ein rotes Schwert

<tt>[ITEMDEF i_sword_red] 
ID=i_sword_viking 
TYPE=t_weapon_sword 
NAME=Das rote Schwert 
CATEGORY=Weapons 
SUBSECTION=New Swords 
DESCRIPTION=Red Sword 

ON=@Create
:COLOR=colors_red // Das ist ein Kommentar. Kommentare werden von Sphere ignoriert. </tt>

Moment ... was heisst das // an dieser Stelle? Das ist ein Kommentar, er wird gänzlich von Sphere ignoriert, deshalb kann hier alles stehen, solange es hinter den // steht. Es gibt in Sphere keine mehrzeiligen Kommentare, solange man nicht jede Zeile mit // beginnen lässt. Deshalb sollte man das gar nicht versuchen, sonst wird Sphere viele Fehler ausgeben und man darf sie suchen.

'''Beispiel 2''': Ein blauer Ettin

<tt>[CHARDEF c_ettin_blue] 
ID=02 // Hier kann auch c_ettin benutzt werden natürlich. 
NAME=Mein blauer Ettin 
 
 
ON=@Create 
:COLOR=02 // Das ist dunkelblau. Wird oft für Counselorroben benutzt. Merken. </tt>

'''Beispiel 3''': Ein Template aus einer der Dateien, weil ich zu faul bin eins selbst zu schreiben

<tt>[TEMPLATE 101521] 
DEFNAME=goodie_meager_1 
CATEGORY=Item Templates 
SUBSECTION=Loot Templates 
DESCRIPTION=Meager Goodie 1 
ITEM={ meager_gold_pile 1 backpack_meager 1 pouch_meager 1 } 
ITEM={ random_boots 1 0 4 } 
ITEM={ random_gorget 1 0 4 } 
ITEM={ random_staff 1 0 4 } 
ITEM={ random_necklace 1 0 4 } 
ITEM={ i_cape 1 0 9 } 
COLOR=colors_all </tt>

Bemerkenswert ist hier etwas neues (das speziell in rot hervorgehoben ist) und ja, das kann man so schreiben. Alle Zeilen zwischen ITEM= Zeilen betreffen das zuvor erstelle Item. COLOR= bezieht sich also auf die Zeile

ITEM={ i_cape 1 0 9 }

Der beste Weg diese Art von Skripten zu lernen, liegt darin, dass man die Skripte in den Dateien wie beispielsweise sphereitem_colorarm.scp und sphereitem_beers.scp liest.

[[Category:Tutorials]]

De:Chapter 10

2010-11-27T15:23:45Z

Sco: Created page with '{{Languages|Chapter_10}} ==Grundlagen über Strings und Zeichenketten== Dieser Abschnitt behandelt die Verarbeitung von Zeichenketten (Trennung, Vergleich, Umformung, Umkehrung,...'

{{Languages|Chapter_10}}

==Grundlagen über Strings und Zeichenketten==
Dieser Abschnitt behandelt die Verarbeitung von Zeichenketten (Trennung, Vergleich, Umformung, Umkehrung, Speicherung). Viel Spass.

Als erstes wird die Trennung von Zeichenketten behandelt. Die häufigste und einfachste Art nutzt Kommata (,). Die meisten Funktionen in Sphere nutzen sie als Trennzeichen und es ist einfacher als Leerzeichen zu benutzen. Auch Leerzeichen sind gültige Trennzeichen, aber werden kaum verwendet. Diese Funktion stellt dar, warum das so ist:

<spherescript>[FUNCTION f_test]
SERV.LOG Arguments :: <ARGV>
SERV.LOG Arg. 1 :: <ARGV[0]>
SERV.LOG Arg. 2 :: <ARGV[1]>
SERV.LOG Arg. 3 :: <ARGV[2]>
SERV.LOG Arg. 4 :: <ARGV[3]></spherescript>

Wenn wir nun IG ".f_test Hello to all World" eingeben, dann sehen wir sowas in der Sphere Konsole:

<spherescript color="darkgreen">23:01:(Test.scp,2)Arguments :: 1
23:01:(Test.scp,3)Arg. 1 :: Hello To all World
23:01:(Test.scp,4)Arg. 2 ::
23:01:(Test.scp,5)Arg. 3 ::
23:01:(Test.scp,6)Arg. 4 :: </spherescript>

Das bedeutet, dass nur ein Argument der Funktion erkannt wurde und es die komplette Zeichenkette war. Das ist nicht nützlich, denn später muss diese Zeichenkette mit [[#STRARG|STRARG]] oder [[#STREAT|STREAT]] zerschnitten werden. Aber wenn nun die Leerzeichen mit Kommata ersetzt werden, indem ".f_test Hello,to,all,World" eingebenen wird:

<spherescript color="darkgreen">23:02:(Test.scp,2)Arguments :: 4
23:02:(Test.scp,3)Arg. 1 :: Hello
23:02:(Test.scp,4)Arg. 2 :: To
23:02:(Test.scp,5)Arg. 3 :: All
23:02:(Test.scp,6)Arg. 4 :: World</spherescript>

Somit wurde der komplette String zertrennt. Einfach? Ja, aber das ist auch nur der Anfang.

Man kann fast alles mit Zeichenketten anstellen, was man will: Vergleichen, Zerschneiden, Löschen, Verschieben, usw ... Um alle gültigen Operationen zu sehen, gibt es [[#String Functions|eine Auflistung unten]].

==Operationen auf Zeichenketten==

===EXPLODE===
Die EXPLODE Opteration wandelt automatisch beliebige Trennzeichen in Kommata um. Das Ergebnis kann an eine Funktion übergeben werden, die dann mittels ARGV auf die Einzelteile zugreifen kann.

Syntax von EXPLODE: <tt>EXPLODE Trennzeichen, Zeichenkette</tt>

Das folgende Beispiel verwandelt "-"- und "+"-Zeichen in Kommata und schreibt die Ausgabe in das Log der Sphere Konsole:

<spherescript>[FUNCTION f_explode]
F_EXPLODE_LOG <EXPLODE -+,<ARGS>> // Trennt den String bei - und + und übergibt das Ergebnis an F_EXPLODE_LOG

[FUNCTION f_explode_log]
SERV.LOG ARGV Length = <ARGV> // Gibt die Anzahl der Einzelteile aus
FOR 0 <EVAL (<ARGV> - 1)> // Schleife über alle Einzelteile
SERV.LOG ARGV[<LOCAL._FOR>] = <ARGV[<LOCAL._FOR>]> // Ausgabe eines Einzelteils
ENDFOR</spherescript>

===STRARG===
STRARG liefert das erste Wort in einer Zeichenkette. Demonstrationsbeispiel:

<spherescript>[FUNCTION f_strarg]
SERV.LOG <STRARG Eins Zwei Drei></spherescript>

In der Konsole erscheint das Wort "Eins".

===STREAT===
STREAT macht genau das Gegenteil von STRARG. Während STRARG das erste Wort in einem String liefert, löscht STREAT das erste Wort und liefert den Rest. Demonstrationbeispiel:

<spherescript>[FUNCTION f_streat]
SERV.LOG <STREAT Eins Zwei Drei></spherescript>

In der Konsole erscheint der Text "Zwei Drei".

===STRCMP===
Früher oder später müssen Zeichenketten miteinander verglichen werden. Als erstes sollte man folgendes versuchen:

<spherescript>IF ("String1" == "String2")</spherescript>

Falls du das versuchst, wird ein ziemlich hässlicher Fehler auf der Sphere Konsole auftauchen und das IF-Statement wird nicht richtig arbeiten. Der Grund dafür ist, dass IF-Statements dafür ausgelegt sind Zahlen zu vergleichen. Deshalb kann es den Vergleich zwischen zwei Zeichenketten nicht auswerten.

Es wird also eine Möglichkeit benötigt "string1" und "string2" auf Gleichheit zu prüfen, richtig? Deshalb gibt es STRCMP.

<tt>STRCMP(string1, string2)</tt>

Bevor STRCMP benutzt wird, sollte allerdings darauf eingangen werden, dass diese Funktion nicht wirklich zwei Zeichenketten auf Gleichheit überprüft. In Wahrheit liefert STRCMP einen lexikalischen Vergleich und gibt zurück, ob eine Zeichenkette größer oder kleiner als die andere ist (nach alphabetischer Ordnung). Deshalb liefert diese Funktion drei Ergebniswerte:

{|
| '''Rückgabewert''' || '''Bedeutung'''
|-
| -1 || string1 ist kleiner als string2
|-
| 0 || beide sind gleich
|-
| 1 || string1 ist größer als string2
|}

Man sollte die Semantik dieser Funktion im Kopf haben, denn die Funktion liefert naturgemäß "false" (= 0) innerhalb eines IF-Statements, wenn beide Zeichenketten gleich sind.

Hier ein Beispiel:

<spherescript>IF !(STRCMP(<SRC.NAME>, Klein))
SRC.SAY Mein Name ist Klein!
ENDIF</spherescript>

Nun könnte man noch fragen: "Warum muss STRCMP nicht von < > eingeschlossen werden?".

Der Grund ist, dass STRCMP keine 'normale' Funktion ist. Es ist eine ''[[intrinsic function]]'', eine spezielle Funktion, die nur innerhalb von <EVAL ...>-Statements benutzt werden kann und anstelle von < > die Argumente mit ( und ) einschließt.

"Moment, aber STRCMP ''wird nicht'' innerhalb eines EVAL benutzt?!", könnte man jetzt sagen. Aber die Eigenheit von konditionalen Statements (wie [[IF]] und [[WHILE]]) ist, dass Sphere automatisch die angebene Bedingung so behandelt, als wäre ein EVAL-Statement vorhanden. Deshalb funktioniert obiges Skript und vergleicht zwei Zeichenketten.

Des Weiteren ist wichtig zu wissen, dass STRCMP auch Groß- und Kleinschreibung prüft. Deshalb ist "STRING1" nicht gleich "string1". Ein Vergleich, der Groß- und Kleinschreibung ignoriert, kann mit [[#STRCMPI|STRCMPI]] durchgeführt werden.

===STRCMPI===
STRCMPI vergleicht zwei Zeichenketten und ignoriert dabei Groß- und Kleinschreibung. Bis auf diesen Unterschied ist die Funktionsweise mit [[#STRCMP|STRCMP]] identisch.

===STRLEN===
Diese Funktion liefert die Anzahl von Zeichen in einer Zeichenketten. Beispielsweise:

<spherescript>LOCAL.LENGTH = <EVAL STRLEN(<ARGS>)></spherescript>

Angenommen der Inhalt von ARGS wäre "Hier stehen 22 Zeichen". Dann ist LOCAL.LENGTH = 22.

===STRPOS===
STRPOS liefert die Position eines spezifischen Zeichens innerhalb einer Zeichenkette. Die Syntax dieser Funktion ist:

<tt>STRPOS pos ch string</tt>

{|
| '''Parameter''' || '''Bedeutung'''
|-
| pos || Die Startposition ab der nach ch gesucht werden soll. Das erste Zeichen steht auf Position 0.
|-
| ch || Das zu suchende Zeichen oder der ASCII-Code des zu suchenden Zeichens.
|-
| string || Der Text, der durchsucht werden soll.
|}

Hier ein paar Beispiele:

<spherescript>LOCAL.POS = <STRPOS 0 32 Wo ist das erste Leerzeichen> // Rückgabewert: 5
LOCAL.POS = <STRPOS 3 e Wo ist das erste 'e''> // Rückgabewert 11</spherescript>

===STRREVERSE===
Diese Funktion kehrt einfach die die Zeichenkette um. Beispielsweise:

<spherescript>SERV.LOG <STRREVERSE Hallo></spherescript>

Diese Zeile gibt auf der Konsole "alloH" aus.

===STRSUB===
STRSUB kann aus einer Zeichenkette eine Folge von Zeichen extrahieren. Warum das nützlich ist? Es gibt einige Gelegenheiten und sicherlich will man darauf vorbereitet sein:

<spherescript>[FUNCTION TestStrSub]
SERV.LOG <STRSUB 0 1 Hallo></spherescript>

Wie ersichtlich werden für STRSUB drei Parameter benötigt. Der erste ist die Startposition (beginnend bei 0). Der zweite Parameter ist die Länge und schlussendlich ist der dritte Parameter die Zeichenkette.

Wird diese Funktion IG aufgerufen, dann erscheint in der Konsole das erste Zeichen ab der dritten Position. Wichtig ist, dass die erste Position bei 0 beginnt. Wird ein Teilstring ab der allerersten Position benötigt, dann sollte man 0 als ersten Parameter setzen. Der zweite Parameter gibt an, wieviele Zeichen ab der angegebenen Position zurückgegeben werden sollen.

Ein negativer Wert als erstes Parameter weist Sphere an, am Ende der Zeichenkette zu beginnen und von dort aus rückwärts zu zählen. Hier ist ein Beispiel:

<spherescript>[FUNCTION TestStrSub]
SERV.LOG <STRSUB -1 1 Hallo></spherescript>

Bei Benutzung dieser Funktion IG wird das letzte Zeichen auf der Konsole ausgegeben.

Das ist nicht zu schwierig, oder?

===STRTOLOWER===
Diese Funktion verwandelt alle Großbuchstaben einer Zeichenkette in Kleinbuchstaben. Ein einfaches Beispiel:

<spherescript>LOCAL.LOWER = <STRTOLOWER MIt ZeicHENkEtTen herUmSpIelEN ist LusTIG></spherescript>

Diese Funktion liefert "mit zeichenketten herumspielen ist lustig".

===STRTOUPPER===
Diese Funktion macht das genaue Gegenteil von [[#STRTOLOWER|STRTOLOWER]]. Sie wandelt alle Kleinbuchstaben in Großbuchstaben. Das vorherige Beispiel mit STRTOUPPER:

<spherescript>LOCAL.UPPER = <STRTOUPPER MIt ZeicHENkEtTen herUmSpIelEN ist LusTIG></spherescript>

Diese Funktion liefert "MIT ZEICHENKETTEN HERUMSPIELEN IST LUSTIG".

===STRTRIM===
Diese Funktion entfernt alle Leerzeichen (echte Leerzeichen, Tabulatoren und Zeilenumbrüche) am Anfang und am Ende einer Zeichenkette.

Das folgende Skript demonstriert dies:

<spherescript>[FUNCTION f_strtrim]
LOCAL.TEXT = " TEST "
SERV.LOG 1. <LOCAL.TEXT>
SERV.LOG 2. <STRTRIM <LOCAL.TEXT>></spherescript>

Als Ergebnis wird auf der Konsole ausgegeben:

<tt>1.      TEST      
2. TEST</tt>

===STRMATCH===
Die STRMATCH Funktion ermöglicht die Benutzung von sogenannten Wildcards (*).

Die Syntax dieser Funktion ist <tt>STRMATCH(pattern, string)</tt>. Sie liefert 1, wenn der String zu pattern passt und 0 wenn nicht. Ein Beispiel hierfür:

<spherescript>[FUNCTION f_strmatch]
IF (STRMATCH(*ex*, <ARGS>))
SERV.LOG ARGS enthält 'ex'!
ELSE
SERV.LOG ARGS passt nicht.
ENDIF</spherescript>

In der Konsole kann nun F_STRMATCH Mexico aufgerufen werden. Als Ergebnis wird "ARGS enthält 'ex'!" ausgegeben. Mit einigen verschiedenen Experimenten kann leicht die Funktionsweise erschlossen werden.

War interessant? STRMATCH ist in Wahrheit noch um einiges mächtiger als das. * ist nur ein spezielles Zeichen, das innerhalb von pattern benutzt werden kann:

{| border="1"
|-
| '''Pattern''' || '''Bedeutung'''
|-
| * || Stimmt mit einer beliebigen Anzahl von Zeichen überein - inklusive keinem.
|-
| ? || Stimmt mit exakt einem beliebigen Zeichen überein.
|-
| [\*] || Stimmt exakt mit '*' überein.
|-
| [abcdef] || Stimmt mit irgendeinem der Zeichen der Liste überein.
|-
| [!abc] [^abc] || Stimmt mit irgendeinem Zeichen überein, der sich nicht in der Liste befindet.
|-
| [a-z] || Stimmt mit jedem Zeichen zwischen a und z überein.
|}

Das ist alles, was man über STRMATCH wissen muss. Eine letzte Anmerkung noch: pattern ignoriert Groß- und Kleinschreibung immer (beispielsweise wird das <tt>*ex*</tt>-Beispiel auf "TEXT" auch liefern, dass ex enthalten ist).

'''Anmerkung:''' Manche Nutzer benutzen STRMATCH auch dafür, um die Gleichheit zweier Zeichenketten zu bestimmen. Das ist nicht der Bestimmungszweck dieser Funktion und hat einige Nachteile:

* Sphere wird versuchen, eine Übereinstimmung nach pattern zu berechnen und dabei weniger performant sein.
* Wenn eines der speziellen Zeichen (bspw '*') in der ersten Zeichenkette enthalten ist, dann kann es unter umständen dazu führen, dass das Ergebnis nicht das ist, was erwartet wird (beispielsweise etwas ähnliches zu <tt>STRMATCH(<ARGS>, IRGENDEINTEXT))</tt>, und ARGS enthält zufällig ''*INT*'').

Sollen zwei Zeichenketten auf Gleichheit geprüft werden, sollten die [[#STRCMP|STRCMP]] or [[#STRCMPI|STRCMPI]] Funktionen verwendet werden.

===STRREGEX===
STRREGEX bietet weitaus mächtigere Patterns als STRMATCH.

Angenommen eine Zeichenkette soll darauf geprüft werden, ob sie eine Gleitpunktzahl ist (eine Zahl mit einem Komma). Mit STRMATCH könnte folgendes versucht werden:

<spherescript>[FUNCTION f_fpmatch]
IF (STRMATCH([0-9].[0-9], <ARGS>))
SERV.LOG <ARGS> ist eine Gleitpunktzahl.
ELSE
SERV.LOG <ARGS> ist keine Gleitpunktzahl.
ENDIF</spherescript>

Wird der Befehl F_FPMATCH 1.0 in der Konsole abgesetzt, dann wird das pattern erfolgreich erkannt, aber wird eine größere Zahl als 9.9 übergeben oder eine Zahl die mehr als nur eine Nachkommastelle hat, dann wird diese nicht erkannt. Man könnte nun mehrere "[0-9]" angeben, allerdings würde das keine Lösung für das Problem bedeuten, denn es wird immer genau auf eine feste Anzahl geprüft. Beispielsweise könnte <tt>STRMATCH([0-9][0-9][0-9].[0-9][0-9][0-9], <ARGS>)</tt> benutzt werden. Dann würde 001.500 passen, aber 1.5 nicht.

STRREGEX bietet hierfür eine Lösung indem reguläre Ausdrücke benutzt werden um eine weitaus mächtigere Art der Mustererkennung zu unterstützen. In der Tat sind reguläre Ausdrücke so mächtig, dass sie für sich genommen eine eigene Sprache sind und deshalb kann innerhalb dieser Hilfe nur eine kleine Einführung geboten werden, wie reguläre Ausdrücke arbeiten. Um mehr darüber zu lernen, bietet sich eine Recherche im Web an, beispielsweise [http://www.regular-expressions.info/tutorial.html regular-expressions.info] (auf Englisch) oder [http://www.danielfett.de/internet-und-opensource,artikel,regulaere-ausdruecke Tutorial für reguläre Ausdrücke] (auf Deutsch).

Um nun eine Gleitpunktzahl mit regulären Ausdrücken zu erkennen, kann folgendes Pattern verwendet werden:

<spherescript color="darkgreen">^[-+]?[0-9]*\.?[0-9]+$</spherescript>

Falls die Sprache für reguläre Ausdrücke für dich zu schwierig erscheint, dann sieht das sicherlich wie eine zufällige Ansammlung von Symbolen und Zeichen aus. Aber eigentlich ist das ein einfaches Beispiel für einen regulären Ausdrück. Glücklicherweise ist der Ausdruck sicherlich korrekt (laut Autor) und es kann in STRREGEX benutzt werden. Die obige funktion kann folgendermaßen modifiziert werden:

<spherescript>[FUNCTION f_fpmatch]
IF (STRREGEX(^[-+]?[0-9]*\.?[0-9]+$, <ARGS>))
SERV.LOG <ARGS> ist eine Gleitpunktzahl.
ELSE
SERV.LOG <ARGS> ist KEINE Gleitpunkzahl.
ENDIF</spherescript>

So kompliziert es aussieht, es funktioniert sehr gut. Beispielsweise mit folgenden Werten: "1.5", "-250.002", "50", and even ".007".

[[Category:Tutorials]]

De:Configuring Sphere.ini

2010-11-26T00:21:01Z

Sco: Created page with '{{Languages|Configuring Sphere.ini}} Die Sphere.ini enthält alle intern Optionen und Einstellungen des Sphere Emulators. Um den eigenen Shard zu konfigurieren, muss diese Datei ...'

{{Languages|Configuring Sphere.ini}}
Die Sphere.ini enthält alle intern Optionen und Einstellungen des Sphere Emulators. Um den eigenen Shard zu konfigurieren, muss diese Datei bearbeitet werden. Es sind viele Kommentare enthalten und ist die Datei eigentlich selbsterklären, aber um häufige Fehler zu vermeiden, wird an dieser Stelle auf einige wichtige Punkte eingegangen. Hinzugefügte Erklärungen und Kommentare sind deshalb in <tt>'''dickem blauen Text'''</tt> verfasst worden.

Manche Optionen werden benutzt, indem man die Kommentare am Zeilenanfang entfernt, wie bspw.:

Falls eine zusätzliche map2 benutzt werden soll, dann:

<spherescript color="darkgreen">// MAP2=2304,1600,32,2</spherescript>

Sollte geändert werden in:

<spherescript color="darkgreen">MAP2=2304,1600,32,2</spherescript>

Das gilt für jede Einstellung, die genutzt werden soll (MySQL, AutoResdisp, usw.).

Hier nun die sphere.ini im Einzelnen:

<spherescript color="darkgreen">//****************************************************************************
// SPHERE by : Menasoft 1997-2003
// www.sphereserver.com
// All SPHERE script files and formats are copyright Menasoft & Partners.
// This file may be freely edited for personal use, but may not be distributed
// in whole or in part, in any format without express written permission from
// Menasoft & Partners. All donations and contributions
// become the property of Menasoft & Partners.
//****************************************************************************

///////////////////////////////////////////////////////////////
//////// General Information
///////////////////////////////////////////////////////////////

[SPHERE]
// Name of your Sphere shard
ServName=MyShard
// The IP of your server, this will be 127.0.0.1 almost always
ServIP=127.0.0.1
// The port of your server, this is 2593 by default
ServPort=2593

// Admin's contact email
AdminEmail=me@my.email.com
// Web page for this server
URL=www.myshard.com
// GMT offset, from -12 to +12 [London=0, EST=5, etc]
TimeZone=0

// Official staff language
Lang=English
// Start this as a system service on Win2000, XP, NT</spherescript>
<tt>'''// Setzt man NTService hier auf 1, kann man auch nicht mehr auf die Konsole zugreifen''' </tt>
<spherescript color="darkgreen">NTService=0

// MySql configuration.</spherescript>
<tt>'''// Soll eine MySQL-Datenbank benutzt werden, dann hier auf 1 setzen''' </tt>
<spherescript color="darkgreen">//MYSQL=0</spherescript>
<tt>'''// Den Server angeben, auf dem sich die Datenbank befindet, oder localhost, falls die Datenbank auf dem selben Rechner läuft''' </tt>
<spherescript color="darkgreen">//MySqlHost=</spherescript>
<tt>'''// Benutzername zur gewünschten Datenbank''' </tt>
<spherescript color="darkgreen">//MySqlUser=</spherescript>
<tt>'''// Passwort für den angegebenen Benutzer''' </tt>
<spherescript color="darkgreen">//MySqlPassword=</spherescript>
<tt>'''// Der Name der Datenbank. _NICHT_ der Hostname, sondern den Namen der Datenbank, die man angelegt hat.''' </tt>
<spherescript color="darkgreen">//MySqlDatabase=

///////////////////////////////////////////////////////////////
//////// File Locations
///////////////////////////////////////////////////////////////
// Directory where spheretables.scp is located, from there we will
// load any additional scripts</spherescript>
<tt>'''// Der Ordner, in dem die Skripte liegen, kann auch dafür genutzt werden.''' 
'''// verschiedene .exe mit den selben Skripten zu starten.''' </tt>
<spherescript color="darkgreen">ScpFiles=scripts/

// Where your sphereworld.scp and spherechars.scp are located
WorldSave=save/

// Where your sphereaccu.scp and sphereacct.scp is located
AcctFiles=accounts/

// Where your UO installation is located. This need: map0.mul, statics0.mul,
// staidx0.mul, multi.mul, multi.idx, hues.mul, tiledata.mul.
// Optional files: verdata.mul, mapX.mul/staticsX.mul/staidxX.mul for higher
// maps support (Malas, etc).
//
// Note that if not set, sphere will scan windows registry to auto-detect it
//MulFiles=mul/

// Where your log files will be saved by sphere
Log=logs/

// To activate ML-sized map #0 uncomment the next line (don't forget to uncomment
// sphere_map0_ml.scp and sphere_map_points0_ml.scp in spheretables.scp if you want
// to use the default areas)
//Map0=7168,4096,-1,-1

// To activate ML-sized map #1 uncomment the next line
//Map1=7168,4096,-1,-1

// To enable the use of MapDif*.mul and StaDif*.mul files, set this to 1.</spherescript>
<tt>'''// Einige Patches für die Maps, die für Map0 und Map1 genutzt werden.''' 
'''// Die Insel Occlo auf Map0 ist auf Map1 Haven. Diese Option nutzt die Patches, die dafür notwendig sind.''' 
'''// Aktuelle Clientversionen benutzen diese Patches nicht mehr, da sie über eine separate Map1.mul verfügen.''' </tt>
<spherescript color="darkgreen">UseMapDiffs=0

///////////////////////////////////////////////////////////////
//////// World Save Information
///////////////////////////////////////////////////////////////
// How often for Sphere to save your world (minutes)
SavePeriod=20

// How many backup levels to keep. Each level means 7 backups done for it.
// So, 10*7 = 70 backup saves will be storied.
BackupLevels=10

// On would save in the background quietly over a longer period of time, and not interrupt the game
// Off would notify "World save has been initiated" and save faster, but pause the game momentarily
SaveBackground=0

///////////////////////////////////////////////////////////////
//////// Account Management
///////////////////////////////////////////////////////////////
//Code for servers account application process
// 0=Closed, // Closed. Not accepting more.
// 2=Free, // Anyone can just log in and create a full account.
// 3=GuestAuto, // You get to be a guest and are automatically sent email with u're new password.
// 4=GuestTrial, // You get to be a guest til u're accepted for full by an Admin.
// 6=Unspecified, // Not specified.
// To enable auto account you must set this to 2
AccApp=0

// Store password hashed with MD5</spherescript>
<tt>'''// MD5 ist eine sicherere Möglichkeit, Passwörter zu speichern. [http://de.wikipedia.org/wiki/MD5 weitere Infos]''' </tt>
<spherescript color="darkgreen">Md5Passwords=0

// local ip is assumed to be the admin
LocalIPAdmin=1

// Default number of chars allowed per account (maximum value is 7)
MaxCharsPerAccount=5

// Min time for a char to exist before delete allowed (in seconds)
MinCharDeleteTime=3*24*60

// Max number of Guest accounts allowed
GuestsMax=0

// Max login tries for account before a temporary ban (0 is disabled)</spherescript>
<tt>'''// Wie auch bei manchen Foren ist diese Funktion nützlich.''' </tt>
<spherescript color="darkgreen">MaxAccountLoginTries=0

///////////////////////////////////////////////////////////////
//////// Client Management
///////////////////////////////////////////////////////////////
// What client protocol version used
// Comment out the ClientVersion line to allow any client that is supported.
//ClientVersion=2.0.3

// Set this to 0 to allow login to encrypted clients</spherescript>
<tt>'''// Die offiziellen OSI-Clients nutzen Verschlüsselung.''' </tt>
<spherescript color="darkgreen">UseCrypt=1

// Set this to 1 to allow login to unencrypted clients</spherescript>
<tt>'''// Mit Tools, wie [http://stud4.tuwien.ac.at/~e9425109/UO_RICE.htm UO Rice] und [http://www.uogateway.com/ UOGateway] kann die Verschlüsselung eines Clients deaktiviert werden.''' </tt>
<spherescript color="darkgreen">UseNoCrypt=0

// Maximum total open connections to server
ClientMax=256

// Maximum open connections to server per IP
ClientMaxIP=16

// Maximum total (not-in-game) connections to server
ConnectingMax=32

// Maximum total simultaneous (not-in-game) connections to server per IP
ConnectingMaxIp=8

// How long logged out clients linger in seconds
ClientLinger=15

// Walk limiting code: buffer size (in tenths of second)
WalkBuffer=75

// Walk limiting code: regen speed (%)
WalkRegen=25

// Only commands issued by this plevel and higher will be logged</spherescript>
<tt>'''// Mit 0 wird JEDER Befehl im Spiel geloggt.''' </tt>
<spherescript color="darkgreen">CommandLog=0

// Prefix for ingame commands
CommandPrefix=.

// Function to call if client is executing a command to override the default.
//CommandTrigger=f_oncommand

// Use the built in http server
// 0 - disable http server and webpage generation
// 1 - disable http server and enable webpage generation
// 2 - enable http server and webpage generation (default)
UseHttp=2

// Use the OSI AuthID to avoid possible hijack to game server.
UseAuthID=0

// Default setting for all accounts specifying default resdisp.</spherescript>
<tt>'''// 0=Vor-T2A, 1=T2A, 2=LBR, 3=AoS, 4=SE, 5=ML''' </tt>
<spherescript color="darkgreen">//AutoResDisp=1

// Default setting for new accounts specifying default priv level
//AutoPrivFlags=010

// Max tooltip (if enabled) to send on each tick (to avoid client flooding)
//MaxTooltipForTick=7

// How often send my hits updates to visible clients (in seconds)
//HitsUpdateRate=1

///////////////////////////////////////////////////////////////
//////// Game Mechanics
///////////////////////////////////////////////////////////////

// Maximum distance to hear char whispering
//DistanceWhisper=3

// Maximum distance to hear char talking
//DistanceTalk=18

// Maximum distance to hear char yelling
//DistanceYell=31

// Do not allow entering under roof being on horse?
MountHeight=0

// Archery does not work if too close (0 = not checked)
ArcheryMinDist=2

// Maximum Distance for Archery
ArcheryMaxDist=15

// Speed scale factor for weapons</spherescript>
<tt>'''// Die Formel lautet: DELAY = SPEEDSCALEFACTOR / ((DEX + 100) * SPEED)''' </tt>
<spherescript color="darkgreen">SpeedScaleFactor=15000

// This is the percent of max weight at which stamina is lost half the time
// (200 = no effect)
StaminaLossAtWeight=150

// Weight penalty for running +N% of max carry weight (0 = no effect)
RunningPenalty=50

// Show people joining/leaving the server. 0 disables, 2 enables staff only.
ArriveDepartMsg=1

// Are house and boat keys newbied automatically
AutoNewbieKeys=1

// Maximum number of items allowed in bank
BankMaxItems=1000

// Maximum weight in stones allowed in bank
BankMaxWeight=1000

// If 1 vendors will take gold only from backpack</spherescript>
<tt>'''// Wenn hier 0 eingetragen ist, nehmen NPC-Vendoren Geld von Spielern aus dem Rucksack und der Bank.''' </tt>
<spherescript color="darkgreen">PayFromPackOnly=0

// Disable weather effects?
NoWeather=1

// Default light level in dungeons</spherescript>
<tt>'''// 0 = Hell; 30 = Dunkel.''' </tt>
<spherescript color="darkgreen">DungeonLight=27

// Day light level 0-30
LightDay=0

// Night light level 0-30
LightNight=25

// Allow manual sector light override?
//AllowLightOverride=1

// Wool Regen Time (in minutes)
WoolGrowthTime=30

// Suppress player speech with 75% of capital letters</spherescript>
<tt>'''// "LETZ AVOID L337 SP33CH DEWD." Wird nicht angezeigt.''' </tt>
<spherescript color="darkgreen">SuppressCapitals=0

// Extra combat flags to control the fight (default:0, 0.55i compatible)
// COMBAT_NODIRCHANGE 00001 // Not rotate player when fighting (like was in 0.51a)
// COMBAT_FACECOMBAT 00002 // Allow faced combat only (recommended)
// COMBAT_PREHIT 00004 // allow prehit for close combat. first hit is instant (delay 0.1sec)
// COMBAT_USE_RESISTANCE 00008 // use character props RES* against oldfashioned damage types
// COMBAT_SPECIALDAMAGE 00010 // use character tags TAG.*DAMAGE to apply additional damage
// COMBAT_DCLICKSELF_UNMOUNTS 00020 // unmount horse when dclicking self while in warmode
// COMBAT_ALLOWHITFROMSHIP 00040 // Allow attacking opponents from ships
// COMBAT_OSIDAMAGEMOD 00080 // modify weapon damage OSI-style (taking anatomy, tactics, lumberjacking into account)
// COMBAT_ARCHERYCANMOVE 00100 // firing bow while moving
// COMBAT_STAYINRANGE 00200 // abort attack swing when out of range instead of waiting to come back in range
//
// COMBAT_STACKARMOR 01000 // If a region is covered by more than one armor part, all AR will count
// COMBAT_TARGETTEDHIT 02000 // Allows setting of preferred hit area by TAG.HITPREFERENCE
//CombatFlags=0

// Extra magic flags to control magic/magery behaviour (default:0, 0.55i compatible)
// MAGICF_NODIRCHANGE = 0x0000001 // Not rotate player when casting/targeting
// MAGICF_PRECAST = 0x0000002 // Precasting (cast spell before target prompt)
// MAGICF_IGNOREAR = 0x0000004 // Magic damage ignore ar
// MAGICF_CANHARMSELF = 0x0000008 // Magic can do damage on self
// MAGICF_STACKSTATS = 0x0000010 // Different stat spells don't cancel each other out
// MAGICF_FREEZEONCAST = 0x0000020 // No movement whilst casting
// MAGICF_SUMMONWALKCHECK = 0x0000040 // Summoned creatures should be able to walk on the target location (e.g. water creatures to be summoned on water)
// MAGICF_NOFIELDSOVERWALLS = 0x0000080 // Field spells cannot cross over blocking objects
//MagicFlags=0

// Length of time (in seconds) for a player to choose a target when casting (0 = no timeout)
SpellTimeout=0

// Zero point for sextant coordinates counting
//ZeroPoint=1323,1624,0

// How far from land i can be to take off a ship
//MaxShipPlankTeleport=18

///////////////////////////////////////////////////////////////
//////// NPC/Item/Player Management
///////////////////////////////////////////////////////////////
// Distance in tiles before an NPC that's wandered too far from it's home will teleport back
LostNPCTeleport=50

// Whether PCs get a resurrection robe when they get resurrected.
NoResRobe=0

// Time for a NPC corpse to decay mins
CorpseNPCDecay=10

// Time for a player corpse to decay mins
CorpsePlayerDecay=15

// Base decay time in minutes for items
DecayTimer=30

// Put [NPC] tags over chars</spherescript>
<tt>'''// Und [TAME] falls die Spielfigur gezähmt wurde.''' </tt>
<spherescript color="darkgreen">CharTags=0

// Flip dropped items
FlipDroppedItems=0

// Set to 1 to allow players to take equipment from their pets' paperdoll
CanUndressPets=1

// Monsters run when scared of death
MonsterFear=0

// Monsters may fight each other
MonsterFight=0

// Percent setting of the all NPC move rate, default 100
MoveRate=100

// Do players receive sounds
GenericSounds=1

// Max number of items to sell to one person at once
VendorMaxSell=255

// Max level npc trainers can go</spherescript>
<tt>'''// Für alle Skills gilt: 300 = 30.0''' </tt>
<spherescript color="darkgreen">NPCTrainMax=300

// Percent of own ability npcs can train to
NPCTrainPercent=30

// NPC will not be addressed as "Lord" or such if this is set</spherescript>
<tt>'''// Verhindert Doppeltitel wie: Lord Lord Knight''' </tt>
<spherescript color="darkgreen">// NPCNoFameTitle=0

// Max level of skill trainable on dummies, archery butte ecc..</spherescript>
<tt>'''// Für alle Skills gilt: 300 = 30.0''' </tt>
<spherescript color="darkgreen">SkillPracticeMax=300

// Max skill player's will start with on skills they haven't chosen during
// character creation</spherescript>
<tt>'''// Wenn auf 0 gesetezt, dann starten Spieler ausschließlich mit den Skills, die sie am Anfang wählten.''' </tt>
<spherescript color="darkgreen">MaxBaseSkill=200

// If set to 0, the MaxBaseSkill will only apply to skills that the client
// can see in their menu (based on Feature* settings, ResDisp and Client
// Version). If this is set to 1 then players to start with all the skills
// that have been defined.
InitHiddenSkills=0

// Time in seconds for hitpoint regeneration
Regen0=40

// Time in seconds for mana regeneration
Regen1=20

// Time in seconds for stamina regeneration
Regen2=10

// Time in minutes for food regeneration
// 1*60*24 = 1 day of real life time
Regen3=1*60*24

// Speech block associated to players
SpeechSelf=spk_player

// Speech block associated to pets
SpeechPet=spk_pet

//Events related to all NPCs
//EventsPet=your_event

//Events related to all players
//EventsPlayer=your_event

//Events related to all regions
//EventsRegion=your_event

// When player skills/stats goes this times more than skillclass allowed, drop
// them to skillclass level. Setting this to 0 disables the action.
OverSkillMultiply=2

// NPC AI settings
// NPC_AI_PATH 0001 NPC pathfinding
// NPC_AI_FOOD 0002 NPC food search (objects + grass)
// NPC_AI_EXTRA 0004 NPC magics, etc
// NPC_AI_ALWAYSINT 0008 Always be as smart as possible with pathfinding
// NPC_AI_INTFOOD 0010 NPC food search (more intelligent and trusworthy)
// NPC_AI_COMBAT 0040 Look for friends in combat
// NPC_AI_VEND_TIME 0080 vendors closing their shops at nighttime
// NPC_AI_LOOTING 0100 loot corpses an the way
// NPC_AI_MOVEOBSTACLES 0200 if moveable items block my way, try to move them
//NPCAI=0

///////////////////////////////////////////////////////////////
//////// Crime/Murder/Karma/Fame/Guard Settings
///////////////////////////////////////////////////////////////
// Karma when player goes from good to neutral (from -10000 to 10000)
PlayerNeutral=-2000

// How many minutes are criminals flagged for
CriminalTimer=3

// Times a player can snoop before becoming a criminal
SnoopCriminal=20

// Seconds time to decay a murder count (default 8*60*60 is 8 hours)
MurderDecayTime=8*60*60

// Amount of murders before we get title
MurderMinCount=1

// Looting or carving a blue player is a crime
LootingIsaCrime=1

// Flag players criminal for helping criminals?
HelpingCriminalsIsaCrime=1

// How long do guards linger about in minutes
GuardLinger=3

// Will guards kill instantly or follow normal combat rules
GuardsInstantKill=1

// Limits the MAXHITS/MAXMANA/MAXSTAM changes
// STAT_FLAG_NORMAL 0x00 // MAX* status allowed (default)
// STAT_FLAG_DENYMAX 0x01 // MAX* denied
// STAT_FLAG_DENYMAXP 0x02 // .. for players
// STAT_FLAG_DENYMAXN 0x04 // .. for npcs
StatsFlags=0

// Uses the new LoS algorithm
// ADVANCEDLOS_DISABLED 0x00 // Disabled, use the old method
// ADVANCEDLOS_PLAYER 0x01 // Enabled only for players
// ADVANCEDLOS_NPC 0x02 // Enabled only for NPCs
AdvancedLos=0

// Default color settings for characters (name, speech)
//ColorNotoGood=063 // blue
//ColorNotoGuildSame=044 // green (ally)
//ColorNotoCriminal=03b2 // grey (criminal)
//ColorNotoNeutral=03b2 // grey (can be attacked)
//ColorNotoEvil=026 // red
//ColorNotoGuildWar=02b // orange (enemy guild)
//ColorNotoDefault=03b2 // grey (if not any other)

// Which notoriety flags do pets inherit from their masters? (default 0)
// Set flags to indicate which notoriety statuses a pet can inherit from its owner.
// NotoGood = 0x01 // blue
// NotoGuildSame = 0x02 // green (ally)
// NotoNeutral = 0x04 // grey (can be attacked)
// NotoCriminal = 0x08 // grey (criminal)
// NotoGuildWar = 0x10 // orange (enemy guild)
// NotoEvil = 0x20 // red
// e.g. "03a" will show pets as criminal/warring/evil/allied when their master has
// one of these statuses, regardless of the pet's true notoriety.
PetsInheritNotoriety=0

///////////////////////////////////////////////////////////////
//////// Server Mechanics
///////////////////////////////////////////////////////////////
// Experimental flags
// Flags for options that affect server behaviour and which might affect compatibility
// See the revisions.txt file for more details on this</spherescript>
<tt>// EF_DiagonalWalkCheck = 00000001 
// EF_UNICODE = 00000002 // No on Linux. '''Aktiviert UNIODE Korrekturen.''' 
// EF_New_Triggers = 00000008 '''// Aktiviert neue Trigger''' 
// EF_Intrinsic_Locals = 00000020 '''// Lokale Variablen können direkt referenziert werden, bspw. statt lt;LOCAL.X> kann <X> genutzt werden. 
// EF_Item_Strict_Comparison = 00000040 
// EF_NewPositionChecks = 00000080 // Do not set while server is running !!! 
// EF_WalkCheck = 00000100 '''// Korrektur für Walkchecks und gegen Hauseinbrecher.''' 
// EF_AllowTelnetPacketFilter = 00000200 // Enables packet filtering for telnet connections as well 
// EF_Script_Profiler = 00000400 
// EF_Size_Optimise = 00000800 
// EF_Minimize_Triggers = 00001000 // Minimize trigger calls (use only 0.51 triggers) 
// EF_DamageTools = 00002000 // damage tools (and fire @damage on them) while mining or lumberjacking 
// EF_PetSlots = 00004000 // INCOMPLETE YET! DO NOT USE until this warning is removed! 
// EF_UsePingServer = 00008000 // Enable the experimental Ping Server (for showing pings on the server list, uses UDP port 12000) 
// EF_NPCAct_Triggers = 00010000 // Enable @NPCSpecialAction and @NPCAction triggers (mutual exclusive with EF_Minimize_Triggers) 
// EF_UseNetworkMultiVersion = 00400000 // Modify EF_UseNetworkMulti so clients prior to 4.0.0 are unaffected (try this if you find EF_UseNetworkMulti negatively affects older clients). - Do not set while server is running !!! 
// EF_UseNetworkMulti = 00800000 // Enable optimized network routines (better) - Do not set while server is running !!! 
// EF_Specific = 01000000 // Specific behaviour, not completly tested </tt>
<spherescript color="darkgreen">Experimental=00000

// Option flags
// Flags for options that affect server behaviour but not compatibility
// See the revisions.txt file for more details on this</spherescript>
<tt>// OF_Command_Sysmsgs = 00000008 //Shows status of hearall, allshow, allmove... commands after toggling them 
// OF_OSIMultiSight = 00000020 
// OF_Items_AutoName = 00000040 
// OF_FileCommands = 00000080 '''// Aktiviert die FILE Befehle, [[File| hier]] gibt es dazu weitere Informationen.''' 
// OF_NoItemNaming = 00000100 '''// Wenn aktiviert, dann gibt es keine Benennung für Gegenstände ala "Crafted by..."''' 
// OF_NoHouseMuteSpeech = 00000200 
// OF_Flood_Protection = 00001000 
// OF_Buffs = 00002000 
// OF_NoPrefix = 00004000 // Add prefix "A" and "An" to itemnames or not 
// OF_DyeType = 00008000 // if set allows using i_dye on all t_dye_vat instead of only i_dye_tub 
// OF_DrinkIsFood = 00010000 // type T_DRINK will increase FOOD lvl like T_FOOD 
// OF_Specific = 01000000 // Specific behaviour, not completly tested </tt>
<spherescript color="darkgreen">OptionFlags=08|0200

// FeatureT2A, used to control T2A expansion features ( default 03 )
// FEATURE_T2A_UPDATE 01 // Monster and Lost lands
// FEATURE_T2A_CHAT 02 // In game chat
FeatureT2A = 03

// FeatureLBR, used to control LBR expansion features ( default 0 )
// FEATURE_LBR_UPDATE 01 // Lbr Monsters
// FEATURE_LBR_SOUND 02 // MP3 instead of MIDI
FeatureLBR = 0

// FeatureAOS, used to control AOS expansion features ( default 0 )
// FEATURE_AOS_UPDATE_A 01 // AOS Monsters, Map
// FEATURE_AOS_UPDATE_B 02 // Tooltip, Fightbook, Necro/paladin on creation, Single/Six char selection screen, Skills, Newer spellbook support
// FEATURE_AOS_POPUP 04 // PopUp Menus
// FEATURE_AOS_DAMAGE 08
FeatureAOS = 0

// FeatureSE, used to control SE expansion features ( default 0 )
// FEATURE_SE_UPDATE 01 // Basic SE features
// FEATURE_SE_NINJASAM 02 // Ninja and Samurai
FeatureSE = 0

// FeatureML, used to control ML expansion features ( default 0 )
// FEATURE_ML_UPDATE 01 // Basic ML features
// FEATURE_ML_NINTHAGE 02 // Unlocks ninth age house designer items
FeatureML = 0

// FeatureKR, used to control KR expansion features ( default 0 ) (still not complete but usable)
// FEATURE_KR_UPDATE 01 // Basic KR features
FeatureKR = 0

// In game effects to turn on and off
// Messages echoed to the server console while in debug mode
// DEBUGF_NPC_EMOTE = 00001
// DEBUGF_ADVANCE_STATS = 00002
// DEBUGF_WALKCODES = 00080 // try the new walk code checking stuff
// DEBUGF_EXP = 00200 // experience gain/loss
// DEBUGF_LEVEL = 00400 // experience level changes
// DEBUGF_SCRIPTS = 00800 // debug flag for scripts
// DEBUGF_LOS = 01000 // debug flag for AdvancedLOS
// DEBUGF_WALK = 02000 // debug flag for new walking check stuff
//DebugFlags=00

// Allow rapid Buy/Sell through Buy/Sell agent
AllowBuySellAgent=0

// Console Hears all that is said on the server
HearAll=1

// Secure mode attempts to ignore errors, protect from accidently shutdowns
Secure=1

// Value from 1 to 32, set sectors inactive when unused to conserve resources
SectorSleep=10

// Disconnect inactive socket in x min
DeadSocketTime=5

// Always force a full garbage collection on save
ForceGarbageCollect=1

// Time before restarting when server appears hung (in seconds)
FreezeRestartTime=60

// Length of the game world minute in real world in seconds
GameMinuteLength=60

// Bit Mask of the subjects you want to log when logging is on
// LOGM_ACCOUNTS 0x00080
// LOGM_SAVE 0x00200 // world save status.
// LOGM_CLIENTS_LOG 0x00400 // all clients as they log in and out.
// LOGM_GM_PAGE 0x00800 // player gm pages.
// LOGM_PLAYER_SPEAK 0x01000 // All that the players say.
// LOGM_GM_CMDS 0x02000 // Log all GM commands.
// LOGM_CHEAT 0x04000 // Probably an exploit !
// LOGM_KILLS 0x08000 // Log player combat results.
// LOGM_HTTP 0x10000
// 0x1ffff // log everything
LogMask=01ec80

// Amount of time to keep map data cached in sec
MapCacheTime=120

// Max NPC chars for a sector to prevent lag
MaxComplexity=32

// Amount of items in one tile so start showing "too many items here"
MaxItemComplexity=25

// Amount of items in one sector to start showing "x items too complex"
MaxSectorComplexity=1024

// Limit the number of cycles the while/for loop can proceed. Setting this to
// zero disables the limitation
MaxLoopTimes=0

// Amount of minutes to call f_onserver_timer (0 disables this, default)
TimerCall=0

// Should sphere record the time it takes to do actions like treating npcs, scripts, clients and such?
// Can be viewed by right clicking the mouse on sphere screen.
Profile=0

///////////////////////////////////////////////////////////////
//////// Magic/Effects Settings
///////////////////////////////////////////////////////////////

// Allow casting while equipped
EquippedCast=1

// Words of power for player using magic
WOPPlayer=1

// Words of power for staff using magic
WOPStaff=0

// Words of power font
//WOPFont=3

// Words of power color
//WOPColor=03B2

// Reagents lost if magic fails
ReagentLossFail=0

// Magic requires reagents
ReagentsRequired=0

// What % of hitpoints players will resurrect with. Note, that if you set this
// too low, people with little STR will have problems resurrecting.
HitPointPercentOnRez=33

// How many % of hits will the character loose when starving. 0 disables
//HitsHungerLoss=0

// Amount of skill of lock picking needed to unlock a magically locked door
MagicUnlockDoor=900

// Teleport effect for GMs and players. Setting 0 disables the effect
TeleportEffectNPC=0372a
TeleportEffectPlayers=0372a
TeleportEffectStaff=03709
TeleportSoundNPC=01fe
TeleportSoundPlayers=01fe
TeleportSoundStaff=01f3

///////////////////////////////////////////////////////////////
//////// Experience and Level system
///////////////////////////////////////////////////////////////

// Enable experience system
//ExperienceSystem=0

// Experience system settings:
// 0001 gain experience in combat
// 0002 gain experience in crafts
// 0004 allow experience to go down
// 0008 limit experience decrease by a range witheen a current level
// 0010 auto-init EXP/LEVEL for NPCs if not set in @Create
// 0020 allow trigger @ExpChange
// 0040 allow trigger @ExpLevelChange
//ExperienceMode=0

// If combat experience gain is allowed, use these percents for gaining exp in
// Player versus Monster and Player versus Player combats. Value 0 disables gain.
//ExperienceKoefPVM=100
//ExperienceKoefPVP=100

// Enable levels system (as a part of experience system)
//LevelSystem=0

// Level system settings:
// linear = 0 (each NextLevelAt exp will give a level up)
// double = 1 (you need (NextLevelAt * (level+1)) to get a level up)
//LevelMode=1

// Amount of experience to raise to the next level
//LevelNextAt=0

///////////////////////////////////////////////////////////////
//////// external program support
///////////////////////////////////////////////////////////////

// TNG
// on Linux do sth like "/srv/www/"
// on Windows do sth. like "C:\foo\bar\"
StripPath=scripts\web\

///////////////////////////////////////////////////////////////
//////// Webpage Settings
///////////////////////////////////////////////////////////////

// Note, that you can catch error codes by creating sphere404.htm and so on
// for all HTTP error codes sphere support.

[WEBPAGE 1]
// Determines what html file is used as base for the status page
WebPageSrc=scripts/web/spherestatusbase.html
// Determines where the status page is saved
WebPageFile=scripts/web/status.html
// In seconds, how often the status file is updated
WebPageUpdate=60
// Required PLevel to view this page (0 = anyone, 6 = admins only)
PLevel=0

///////////////////////////////////////////////////////////////
//////// Abuse Control
///////////////////////////////////////////////////////////////

// Block these ips from the server
// 255 is a wildcard, so 255.255.255.255 disables anyone connecting.
[BlockIP]
//123.34.45.56
//123.45.56.78

///////////////////////////////////////////////////////////////
//////// Connection Information
///////////////////////////////////////////////////////////////

//First line should be the name of your shard (this is what people see when they connect)
//Second line should be the IP of your shard (this is almost always 127.0.0.1)
//Third line should be the port of your shard (this should be whatever ServPort is set to)</spherescript>
<tt>'''// Eine exakte Hilfe für diesen Abschnitt findet man hier: [http://www.sphereserver.net/forums/index.php?showtopic=36161 Rattlehead's Single Shard Listing For Routers tutorial]''' </tt>
<spherescript color="darkgreen">
//Uncomment next 3 lines below this if you have a router
//First line should be a name different than your shard name above this
//Second line should be your real/external IP (www.whatismyip.com)
//Third line should be the shard port (this should be whatever ServPort is set to)
[SERVERS]
MyShard
127.0.0.1
2593

//External
//my.ip.goes.here
//2593

[EOF]</spherescript>

[[Category: Setting Up Sphere]]

De:Installing Sphere

2010-11-25T22:17:08Z

Sco:

{{Languages|Installing Sphere}}
==Linux==
===Vorwort===
Sphere auf einem Linuxsystem zu installieren, ist nicht viel schwieriger als auf einem Windowsrechner. Allerdings ist Basiswissen über Linux vorausgesetzt und ein wenig Erfahrung mit der Kommandozeile von Nöten, da hier nicht einfach auf ein Symbol geklickt wird und Sphere läuft.

Diese Anleitung ist deshalb darauf ausgelegt, dass eine Shell oder ein Terminal zum Linuxsystem verfügbar ist und root-Rechte vorhanden sind.

Letztendlich wird diese Anleitung nicht beinhalten, welche Dateien auf dem Linux Server verfügbar sein müssen. Diese Anleitung umfasst keine Einführung in Linuxsysteme und hat auch keinen Anspruch darauf, dies zu sein. Für weiterführende Informationen über Linux gibt es viele E-Books und Howtos, die frei im Web verfügbar sind. Beispielsweise ist hier ein guter Startpunkt: [http://www.linux.org http://www.linux.org]

Wichtig ist aber vor allem folgendes: Anders als ein Windowssystem, ist Linux bezüglich Datei- und Ordnernamen die Groß- und Kleinschreibung zu beachten. Wenn eine Datei von Sphere nicht gefunden wird, liegt das möglicherweise daran, dass gewisse Dateien falsch geschrieben sind, wie bspw: "sphere.INI" anstelle von "sphere.ini".

Alle Zeilen, die in dieser Anleitung kursiv sind, sollten direkt in das Terminal eingegeben werden.

===Vorbereitungens===
Auf dem Linuxsystem wird eine Installation des MySQL Clients benötigt. Fehlen die Bibliotheken des MySQL Clients, wird Sphere nicht ausführbar sein.

Des Weiteren wird ein Sphere Version FÜR LINUX benötigt, sowie das passende Skriptpaket und eventuelle zusätzliche Bibliotheken, die in der Downloadsektion angegeben sind.

===Schritt für Schritt Installation===
'''1)''' Mit Rootrechten einen neuen Nutzer namens "sphere" anlegen. Dieser Nutzer benötigt ein eigenen Heimverzeichnis (meistens: /home/sphere) mit den entsprechenden Rechten.

<tt>useradd -d /home/sphere sphere 
mkdir /home/sphere 
chown sphere /home/sphere 
chmod 700 /home/sphere </tt>

'''2)''' Kopiere alle Dateien des Sphere LINUX downloads, das Skriptpaket und eventuell nötige Bibliotheken in das neu angelegte Verzeichnis. Zudem müssen Unterordner angelegt werden: "save", "logs" und "accounts", wie angegeben in der sphere.ini und in spheretables.scp. Am Ende sollte eine ähnliche Ordnerstruktur vorliegen:

<tt>/home/sphere --- spheresvr 
              |  sphere.ini 
              |  sphereCrypt.ini 
          |-------------------- accounts/ 
          |-------------------- logs/ 
          |-------------------- muls/ 
          |-------------------- save/ 
          |-------------------- scripts/ </tt>

'''3)''' Nachdem alle Dateien an die richtige Stelle kopiert wurden, benötigen sie die richtigen Dateirechte. Deshalb weiterhin unter Rootrechten folgende Befehle ausführen:

<tt>cd ~sphere 
chown -R sphere * 
find . -type d | xargs chmod 0700 
find . -type f | xargs chmod 0600 
chmod 4700 spheresvr </tt>

'''4)''' Immer noch unter Rootrechten:

<tt>ldd spheresvr </tt>

Die Ausgabe sollte nun ungefähr so lauten:

<tt>longbow:/home/sphere# ldd spheresvr 
libpthread.so.0 => /lib/libpthread.so.0 (0x4001f000) 
libmysqlclient.so.15 => /usr/lib/libmysqlclient.so.15 (0x40071000) 
libboost_regex-gcc-1_33_1.so => /usr/lib/libboost_regex-gcc-1_33_1.so (0x40243000) 
libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x402ea000) 
libm.so.6 => /lib/libm.so.6 (0x403c9000) 
libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x403ef000) 
libc.so.6 => /lib/libc.so.6 (0x403fa000) 
/lib/ld-linux.so.2 (0x40000000) 
libcrypt.so.1 => /lib/libcrypt.so.1 (0x4051c000) 
libnsl.so.1 => /lib/libnsl.so.1 (0x4054a000) 
libz.so.1 => /usr/lib/libz.so.1 (0x40561000) </tt>

NACH FEHLENDEN BIBLIOTHEKEN AUSSCHAU HALTEN! Notfalls müssen diese nachinstalliert werden.

===Die Installation testen===
Es ist jetzt nicht mehr von Belang, ob der erste Test mit Rootrechten oder unter dem Benutzer sphere ausgeführt wird. Werden die Rechte der Datei auf 4700 gesetzt, wird Sphere automatisch immer unter dem benutzer sphere ausgeführt. Deshalb:

<tt>cd ~sphere 
./spheresvr </tt>

Es sollte nun eine Liste des Startups folgen ... mit vielleicht enthaltenen Warnings:

<tt>longbow:/home/sphere# ./spheresvr 
WARNING:(sphere.ini,587)'scripts/spherestatusbase.html' not found... 
ERROR:(sphere.ini,587)Can't open web page input 'spherestatusbase1.htm' 
Sphere Version 0.56b [Linux] by www.sphereserver.com, compiled at Sep 15 2006 (23:23:07) 
Signal handlers installed. 
Expansion maps supported: T2A, LBR, AOS, SE, ML 
ERROR:(spheretables.scp,59)Unable to open directory scripts/custom/ 
ERROR:(spheretables.scp,59)DirList=-1 for 'scripts/custom/' 
Allocating map sectors: 0=7168 1=7168 2=900 3=1280 4=32761 
Indexing 211 scripts... 
Loading scripts/sphere_defs.scp 
[...] </tt>

Warnings und Fehler über fehlende Webseiten können ignoriert werden. Falls allerdings andere Fehler auftreten oder Sphere terminiert (=sich beendet), dann sollte in den vorhergehenden Zeilen nach dem Grund gesucht werden.

Letztendlich sollten folgende Meldungen auftauchen, falls alles gut lief:

<tt>[...] 
Loading save/spheredata... 
Loading save/spherestatics... 
Loading save/sphereworld... 
Loading save/spherechars... 
166 Objects accounted for 
Option flags: CommandSysmsgs + NoHouseMuteSpeech 
Experimental flags: DiagonalWalkCheck + ScriptsReturnStrings + NewTriggersEnable + NewPositionChecks + WalkCheck + ScriptProfiler + SizeOptimize 
Admin=me@my.email.com, URL=www.myshard.com, Lang=English, TZ=0 
Startup complete. items=0, chars=0 
Creating thread. </tt>

Danach befindet man sich in der Sphere Konsole und kann allgemeine Befehle absetzen ('?' gibt eine Liste aus). Lege einen Account an, aktiviert ihn, editier die login.cfg des Ultima Online Clients damit er die IP-Adresse des Servers enthält und log ein.

Damit Sphere wieder heruntergefahren wird, ist zunächst der Befehl "S", gefolgt vom Befehl "X" notwendig. Linux wird dann versuchen, Sphere zu beenden - sollte das aus irgendeinem Grund nicht funktionieren, hilft die Tastenkombination STRG-c weiter.

===Einen Liveshard aufsetzen===
Sphere in einem Terminal laufen zu lassen hat einen Nachteil: schließt man dieses Terminal, beendet Linux auch Sphere. Das ist unter Linuxsystemen beabsichtigt, weil es ein Multiusersystem ist. Das bedeutet vor allem, dass bei jedem Logout eines Nutzers auch unbedingt all seine laufenden Prozesse beendet werden sollten.

Natürlich ist es aber dennoch möglich, Prozesse im Hintergrund laufen zu lassen, selbst wenn Terminal oder Shell geschlossen werden. Hierfür bietet sich ein Skript an, das ein Tool namens 'screen' nutzt (notfalls nachinstallieren):

<tt>#!/bin/sh 
cd ~sphere 
while true; do 
screen -D -m /home/sphere/spheresvr 
sleep 30 
done </tt>

Dieses Skript kann in jedem beliebigen Editor abgespeichert werden und sollte möglichst die Dateiendung .sh erhalten. Wird das Skript ausgeführt, startet sich Sphere in einem virtuellen Terminal, das jederzeit mit "screen -r "abgerufen werden kann. Mit der Tastenkombination STRG-a gefolgt von STRG-d kann man dieses Terminal jederzeit wieder verlassen und es läuft im Hintergrund weiter. In der Dokumentation von "screen" finden sich weitere Informationen.

==Windows==
Als erstes sollte Sphere hier heruntergeladen werden: [[Where to get Sphere/de|Sphere Download]]. Man sollte danach mindestestens zwei verschiedene zip Dateien erhalten haben, eins für den SphereServer und eins mit dem Script Paket.

# Entpacke SphereServer-0.56b....zip in einen Ordner bspw. nach "c:\sphere"
# Entpacke SphereServer-0.56b-xxxxxxxxxxxx-Scripts.zip Ordner aus Schritt 1. Es sollte nun "c:\sphere" ein Ordner namens "scripts" vorhanden sein.
# Erstelle in diesem Ordner drei weitere Unterordner: "accounts", "logs" und "save".
# Im "save" Ordner, erstelle eine leere Textdatei (bspw. mit dem Windows Notepad) und schreibe in diese Datei eine einzelne Zeile, in der [EOF] steht. Benenne diese Datei dann "spheredata.SCP" (NICHT .txt).
# Erstelle drei Kopien dieser Datei und benenne sie: spherestatics, spherechars.scp und sphereworld.scp
# Wiederhole das dann im "accounts" Ordner und erstelle die Dateien: "sphereacct.scp" und "sphereaccu.scp"
# Lade dir dann [http://prerelease.sphere.torfo.org/files/libMySQL.dll MySQL Library] und kopiere sie in den Sphere Ordner (bspw.: "c:\sphere").
# Nun sollte die [[Configuring_Sphere.ini/de|Sphere.ini]] bearbeitet werden, der SphereServer wird sonst nicht starten.
# Doppelklicke dann SphereSvr.exe und dann wird die Konsole starten. In diesem Fenster können administrative Befehle abgesetzt werden (eine Liste dieser Befehle gibts mit Eingabe von "?").
# Erstelle einen ersten Account auf dem Server. Führe deshalb folgende Befehle der Reihe nach aus und setze dabei einen passenden Nutzernamen und ein passenden Passwort ein:
#*"account add USERNAME PASSWORD"
#*"account USERNAME plevel 7" (dieser Befehl gibt dem Account GM-Rechte).

Der Server ist nun bereit und man kann sich mit einem UO Client einloggen. Es empfiehlt sich die Tutorials innerhalb dieses Wikis zu lesen, um ein wenig mehr über Sphere zu erfahren.

==FreeBSD==
We currently have no guide for this OS. Anyway, the developers have posted a list of required stuff. Here is the list:

Compiled on:

<tt>FreeBSD freebsdvbox.fastwebnet.it 7.0-RELEASE FreeBSD 7.0-RELEASE #0: Sun Feb 24 19:59:52 UTC 2008 root@logan.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC i386 </tt>

With:

<tt>Using built-in specs. 
Target: i386-portbld-freebsd7.0 
Configured with: ./..//gcc-4.1-20071105/configure --disable-nls --with-system-zlib --with-libiconv-prefix=/usr/local --program-suffix=41 --libdir=/usr/local/lib/gcc-4.1.3 --with-gxx-include-dir=/usr/local/lib/gcc-4.1.3/include/c++/ --disable-rpath --prefix=/usr/local --mandir=/usr/local/man --infodir=/usr/local/info/gcc41 i386-portbld-freebsd7.0 
Thread model: posix 
gcc version 4.1.3 20071105 (prerelease) </tt>

Linked Against:

<tt>libthr.so.3 => /lib/libthr.so.3 (0x281f3000) 
libmysqlclient.so.15 => /usr/local/lib/mysql/libmysqlclient.so.15 (0x28206000) 
libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x28265000) 
libm.so.5 => /lib/libm.so.5 (0x2835a000) 
libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x2836f000) 
libc.so.7 => /lib/libc.so.7 (0x2837a000) 
libcrypt.so.4 => /lib/libcrypt.so.4 (0x28476000) 
libz.so.4 => /lib/libz.so.4 (0x2848f000) </tt>

If you use this release, please check [http://www.sphereserver.net/index.php?showtopic=44153 this topic].

[[Category: Setting Up Sphere]]

De:Where to get Sphere

2010-11-25T22:16:25Z

Sco:

{{Languages|Where to get Sphere}}
Für Sphere 56b gibt es hauptsächlich 2 Möglichkeiten: Pre-Releases und automatische Builds. Unten ist eine Gegenüberstellung, die Unterschiede beinhaltet.

==Prerelease Builds==
Prerelease Builds werden regelmäßig veröffentlicht, wenn die Entwickler der Meinung sind, dass eine neue Version fällig ist und sie mit der Stabilität zufrieden sind (d.h. u.a. dass ein Prerelease Build auch läuft). Weil es noch keinen finalen Build gibt, sind die Prerelease Builds am nächsten an einer stabilen Version dran.

Prerelease Builds können hier heruntergeladen werden: [http://prerelease.sphereserver.net SphereServer Pre-releases].

Falls du nicht sicher bist, was genau hinter einem Prerelease Build steckt, dann gibt es hier noch weitere Informationen: [[#Was will ich eigentlich?|Was will ich eigentlich?]]

==Automatisierte Builds==
Jede Nacht wird automatisiert aus dem bestehenden Code eine neue Version von Sphere erstellt. Das passiert direkt und dieser Build enthält die letzten Änderungen, die von den Entwicklern vorgenommen wurden. Wenn es also die das topaktuellste sein soll, dann nutzt man einen automatisierten Build.

Automatisierte Builds sind hier zum Download verfügbar: [http://nightly.prerelease.sphere.torfo.org/ SphereServer Nightly Automated Builds]

Einige Warnungen, ehe ein solcher automatisierter Build genutzt wird:
* Da diese Builds direkt mit den neuesten und aktuellsten Änderungen am Quellcode erstellt wurden, ist es nicht ratsam, diese Version für einen laufenden Server zu nutzen, ausser man hat zuvor gut und gründlich getestet.
* Das Entwicklerteam kann keine oder wenige Hilfestellungen leisten, falls Probleme auftreten.

==Was will ich eigentlich?==
Falls noch Unsicherheiten bestehen, welche Version gewählt werden soll, dann sollte man auf einen Prerelease Build zurückgreifen. Automatisierte Builds sind vor allem für fortgeschrittenere Nutzer und Tester gedacht, die neue Features austesten wollen, bevor sie offiziell veröffentlicht werden.

Hier eine knappe Gegenüberstellung, was die Builds hauptsächlich unterscheidet:

{| border="1" cellpadding="4"
| '''[[#Prerelease Builds|Prerelease Builds]]''' || '''[[#Automatisierte Builds|Automatisierte Builds]]'''
|-
| Forensupport || Kein Support in den Foren
|-
| Höhere Stabilität || Keine Garantien für Stabilität
|-
| Von Hand kompiliert aus einem stabilen Zweig des Quellcodes || Automatisch kompiliert aus dem Quellcode der Entwickler
|-
| Enthält nicht die neuesten Features und Fehlerkorrekturen || Enthält das neueste an Features und Fehlerkorrekturen
|-
| Wird alle paar Monate veröffentlicht || Wird täglich veröffentlicht
|}

Zusammengefasst: die Prerelease Builds erhalten Forensupport durch die Entwickler und werden nur veröffentlicht, wenn das Team der Meinung ist, dass genug an Arbeit hineingeflossen ist. Solange nicht dringend neueste Features und Fehlerkorrekturen benötigt werden, sollte man deshalb als Endnutzer auf diese Builds zurückgreifen.

'''''Anmerkung:''''' ''Sollte man nur aus dem Grund einen automatisierten Build wählen, da man nicht auf die offiziellen Prerelease Builds warten will, dann sollte man sich das genau überlegen. Zwar sind neue Features oder Fehlerkorrekturen enthalten, aber die Gefahr, dass manche Dinge nicht abgeschlossen wurden oder bisher unbekannte Bugs und Fehler in Sphere auftauchen, ist viel höher und das kann die Stabilität des Servers stark verringern.''

[[Category: Setting Up Sphere]]

De:Contribution Guide

2010-11-25T22:15:59Z

Sco:

{{Languages|Contribution Guide}}
Da dieses Wiki durch die Community und nicht durch die Entwickler gepflegt wird, ist jede Hilfe willkommen.

Es wird lediglich ein [[Special:UserLogin|Account]] benötigt und schon kann man loslegen. Oberhalb jedes Artikels ist ein "Edit"-Link, mit dem sich jeder Artikel sofort bearbeiten lässt, sofern man eingeloggt ist.

Zentrale Punkte in der Pflege der Artikel:
* Fehlerkorrektur in existierenden Seiten
* Artikel über UO oder Sphere verfassen
* Updates für das [[de:Main Page#Referenzkompendium|Referenzkompendium]], denn mit jeder neuen Version von Sphere können neue Features auftauchen.

Egal welche Art von Pflege hier betrieben wird, es sollten dabei folgende Gebote beachtet werden:
* Sicherstellen, dass die Information fehlerfrei, präzise und aktuell ist.
* So klar wie möglich Sachverhalte darlegen und dabei auf den übliche Internetslang verzichten.
* Andere werden es nicht gern sehen, wenn man ihre Artikel grundlegend verändert. Wenn grundlegende Änderungen durchgeführt werden sollen, sollte man in Betracht ziehen, die ursprünglichen Autoren zu kontaktieren.

Wenn du etwas beitragen möchtest, aber nicht weisst, was zu tun wäre:
* Überprüfe [[Special:WantedPages|wanted pages]]. Diese Liste enthält Seiten, die von anderen Artikeln zwar verlinkt wurden, aber die noch keinerlei Inhalt haben.
* Überprüfe [[Special:WantedCategories|wanted categories]]. Hier sind Kategorisierungen, die von anderen verlinkt wurden, aber noch keinen Inhalt enthalten.

Falls du beim Bearbeiten von Artikeln keinerlei Erfahrung hast und die Syntax des Wikis nicht kennst: [[Help:Editing|Editing help]] (deutsche Version wird noch folgen). Diese Hilfe enthält auch eine spezielle Syntax für Sphere Skripte.

[[Category: Navigation]]

De:Main Page

2010-11-25T22:15:18Z

Sco:

{{Languages|Main Page}}
Willkommen zum Remake von Taran's bekannter Seite: "[http://www.cs.rit.edu/~djr7581/ Sphere Scripting for Dummies tutorials]". Seine Tutorials waren damals für Sphere 55i erstellt worden, mittlerweile ist die aktuelle Version Sphere 56b und deshalb wurde entschieden, hier auf diesen Seiten eine Sammlung aktueller Tutorials und ein Kompendium neuer Funktionen zu bieten.

'''Wo fang ich nun an?'''

Jeder, der sich für die Skriptsprache von Sphere 56b interessiert, sollte hier anfangen: [[#Installation von Sphere|Installation von Sphere]]. Dort findet man die ersten Schritte mit Sphere. Danach empfiehlt es sich alle [[#Tutorials|Tutorials]] durch zu arbeiten, möglichst alles dabei zu verstehen und viel zu lernen.

'''Ich hab jetzt Skripten gelernt! Was nun?'''

Sind die ersten 10 Kapitels durchgearbeitet, dann gibt es hier natürlich noch weitere Artikel und Seiten. Sie erscheinen vielleicht nicht so wichtig, wie die anderen, aber sind dennöch mit weiterführenden und nützlichen Informationen gespickt. Versuche eigene Skripte zu entwickeln, sie vielleicht auch im [http://www.sphereserver.net/index.php SphereServer Forums] zu veröffentlichen. In den Forum erhält man auch weitere Hilfestellungen und Antworten auf Fragen. Des Weiteren ist auch das [[#Referenzkompendium|Referenzkompendium]] sehr nützlich.

'''Ich will mithelfen!'''

Um die Informationen auf diesen Seiten immer möglichst aktuell zu halten, ist natürlich viel Arbeit und Zeit notwendig. Jeder, der mithelfen möchte, diese Seiten zu pflegen, darf sich jederzeit hier anmelden und die Artikel hier überarbeiten. Alles, was man dafür braucht, ist ein [[Special:UserLogin|Wiki-Account]]. Oberhalb jeder Seite ist ein "Edit"-Link. Ausserdem sollte dieser Guide gelesen werden: [[de:Contribution Guide|Leitfaden für das SphereWiki]].

'''Dank geht speziell an:'''

[[WhoIsWho|Ben, Cloud_Br, Ellessar, Jdog, Lord Zerofiz, Mordaunt, Nazghul-ll, RanXerox, Rattlehead, Sandman, Sharlenwar, ShiryuX, thelegbra, Maximus and WarAngel]], für das Hinzufügen von Inhalt.

[[WhoIsWho|Daleth]], für das Erstellen des Sphere Reference Project, and [[WhoIsWho|Mordaunt]] für die Konvertierung ins .chm-Format.

[[WhoIsWho|Tracker]], für das Übertragen von Änderungen in Sphere 56 Tracking Changes.

[[WhoIsWho|Taran]], für die originalen Sphere Scripting for Dummies tutorials und [[WhoIsWho|MrSugarCube]], der ständige Neuerungen aktuell hält.

[[WhoIsWho|Furio, Radiant, Vjaka, Nazghul-ll, Ellessar, Torfo, Shadow Dragon and MrSugarCube]] für kontinuierliche Arbeit an Sphere, wodurch ein sehr mächtiger und an alle möglichen Bedürfnisse anpassbarer Ultima Online Emulator entstand.

[[WhoIsWho|Crius]], der das ursprüngliche Wiki gehostet hat, und [[WhoIsWho|Torfo]], der das Wiki momentan hostet.

----

==Installation von Sphere==

* [[de:Where to get Sphere|Sphere herunterladen]]
* [[de:Installing Sphere|Sphere installieren]]
* [[de:Configuring Sphere.ini|Konfigurationseinstellungen der Sphere.ini]]

==Tutorials==

Die Kapitel von Taran in aktualisierter Version für 56b:

* [[de:Chapter 1|Kapitel 1]] ''(Nummern, DEFNAME, ITEMDEF, CHARDEF)''
* [[de:Chapter 2|Kapitel 2]] ''(Übersicht über die Standardskripte)''
* [[de:Chapter 3|Kapitel 3]] ''(NPC's und Gegenstände, coole Funktionen)''
* [[de:Chapter 4|Kapitel 4]] ''(Objekte, Operatoren, Sprache)''
* [[de:Chapter 5|Kapitel 5]] ''(Tags, Vars, Locals, Functions)''
* [[de:Chapter 6|Kapitel 6]] ''(LINKs, TIMERs, TARGETs)''
* [[de:Chapter 7|Kapitel 7]] ''(Schleifen und mächtige Funktionen)''
* [[de:Chapter 8|Kapitel 8]] ''(SKILLMENUs, MENUs, Gumps)''
* [[de:Chapter 9|Kapitel 9]] ''(Events)''
* [[de:Chapter 10|Kapitel 10]] ''(Strings/Zeichenketten behandeln)''

Zusätlich gibt es noch einige etwas fortgeschrittenere Tutorials, die von anderen Mitgliedern der Community bereitgestellt wurden. Nachdem man die 10 Kapitel durchgearbeitet hat, bieten sich die folgenden an, wenn man noch mehr lernen möchte:

* [[Common Mistakes|Häufige Fehler]] ''(A revision of Maximus's tutorial on the forums, and continuation of Taran's Misconceptions tutorial)''
* [[Internet and Sphere]] ''(And how to make the right use of them)''
* [[Languages Tutorial]] ''(How to script your own language system)''
* [[Making your own Skills]] ''(How to make and customize your skill)''
* [[Mul Patching Tutorial|Nazghul's Mul Patching Tutorial]] [http://sorea.profitux.cz/patching/ external link] ''(A document about mul patching and customizing your server)''
* [[Overriding Hardcoded Commands]] ''(How to override hardcoded commands and functions)''
* [[Scheduled Reboot]] ''(How to schedule system reboots)''
* [[Using MySQL]] ''(How to use MySQL)''

==Referenzkompendium==

* [[:Category:Definitions|Definitions]]
** [[CHARDEF|Characters]]
** [[DIALOG|Dialogs]]
** [[EVENTS|Events]]
** [[ITEMDEF|Items]]
** [[MENU|Menus]]
** [[REGIONRESOURCE|Region Resources]]
** [[REGIONTYPE|Region Types]]
** [[AREADEF|Regions]]
** [[ROOMDEF|Rooms]]
** [[SKILLCLASS|Skill Classes]]
** [[SKILLMENU|Skill Menus]]
** [[SKILL|Skills]]
** [[SPAWN|Spawn Groups]]
** [[SPELL|Spells]]
** [[TYPEDEF|Types]]
* [[:Category:Objects|Objects]]
** [[Accounts]]
** [[Characters]]
** [[Database]]
** [[Files]]
** [[GM Pages]]
** [[Items]]
*** [[Special Items]]
** [[Map Points]]
** [[Parties]]
** [[Regions]]
** [[Rooms]]
** [[Sectors]]
** [[Server]]
* [[:Category:Scripts|Scripts]]
** [[:Category:Functions|Functions and Triggers]]
** [[:Category:Variables|General Functions, Properties and References]]
** [[Intrinsic Functions]]
** [[:Category:Statements|Statements]]

==Andere Artikel==

* [[Armor Calculation]]
* [[Client Changes]]
* [[Common Scripting Misconceptions]]
* [[Custom Object Properties]]
* [[Error Codes]]
* [[Experience System]]
* [[How Combat Works]]
* [[Occam's Razor]]
* [[Optimization|Optimization Theory]]
* [[Override TAGs]]
* [[Revisions Changelog]]
* [[Sendpacket]]
* [[Skill Gain Theory]]
* [[The Process of Scripting]]

==External Links==

* [http://www.sphereserver.net/ Offizielle SphereServer Webseite]
* [http://prerelease.sphere.torfo.org/ Offizielle Sphere 56b Downloads]
* [http://nightly.prerelease.sphere.torfo.org/ Offizielle Sphere 56b Nightly Builds]
* [http://scriptsharing.dv-team.de/ ScriptSharing]
* [http://www.cs.rit.edu/~djr7581/ Taran's Scripting for Dummies (Sphere 55i)]
* [http://uo.torfo.org/packetguide/ Jerrith's UO Packet Guide]
* [http://uo.torfo.org/packetguideKR/ Wyatt&Kons's UOKR Packet Guide]

[[Category: Navigation]]

Template:Languages

2010-11-25T22:10:56Z

Sco:

<includeonly>{{ {{{2|Languages/Interface}}}

|{{LanguageExisting|de|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|de|{{{1|{{PAGENAME}}}}}}}

|{{LanguageExistingEn|{{{1|{{PAGENAME}}}}}}} = {{LanguageLinkEn|{{{1|{{PAGENAME}}}}}}}

|{{LanguageExisting|es|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|es|{{{1|{{PAGENAME}}}}}}}

}}</includeonly><noinclude>
'''Note: This is a test for a language toolbar. The template is taken from the openstreetmap-wiki.'''

'''Do not edit this template too often. This template is linked from many pages, when you renew it, the wiki-server starts to rebuild database of link connections. It takes about 20 seconds for each page.'''

Instructions were moved to [[Wiki Translation]]:
{{Languages|Wiki Translation}}

[[Category:Template:Internationalisation]]
</noinclude>

Template:Languages

2010-11-25T22:09:10Z

Sco:

<includeonly>{{ {{{2|Languages/Interface}}}

|{{LanguageExisting|de|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|de|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|el|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|el|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExistingEn|{{{1|{{PAGENAME}}}}}}} = {{LanguageLinkEn|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|eo|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|eo|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|es|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|es|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|et|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|et|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|eu|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|eu|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|fi|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|fi|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|fr|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|fr|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|fy|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|fy|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|gcf|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|gcf|{{{1|{{PAGENAME}}}}}|Créole guadeloupéen}}
|{{LanguageExisting|he|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|he|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|ht|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|ht|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|HU|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|HU|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|hr|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|hr|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|hy|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|hy|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|ia|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|ia|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|is|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|is|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|it|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|it|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|ja|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|ja|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|ko|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|ko|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|lb|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|lb|{{{1|{{PAGENAME}}}}}|Lëtzebuergesch}}
|{{LanguageExisting|lt|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|lt|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|lv|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|lv|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|mk|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|mk|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|nl|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|nl|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|nn|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|nn|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|no|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|no|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|oc|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|oc|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|pl|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|pl|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|pt|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|pt|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|pt-br|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|pt-br|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|ro|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|ro|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|ro-md|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|ro-md|{{{1|{{PAGENAME}}}}}|{{#language:ro}} (Moldova)}}
|{{LanguageExisting|ru|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|ru|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|sk|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|sk|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|sl|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|sl|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|sq|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|sq|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|sv|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|sv|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|tr|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|tr|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|uk|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|uk|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|vi|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|vi|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|zh-hans|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|zh-hans|{{{1|{{PAGENAME}}}}}}}
|{{LanguageExisting|zh-hant|{{{1|{{PAGENAME}}}}}}} = {{LanguageLink|zh-hant|{{{1|{{PAGENAME}}}}}}}
}}</includeonly><noinclude>
'''Note: This is a test for a language toolbar. The template is taken from the openstreetmap-wiki.'''

'''Do not edit this template too often. This template is linked from many pages, when you renew it, the wiki-server starts to rebuild database of link connections. It takes about 20 seconds for each page.'''

Instructions were moved to [[Wiki Translation]]:
{{Languages|Wiki Translation}}

[[Category:Template:Internationalisation]]
</noinclude>

De:Installing Sphere

2010-11-25T13:36:25Z

Sco: moved Installing Sphere/de to De:Installing Sphere

==Linux==
===Vorwort===
Sphere auf einem Linuxsystem zu installieren, ist nicht viel schwieriger als auf einem Windowsrechner. Allerdings ist Basiswissen über Linux vorausgesetzt und ein wenig Erfahrung mit der Kommandozeile von Nöten, da hier nicht einfach auf ein Symbol geklickt wird und Sphere läuft.

Diese Anleitung ist deshalb darauf ausgelegt, dass eine Shell oder ein Terminal zum Linuxsystem verfügbar ist und root-Rechte vorhanden sind.

Letztendlich wird diese Anleitung nicht beinhalten, welche Dateien auf dem Linux Server verfügbar sein müssen. Diese Anleitung umfasst keine Einführung in Linuxsysteme und hat auch keinen Anspruch darauf, dies zu sein. Für weiterführende Informationen über Linux gibt es viele E-Books und Howtos, die frei im Web verfügbar sind. Beispielsweise ist hier ein guter Startpunkt: [http://www.linux.org http://www.linux.org]

Wichtig ist aber vor allem folgendes: Anders als ein Windowssystem, ist Linux bezüglich Datei- und Ordnernamen die Groß- und Kleinschreibung zu beachten. Wenn eine Datei von Sphere nicht gefunden wird, liegt das möglicherweise daran, dass gewisse Dateien falsch geschrieben sind, wie bspw: "sphere.INI" anstelle von "sphere.ini".

Alle Zeilen, die in dieser Anleitung kursiv sind, sollten direkt in das Terminal eingegeben werden.

===Vorbereitungens===
Auf dem Linuxsystem wird eine Installation des MySQL Clients benötigt. Fehlen die Bibliotheken des MySQL Clients, wird Sphere nicht ausführbar sein.

Des Weiteren wird ein Sphere Version FÜR LINUX benötigt, sowie das passende Skriptpaket und eventuelle zusätzliche Bibliotheken, die in der Downloadsektion angegeben sind.

===Schritt für Schritt Installation===
'''1)''' Mit Rootrechten einen neuen Nutzer namens "sphere" anlegen. Dieser Nutzer benötigt ein eigenen Heimverzeichnis (meistens: /home/sphere) mit den entsprechenden Rechten.

<tt>useradd -d /home/sphere sphere 
mkdir /home/sphere 
chown sphere /home/sphere 
chmod 700 /home/sphere </tt>

'''2)''' Kopiere alle Dateien des Sphere LINUX downloads, das Skriptpaket und eventuell nötige Bibliotheken in das neu angelegte Verzeichnis. Zudem müssen Unterordner angelegt werden: "save", "logs" und "accounts", wie angegeben in der sphere.ini und in spheretables.scp. Am Ende sollte eine ähnliche Ordnerstruktur vorliegen:

<tt>/home/sphere --- spheresvr 
              |  sphere.ini 
              |  sphereCrypt.ini 
          |-------------------- accounts/ 
          |-------------------- logs/ 
          |-------------------- muls/ 
          |-------------------- save/ 
          |-------------------- scripts/ </tt>

'''3)''' Nachdem alle Dateien an die richtige Stelle kopiert wurden, benötigen sie die richtigen Dateirechte. Deshalb weiterhin unter Rootrechten folgende Befehle ausführen:

<tt>cd ~sphere 
chown -R sphere * 
find . -type d | xargs chmod 0700 
find . -type f | xargs chmod 0600 
chmod 4700 spheresvr </tt>

'''4)''' Immer noch unter Rootrechten:

<tt>ldd spheresvr </tt>

Die Ausgabe sollte nun ungefähr so lauten:

<tt>longbow:/home/sphere# ldd spheresvr 
libpthread.so.0 => /lib/libpthread.so.0 (0x4001f000) 
libmysqlclient.so.15 => /usr/lib/libmysqlclient.so.15 (0x40071000) 
libboost_regex-gcc-1_33_1.so => /usr/lib/libboost_regex-gcc-1_33_1.so (0x40243000) 
libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x402ea000) 
libm.so.6 => /lib/libm.so.6 (0x403c9000) 
libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x403ef000) 
libc.so.6 => /lib/libc.so.6 (0x403fa000) 
/lib/ld-linux.so.2 (0x40000000) 
libcrypt.so.1 => /lib/libcrypt.so.1 (0x4051c000) 
libnsl.so.1 => /lib/libnsl.so.1 (0x4054a000) 
libz.so.1 => /usr/lib/libz.so.1 (0x40561000) </tt>

NACH FEHLENDEN BIBLIOTHEKEN AUSSCHAU HALTEN! Notfalls müssen diese nachinstalliert werden.

===Die Installation testen===
Es ist jetzt nicht mehr von Belang, ob der erste Test mit Rootrechten oder unter dem Benutzer sphere ausgeführt wird. Werden die Rechte der Datei auf 4700 gesetzt, wird Sphere automatisch immer unter dem benutzer sphere ausgeführt. Deshalb:

<tt>cd ~sphere 
./spheresvr </tt>

Es sollte nun eine Liste des Startups folgen ... mit vielleicht enthaltenen Warnings:

<tt>longbow:/home/sphere# ./spheresvr 
WARNING:(sphere.ini,587)'scripts/spherestatusbase.html' not found... 
ERROR:(sphere.ini,587)Can't open web page input 'spherestatusbase1.htm' 
Sphere Version 0.56b [Linux] by www.sphereserver.com, compiled at Sep 15 2006 (23:23:07) 
Signal handlers installed. 
Expansion maps supported: T2A, LBR, AOS, SE, ML 
ERROR:(spheretables.scp,59)Unable to open directory scripts/custom/ 
ERROR:(spheretables.scp,59)DirList=-1 for 'scripts/custom/' 
Allocating map sectors: 0=7168 1=7168 2=900 3=1280 4=32761 
Indexing 211 scripts... 
Loading scripts/sphere_defs.scp 
[...] </tt>

Warnings und Fehler über fehlende Webseiten können ignoriert werden. Falls allerdings andere Fehler auftreten oder Sphere terminiert (=sich beendet), dann sollte in den vorhergehenden Zeilen nach dem Grund gesucht werden.

Letztendlich sollten folgende Meldungen auftauchen, falls alles gut lief:

<tt>[...] 
Loading save/spheredata... 
Loading save/spherestatics... 
Loading save/sphereworld... 
Loading save/spherechars... 
166 Objects accounted for 
Option flags: CommandSysmsgs + NoHouseMuteSpeech 
Experimental flags: DiagonalWalkCheck + ScriptsReturnStrings + NewTriggersEnable + NewPositionChecks + WalkCheck + ScriptProfiler + SizeOptimize 
Admin=me@my.email.com, URL=www.myshard.com, Lang=English, TZ=0 
Startup complete. items=0, chars=0 
Creating thread. </tt>

Danach befindet man sich in der Sphere Konsole und kann allgemeine Befehle absetzen ('?' gibt eine Liste aus). Lege einen Account an, aktiviert ihn, editier die login.cfg des Ultima Online Clients damit er die IP-Adresse des Servers enthält und log ein.

Damit Sphere wieder heruntergefahren wird, ist zunächst der Befehl "S", gefolgt vom Befehl "X" notwendig. Linux wird dann versuchen, Sphere zu beenden - sollte das aus irgendeinem Grund nicht funktionieren, hilft die Tastenkombination STRG-c weiter.

===Einen Liveshard aufsetzen===
Sphere in einem Terminal laufen zu lassen hat einen Nachteil: schließt man dieses Terminal, beendet Linux auch Sphere. Das ist unter Linuxsystemen beabsichtigt, weil es ein Multiusersystem ist. Das bedeutet vor allem, dass bei jedem Logout eines Nutzers auch unbedingt all seine laufenden Prozesse beendet werden sollten.

Natürlich ist es aber dennoch möglich, Prozesse im Hintergrund laufen zu lassen, selbst wenn Terminal oder Shell geschlossen werden. Hierfür bietet sich ein Skript an, das ein Tool namens 'screen' nutzt (notfalls nachinstallieren):

<tt>#!/bin/sh 
cd ~sphere 
while true; do 
screen -D -m /home/sphere/spheresvr 
sleep 30 
done </tt>

Dieses Skript kann in jedem beliebigen Editor abgespeichert werden und sollte möglichst die Dateiendung .sh erhalten. Wird das Skript ausgeführt, startet sich Sphere in einem virtuellen Terminal, das jederzeit mit "screen -r "abgerufen werden kann. Mit der Tastenkombination STRG-a gefolgt von STRG-d kann man dieses Terminal jederzeit wieder verlassen und es läuft im Hintergrund weiter. In der Dokumentation von "screen" finden sich weitere Informationen.

==Windows==
Als erstes sollte Sphere hier heruntergeladen werden: [[Where to get Sphere/de|Sphere Download]]. Man sollte danach mindestestens zwei verschiedene zip Dateien erhalten haben, eins für den SphereServer und eins mit dem Script Paket.

# Entpacke SphereServer-0.56b....zip in einen Ordner bspw. nach "c:\sphere"
# Entpacke SphereServer-0.56b-xxxxxxxxxxxx-Scripts.zip Ordner aus Schritt 1. Es sollte nun "c:\sphere" ein Ordner namens "scripts" vorhanden sein.
# Erstelle in diesem Ordner drei weitere Unterordner: "accounts", "logs" und "save".
# Im "save" Ordner, erstelle eine leere Textdatei (bspw. mit dem Windows Notepad) und schreibe in diese Datei eine einzelne Zeile, in der [EOF] steht. Benenne diese Datei dann "spheredata.SCP" (NICHT .txt).
# Erstelle drei Kopien dieser Datei und benenne sie: spherestatics, spherechars.scp und sphereworld.scp
# Wiederhole das dann im "accounts" Ordner und erstelle die Dateien: "sphereacct.scp" und "sphereaccu.scp"
# Lade dir dann [http://prerelease.sphere.torfo.org/files/libMySQL.dll MySQL Library] und kopiere sie in den Sphere Ordner (bspw.: "c:\sphere").
# Nun sollte die [[Configuring_Sphere.ini/de|Sphere.ini]] bearbeitet werden, der SphereServer wird sonst nicht starten.
# Doppelklicke dann SphereSvr.exe und dann wird die Konsole starten. In diesem Fenster können administrative Befehle abgesetzt werden (eine Liste dieser Befehle gibts mit Eingabe von "?").
# Erstelle einen ersten Account auf dem Server. Führe deshalb folgende Befehle der Reihe nach aus und setze dabei einen passenden Nutzernamen und ein passenden Passwort ein:
#*"account add USERNAME PASSWORD"
#*"account USERNAME plevel 7" (dieser Befehl gibt dem Account GM-Rechte).

Der Server ist nun bereit und man kann sich mit einem UO Client einloggen. Es empfiehlt sich die Tutorials innerhalb dieses Wikis zu lesen, um ein wenig mehr über Sphere zu erfahren.

==FreeBSD==
We currently have no guide for this OS. Anyway, the developers have posted a list of required stuff. Here is the list:

Compiled on:

<tt>FreeBSD freebsdvbox.fastwebnet.it 7.0-RELEASE FreeBSD 7.0-RELEASE #0: Sun Feb 24 19:59:52 UTC 2008 root@logan.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC i386 </tt>

With:

<tt>Using built-in specs. 
Target: i386-portbld-freebsd7.0 
Configured with: ./..//gcc-4.1-20071105/configure --disable-nls --with-system-zlib --with-libiconv-prefix=/usr/local --program-suffix=41 --libdir=/usr/local/lib/gcc-4.1.3 --with-gxx-include-dir=/usr/local/lib/gcc-4.1.3/include/c++/ --disable-rpath --prefix=/usr/local --mandir=/usr/local/man --infodir=/usr/local/info/gcc41 i386-portbld-freebsd7.0 
Thread model: posix 
gcc version 4.1.3 20071105 (prerelease) </tt>

Linked Against:

<tt>libthr.so.3 => /lib/libthr.so.3 (0x281f3000) 
libmysqlclient.so.15 => /usr/local/lib/mysql/libmysqlclient.so.15 (0x28206000) 
libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x28265000) 
libm.so.5 => /lib/libm.so.5 (0x2835a000) 
libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x2836f000) 
libc.so.7 => /lib/libc.so.7 (0x2837a000) 
libcrypt.so.4 => /lib/libcrypt.so.4 (0x28476000) 
libz.so.4 => /lib/libz.so.4 (0x2848f000) </tt>

If you use this release, please check [http://www.sphereserver.net/index.php?showtopic=44153 this topic].

{{Languages|Installing Sphere}}
[[Category: Setting Up Sphere]]

Installing Sphere/de

2010-11-25T13:36:25Z

Sco: moved Installing Sphere/de to De:Installing Sphere

#REDIRECT [[De:Installing Sphere]]

De:Where to get Sphere

2010-11-25T13:35:45Z

Sco: moved Where to get Sphere/de to De:Where to get Sphere

Für Sphere 56b gibt es hauptsächlich 2 Möglichkeiten: Pre-Releases und automatische Builds. Unten ist eine Gegenüberstellung, die Unterschiede beinhaltet.

==Prerelease Builds==
Prerelease Builds werden regelmäßig veröffentlicht, wenn die Entwickler der Meinung sind, dass eine neue Version fällig ist und sie mit der Stabilität zufrieden sind (d.h. u.a. dass ein Prerelease Build auch läuft). Weil es noch keinen finalen Build gibt, sind die Prerelease Builds am nächsten an einer stabilen Version dran.

Prerelease Builds können hier heruntergeladen werden: [http://prerelease.sphereserver.net SphereServer Pre-releases].

Falls du nicht sicher bist, was genau hinter einem Prerelease Build steckt, dann gibt es hier noch weitere Informationen: [[#Was will ich eigentlich?|Was will ich eigentlich?]]

==Automatisierte Builds==
Jede Nacht wird automatisiert aus dem bestehenden Code eine neue Version von Sphere erstellt. Das passiert direkt und dieser Build enthält die letzten Änderungen, die von den Entwicklern vorgenommen wurden. Wenn es also die das topaktuellste sein soll, dann nutzt man einen automatisierten Build.

Automatisierte Builds sind hier zum Download verfügbar: [http://nightly.prerelease.sphere.torfo.org/ SphereServer Nightly Automated Builds]

Einige Warnungen, ehe ein solcher automatisierter Build genutzt wird:
* Da diese Builds direkt mit den neuesten und aktuellsten Änderungen am Quellcode erstellt wurden, ist es nicht ratsam, diese Version für einen laufenden Server zu nutzen, ausser man hat zuvor gut und gründlich getestet.
* Das Entwicklerteam kann keine oder wenige Hilfestellungen leisten, falls Probleme auftreten.

==Was will ich eigentlich?==
Falls noch Unsicherheiten bestehen, welche Version gewählt werden soll, dann sollte man auf einen Prerelease Build zurückgreifen. Automatisierte Builds sind vor allem für fortgeschrittenere Nutzer und Tester gedacht, die neue Features austesten wollen, bevor sie offiziell veröffentlicht werden.

Hier eine knappe Gegenüberstellung, was die Builds hauptsächlich unterscheidet:

{| border="1" cellpadding="4"
| '''[[#Prerelease Builds|Prerelease Builds]]''' || '''[[#Automatisierte Builds|Automatisierte Builds]]'''
|-
| Forensupport || Kein Support in den Foren
|-
| Höhere Stabilität || Keine Garantien für Stabilität
|-
| Von Hand kompiliert aus einem stabilen Zweig des Quellcodes || Automatisch kompiliert aus dem Quellcode der Entwickler
|-
| Enthält nicht die neuesten Features und Fehlerkorrekturen || Enthält das neueste an Features und Fehlerkorrekturen
|-
| Wird alle paar Monate veröffentlicht || Wird täglich veröffentlicht
|}

Zusammengefasst: die Prerelease Builds erhalten Forensupport durch die Entwickler und werden nur veröffentlicht, wenn das Team der Meinung ist, dass genug an Arbeit hineingeflossen ist. Solange nicht dringend neueste Features und Fehlerkorrekturen benötigt werden, sollte man deshalb als Endnutzer auf diese Builds zurückgreifen.

'''''Anmerkung:''''' ''Sollte man nur aus dem Grund einen automatisierten Build wählen, da man nicht auf die offiziellen Prerelease Builds warten will, dann sollte man sich das genau überlegen. Zwar sind neue Features oder Fehlerkorrekturen enthalten, aber die Gefahr, dass manche Dinge nicht abgeschlossen wurden oder bisher unbekannte Bugs und Fehler in Sphere auftauchen, ist viel höher und das kann die Stabilität des Servers stark verringern.''

{{Languages|Where to get Sphere}}
[[Category: Setting Up Sphere]]

Where to get Sphere/de

2010-11-25T13:35:45Z

Sco: moved Where to get Sphere/de to De:Where to get Sphere

#REDIRECT [[De:Where to get Sphere]]

De:Where to get Sphere

2010-11-25T13:35:36Z

Sco:

De:Contribution Guide

2010-11-25T13:34:18Z

Sco:

Da dieses Wiki durch die Community und nicht durch die Entwickler gepflegt wird, ist jede Hilfe willkommen.

Es wird lediglich ein [[Special:UserLogin|Account]] benötigt und schon kann man loslegen. Oberhalb jedes Artikels ist ein "Edit"-Link, mit dem sich jeder Artikel sofort bearbeiten lässt, sofern man eingeloggt ist.

Zentrale Punkte in der Pflege der Artikel:
* Fehlerkorrektur in existierenden Seiten
* Artikel über UO oder Sphere verfassen
* Updates für das [[de:Main Page#Referenzkompendium|Referenzkompendium]], denn mit jeder neuen Version von Sphere können neue Features auftauchen.

Egal welche Art von Pflege hier betrieben wird, es sollten dabei folgende Gebote beachtet werden:
* Sicherstellen, dass die Information fehlerfrei, präzise und aktuell ist.
* So klar wie möglich Sachverhalte darlegen und dabei auf den übliche Internetslang verzichten.
* Andere werden es nicht gern sehen, wenn man ihre Artikel grundlegend verändert. Wenn grundlegende Änderungen durchgeführt werden sollen, sollte man in Betracht ziehen, die ursprünglichen Autoren zu kontaktieren.

Wenn du etwas beitragen möchtest, aber nicht weisst, was zu tun wäre:
* Überprüfe [[Special:WantedPages|wanted pages]]. Diese Liste enthält Seiten, die von anderen Artikeln zwar verlinkt wurden, aber die noch keinerlei Inhalt haben.
* Überprüfe [[Special:WantedCategories|wanted categories]]. Hier sind Kategorisierungen, die von anderen verlinkt wurden, aber noch keinen Inhalt enthalten.

Falls du beim Bearbeiten von Artikeln keinerlei Erfahrung hast und die Syntax des Wikis nicht kennst: [[Help:Editing|Editing help]] (deutsche Version wird noch folgen). Diese Hilfe enthält auch eine spezielle Syntax für Sphere Skripte.

{{Languages|Contribution Guide}}
[[Category: Navigation]]

De:Contribution Guide

2010-11-25T13:33:33Z

Sco: moved Contribution Guide/de to De:Contribution Guide

Da dieses Wiki durch die Community und nicht durch die Entwickler gepflegt wird, ist jede Hilfe willkommen.

Es wird lediglich ein [[Special:UserLogin|Account]] benötigt und schon kann man loslegen. Oberhalb jedes Artikels ist ein "Edit"-Link, mit dem sich jeder Artikel sofort bearbeiten lässt, sofern man eingeloggt ist.

Zentrale Punkte in der Pflege der Artikel:
* Fehlerkorrektur in existierenden Seiten
* Artikel über UO oder Sphere verfassen
* Updates für das [[Main Page/de#Referenzkompendium|Referenzkompendium]], denn mit jeder neuen Version von Sphere können neue Features auftauchen.

Egal welche Art von Pflege hier betrieben wird, es sollten dabei folgende Gebote beachtet werden:
* Sicherstellen, dass die Information fehlerfrei, präzise und aktuell ist.
* So klar wie möglich Sachverhalte darlegen und dabei auf den übliche Internetslang verzichten.
* Andere werden es nicht gern sehen, wenn man ihre Artikel grundlegend verändert. Wenn grundlegende Änderungen durchgeführt werden sollen, sollte man in Betracht ziehen, die ursprünglichen Autoren zu kontaktieren.

Wenn du etwas beitragen möchtest, aber nicht weisst, was zu tun wäre:
* Überprüfe [[Special:WantedPages|wanted pages]]. Diese Liste enthält Seiten, die von anderen Artikeln zwar verlinkt wurden, aber die noch keinerlei Inhalt haben.
* Überprüfe [[Special:WantedCategories|wanted categories]]. Hier sind Kategorisierungen, die von anderen verlinkt wurden, aber noch keinen Inhalt enthalten.

Falls du beim Bearbeiten von Artikeln keinerlei Erfahrung hast und die Syntax des Wikis nicht kennst: [[Help:Editing|Editing help]] (deutsche Version wird noch folgen). Diese Hilfe enthält auch eine spezielle Syntax für Sphere Skripte.

[[Category: Navigation]]

Contribution Guide/de

2010-11-25T13:33:33Z

Sco: moved Contribution Guide/de to De:Contribution Guide

#REDIRECT [[De:Contribution Guide]]

De:Main Page

2010-11-25T13:32:38Z

Sco:

Willkommen zum Remake von Taran's bekannter Seite: "[http://www.cs.rit.edu/~djr7581/ Sphere Scripting for Dummies tutorials]". Seine Tutorials waren damals für Sphere 55i erstellt worden, mittlerweile ist die aktuelle Version Sphere 56b und deshalb wurde entschieden, hier auf diesen Seiten eine Sammlung aktueller Tutorials und ein Kompendium neuer Funktionen zu bieten.

'''Wo fang ich nun an?'''

Jeder, der sich für die Skriptsprache von Sphere 56b interessiert, sollte hier anfangen: [[#Installation von Sphere|Installation von Sphere]]. Dort findet man die ersten Schritte mit Sphere. Danach empfiehlt es sich alle [[#Tutorials|Tutorials]] durch zu arbeiten, möglichst alles dabei zu verstehen und viel zu lernen.

'''Ich hab jetzt Skripten gelernt! Was nun?'''

Sind die ersten 10 Kapitels durchgearbeitet, dann gibt es hier natürlich noch weitere Artikel und Seiten. Sie erscheinen vielleicht nicht so wichtig, wie die anderen, aber sind dennöch mit weiterführenden und nützlichen Informationen gespickt. Versuche eigene Skripte zu entwickeln, sie vielleicht auch im [http://www.sphereserver.net/index.php SphereServer Forums] zu veröffentlichen. In den Forum erhält man auch weitere Hilfestellungen und Antworten auf Fragen. Des Weiteren ist auch das [[#Referenzkompendium|Referenzkompendium]] sehr nützlich.

'''Ich will mithelfen!'''

Um die Informationen auf diesen Seiten immer möglichst aktuell zu halten, ist natürlich viel Arbeit und Zeit notwendig. Jeder, der mithelfen möchte, diese Seiten zu pflegen, darf sich jederzeit hier anmelden und die Artikel hier überarbeiten. Alles, was man dafür braucht, ist ein [[Special:UserLogin|Wiki-Account]]. Oberhalb jeder Seite ist ein "Edit"-Link. Ausserdem sollte dieser Guide gelesen werden: [[de:Contribution Guide|Leitfaden für das SphereWiki]].

'''Dank geht speziell an:'''

[[WhoIsWho|Ben, Cloud_Br, Ellessar, Jdog, Lord Zerofiz, Mordaunt, Nazghul-ll, RanXerox, Rattlehead, Sandman, Sharlenwar, ShiryuX, thelegbra, Maximus and WarAngel]], für das Hinzufügen von Inhalt.

[[WhoIsWho|Daleth]], für das Erstellen des Sphere Reference Project, and [[WhoIsWho|Mordaunt]] für die Konvertierung ins .chm-Format.

[[WhoIsWho|Tracker]], für das Übertragen von Änderungen in Sphere 56 Tracking Changes.

[[WhoIsWho|Taran]], für die originalen Sphere Scripting for Dummies tutorials und [[WhoIsWho|MrSugarCube]], der ständige Neuerungen aktuell hält.

[[WhoIsWho|Furio, Radiant, Vjaka, Nazghul-ll, Ellessar, Torfo, Shadow Dragon and MrSugarCube]] für kontinuierliche Arbeit an Sphere, wodurch ein sehr mächtiger und an alle möglichen Bedürfnisse anpassbarer Ultima Online Emulator entstand.

[[WhoIsWho|Crius]], der das ursprüngliche Wiki gehostet hat, und [[WhoIsWho|Torfo]], der das Wiki momentan hostet.

----

==Installation von Sphere==

* [[de:Where to get Sphere|Sphere herunterladen]]
* [[de:Installing Sphere|Sphere installieren]]
* [[de:Configuring Sphere.ini|Konfigurationseinstellungen der Sphere.ini]]

==Tutorials==

Die Kapitel von Taran in aktualisierter Version für 56b:

* [[de:Chapter 1|Kapitel 1]] ''(Nummern, DEFNAME, ITEMDEF, CHARDEF)''
* [[de:Chapter 2|Kapitel 2]] ''(Übersicht über die Standardskripte)''
* [[de:Chapter 3|Kapitel 3]] ''(NPC's und Gegenstände, coole Funktionen)''
* [[de:Chapter 4|Kapitel 4]] ''(Objekte, Operatoren, Sprache)''
* [[de:Chapter 5|Kapitel 5]] ''(Tags, Vars, Locals, Functions)''
* [[de:Chapter 6|Kapitel 6]] ''(LINKs, TIMERs, TARGETs)''
* [[de:Chapter 7|Kapitel 7]] ''(Schleifen und mächtige Funktionen)''
* [[de:Chapter 8|Kapitel 8]] ''(SKILLMENUs, MENUs, Gumps)''
* [[de:Chapter 9|Kapitel 9]] ''(Events)''
* [[de:Chapter 10|Kapitel 10]] ''(Strings/Zeichenketten behandeln)''

Zusätlich gibt es noch einige etwas fortgeschrittenere Tutorials, die von anderen Mitgliedern der Community bereitgestellt wurden. Nachdem man die 10 Kapitel durchgearbeitet hat, bieten sich die folgenden an, wenn man noch mehr lernen möchte:

* [[Common Mistakes|Häufige Fehler]] ''(A revision of Maximus's tutorial on the forums, and continuation of Taran's Misconceptions tutorial)''
* [[Internet and Sphere]] ''(And how to make the right use of them)''
* [[Languages Tutorial]] ''(How to script your own language system)''
* [[Making your own Skills]] ''(How to make and customize your skill)''
* [[Mul Patching Tutorial|Nazghul's Mul Patching Tutorial]] [http://sorea.profitux.cz/patching/ external link] ''(A document about mul patching and customizing your server)''
* [[Overriding Hardcoded Commands]] ''(How to override hardcoded commands and functions)''
* [[Scheduled Reboot]] ''(How to schedule system reboots)''
* [[Using MySQL]] ''(How to use MySQL)''

==Referenzkompendium==

* [[:Category:Definitions|Definitions]]
** [[CHARDEF|Characters]]
** [[DIALOG|Dialogs]]
** [[EVENTS|Events]]
** [[ITEMDEF|Items]]
** [[MENU|Menus]]
** [[REGIONRESOURCE|Region Resources]]
** [[REGIONTYPE|Region Types]]
** [[AREADEF|Regions]]
** [[ROOMDEF|Rooms]]
** [[SKILLCLASS|Skill Classes]]
** [[SKILLMENU|Skill Menus]]
** [[SKILL|Skills]]
** [[SPAWN|Spawn Groups]]
** [[SPELL|Spells]]
** [[TYPEDEF|Types]]
* [[:Category:Objects|Objects]]
** [[Accounts]]
** [[Characters]]
** [[Database]]
** [[Files]]
** [[GM Pages]]
** [[Items]]
*** [[Special Items]]
** [[Map Points]]
** [[Parties]]
** [[Regions]]
** [[Rooms]]
** [[Sectors]]
** [[Server]]
* [[:Category:Scripts|Scripts]]
** [[:Category:Functions|Functions and Triggers]]
** [[:Category:Variables|General Functions, Properties and References]]
** [[Intrinsic Functions]]
** [[:Category:Statements|Statements]]

==Andere Artikel==

* [[Armor Calculation]]
* [[Client Changes]]
* [[Common Scripting Misconceptions]]
* [[Custom Object Properties]]
* [[Error Codes]]
* [[Experience System]]
* [[How Combat Works]]
* [[Occam's Razor]]
* [[Optimization|Optimization Theory]]
* [[Override TAGs]]
* [[Revisions Changelog]]
* [[Sendpacket]]
* [[Skill Gain Theory]]
* [[The Process of Scripting]]

==External Links==

* [http://www.sphereserver.net/ Offizielle SphereServer Webseite]
* [http://prerelease.sphere.torfo.org/ Offizielle Sphere 56b Downloads]
* [http://nightly.prerelease.sphere.torfo.org/ Offizielle Sphere 56b Nightly Builds]
* [http://scriptsharing.dv-team.de/ ScriptSharing]
* [http://www.cs.rit.edu/~djr7581/ Taran's Scripting for Dummies (Sphere 55i)]
* [http://uo.torfo.org/packetguide/ Jerrith's UO Packet Guide]
* [http://uo.torfo.org/packetguideKR/ Wyatt&Kons's UOKR Packet Guide]

{{Languages|Main Page}}
[[Category: Navigation]]

De:Main Page

2010-11-25T13:30:28Z

Sco: moved Main Page/de to De:Main Page

Willkommen zum Remake von Taran's bekannter Seite: "[http://www.cs.rit.edu/~djr7581/ Sphere Scripting for Dummies tutorials]". Seine Tutorials waren damals für Sphere 55i erstellt worden, mittlerweile ist die aktuelle Version Sphere 56b und deshalb wurde entschieden, hier auf diesen Seiten eine Sammlung aktueller Tutorials und ein Kompendium neuer Funktionen zu bieten.

'''Wo fang ich nun an?'''

Jeder, der sich für die Skriptsprache von Sphere 56b interessiert, sollte hier anfangen: [[#Installation von Sphere|Installation von Sphere]]. Dort findet man die ersten Schritte mit Sphere. Danach empfiehlt es sich alle [[#Tutorials|Tutorials]] durch zu arbeiten, möglichst alles dabei zu verstehen und viel zu lernen.

'''Ich hab jetzt Skripten gelernt! Was nun?'''

Sind die ersten 10 Kapitels durchgearbeitet, dann gibt es hier natürlich noch weitere Artikel und Seiten. Sie erscheinen vielleicht nicht so wichtig, wie die anderen, aber sind dennöch mit weiterführenden und nützlichen Informationen gespickt. Versuche eigene Skripte zu entwickeln, sie vielleicht auch im [http://www.sphereserver.net/index.php SphereServer Forums] zu veröffentlichen. In den Forum erhält man auch weitere Hilfestellungen und Antworten auf Fragen. Des Weiteren ist auch das [[#Referenzkompendium|Referenzkompendium]] sehr nützlich.

'''Ich will mithelfen!'''

Um die Informationen auf diesen Seiten immer möglichst aktuell zu halten, ist natürlich viel Arbeit und Zeit notwendig. Jeder, der mithelfen möchte, diese Seiten zu pflegen, darf sich jederzeit hier anmelden und die Artikel hier überarbeiten. Alles, was man dafür braucht, ist ein [[Special:UserLogin|Wiki-Account]]. Oberhalb jeder Seite ist ein "Edit"-Link. Ausserdem sollte dieser Guide gelesen werden: [[Contribution Guide/de|Leitfaden für das SphereWiki]].

'''Dank geht speziell an:'''

[[WhoIsWho|Ben, Cloud_Br, Ellessar, Jdog, Lord Zerofiz, Mordaunt, Nazghul-ll, RanXerox, Rattlehead, Sandman, Sharlenwar, ShiryuX, thelegbra, Maximus and WarAngel]], für das Hinzufügen von Inhalt.

[[WhoIsWho|Daleth]], für das Erstellen des Sphere Reference Project, and [[WhoIsWho|Mordaunt]] für die Konvertierung ins .chm-Format.

[[WhoIsWho|Tracker]], für das Übertragen von Änderungen in Sphere 56 Tracking Changes.

[[WhoIsWho|Taran]], für die originalen Sphere Scripting for Dummies tutorials und [[WhoIsWho|MrSugarCube]], der ständige Neuerungen aktuell hält.

[[WhoIsWho|Furio, Radiant, Vjaka, Nazghul-ll, Ellessar, Torfo, Shadow Dragon and MrSugarCube]] für kontinuierliche Arbeit an Sphere, wodurch ein sehr mächtiger und an alle möglichen Bedürfnisse anpassbarer Ultima Online Emulator entstand.

[[WhoIsWho|Crius]], der das ursprüngliche Wiki gehostet hat, und [[WhoIsWho|Torfo]], der das Wiki momentan hostet.

----

==Installation von Sphere==

* [[Where to get Sphere/de|Sphere herunterladen]]
* [[Installing Sphere/de|Sphere installieren]]
* [[Configuring Sphere.ini/de|Konfigurationseinstellungen der Sphere.ini]]

==Tutorials==

Die Kapitel von Taran in aktualisierter Version für 56b:

* [[Chapter 1/de|Kapitel 1]] ''(Nummern, DEFNAME, ITEMDEF, CHARDEF)''
* [[Chapter 2/de|Kapitel 2]] ''(Übersicht über die Standardskripte)''
* [[Chapter 3/de|Kapitel 3]] ''(NPC's und Gegenstände, coole Funktionen)''
* [[Chapter 4/de|Kapitel 4]] ''(Objekte, Operatoren, Sprache)''
* [[Chapter 5/de|Kapitel 5]] ''(Tags, Vars, Locals, Functions)''
* [[Chapter 6/de|Kapitel 6]] ''(LINKs, TIMERs, TARGETs)''
* [[Chapter 7/de|Kapitel 7]] ''(Schleifen und mächtige Funktionen)''
* [[Chapter 8/de|Kapitel 8]] ''(SKILLMENUs, MENUs, Gumps)''
* [[Chapter 9/de|Kapitel 9]] ''(Events)''
* [[Chapter 10/de|Kapitel 10]] ''(Strings/Zeichenketten behandeln)''

Zusätlich gibt es noch einige etwas fortgeschrittenere Tutorials, die von anderen Mitgliedern der Community bereitgestellt wurden. Nachdem man die 10 Kapitel durchgearbeitet hat, bieten sich die folgenden an, wenn man noch mehr lernen möchte:

* [[Common Mistakes|Häufige Fehler]] ''(A revision of Maximus's tutorial on the forums, and continuation of Taran's Misconceptions tutorial)''
* [[Internet and Sphere]] ''(And how to make the right use of them)''
* [[Languages Tutorial]] ''(How to script your own language system)''
* [[Making your own Skills]] ''(How to make and customize your skill)''
* [[Mul Patching Tutorial|Nazghul's Mul Patching Tutorial]] [http://sorea.profitux.cz/patching/ external link] ''(A document about mul patching and customizing your server)''
* [[Overriding Hardcoded Commands]] ''(How to override hardcoded commands and functions)''
* [[Scheduled Reboot]] ''(How to schedule system reboots)''
* [[Using MySQL]] ''(How to use MySQL)''

==Referenzkompendium==

* [[:Category:Definitions|Definitions]]
** [[CHARDEF|Characters]]
** [[DIALOG|Dialogs]]
** [[EVENTS|Events]]
** [[ITEMDEF|Items]]
** [[MENU|Menus]]
** [[REGIONRESOURCE|Region Resources]]
** [[REGIONTYPE|Region Types]]
** [[AREADEF|Regions]]
** [[ROOMDEF|Rooms]]
** [[SKILLCLASS|Skill Classes]]
** [[SKILLMENU|Skill Menus]]
** [[SKILL|Skills]]
** [[SPAWN|Spawn Groups]]
** [[SPELL|Spells]]
** [[TYPEDEF|Types]]
* [[:Category:Objects|Objects]]
** [[Accounts]]
** [[Characters]]
** [[Database]]
** [[Files]]
** [[GM Pages]]
** [[Items]]
*** [[Special Items]]
** [[Map Points]]
** [[Parties]]
** [[Regions]]
** [[Rooms]]
** [[Sectors]]
** [[Server]]
* [[:Category:Scripts|Scripts]]
** [[:Category:Functions|Functions and Triggers]]
** [[:Category:Variables|General Functions, Properties and References]]
** [[Intrinsic Functions]]
** [[:Category:Statements|Statements]]

==Andere Artikel==

* [[Armor Calculation]]
* [[Client Changes]]
* [[Common Scripting Misconceptions]]
* [[Custom Object Properties]]
* [[Error Codes]]
* [[Experience System]]
* [[How Combat Works]]
* [[Occam's Razor]]
* [[Optimization|Optimization Theory]]
* [[Override TAGs]]
* [[Revisions Changelog]]
* [[Sendpacket]]
* [[Skill Gain Theory]]
* [[The Process of Scripting]]

==External Links==

* [http://www.sphereserver.net/ Offizielle SphereServer Webseite]
* [http://prerelease.sphere.torfo.org/ Offizielle Sphere 56b Downloads]
* [http://nightly.prerelease.sphere.torfo.org/ Offizielle Sphere 56b Nightly Builds]
* [http://scriptsharing.dv-team.de/ ScriptSharing]
* [http://www.cs.rit.edu/~djr7581/ Taran's Scripting for Dummies (Sphere 55i)]
* [http://uo.torfo.org/packetguide/ Jerrith's UO Packet Guide]
* [http://uo.torfo.org/packetguideKR/ Wyatt&Kons's UOKR Packet Guide]

[[Category: Navigation]]

Main Page/de

2010-11-25T13:30:28Z

Sco: moved Main Page/de to De:Main Page

#REDIRECT [[De:Main Page]]

De:Installing Sphere

2010-11-23T23:50:59Z

Sco:

De:Installing Sphere

2010-11-23T23:50:39Z

Sco:

==Linux==
===Vorwort===
Sphere auf einem Linuxsystem zu installieren, ist nicht viel schwieriger als auf einem Windowsrechner. Allerdings ist Basiswissen über Linux vorausgesetzt und ein wenig Erfahrung mit der Kommandozeile von Nöten, da hier nicht einfach auf ein Symbol geklickt wird und Sphere läuft.

Diese Anleitung ist deshalb darauf ausgelegt, dass eine Shell oder ein Terminal zum Linuxsystem verfügbar ist und root-Rechte vorhanden sind.

Letztendlich wird diese Anleitung nicht beinhalten, welche Dateien auf dem Linux Server verfügbar sein müssen. Diese Anleitung umfasst keine Einführung in Linuxsysteme und hat auch keinen Anspruch darauf, dies zu sein. Für weiterführende Informationen über Linux gibt es viele E-Books und Howtos, die frei im Web verfügbar sind. Beispielsweise ist hier ein guter Startpunkt: [http://www.linux.org http://www.linux.org]

Wichtig ist aber vor allem folgendes: Anders als ein Windowssystem, ist Linux bezüglich Datei- und Ordnernamen die Groß- und Kleinschreibung zu beachten. Wenn eine Datei von Sphere nicht gefunden wird, liegt das möglicherweise daran, dass gewisse Dateien falsch geschrieben sind, wie bspw: "sphere.INI" anstelle von "sphere.ini".

Alle Zeilen, die in dieser Anleitung kursiv sind, sollten direkt in das Terminal eingegeben werden.

===Vorbereitungens===
Auf dem Linuxsystem wird eine Installation des MySQL Clients benötigt. Fehlen die Bibliotheken des MySQL Clients, wird Sphere nicht ausführbar sein.

Des Weiteren wird ein Sphere Version FÜR LINUX benötigt, sowie das passende Skriptpaket und eventuelle zusätzliche Bibliotheken, die in der Downloadsektion angegeben sind.

===Schritt für Schritt Installation===
'''1)''' Mit Rootrechten einen neuen Nutzer namens "sphere" anlegen. Dieser Nutzer benötigt ein eigenen Heimverzeichnis (meistens: /home/sphere) mit den entsprechenden Rechten.

<tt>useradd -d /home/sphere sphere 
mkdir /home/sphere 
chown sphere /home/sphere 
chmod 700 /home/sphere </tt>

'''2)''' Kopiere alle Dateien des Sphere LINUX downloads, das Skriptpaket und eventuell nötige Bibliotheken in das neu angelegte Verzeichnis. Zudem müssen Unterordner angelegt werden: "save", "logs" und "accounts", wie angegeben in der sphere.ini und in spheretables.scp. Am Ende sollte eine ähnliche Ordnerstruktur vorliegen:

<tt>/home/sphere --- spheresvr 
              |  sphere.ini 
              |  sphereCrypt.ini 
          |-------------------- accounts/ 
          |-------------------- logs/ 
          |-------------------- muls/ 
          |-------------------- save/ 
          |-------------------- scripts/ </tt>

'''3)''' Nachdem alle Dateien an die richtige Stelle kopiert wurden, benötigen sie die richtigen Dateirechte. Deshalb weiterhin unter Rootrechten folgende Befehle ausführen:

<tt>cd ~sphere 
chown -R sphere * 
find . -type d | xargs chmod 0700 
find . -type f | xargs chmod 0600 
chmod 4700 spheresvr </tt>

'''4)''' Immer noch unter Rootrechten:

<tt>ldd spheresvr </tt>

Die Ausgabe sollte nun ungefähr so lauten:

<tt>longbow:/home/sphere# ldd spheresvr 
libpthread.so.0 => /lib/libpthread.so.0 (0x4001f000) 
libmysqlclient.so.15 => /usr/lib/libmysqlclient.so.15 (0x40071000) 
libboost_regex-gcc-1_33_1.so => /usr/lib/libboost_regex-gcc-1_33_1.so (0x40243000) 
libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x402ea000) 
libm.so.6 => /lib/libm.so.6 (0x403c9000) 
libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x403ef000) 
libc.so.6 => /lib/libc.so.6 (0x403fa000) 
/lib/ld-linux.so.2 (0x40000000) 
libcrypt.so.1 => /lib/libcrypt.so.1 (0x4051c000) 
libnsl.so.1 => /lib/libnsl.so.1 (0x4054a000) 
libz.so.1 => /usr/lib/libz.so.1 (0x40561000) </tt>

NACH FEHLENDEN BIBLIOTHEKEN AUSSCHAU HALTEN! Notfalls müssen diese nachinstalliert werden.

===Die Installation testen===
Es ist jetzt nicht mehr von Belang, ob der erste Test mit Rootrechten oder unter dem Benutzer sphere ausgeführt wird. Werden die Rechte der Datei auf 4700 gesetzt, wird Sphere automatisch immer unter dem benutzer sphere ausgeführt. Deshalb:

<tt>cd ~sphere 
./spheresvr </tt>

Es sollte nun eine Liste des Startups folgen ... mit vielleicht enthaltenen Warnings:

<tt>longbow:/home/sphere# ./spheresvr 
WARNING:(sphere.ini,587)'scripts/spherestatusbase.html' not found... 
ERROR:(sphere.ini,587)Can't open web page input 'spherestatusbase1.htm' 
Sphere Version 0.56b [Linux] by www.sphereserver.com, compiled at Sep 15 2006 (23:23:07) 
Signal handlers installed. 
Expansion maps supported: T2A, LBR, AOS, SE, ML 
ERROR:(spheretables.scp,59)Unable to open directory scripts/custom/ 
ERROR:(spheretables.scp,59)DirList=-1 for 'scripts/custom/' 
Allocating map sectors: 0=7168 1=7168 2=900 3=1280 4=32761 
Indexing 211 scripts... 
Loading scripts/sphere_defs.scp 
[...] </tt>

Warnings und Fehler über fehlende Webseiten können ignoriert werden. Falls allerdings andere Fehler auftreten oder Sphere terminiert (=sich beendet), dann sollte in den vorhergehenden Zeilen nach dem Grund gesucht werden.

Letztendlich sollten folgende Meldungen auftauchen, falls alles gut lief:

<tt>[...] 
Loading save/spheredata... 
Loading save/spherestatics... 
Loading save/sphereworld... 
Loading save/spherechars... 
166 Objects accounted for 
Option flags: CommandSysmsgs + NoHouseMuteSpeech 
Experimental flags: DiagonalWalkCheck + ScriptsReturnStrings + NewTriggersEnable + NewPositionChecks + WalkCheck + ScriptProfiler + SizeOptimize 
Admin=me@my.email.com, URL=www.myshard.com, Lang=English, TZ=0 
Startup complete. items=0, chars=0 
Creating thread. </tt>

Danach befindet man sich in der Sphere Konsole und kann allgemeine Befehle absetzen ('?' gibt eine Liste aus). Lege einen Account an, aktiviert ihn, editier die login.cfg des Ultima Online Clients damit er die IP-Adresse des Servers enthält und log ein.

Damit Sphere wieder heruntergefahren wird, ist zunächst der Befehl "S", gefolgt vom Befehl "X" notwendig. Linux wird dann versuchen, Sphere zu beenden - sollte das aus irgendeinem Grund nicht funktionieren, hilft die Tastenkombination STRG-c weiter.

===Einen Liveshard aufsetzen===
Sphere in einem Terminal laufen zu lassen hat einen Nachteil: schließt man dieses Terminal, beendet Linux auch Sphere. Das ist unter Linuxsystemen beabsichtigt, weil es ein Multiusersystem ist. Das bedeutet vor allem, dass bei jedem Logout eines Nutzers auch unbedingt all seine laufenden Prozesse beendet werden sollten.

Natürlich ist es aber dennoch möglich, Prozesse im Hintergrund laufen zu lassen, selbst wenn Terminal oder Shell geschlossen werden. Hierfür bietet sich ein Skript an, das ein Tool namens 'screen' nutzt (notfalls nachinstallieren):

<tt>#!/bin/sh 
cd ~sphere 
while true; do 
screen -D -m /home/sphere/spheresvr 
sleep 30 
done </tt>

Dieses Skript kann in jedem beliebigen Editor abgespeichert werden und sollte möglichst die Dateiendung .sh erhalten. Wird das Skript ausgeführt, startet sich Sphere in einem virtuellen Terminal, das jederzeit mit "screen -r "abgerufen werden kann. Mit der Tastenkombination STRG-a gefolgt von STRG-d kann man dieses Terminal jederzeit wieder verlassen und es läuft im Hintergrund weiter. In der Dokumentation von "screen" finden sich weitere Informationen.

==Windows==
Als erstes sollte Sphere hier heruntergeladen werden: [[Where to get Sphere/de|Sphere Download]]. Man sollte danach mindestestens zwei verschiedene zip Dateien erhalten haben, eins für den SphereServer und eins mit dem Script Paket.

# Entpacke SphereServer-0.56b....zip in einen Ordner bspw. nach "c:\sphere"
# Entpacke SphereServer-0.56b-xxxxxxxxxxxx-Scripts.zip Ordner aus Schritt 1. Es sollte nun "c:\sphere" ein Ordner namens "scripts" vorhanden sein.
# Erstelle in diesem Ordner drei weitere Unterordner: "accounts", "logs" und "save".
# Im "save" Ordner, erstelle eine leere Textdatei (bspw. mit dem Windows Notepad) und schreibe in diese Datei eine einzelne Zeile, in der [EOF] steht. Benenne diese Datei dann "spheredata.SCP" (NICHT .txt).
# Erstelle drei Kopien dieser Datei und benenne sie: spherestatics, spherechars.scp und sphereworld.scp
# Wiederhole das dann im "accounts" Ordner und erstelle die Dateien: "sphereacct.scp" und "sphereaccu.scp"
# Lade dir dann [http://prerelease.sphere.torfo.org/files/libMySQL.dll MySQL Library] und kopiere sie in den Sphere Ordner (bspw.: "c:\sphere").
# Nun sollte die [[Configuring_Sphere.ini/de|Sphere.ini]] bearbeitet werden, der SphereServer wird sonst nicht starten.
# Doppelklicke dann SphereSvr.exe und dann wird die Konsole starten. In diesem Fenster können administrative Befehle abgesetzt werden (eine Liste dieser Befehle gibts mit Eingabe von "?").
# Erstelle einen ersten Account auf dem Server. Führe deshalb folgende Befehle der Reihe nach aus und setze dabei einen passenden Nutzernamen und ein passenden Passwort ein:
#*"account add USERNAME PASSWORD"
#*"account USERNAME plevel 7" (dieser Befehl gibt dem Account GM-Rechte).

Der Server ist nun bereit und man kann sich mit einem UO Client einloggen. Es empfiehlt sich die Tutorials innerhalb dieses Wikis zu lesen, um ein wenig mehr über Sphere zu erfahren.

==FreeBSD==
We currently have no guide for this OS. Anyway, the developers have posted a list of required stuff. Here is the list:

Compiled on:

<tt>FreeBSD freebsdvbox.fastwebnet.it 7.0-RELEASE FreeBSD 7.0-RELEASE #0: Sun Feb 24 19:59:52 UTC 2008 root@logan.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC i386 </tt>

With:

<tt>Using built-in specs. 
Target: i386-portbld-freebsd7.0 
Configured with: ./..//gcc-4.1-20071105/configure --disable-nls --with-system-zlib --with-libiconv-prefix=/usr/local --program-suffix=41 --libdir=/usr/local/lib/gcc-4.1.3 --with-gxx-include-dir=/usr/local/lib/gcc-4.1.3/include/c++/ --disable-rpath --prefix=/usr/local --mandir=/usr/local/man --infodir=/usr/local/info/gcc41 i386-portbld-freebsd7.0 
Thread model: posix 
gcc version 4.1.3 20071105 (prerelease) </tt>

Linked Against:

<tt>libthr.so.3 => /lib/libthr.so.3 (0x281f3000) 
libmysqlclient.so.15 => /usr/local/lib/mysql/libmysqlclient.so.15 (0x28206000) 
libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x28265000) 
libm.so.5 => /lib/libm.so.5 (0x2835a000) 
libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x2836f000) 
libc.so.7 => /lib/libc.so.7 (0x2837a000) 
libcrypt.so.4 => /lib/libcrypt.so.4 (0x28476000) 
libz.so.4 => /lib/libz.so.4 (0x2848f000) </tt>

If you use this release, please check [http://www.sphereserver.net/index.php?showtopic=44153 this topic].

{{Language|Installing Sphere}}
[[Category: Setting Up Sphere]]

De:Installing Sphere

2010-11-23T15:32:40Z

Sco: /* Windows */

De:Installing Sphere

2010-11-23T08:01:09Z

Sco: /* Einen Liveshard aufsetzen */

==Linux==
===Vorwort===
Sphere auf einem Linuxsystem zu installieren, ist nicht viel schwieriger als auf einem Windowsrechner. Allerdings ist Basiswissen über Linux vorausgesetzt und ein wenig Erfahrung mit der Kommandozeile von Nöten, da hier nicht einfach auf ein Symbol geklickt wird und Sphere läuft.

Diese Anleitung ist deshalb darauf ausgelegt, dass eine Shell oder ein Terminal zum Linuxsystem verfügbar ist und root-Rechte vorhanden sind.

Letztendlich wird diese Anleitung nicht beinhalten, welche Dateien auf dem Linux Server verfügbar sein müssen. Diese Anleitung umfasst keine Einführung in Linuxsysteme und hat auch keinen Anspruch darauf, dies zu sein. Für weiterführende Informationen über Linux gibt es viele E-Books und Howtos, die frei im Web verfügbar sind. Beispielsweise ist hier ein guter Startpunkt: [http://www.linux.org http://www.linux.org]

Wichtig ist aber vor allem folgendes: Anders als ein Windowssystem, ist Linux bezüglich Datei- und Ordnernamen die Groß- und Kleinschreibung zu beachten. Wenn eine Datei von Sphere nicht gefunden wird, liegt das möglicherweise daran, dass gewisse Dateien falsch geschrieben sind, wie bspw: "sphere.INI" anstelle von "sphere.ini".

Alle Zeilen, die in dieser Anleitung kursiv sind, sollten direkt in das Terminal eingegeben werden.

===Vorbereitungens===
Auf dem Linuxsystem wird eine Installation des MySQL Clients benötigt. Fehlen die Bibliotheken des MySQL Clients, wird Sphere nicht ausführbar sein.

Des Weiteren wird ein Sphere Version FÜR LINUX benötigt, sowie das passende Skriptpaket und eventuelle zusätzliche Bibliotheken, die in der Downloadsektion angegeben sind.

===Schritt für Schritt Installation===
'''1)''' Mit Rootrechten einen neuen Nutzer namens "sphere" anlegen. Dieser Nutzer benötigt ein eigenen Heimverzeichnis (meistens: /home/sphere) mit den entsprechenden Rechten.

<tt>useradd -d /home/sphere sphere 
mkdir /home/sphere 
chown sphere /home/sphere 
chmod 700 /home/sphere </tt>

'''2)''' Kopiere alle Dateien des Sphere LINUX downloads, das Skriptpaket und eventuell nötige Bibliotheken in das neu angelegte Verzeichnis. Zudem müssen Unterordner angelegt werden: "save", "logs" und "accounts", wie angegeben in der sphere.ini und in spheretables.scp. Am Ende sollte eine ähnliche Ordnerstruktur vorliegen:

<tt>/home/sphere --- spheresvr 
              |  sphere.ini 
              |  sphereCrypt.ini 
          |-------------------- accounts/ 
          |-------------------- logs/ 
          |-------------------- muls/ 
          |-------------------- save/ 
          |-------------------- scripts/ </tt>

'''3)''' Nachdem alle Dateien an die richtige Stelle kopiert wurden, benötigen sie die richtigen Dateirechte. Deshalb weiterhin unter Rootrechten folgende Befehle ausführen:

<tt>cd ~sphere 
chown -R sphere * 
find . -type d | xargs chmod 0700 
find . -type f | xargs chmod 0600 
chmod 4700 spheresvr </tt>

'''4)''' Immer noch unter Rootrechten:

<tt>ldd spheresvr </tt>

Die Ausgabe sollte nun ungefähr so lauten:

<tt>longbow:/home/sphere# ldd spheresvr 
libpthread.so.0 => /lib/libpthread.so.0 (0x4001f000) 
libmysqlclient.so.15 => /usr/lib/libmysqlclient.so.15 (0x40071000) 
libboost_regex-gcc-1_33_1.so => /usr/lib/libboost_regex-gcc-1_33_1.so (0x40243000) 
libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x402ea000) 
libm.so.6 => /lib/libm.so.6 (0x403c9000) 
libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x403ef000) 
libc.so.6 => /lib/libc.so.6 (0x403fa000) 
/lib/ld-linux.so.2 (0x40000000) 
libcrypt.so.1 => /lib/libcrypt.so.1 (0x4051c000) 
libnsl.so.1 => /lib/libnsl.so.1 (0x4054a000) 
libz.so.1 => /usr/lib/libz.so.1 (0x40561000) </tt>

NACH FEHLENDEN BIBLIOTHEKEN AUSSCHAU HALTEN! Notfalls müssen diese nachinstalliert werden.

===Die Installation testen===
Es ist jetzt nicht mehr von Belang, ob der erste Test mit Rootrechten oder unter dem Benutzer sphere ausgeführt wird. Werden die Rechte der Datei auf 4700 gesetzt, wird Sphere automatisch immer unter dem benutzer sphere ausgeführt. Deshalb:

<tt>cd ~sphere 
./spheresvr </tt>

Es sollte nun eine Liste des Startups folgen ... mit vielleicht enthaltenen Warnings:

<tt>longbow:/home/sphere# ./spheresvr 
WARNING:(sphere.ini,587)'scripts/spherestatusbase.html' not found... 
ERROR:(sphere.ini,587)Can't open web page input 'spherestatusbase1.htm' 
Sphere Version 0.56b [Linux] by www.sphereserver.com, compiled at Sep 15 2006 (23:23:07) 
Signal handlers installed. 
Expansion maps supported: T2A, LBR, AOS, SE, ML 
ERROR:(spheretables.scp,59)Unable to open directory scripts/custom/ 
ERROR:(spheretables.scp,59)DirList=-1 for 'scripts/custom/' 
Allocating map sectors: 0=7168 1=7168 2=900 3=1280 4=32761 
Indexing 211 scripts... 
Loading scripts/sphere_defs.scp 
[...] </tt>

Warnings und Fehler über fehlende Webseiten können ignoriert werden. Falls allerdings andere Fehler auftreten oder Sphere terminiert (=sich beendet), dann sollte in den vorhergehenden Zeilen nach dem Grund gesucht werden.

Letztendlich sollten folgende Meldungen auftauchen, falls alles gut lief:

<tt>[...] 
Loading save/spheredata... 
Loading save/spherestatics... 
Loading save/sphereworld... 
Loading save/spherechars... 
166 Objects accounted for 
Option flags: CommandSysmsgs + NoHouseMuteSpeech 
Experimental flags: DiagonalWalkCheck + ScriptsReturnStrings + NewTriggersEnable + NewPositionChecks + WalkCheck + ScriptProfiler + SizeOptimize 
Admin=me@my.email.com, URL=www.myshard.com, Lang=English, TZ=0 
Startup complete. items=0, chars=0 
Creating thread. </tt>

Danach befindet man sich in der Sphere Konsole und kann allgemeine Befehle absetzen ('?' gibt eine Liste aus). Lege einen Account an, aktiviert ihn, editier die login.cfg des Ultima Online Clients damit er die IP-Adresse des Servers enthält und log ein.

Damit Sphere wieder heruntergefahren wird, ist zunächst der Befehl "S", gefolgt vom Befehl "X" notwendig. Linux wird dann versuchen, Sphere zu beenden - sollte das aus irgendeinem Grund nicht funktionieren, hilft die Tastenkombination STRG-c weiter.

===Einen Liveshard aufsetzen===
Sphere in einem Terminal laufen zu lassen hat einen Nachteil: schließt man dieses Terminal, beendet Linux auch Sphere. Das ist unter Linuxsystemen beabsichtigt, weil es ein Multiusersystem ist. Das bedeutet vor allem, dass bei jedem Logout eines Nutzers auch unbedingt all seine laufenden Prozesse beendet werden sollten.

Natürlich ist es aber dennoch möglich, Prozesse im Hintergrund laufen zu lassen, selbst wenn Terminal oder Shell geschlossen werden. Hierfür bietet sich ein Skript an, das ein Tool namens 'screen' nutzt (notfalls nachinstallieren):

<tt>#!/bin/sh 
cd ~sphere 
while true; do 
screen -D -m /home/sphere/spheresvr 
sleep 30 
done </tt>

Dieses Skript kann in jedem beliebigen Editor abgespeichert werden und sollte möglichst die Dateiendung .sh erhalten. Wird das Skript ausgeführt, startet sich Sphere in einem virtuellen Terminal, das jederzeit mit "screen -r "abgerufen werden kann. Mit der Tastenkombination STRG-a gefolgt von STRG-d kann man dieses Terminal jederzeit wieder verlassen und es läuft im Hintergrund weiter. In der Dokumentation von "screen" finden sich weitere Informationen.

==Windows==
:Übersetzung läuft noch --[[User:Sco|Sco]] 07:58, 23 November 2010 (UTC)
Start by downloading Sphere. See the [[Where to get Sphere]] page for download links. You should end up with two different zip files, one containing the Sphere executable and the other containing the [[Script Pack]].

# Extract the SphereServer-0.56b-xxxxxxxxxxxx-Win32.zip file to wherever you want to run it from. I would recommend "c:\sphere"
# Extract SphereServer-0.56b-xxxxxxxxxxxx-Scripts.zip to the directory where you previously extracted the file in the previous step. Now you should have the directory scripts in "c:\sphere".
# Create three new folders, one named "accounts", another called "logs", and the third one called "save".
# Now, go to your "save" folder, recently created. And create an empty text file (I recommend using the Start Menu to access Notepad instead of "Right Click => New"). Write an empty line and add "[EOF]" in the second one. Save the file as "spheredata.SCP" (not .txt).
# Copy this file three times an rename them as: spherestatics, spherechars.scp and sphereworld.scp
# Go to the "accounts" folder that you created alongside the "save" folder, and do the same as Step 3 and 4, but name the files: "sphereacct.scp" and "sphereaccu.scp"
# Download the [http://prerelease.sphere.torfo.org/files/libMySQL.dll MySQL Library] and place it into your Sphere Folder (remember: "c:\sphere").
# Now, [[Configuring_Sphere.ini|configure your sphere.ini]]. This is a must before running Sphere for the first time!
# Double Click on SphereSvr.exe to launch the Console. This black window is your server console from which you can enter commands.
# Create an Account for yourself. In the console, type in "account add USERNAME PASSWORD". With whatever username and password you want. Then, type in "account USERNAME plevel 7" to grant your account Owner privileges.

Now you can go around your map and explore some parts of it. You can use the navigation bar on the left to read various tutorials to learn how to script and learn something about Sphere. After that, read the other articles and check the [[Main_Page#Reference Compendium|reference compendium]] if you need something special.

==FreeBSD==
We currently have no guide for this OS. Anyway, the developers have posted a list of required stuff. Here is the list:

Compiled on:

<tt>FreeBSD freebsdvbox.fastwebnet.it 7.0-RELEASE FreeBSD 7.0-RELEASE #0: Sun Feb 24 19:59:52 UTC 2008 root@logan.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC i386 </tt>

With:

<tt>Using built-in specs. 
Target: i386-portbld-freebsd7.0 
Configured with: ./..//gcc-4.1-20071105/configure --disable-nls --with-system-zlib --with-libiconv-prefix=/usr/local --program-suffix=41 --libdir=/usr/local/lib/gcc-4.1.3 --with-gxx-include-dir=/usr/local/lib/gcc-4.1.3/include/c++/ --disable-rpath --prefix=/usr/local --mandir=/usr/local/man --infodir=/usr/local/info/gcc41 i386-portbld-freebsd7.0 
Thread model: posix 
gcc version 4.1.3 20071105 (prerelease) </tt>

Linked Against:

<tt>libthr.so.3 => /lib/libthr.so.3 (0x281f3000) 
libmysqlclient.so.15 => /usr/local/lib/mysql/libmysqlclient.so.15 (0x28206000) 
libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x28265000) 
libm.so.5 => /lib/libm.so.5 (0x2835a000) 
libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x2836f000) 
libc.so.7 => /lib/libc.so.7 (0x2837a000) 
libcrypt.so.4 => /lib/libcrypt.so.4 (0x28476000) 
libz.so.4 => /lib/libz.so.4 (0x2848f000) </tt>

If you use this release, please check [http://www.sphereserver.net/index.php?showtopic=44153 this topic].

[[Category: Setting Up Sphere]]

De:Installing Sphere

2010-11-23T07:58:47Z

Sco: Created page with '==Linux== ===Vorwort=== Sphere auf einem Linuxsystem zu installieren, ist nicht viel schwieriger als auf einem Windowsrechner. Allerdings ist Basiswissen über Linux vorausgesetz...'

==Linux==
===Vorwort===
Sphere auf einem Linuxsystem zu installieren, ist nicht viel schwieriger als auf einem Windowsrechner. Allerdings ist Basiswissen über Linux vorausgesetzt und ein wenig Erfahrung mit der Kommandozeile von Nöten, da hier nicht einfach auf ein Symbol geklickt wird und Sphere läuft.

Diese Anleitung ist deshalb darauf ausgelegt, dass eine Shell oder ein Terminal zum Linuxsystem verfügbar ist und root-Rechte vorhanden sind.

Letztendlich wird diese Anleitung nicht beinhalten, welche Dateien auf dem Linux Server verfügbar sein müssen. Diese Anleitung umfasst keine Einführung in Linuxsysteme und hat auch keinen Anspruch darauf, dies zu sein. Für weiterführende Informationen über Linux gibt es viele E-Books und Howtos, die frei im Web verfügbar sind. Beispielsweise ist hier ein guter Startpunkt: [http://www.linux.org http://www.linux.org]

Wichtig ist aber vor allem folgendes: Anders als ein Windowssystem, ist Linux bezüglich Datei- und Ordnernamen die Groß- und Kleinschreibung zu beachten. Wenn eine Datei von Sphere nicht gefunden wird, liegt das möglicherweise daran, dass gewisse Dateien falsch geschrieben sind, wie bspw: "sphere.INI" anstelle von "sphere.ini".

Alle Zeilen, die in dieser Anleitung kursiv sind, sollten direkt in das Terminal eingegeben werden.

===Vorbereitungens===
Auf dem Linuxsystem wird eine Installation des MySQL Clients benötigt. Fehlen die Bibliotheken des MySQL Clients, wird Sphere nicht ausführbar sein.

Des Weiteren wird ein Sphere Version FÜR LINUX benötigt, sowie das passende Skriptpaket und eventuelle zusätzliche Bibliotheken, die in der Downloadsektion angegeben sind.

===Schritt für Schritt Installation===
'''1)''' Mit Rootrechten einen neuen Nutzer namens "sphere" anlegen. Dieser Nutzer benötigt ein eigenen Heimverzeichnis (meistens: /home/sphere) mit den entsprechenden Rechten.

<tt>useradd -d /home/sphere sphere 
mkdir /home/sphere 
chown sphere /home/sphere 
chmod 700 /home/sphere </tt>

'''2)''' Kopiere alle Dateien des Sphere LINUX downloads, das Skriptpaket und eventuell nötige Bibliotheken in das neu angelegte Verzeichnis. Zudem müssen Unterordner angelegt werden: "save", "logs" und "accounts", wie angegeben in der sphere.ini und in spheretables.scp. Am Ende sollte eine ähnliche Ordnerstruktur vorliegen:

<tt>/home/sphere --- spheresvr 
              |  sphere.ini 
              |  sphereCrypt.ini 
          |-------------------- accounts/ 
          |-------------------- logs/ 
          |-------------------- muls/ 
          |-------------------- save/ 
          |-------------------- scripts/ </tt>

'''3)''' Nachdem alle Dateien an die richtige Stelle kopiert wurden, benötigen sie die richtigen Dateirechte. Deshalb weiterhin unter Rootrechten folgende Befehle ausführen:

<tt>cd ~sphere 
chown -R sphere * 
find . -type d | xargs chmod 0700 
find . -type f | xargs chmod 0600 
chmod 4700 spheresvr </tt>

'''4)''' Immer noch unter Rootrechten:

<tt>ldd spheresvr </tt>

Die Ausgabe sollte nun ungefähr so lauten:

<tt>longbow:/home/sphere# ldd spheresvr 
libpthread.so.0 => /lib/libpthread.so.0 (0x4001f000) 
libmysqlclient.so.15 => /usr/lib/libmysqlclient.so.15 (0x40071000) 
libboost_regex-gcc-1_33_1.so => /usr/lib/libboost_regex-gcc-1_33_1.so (0x40243000) 
libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x402ea000) 
libm.so.6 => /lib/libm.so.6 (0x403c9000) 
libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x403ef000) 
libc.so.6 => /lib/libc.so.6 (0x403fa000) 
/lib/ld-linux.so.2 (0x40000000) 
libcrypt.so.1 => /lib/libcrypt.so.1 (0x4051c000) 
libnsl.so.1 => /lib/libnsl.so.1 (0x4054a000) 
libz.so.1 => /usr/lib/libz.so.1 (0x40561000) </tt>

NACH FEHLENDEN BIBLIOTHEKEN AUSSCHAU HALTEN! Notfalls müssen diese nachinstalliert werden.

===Die Installation testen===
Es ist jetzt nicht mehr von Belang, ob der erste Test mit Rootrechten oder unter dem Benutzer sphere ausgeführt wird. Werden die Rechte der Datei auf 4700 gesetzt, wird Sphere automatisch immer unter dem benutzer sphere ausgeführt. Deshalb:

<tt>cd ~sphere 
./spheresvr </tt>

Es sollte nun eine Liste des Startups folgen ... mit vielleicht enthaltenen Warnings:

<tt>longbow:/home/sphere# ./spheresvr 
WARNING:(sphere.ini,587)'scripts/spherestatusbase.html' not found... 
ERROR:(sphere.ini,587)Can't open web page input 'spherestatusbase1.htm' 
Sphere Version 0.56b [Linux] by www.sphereserver.com, compiled at Sep 15 2006 (23:23:07) 
Signal handlers installed. 
Expansion maps supported: T2A, LBR, AOS, SE, ML 
ERROR:(spheretables.scp,59)Unable to open directory scripts/custom/ 
ERROR:(spheretables.scp,59)DirList=-1 for 'scripts/custom/' 
Allocating map sectors: 0=7168 1=7168 2=900 3=1280 4=32761 
Indexing 211 scripts... 
Loading scripts/sphere_defs.scp 
[...] </tt>

Warnings und Fehler über fehlende Webseiten können ignoriert werden. Falls allerdings andere Fehler auftreten oder Sphere terminiert (=sich beendet), dann sollte in den vorhergehenden Zeilen nach dem Grund gesucht werden.

Letztendlich sollten folgende Meldungen auftauchen, falls alles gut lief:

<tt>[...] 
Loading save/spheredata... 
Loading save/spherestatics... 
Loading save/sphereworld... 
Loading save/spherechars... 
166 Objects accounted for 
Option flags: CommandSysmsgs + NoHouseMuteSpeech 
Experimental flags: DiagonalWalkCheck + ScriptsReturnStrings + NewTriggersEnable + NewPositionChecks + WalkCheck + ScriptProfiler + SizeOptimize 
Admin=me@my.email.com, URL=www.myshard.com, Lang=English, TZ=0 
Startup complete. items=0, chars=0 
Creating thread. </tt>

Danach befindet man sich in der Sphere Konsole und kann allgemeine Befehle absetzen ('?' gibt eine Liste aus). Lege einen Account an, aktiviert ihn, editier die login.cfg des Ultima Online Clients damit er die IP-Adresse des Servers enthält und log ein.

Damit Sphere wieder heruntergefahren wird, ist zunächst der Befehl "S", gefolgt vom Befehl "X" notwendig. Linux wird dann versuchen, Sphere zu beenden - sollte das aus irgendeinem Grund nicht funktionieren, hilft die Tastenkombination STRG-c weiter.

===Einen Liveshard aufsetzen===
Sphere in einem Terminal laufen zu lassen hat einen Nachteil: schließt man dieses Terminal, beendet Linux auch Sphere. Das ist unter Linuxsystemen beabsichtigt, weil es ein Multiusersystem ist. Das bedeutet vor allem auch, dass bei jedem Logout eines Nutzers auch unbedingt all seine laufenden Prozesse beendet werden sollten.

Natürlich ist es aber dennoch möglich, Prozesse im Hintergrund laufen zu lassen, selsbt wenn das Terminal oder die Shell geschlossen werden. Hierfür bietet sich ein Skript an, das ein tool namens 'screen' nutzt (notfalls nachinstallieren):

<tt>#!/bin/sh 
cd ~sphere 
while true; do 
screen -D -m /home/sphere/spheresvr 
sleep 30 
done </tt>

Dieses Skript kann in jedem beliebigen Editor abgespeichert werden und sollte möglichst die Dateiendung .sh erhalten. Wird das Skript ausgeführt, startet sich Sphere in einem virtuellen Terminal, das jederzeit mit screen -r abgerufen werden kann. Mit der Tastenkombination STRG-a gefolgt von STRG-d kann man dieses Terminal jederzeit wieder verlassen und es läuft im Hintergrund weiter. In der Dokumentation von "screen" finden sich weitere Informationen.

==Windows==
:Übersetzung läuft noch --[[User:Sco|Sco]] 07:58, 23 November 2010 (UTC)
Start by downloading Sphere. See the [[Where to get Sphere]] page for download links. You should end up with two different zip files, one containing the Sphere executable and the other containing the [[Script Pack]].

# Extract the SphereServer-0.56b-xxxxxxxxxxxx-Win32.zip file to wherever you want to run it from. I would recommend "c:\sphere"
# Extract SphereServer-0.56b-xxxxxxxxxxxx-Scripts.zip to the directory where you previously extracted the file in the previous step. Now you should have the directory scripts in "c:\sphere".
# Create three new folders, one named "accounts", another called "logs", and the third one called "save".
# Now, go to your "save" folder, recently created. And create an empty text file (I recommend using the Start Menu to access Notepad instead of "Right Click => New"). Write an empty line and add "[EOF]" in the second one. Save the file as "spheredata.SCP" (not .txt).
# Copy this file three times an rename them as: spherestatics, spherechars.scp and sphereworld.scp
# Go to the "accounts" folder that you created alongside the "save" folder, and do the same as Step 3 and 4, but name the files: "sphereacct.scp" and "sphereaccu.scp"
# Download the [http://prerelease.sphere.torfo.org/files/libMySQL.dll MySQL Library] and place it into your Sphere Folder (remember: "c:\sphere").
# Now, [[Configuring_Sphere.ini|configure your sphere.ini]]. This is a must before running Sphere for the first time!
# Double Click on SphereSvr.exe to launch the Console. This black window is your server console from which you can enter commands.
# Create an Account for yourself. In the console, type in "account add USERNAME PASSWORD". With whatever username and password you want. Then, type in "account USERNAME plevel 7" to grant your account Owner privileges.

Now you can go around your map and explore some parts of it. You can use the navigation bar on the left to read various tutorials to learn how to script and learn something about Sphere. After that, read the other articles and check the [[Main_Page#Reference Compendium|reference compendium]] if you need something special.

==FreeBSD==
We currently have no guide for this OS. Anyway, the developers have posted a list of required stuff. Here is the list:

Compiled on:

<tt>FreeBSD freebsdvbox.fastwebnet.it 7.0-RELEASE FreeBSD 7.0-RELEASE #0: Sun Feb 24 19:59:52 UTC 2008 root@logan.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC i386 </tt>

With:

<tt>Using built-in specs. 
Target: i386-portbld-freebsd7.0 
Configured with: ./..//gcc-4.1-20071105/configure --disable-nls --with-system-zlib --with-libiconv-prefix=/usr/local --program-suffix=41 --libdir=/usr/local/lib/gcc-4.1.3 --with-gxx-include-dir=/usr/local/lib/gcc-4.1.3/include/c++/ --disable-rpath --prefix=/usr/local --mandir=/usr/local/man --infodir=/usr/local/info/gcc41 i386-portbld-freebsd7.0 
Thread model: posix 
gcc version 4.1.3 20071105 (prerelease) </tt>

Linked Against:

<tt>libthr.so.3 => /lib/libthr.so.3 (0x281f3000) 
libmysqlclient.so.15 => /usr/local/lib/mysql/libmysqlclient.so.15 (0x28206000) 
libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x28265000) 
libm.so.5 => /lib/libm.so.5 (0x2835a000) 
libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x2836f000) 
libc.so.7 => /lib/libc.so.7 (0x2837a000) 
libcrypt.so.4 => /lib/libcrypt.so.4 (0x28476000) 
libz.so.4 => /lib/libz.so.4 (0x2848f000) </tt>

If you use this release, please check [http://www.sphereserver.net/index.php?showtopic=44153 this topic].

[[Category: Setting Up Sphere]]

De:Where to get Sphere

2010-11-22T12:33:33Z

Sco: /* Was will ich eigentlich? */

De:Where to get Sphere

2010-11-22T12:28:40Z

Sco: Created page with 'Für Sphere 56b gibt es hauptsächlich 2 Möglichkeiten: Pre-Releases und automatische Builds. Unten ist eine Gegenüberstellung, die Unterschiede beinhaltet. ==Prerelease Build...'

Für Sphere 56b gibt es hauptsächlich 2 Möglichkeiten: Pre-Releases und automatische Builds. Unten ist eine Gegenüberstellung, die Unterschiede beinhaltet.

==Prerelease Builds==
Prerelease Builds werden regelmäßig veröffentlicht, wenn die Entwickler der Meinung sind, dass eine neue Version fällig ist und sie mit der Stabilität zufrieden sind (d.h. u.a. dass ein Prerelease Build auch läuft). Weil es noch keinen finalen Build gibt, sind die Prerelease Builds am nächsten an einer stabilen Version dran.

Prerelease Builds können hier heruntergeladen werden: [http://prerelease.sphereserver.net SphereServer Pre-releases].

Falls du nicht sicher bist, was genau hinter einem Prerelease Build steckt, dann gibt es hier noch weitere Informationen: [[#Was will ich eigentlich?|Was will ich eigentlich?]]

==Automatisierte Builds==
Jede Nacht wird automatisiert aus dem bestehenden Code eine neue Version von Sphere erstellt. Das passiert direkt und dieser Build enthält die letzten Änderungen, die von den Entwicklern vorgenommen wurden. Wenn es also die das topaktuellste sein soll, dann nutzt man einen automatisierten Build.

Automatisierte Builds sind hier zum Download verfügbar: [http://nightly.prerelease.sphere.torfo.org/ SphereServer Nightly Automated Builds]

Einige Warnungen, ehe ein solcher automatisierter Build genutzt wird:
* Da diese Builds direkt mit den neuesten und aktuellsten Änderungen am Quellcode erstellt wurden, ist es nicht ratsam, diese Version für einen laufenden Server zu nutzen, ausser man hat zuvor gut und gründlich getestet.
* Das Entwicklerteam kann keine oder wenige Hilfestellungen leisten, falls Probleme auftreten.

==Was will ich eigentlich?==
Falls noch Unsicherheiten bestehen, welche Version gewählt werden soll, dann sollte man auf einen Prerelease Build zurückgreifen. Automatisierte Builds sind vor allem für fortgeschrittenere Nutzer und Tester gedacht, die neue Features austesten wollen, bevor sie offiziell veröffentlicht werden.

Hier eine knappe Gegenüberstellung, was die Builds hauptsächlich unterscheidet:

{| border="1" cellpadding="4"
| '''[[#Prerelease Builds|Prerelease Builds]]''' || '''[[#Automatisierte Builds|Automatisierte Builds]]'''
|-
| Forensupport || Kein Support in den Foren
|-
| Höhere Stabilität || Keine Garantien für Stabilität
|-
| Von Hand kompiliert aus einem stabilen Zweig des Quellcodes || Automatisch kompiliert aus dem Quellcode der Entwickler
|-
| Enthält nicht die neuesten Features und Fehlerkorrekturen || Enthält das neueste an Features und Fehlerkorrekturen
|-
| Wird alle paar Monate veröffentlicht || Wird täglich veröffentlicht
|}

To summarise, the prerelease builds are supported and specifically released by the Sphere development team at appropriate times when it is felt that enough development work has been made for a new release to be worthwhile. Unless you urgently need an as-of-yet unreleased feature or bugfix there should be no reason for you, as an end-user, to want to download an automated build.

'''''Note:''''' ''If your only reason for choosing to use an automated Sphere build is that you don't want to wait for an official prerelease containing a new feature or bugfix then you should reconsider this decision. Whilst you may enjoy having the feature or bugfix in question, there is also an increased chance that some of the work has not been completed, or a new bug may have been introduced, which could consequently destabalise your server!''

[[Category: Setting Up Sphere]]

De:Contribution Guide

2010-11-22T12:01:29Z

Sco: Created page with 'Da dieses Wiki durch die Community und nicht durch die Entwickler gepflegt wird, ist jede Hilfe willkommen. Es wird lediglich ein Account benötigt und sch...'

Da dieses Wiki durch die Community und nicht durch die Entwickler gepflegt wird, ist jede Hilfe willkommen.

Es wird lediglich ein [[Special:UserLogin|Account]] benötigt und schon kann man loslegen. Oberhalb jedes Artikels ist ein "Edit"-Link, mit dem sich jeder Artikel sofort bearbeiten lässt, sofern man eingeloggt ist.

Zentrale Punkte in der Pflege der Artikel:
* Fehlerkorrektur in existierenden Seiten
* Artikel über UO oder Sphere verfassen
* Updates für das [[Main Page/de#Referenzkompendium|Referenzkompendium]], denn mit jeder neuen Version von Sphere können neue Features auftauchen.

Egal welche Art von Pflege hier betrieben wird, es sollten dabei folgende Gebote beachtet werden:
* Sicherstellen, dass die Information fehlerfrei, präzise und aktuell ist.
* So klar wie möglich Sachverhalte darlegen und dabei auf den übliche Internetslang verzichten.
* Andere werden es nicht gern sehen, wenn man ihre Artikel grundlegend verändert. Wenn grundlegende Änderungen durchgeführt werden sollen, sollte man in Betracht ziehen, die ursprünglichen Autoren zu kontaktieren.

Wenn du etwas beitragen möchtest, aber nicht weisst, was zu tun wäre:
* Überprüfe [[Special:WantedPages|wanted pages]]. Diese Liste enthält Seiten, die von anderen Artikeln zwar verlinkt wurden, aber die noch keinerlei Inhalt haben.
* Überprüfe [[Special:WantedCategories|wanted categories]]. Hier sind Kategorisierungen, die von anderen verlinkt wurden, aber noch keinen Inhalt enthalten.

Falls du beim Bearbeiten von Artikeln keinerlei Erfahrung hast und die Syntax des Wikis nicht kennst: [[Help:Editing|Editing help]] (deutsche Version wird noch folgen). Diese Hilfe enthält auch eine spezielle Syntax für Sphere Skripte.

[[Category: Navigation]]

De:Main Page

2010-11-22T11:43:39Z

Sco: Created page with 'Willkommen zum Remake von Taran's bekannter Seite: "[http://www.cs.rit.edu/~djr7581/ Sphere Scripting for Dummies tutorials]". Seine Tutorials waren damals für Sphere 55i erstel...'

Willkommen zum Remake von Taran's bekannter Seite: "[http://www.cs.rit.edu/~djr7581/ Sphere Scripting for Dummies tutorials]". Seine Tutorials waren damals für Sphere 55i erstellt worden, mittlerweile ist die aktuelle Version Sphere 56b und deshalb wurde entschieden, hier auf diesen Seiten eine Sammlung aktueller Tutorials und ein Kompendium neuer Funktionen zu bieten.

'''Wo fang ich nun an?'''

Jeder, der sich für die Skriptsprache von Sphere 56b interessiert, sollte hier anfangen: [[#Installation von Sphere|Installation von Sphere]]. Dort findet man die ersten Schritte mit Sphere. Danach empfiehlt es sich alle [[#Tutorials|Tutorials]] durch zu arbeiten, möglichst alles dabei zu verstehen und viel zu lernen.

'''Ich hab jetzt Skripten gelernt! Was nun?'''

Sind die ersten 10 Kapitels durchgearbeitet, dann gibt es hier natürlich noch weitere Artikel und Seiten. Sie erscheinen vielleicht nicht so wichtig, wie die anderen, aber sind dennöch mit weiterführenden und nützlichen Informationen gespickt. Versuche eigene Skripte zu entwickeln, sie vielleicht auch im [http://www.sphereserver.net/index.php SphereServer Forums] zu veröffentlichen. In den Forum erhält man auch weitere Hilfestellungen und Antworten auf Fragen. Des Weiteren ist auch das [[#Referenzkompendium|Referenzkompendium]] sehr nützlich.

'''Ich will mithelfen!'''

Um die Informationen auf diesen Seiten immer möglichst aktuell zu halten, ist natürlich viel Arbeit und Zeit notwendig. Jeder, der mithelfen möchte, diese Seiten zu pflegen, darf sich jederzeit hier anmelden und die Artikel hier überarbeiten. Alles, was man dafür braucht, ist ein [[Special:UserLogin|Wiki-Account]]. Oberhalb jeder Seite ist ein "Edit"-Link. Ausserdem sollte dieser Guide gelesen werden: [[Contribution Guide/de|Leitfaden für das SphereWiki]].

'''Dank geht speziell an:'''

[[WhoIsWho|Ben, Cloud_Br, Ellessar, Jdog, Lord Zerofiz, Mordaunt, Nazghul-ll, RanXerox, Rattlehead, Sandman, Sharlenwar, ShiryuX, thelegbra, Maximus and WarAngel]], für das Hinzufügen von Inhalt.

[[WhoIsWho|Daleth]], für das Erstellen des Sphere Reference Project, and [[WhoIsWho|Mordaunt]] für die Konvertierung ins .chm-Format.

[[WhoIsWho|Tracker]], für das Übertragen von Änderungen in Sphere 56 Tracking Changes.

[[WhoIsWho|Taran]], für die originalen Sphere Scripting for Dummies tutorials und [[WhoIsWho|MrSugarCube]], der ständige Neuerungen aktuell hält.

[[WhoIsWho|Furio, Radiant, Vjaka, Nazghul-ll, Ellessar, Torfo, Shadow Dragon and MrSugarCube]] für kontinuierliche Arbeit an Sphere, wodurch ein sehr mächtiger und an alle möglichen Bedürfnisse anpassbarer Ultima Online Emulator entstand.

[[WhoIsWho|Crius]], der das ursprüngliche Wiki gehostet hat, und [[WhoIsWho|Torfo]], der das Wiki momentan hostet.

----

==Installation von Sphere==

* [[Where to get Sphere/de|Sphere herunterladen]]
* [[Installing Sphere/de|Sphere installieren]]
* [[Configuring Sphere.ini/de|Konfigurationseinstellungen der Sphere.ini]]

==Tutorials==

Die Kapitel von Taran in aktualisierter Version für 56b:

* [[Chapter 1/de|Kapitel 1]] ''(Nummern, DEFNAME, ITEMDEF, CHARDEF)''
* [[Chapter 2/de|Kapitel 2]] ''(Übersicht über die Standardskripte)''
* [[Chapter 3/de|Kapitel 3]] ''(NPC's und Gegenstände, coole Funktionen)''
* [[Chapter 4/de|Kapitel 4]] ''(Objekte, Operatoren, Sprache)''
* [[Chapter 5/de|Kapitel 5]] ''(Tags, Vars, Locals, Functions)''
* [[Chapter 6/de|Kapitel 6]] ''(LINKs, TIMERs, TARGETs)''
* [[Chapter 7/de|Kapitel 7]] ''(Schleifen und mächtige Funktionen)''
* [[Chapter 8/de|Kapitel 8]] ''(SKILLMENUs, MENUs, Gumps)''
* [[Chapter 9/de|Kapitel 9]] ''(Events)''
* [[Chapter 10/de|Kapitel 10]] ''(Strings/Zeichenketten behandeln)''

Zusätlich gibt es noch einige etwas fortgeschrittenere Tutorials, die von anderen Mitgliedern der Community bereitgestellt wurden. Nachdem man die 10 Kapitel durchgearbeitet hat, bieten sich die folgenden an, wenn man noch mehr lernen möchte:

* [[Common Mistakes|Häufige Fehler]] ''(A revision of Maximus's tutorial on the forums, and continuation of Taran's Misconceptions tutorial)''
* [[Internet and Sphere]] ''(And how to make the right use of them)''
* [[Languages Tutorial]] ''(How to script your own language system)''
* [[Making your own Skills]] ''(How to make and customize your skill)''
* [[Mul Patching Tutorial|Nazghul's Mul Patching Tutorial]] [http://sorea.profitux.cz/patching/ external link] ''(A document about mul patching and customizing your server)''
* [[Overriding Hardcoded Commands]] ''(How to override hardcoded commands and functions)''
* [[Scheduled Reboot]] ''(How to schedule system reboots)''
* [[Using MySQL]] ''(How to use MySQL)''

==Referenzkompendium==

* [[:Category:Definitions|Definitions]]
** [[CHARDEF|Characters]]
** [[DIALOG|Dialogs]]
** [[EVENTS|Events]]
** [[ITEMDEF|Items]]
** [[MENU|Menus]]
** [[REGIONRESOURCE|Region Resources]]
** [[REGIONTYPE|Region Types]]
** [[AREADEF|Regions]]
** [[ROOMDEF|Rooms]]
** [[SKILLCLASS|Skill Classes]]
** [[SKILLMENU|Skill Menus]]
** [[SKILL|Skills]]
** [[SPAWN|Spawn Groups]]
** [[SPELL|Spells]]
** [[TYPEDEF|Types]]
* [[:Category:Objects|Objects]]
** [[Accounts]]
** [[Characters]]
** [[Database]]
** [[Files]]
** [[GM Pages]]
** [[Items]]
*** [[Special Items]]
** [[Map Points]]
** [[Parties]]
** [[Regions]]
** [[Rooms]]
** [[Sectors]]
** [[Server]]
* [[:Category:Scripts|Scripts]]
** [[:Category:Functions|Functions and Triggers]]
** [[:Category:Variables|General Functions, Properties and References]]
** [[Intrinsic Functions]]
** [[:Category:Statements|Statements]]

==Andere Artikel==

* [[Armor Calculation]]
* [[Client Changes]]
* [[Common Scripting Misconceptions]]
* [[Custom Object Properties]]
* [[Error Codes]]
* [[Experience System]]
* [[How Combat Works]]
* [[Occam's Razor]]
* [[Optimization|Optimization Theory]]
* [[Override TAGs]]
* [[Revisions Changelog]]
* [[Sendpacket]]
* [[Skill Gain Theory]]
* [[The Process of Scripting]]

==External Links==

* [http://www.sphereserver.net/ Offizielle SphereServer Webseite]
* [http://prerelease.sphere.torfo.org/ Offizielle Sphere 56b Downloads]
* [http://nightly.prerelease.sphere.torfo.org/ Offizielle Sphere 56b Nightly Builds]
* [http://scriptsharing.dv-team.de/ ScriptSharing]
* [http://www.cs.rit.edu/~djr7581/ Taran's Scripting for Dummies (Sphere 55i)]
* [http://uo.torfo.org/packetguide/ Jerrith's UO Packet Guide]
* [http://uo.torfo.org/packetguideKR/ Wyatt&Kons's UOKR Packet Guide]

[[Category: Navigation]]