SphereWiki - User contributions [en]

De:Chapter 2

2014-03-26T20:13:20Z

Matex:

{{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

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

Skripte mit Itemdefinitionen sollten vor Skripten mit Templatedefinitionen geladen werden und danach dann die 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ärend: [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.

<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 [[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 seconds for food degeneration 
// 60*60*24 = 1 day of real life time 
Regen3=60*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'''

[[De:Chapter 3|Kapitel 3]]

[[Category:Tutorials]]

De:Configuring Sphere.ini

2014-03-26T20:12:58Z

Matex:

{{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 seconds for food degeneration
// 60*60*24 = 1 day of real life time
Regen3=60*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/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]]

Chapter 2

2014-03-26T20:12:38Z

Matex:

{{Languages|Chapter_2}}

==spheretables.scp==

Spheretables.scp is the very first file read by SPHERE after SPHERE.ini, and therefore it is the most important. Almost all of the secondary settings are contained within this file, wich makes this very important. Now, let's talk about this very important file in topics:

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

The first thing you'll see when you open this file is a list of resources. This is marked by (SURPRISE!) a [RESOURCE] tag. It looks something like this:

<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>

This tells sphere what files to load and in what order to do so. You must change it carefully sometimes, put scripts with a lot of DEFNAMES, REGIONS, and other global used settings first, to avoid errors when sphere starts (although those errors won't harm your server). For example, we looked at a gold script in Chapter 1 that had a line like this:

TYPE=t_gold

Now, unless SPHERE loads sphere_defs.scp before the script containing the gold, it will have no idea what t_gold means, and will give you an error. This is because t_gold is defined within sphere_defs.scp.

Item files should be loaded before template files, and finally character files. Other files may come after this, but these particular files must load in that order. The loot on monsters is comprised of items and templates, and unless SPHERE has already loaded the file containing these items and templates, you will get hundreds of fun errors to track down and correct. Actually, it isn't very hard to correct, but it's irritating to start up the program and have a thousand errors scroll up your screen.

'''Note''': ''You can make sphere load a full folder instead of putting each file, that's why we have this scripts/ as the last file on the [RESOURCES] tag, so sphere loads all other scripts that might have been out of the list.''

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

The next section is self-explanatory, [OBSCENE]. This defines "illegal names". If a player creates a character with a name on this list, it will tell him that the name is unavailable and to pick another. If you are a punk who enjoys cussing at others, this list might be a good place to expand your knowledge of obscenities.

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

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] ==

These sections define the commands available to the various account plevels. Any command not listed is automatically assumed to be in the plevel 4 category. This includes self-defined functions (see [[Chapter 6]]). As you can see, there is quite an extensive list of functions and commands.

'''Note''': ''You don't have to put every function you make in this section as you can have various sections in different scripts, although I recommend that you put them here just for organization purposes.''

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

This is the list of those words you say when casting a spell (An, Lor, In, etc). You can play with them, but it'll become very confusing. =P

==Sphere.ini==

Sphere.ini contains all of the internal options for the Sphere emulator. In order to configure your shard, this is the file you will start with. In order to explain this better, I'm just going to add more explanatory comments throughout the file. My comments and additions/changes will be in '''bold text'''.

<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 Eastern Time (US & Canada). Change this to fit your timezone''' 
 
// Official staff language 
Lang=English 
// Start this as a system service on Win2000, XP, NT 
NTService=0 '''Enabling this removes the ability to use the console.''' 
 
// MySql configuration. 
//MYSQL=0 '''Set this to =1 to enable MySQL''' 
//MySqlHost='''localhost This will almost always be localhost if the MYSQL host is located on the same computer as your 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 is a safer encryption method for saving passwords. More information on it [http://en.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 '''Default client uses encryption''' 
UseCrypt=1 
 
// Set this to 1 to allow login to unencrypted clients '''You can use tools such as [http://stud4.tuwien.ac.at/~e9425109/UO_RICE.htm UO Rice] and [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 means that all commands will be logged''' 
 
// 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=automatic detect, 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 '''Formula is now DELAY = 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 '''If set to 0, vendors also take gold from the bank''' 
 
// Disable weather effects? 
NoWeather=1 
 
// Default light level in dungeons 
DungeonLight=27 '''0 is brightest, 30 is darkest''' 
 
// Day light level 0-30 '''0 is brightest, 30 is darkest''' 
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 '''If both of these are enabled, it means the player has to keep turning to face his opponent in order to strike''' 
 
/////////////////////////////////////////////////////////////// 
//////// 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 '''or [TAME], if the creature is tamed''' 
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 is 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 is 30.0 skill''' 
 
// Max skill player's will start with on skills they haven't chosen during char create 
MaxBaseSkill=200 '''Set this to 0 for players to start with no skills other than the selected ones''' 
 
// 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 seconds for food degeneration 
// 60*60*24 = 1 day of real life time 
Regen3=60*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) '''This makes npcs look for food (specified on their FOODTYPE sections) and grass to eat''' 
// 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 '''Enables new Unicode fixes''' 
// EF_Scripts_Ret_Strings = 00000004 
// EF_New_Triggers = 00000008 
// EF_Scripts_Parse_Verbs = 00000010 
// EF_Intrinsic_Locals = 00000020 //'''Allows locals to be referenced differently. For example: <local.X> can be referenced as just <X>''' 
// EF_Item_Strict_Comparison = 00000040 //'''Disables similars items being compared instead of specific items, such as cloth, leather, hides, log, boards, arrow, bolt being compared when the server tries to find an arrow.''' 
// EF_WalkCheck = 00000100 '''//Fixes a lot of house looting bugs, and other walkchecking related problems.''' 
// 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 //'''Does magic ignore a players armor statistics?''' 
// OF_Magic_CanHarmSelf = 00000002 //'''Can a player harm himself with magic? (using Magic Arrow to unparalyze oneself, for example)''' 
// OF_Magic_StackStats = 00000004 
// OF_Archery_CanMove = 00000010 //'''Can a player move and shoot at the same time?''' 
// OF_Magic_PreCast = 00000020 //'''Allow pre-casting of spells, or freeze a player in place while they cast?''' 
// OF_Items_AutoName = 00000040 
// OF_FileCommands = 00000080 //'''This enables all file commands, such as writefile, etc.''' 
// OF_NoItemNaming = 00000100 //'''If enabled, prevents Sphere from naming crafted items such as "sword craft by Player''' 
// OF_NoHouseMuteSpeech = 00000200 //'''Can players inside a house hear players outside, and vice-versa?''' 
// OF_Multithreaded = 00000400 //'''Do not set while server is running !!! (Make *Nix server unstable) Puts account handling in a second thread''' 
// 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''' It isn't present in sphere.ini, but it can be used (just check REVISIONS.txt). You use it like that:

MAPx=max_x,max_y,sector_size,real_map_number.

For example: MAP1=7168,4096,512,-1

will change map 1 size to 7168,4096, the sector sizes of map 1 to 512 tiles and the -1 means it'll call the default mul file for that map.

Another example:

MAP50=7168,4096,64,3

Will activate a map number 50 that has 7168,4096 as size, 64 as sector size and loads map3.mul, statics3.mul and staidx3.mul as it's map file.

==sphere_region.scp==

This script deals with the caracteristics of the places, like what you can mine or lumber, what happens when you enter that place and that kind of things. It also contains most of the resources sections.
Let's start by explaining those:

<tt>[REGIONRESOURCE x]</tt>

This section contains the the skill needed to gather that resource, what resource it gives to the player and the time for it to regen.
Let's take a look at this example (you'll see a commented text "//t_tree" if you have read the previous chapter you'll surelly know what this is, it's a defname)

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

Basically this section defines a resource, something that you can gather from the landscape. It compares skill and amount. This particular one says that you may gather a maximum of 9 logs at 1.0 skill and a maximum of 30 logs at 80.0 skill. Anything after that simply increases your chances of getting 30 logs. See that SKILL line? The syntax is SKILL=lower,high. And the AMOUNT line sets the AMOUNT=min,max.
How does it know what to give you? This line: REAP=i_log. This tells the server to create an i_log item if this resource is taken. So you can put anything you want to be gatherable in this REAP setting.
The next line, REGEN, defines how long this resource will take to reappear, in seconds. As we can see here, it's 60*60*10 seconds, or 10 hours. As a GM, if you walk around where players have been chopping wood or mining, you'll see little worldgem bits all over the ground. They look like spawnpoints, but are really resource markers. They mark where a specific resource has been gathered, how much has been gathered, and what type of resource it is. They also have a TIMER which counts down from this very high number (36000) and then decay when it reaches zero.

<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, you must be saying. What are all these things? mr_iron? mr_agapite? I don't see those anywhere in the file. Now, I bet you'll go to sphere_defs.scp to see if they are DEFNAMEs for something else. And the truth is, they are, but the definitions can be found in sphereitem_ore.scp.

<tt>RESOURCES=50.0 mr_iron</tt>

This should look slightly familiar. Would it look even more familiar if the whole thing looked like this?

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

I bet it would, if you were paying attention during the earlier lessons in Chapter 1. This is a weighted list of resources, in a slightly different format than you're used to. But it works exactly the same way. It's also one of the ONLY places in SPHERE scripting that you can use fractional numbers like 0.1 or 0.2. Actually you can't use them here either, but SPHERE successfully hides this as long as you use them in ALL of the RESOURCES. (By the way, do not try to script a RESOURCES identifier as a random selector. SPHERE wont like that. Use the format provided to you.)

[REGIONTYPE r_default_rock t_rock] ''Understanding:'' That r_dafault_rock defines the defname of that REGIONTYPE, which is how you'll access it in other scripts (wait for next section =P). The t_rock is the defname (see sphere_defs.scp for it) of the type of a rock, which shows sphere where your players can gather that resource (you could change it to t_water so they could mine ores on water, which isn't a good idea actually :P)

Hopefully that clears up the sphere_region.scp file for you. We'll tell you in the next section how to use these REGIONTYPE settings to make resources actually available in game.

==sphere_mapX.scp==

Welcome to one of the easiest files in all of SPHERE. This is the spheremap.scp file. It's also the only file that's almost completely done for you. It is a very rare occasion that you need to change this file.

Actually, on that note, I might as well say it from the start. If you change this file, you must restart your server for the changes to take effect. If you do a resync, you'll get over 1000 "Conflicting region" errors.

This section will tell you how to make new regions, like that you go with the .go command.

There are currently 5 files in the default scripts pack, one for each map (Fellucca, Trammel, Ilshenar, Malas and Tokuno) being each one enumerated from 0 to 4 (sphere_map0,sphere_map1,and so on).

I'll use the region of Fellucca as an example for this part of the tutorial, and now here's the script:

<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>

Let's understand those lines now:

'''[AREADEF somedef]''': As you have probably noticed a_world is a defname which defines the region for the server so it can be processed.

'''Name''': This line contains the name of the region, which is shown when you do .where inside the region and it also makes you go to that place when doing .go "region name" (do not make 2 regions with the same name, the last that has been loaded will replace the first when you do .go command (which can fuck up a lot of things)).

'''Events''': This defines what will happen in that region and what resources are gatherable here (remember the REGIONTYPE section? It can be used as an event here.). Besides the resources gatherable it'll also show sphere what triggers to call from the events (you've probably realized now that the REGIONTYPE section is an event for regions :P), like the @Enter trigger and the others (see [[Triggers]]).

'''Group''': This is just an axis setting, this separates the regions in groups (duh) when you go to the Travel Menu.

'''P''': This is the place you go when you do .go "region name". Almost all regions will have a P value and it's usually a convenient location in the region to teleport to, or else it's the center of the region. If you are making your own new region, be sure to pick a place you'd like to teleport to.

'''RainChance''': This defines the chance to rain on that region when a weather is called (RainChance=50 means 50% chance of raining), the others 50% means it'll snow.

'''Rect''': This describes the exact boundaries of this region, by coordinates. The first two numbers are the coordinate of the upper left corner of the region, and the second two are the coordinates of the lower right. In the case of Fellucca it stretches from 0,0 to 6144,4096 (RECT=0,0,6144,4096). Since 56B you also need to add a fith argument, the map this region uses so it's RECT=0,0,6144,4096,0 (if the map is 0 you can leave it empty, otherwise you MUST NOT leave it empty or you'll have conflicting regions.

'''Flags''': The region flags allow you to control what goes on in a particular region. They describe whether or not a region is to be guarded, what types of magic are allowed to be cast there, who can be harmed here, or whether or not it is allowed to rain there. Basically anything you could ever want. Here's how you use them:

Just add this line to a region script:

FLAGS=#

Of course you're going to want to replace that # with an actual number! Where do we get those numbers? They're predefined in the game, but they give us a nice handy list. I just showed it to you.

Say we want to make a region that is guarded and safe from harm. We would simply add the two numbers together:

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

There you go. Your FLAGS would be set to 06000. "But.. but.." you're saying. "Didn't you tell me that DEFNAMEs were supposed to prevent me from working with scary numbers?" (See [[Chapter 1]].) Of course I did! And there's a way to do this without using any scary number at all. Here it is:

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

That's it. Now your region is both safe and guarded.

Which, as you may learn quickly as a new admin, is a big mistake. Making a region safe and guarded at the same time prevents the guards from actually killing anything, so they pile up and call each other, and soon you have a huge laggy mess of guards hacking at something that can't be killed (because it's a safe region). Just take my word for it and don't make a region safe and guarded.

Here's a quick list for the region flags (you should check you sphere_defs.scp for more, cause they may be changed):

<tt>[DEFNAME region_flags] 
region_antimagic_all 00001 // all magic banned here. 
region_antimagic_recall_in 00002 // teleport,recall in to this, and mark 
region_antimagic_recall_out 00004 // can't recall out of here. 
region_antimagic_gate 00008 // can't open gates from or to this place. 
region_antimagic_teleport 00010 // can't teleport into here. 
region_antimagic_damage 00020 // just no bad magic here 
region_flag_ship 00040 // this is a ship region. ship commands 
region_flag_nobuilding 00080 // no building in this area 
region_flag_globalname 00100 // make sure the name is avail globally. 
region_flag_announce 00200 // announce to all who enter. 
region_flag_insta_logout 00400 // instant log out is allowed here. (hotel) 
region_flag_underground 00800 // dungeon type area. (no weather) 
region_flag_nodecay 01000 // things on the ground don't decay here. 
region_flag_safe 02000 // this region is safe from all harm. 
region_flag_guarded 04000 // try tag.guardowner 
region_flag_no_pvp 08000 // players cannot directly harm each other here. </tt>

And that's about it for the sphere_mapX.scp files.

==sphere_book.scp==
Spherebook.scp is one of the most pointless files you will ever encounter. How many times, when you logged onto a shard, did you actually stop to READ those tips, or to READ the updates screen that comes up every time? I know most of my players refused to. But, in any case, that is what's in this file. And books. Did I mention books? Those impossible-to-write-correctly, rarely-used items that waste RAM in-game?

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

These are the sections that define the messages that pop up when you log in. Anything written after these tags will appear in the appropriate message. You'll have to figure out exactly what spacing is best for those little info boxes. It does take some time, and there's really no way to explain it. Just do it and you'll figure it out. Remember, there is no wordwrap. Or at least there wasn't in the past.

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

You guessed it. These are the tips that pop up on startup. "War is unhealthy for children and other living things." is one of them. Very appropriate right now, I would say.

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

Creates a book with a DEFNAME of title. Putting a page number x after the DEFNAME will add your text to that particular page. Look at the example books for clues on how to do this. The major difficulty with books is that the game uses a variable-width font, so you don't know an exact number of letters you can have on one line. For example, you can fit more i's on one line than w's or M's, since those letters are bigger. You can start a paragraph by typing a TAB text (clicking yout TAB button :P)

==sphere_name.scp==

This is an easy file. It's just lists of names under sections with various DEFNAMEs. It's these names that are important, not the contents, since you will almost NEVER write your own list of names. I've been using this emulator for two years now, and I have never modified this file once.

To access this list of names, you write this in a script:

'''NAME=#NAMES_HUMANMALE'''

It will automatically replace it with a random name from the '''NAMES_HUMANMALE''' list.

To make a list of names, it'll look like that:

<tt>[NAMES A_DEFNAME_YOU_WANT] 
NUMBER_OF_NAMES 
NAMES </tt>

for example:

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

Difficult file huh? I almost didn't give it a section to itself.

==sphere_newb.scp==
There! I did it! No vain attempt at humor under the title! :)

In any case, this is another file that a lot of questions are asked about. "How do I make players start with 10000 gold?" people ask. Or, "How do I give all blacksmiths 800 ingots?" Now, I'm not saying I would like to play on a shard where you start with 10000 gold or blacksmiths start with 800 ingots. But this file would be the place to do it.

<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>

This is what a typical script looks like. It looks kinda like a template doesn't it? Well there's a good reason for that. It really is a template. It just uses the '''ITEMNEWBIE''' tag rather than the '''ITEM''' tag. Look at the section in Chapter 1 on Templates for more information on how to structure this file!

The only real item of note is that these sections MUST have specific names that the server looks for. You cannot add a new newbie section, no matter how much you'd like to. Sorry!

==sphere_skill.scp (SKILLCLASSES)==
Skill classes are what defines how much you can train at each skill/stat and you can also add triggers to it.
A SkillClass script would look like this:

<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>

Now let's understand it:

'''EVENTS''': It means everyone with this skillclass will also call the events specified in this field (to add more events just use a ",", for example: EVENTS=e_1,e_2,and so on)

'''STATSUM''': This is how much the som of your players stats can be, for example, if I have 100 str, 100 dex and 100 int, I've reached 300 stats, so I've reached STATSUM and can't have more (except for magic items and such things)

'''SKILLSUM''': The same thing as STATSUM but for skills.

'''STR/DEX/INT''': This is how much can the player have at this specific stat (except for magic items and such)

'''ALCHEMY''': The same thing as the STR, DEX and INT fields, but for skills (in this case alchemy, but of course you can change to any other)

==sphere_serv_triggers.scp==
This file hold special trigger "functions" that are fired by the server its self at certain times depending on the function, below are a list of the functions found in this file and a breif explain of what the function will do for you.

'''f_onaccount_login'''

This function is called after the client has entered the password.

:ARGS --> username of the client logging in
:ARGO --> the client logging in
:RETURN 0 --> normal action (login)
:RETURN 1 --> disconnect the client

'''f_onaccount_delete'''

This function is called before an account is being deleted.

:ARGS --> username of the account being deleted.
:RETURN 0 --> normal action (delete)
:RETURN 1 --> account not deleted

'''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'''

[[Chapter 3]]

[[Category:Tutorials]]

Chapter 2

2014-03-26T20:12:03Z

Matex:

{{Languages|Chapter_2}}

==spheretables.scp==

Spheretables.scp is the very first file read by SPHERE after SPHERE.ini, and therefore it is the most important. Almost all of the secondary settings are contained within this file, wich makes this very important. Now, let's talk about this very important file in topics:

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

The first thing you'll see when you open this file is a list of resources. This is marked by (SURPRISE!) a [RESOURCE] tag. It looks something like this:

<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>

This tells sphere what files to load and in what order to do so. You must change it carefully sometimes, put scripts with a lot of DEFNAMES, REGIONS, and other global used settings first, to avoid errors when sphere starts (although those errors won't harm your server). For example, we looked at a gold script in Chapter 1 that had a line like this:

TYPE=t_gold

Now, unless SPHERE loads sphere_defs.scp before the script containing the gold, it will have no idea what t_gold means, and will give you an error. This is because t_gold is defined within sphere_defs.scp.

Item files should be loaded before template files, and finally character files. Other files may come after this, but these particular files must load in that order. The loot on monsters is comprised of items and templates, and unless SPHERE has already loaded the file containing these items and templates, you will get hundreds of fun errors to track down and correct. Actually, it isn't very hard to correct, but it's irritating to start up the program and have a thousand errors scroll up your screen.

'''Note''': ''You can make sphere load a full folder instead of putting each file, that's why we have this scripts/ as the last file on the [RESOURCES] tag, so sphere loads all other scripts that might have been out of the list.''

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

The next section is self-explanatory, [OBSCENE]. This defines "illegal names". If a player creates a character with a name on this list, it will tell him that the name is unavailable and to pick another. If you are a punk who enjoys cussing at others, this list might be a good place to expand your knowledge of obscenities.

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

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] ==

These sections define the commands available to the various account plevels. Any command not listed is automatically assumed to be in the plevel 4 category. This includes self-defined functions (see [[Chapter 6]]). As you can see, there is quite an extensive list of functions and commands.

'''Note''': ''You don't have to put every function you make in this section as you can have various sections in different scripts, although I recommend that you put them here just for organization purposes.''

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

This is the list of those words you say when casting a spell (An, Lor, In, etc). You can play with them, but it'll become very confusing. =P

==Sphere.ini==

Sphere.ini contains all of the internal options for the Sphere emulator. In order to configure your shard, this is the file you will start with. In order to explain this better, I'm just going to add more explanatory comments throughout the file. My comments and additions/changes will be in '''bold text'''.

<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 Eastern Time (US & Canada). Change this to fit your timezone''' 
 
// Official staff language 
Lang=English 
// Start this as a system service on Win2000, XP, NT 
NTService=0 '''Enabling this removes the ability to use the console.''' 
 
// MySql configuration. 
//MYSQL=0 '''Set this to =1 to enable MySQL''' 
//MySqlHost='''localhost This will almost always be localhost if the MYSQL host is located on the same computer as your 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 is a safer encryption method for saving passwords. More information on it [http://en.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 '''Default client uses encryption''' 
UseCrypt=1 
 
// Set this to 1 to allow login to unencrypted clients '''You can use tools such as [http://stud4.tuwien.ac.at/~e9425109/UO_RICE.htm UO Rice] and [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 means that all commands will be logged''' 
 
// 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=automatic detect, 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 '''Formula is now DELAY = 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 '''If set to 0, vendors also take gold from the bank''' 
 
// Disable weather effects? 
NoWeather=1 
 
// Default light level in dungeons 
DungeonLight=27 '''0 is brightest, 30 is darkest''' 
 
// Day light level 0-30 '''0 is brightest, 30 is darkest''' 
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 '''If both of these are enabled, it means the player has to keep turning to face his opponent in order to strike''' 
 
/////////////////////////////////////////////////////////////// 
//////// 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 '''or [TAME], if the creature is tamed''' 
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 is 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 is 30.0 skill''' 
 
// Max skill player's will start with on skills they haven't chosen during char create 
MaxBaseSkill=200 '''Set this to 0 for players to start with no skills other than the selected ones''' 
 
// 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 seconds for food degerenation 
// 60*60*24 = 1 day of real life time 
Regen3=60*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) '''This makes npcs look for food (specified on their FOODTYPE sections) and grass to eat''' 
// 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 '''Enables new Unicode fixes''' 
// EF_Scripts_Ret_Strings = 00000004 
// EF_New_Triggers = 00000008 
// EF_Scripts_Parse_Verbs = 00000010 
// EF_Intrinsic_Locals = 00000020 //'''Allows locals to be referenced differently. For example: <local.X> can be referenced as just <X>''' 
// EF_Item_Strict_Comparison = 00000040 //'''Disables similars items being compared instead of specific items, such as cloth, leather, hides, log, boards, arrow, bolt being compared when the server tries to find an arrow.''' 
// EF_WalkCheck = 00000100 '''//Fixes a lot of house looting bugs, and other walkchecking related problems.''' 
// 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 //'''Does magic ignore a players armor statistics?''' 
// OF_Magic_CanHarmSelf = 00000002 //'''Can a player harm himself with magic? (using Magic Arrow to unparalyze oneself, for example)''' 
// OF_Magic_StackStats = 00000004 
// OF_Archery_CanMove = 00000010 //'''Can a player move and shoot at the same time?''' 
// OF_Magic_PreCast = 00000020 //'''Allow pre-casting of spells, or freeze a player in place while they cast?''' 
// OF_Items_AutoName = 00000040 
// OF_FileCommands = 00000080 //'''This enables all file commands, such as writefile, etc.''' 
// OF_NoItemNaming = 00000100 //'''If enabled, prevents Sphere from naming crafted items such as "sword craft by Player''' 
// OF_NoHouseMuteSpeech = 00000200 //'''Can players inside a house hear players outside, and vice-versa?''' 
// OF_Multithreaded = 00000400 //'''Do not set while server is running !!! (Make *Nix server unstable) Puts account handling in a second thread''' 
// 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''' It isn't present in sphere.ini, but it can be used (just check REVISIONS.txt). You use it like that:

MAPx=max_x,max_y,sector_size,real_map_number.

For example: MAP1=7168,4096,512,-1

will change map 1 size to 7168,4096, the sector sizes of map 1 to 512 tiles and the -1 means it'll call the default mul file for that map.

Another example:

MAP50=7168,4096,64,3

Will activate a map number 50 that has 7168,4096 as size, 64 as sector size and loads map3.mul, statics3.mul and staidx3.mul as it's map file.

==sphere_region.scp==

This script deals with the caracteristics of the places, like what you can mine or lumber, what happens when you enter that place and that kind of things. It also contains most of the resources sections.
Let's start by explaining those:

<tt>[REGIONRESOURCE x]</tt>

This section contains the the skill needed to gather that resource, what resource it gives to the player and the time for it to regen.
Let's take a look at this example (you'll see a commented text "//t_tree" if you have read the previous chapter you'll surelly know what this is, it's a defname)

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

Basically this section defines a resource, something that you can gather from the landscape. It compares skill and amount. This particular one says that you may gather a maximum of 9 logs at 1.0 skill and a maximum of 30 logs at 80.0 skill. Anything after that simply increases your chances of getting 30 logs. See that SKILL line? The syntax is SKILL=lower,high. And the AMOUNT line sets the AMOUNT=min,max.
How does it know what to give you? This line: REAP=i_log. This tells the server to create an i_log item if this resource is taken. So you can put anything you want to be gatherable in this REAP setting.
The next line, REGEN, defines how long this resource will take to reappear, in seconds. As we can see here, it's 60*60*10 seconds, or 10 hours. As a GM, if you walk around where players have been chopping wood or mining, you'll see little worldgem bits all over the ground. They look like spawnpoints, but are really resource markers. They mark where a specific resource has been gathered, how much has been gathered, and what type of resource it is. They also have a TIMER which counts down from this very high number (36000) and then decay when it reaches zero.

<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, you must be saying. What are all these things? mr_iron? mr_agapite? I don't see those anywhere in the file. Now, I bet you'll go to sphere_defs.scp to see if they are DEFNAMEs for something else. And the truth is, they are, but the definitions can be found in sphereitem_ore.scp.

<tt>RESOURCES=50.0 mr_iron</tt>

This should look slightly familiar. Would it look even more familiar if the whole thing looked like this?

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

I bet it would, if you were paying attention during the earlier lessons in Chapter 1. This is a weighted list of resources, in a slightly different format than you're used to. But it works exactly the same way. It's also one of the ONLY places in SPHERE scripting that you can use fractional numbers like 0.1 or 0.2. Actually you can't use them here either, but SPHERE successfully hides this as long as you use them in ALL of the RESOURCES. (By the way, do not try to script a RESOURCES identifier as a random selector. SPHERE wont like that. Use the format provided to you.)

[REGIONTYPE r_default_rock t_rock] ''Understanding:'' That r_dafault_rock defines the defname of that REGIONTYPE, which is how you'll access it in other scripts (wait for next section =P). The t_rock is the defname (see sphere_defs.scp for it) of the type of a rock, which shows sphere where your players can gather that resource (you could change it to t_water so they could mine ores on water, which isn't a good idea actually :P)

Hopefully that clears up the sphere_region.scp file for you. We'll tell you in the next section how to use these REGIONTYPE settings to make resources actually available in game.

==sphere_mapX.scp==

Welcome to one of the easiest files in all of SPHERE. This is the spheremap.scp file. It's also the only file that's almost completely done for you. It is a very rare occasion that you need to change this file.

Actually, on that note, I might as well say it from the start. If you change this file, you must restart your server for the changes to take effect. If you do a resync, you'll get over 1000 "Conflicting region" errors.

This section will tell you how to make new regions, like that you go with the .go command.

There are currently 5 files in the default scripts pack, one for each map (Fellucca, Trammel, Ilshenar, Malas and Tokuno) being each one enumerated from 0 to 4 (sphere_map0,sphere_map1,and so on).

I'll use the region of Fellucca as an example for this part of the tutorial, and now here's the script:

<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>

Let's understand those lines now:

'''[AREADEF somedef]''': As you have probably noticed a_world is a defname which defines the region for the server so it can be processed.

'''Name''': This line contains the name of the region, which is shown when you do .where inside the region and it also makes you go to that place when doing .go "region name" (do not make 2 regions with the same name, the last that has been loaded will replace the first when you do .go command (which can fuck up a lot of things)).

'''Events''': This defines what will happen in that region and what resources are gatherable here (remember the REGIONTYPE section? It can be used as an event here.). Besides the resources gatherable it'll also show sphere what triggers to call from the events (you've probably realized now that the REGIONTYPE section is an event for regions :P), like the @Enter trigger and the others (see [[Triggers]]).

'''Group''': This is just an axis setting, this separates the regions in groups (duh) when you go to the Travel Menu.

'''P''': This is the place you go when you do .go "region name". Almost all regions will have a P value and it's usually a convenient location in the region to teleport to, or else it's the center of the region. If you are making your own new region, be sure to pick a place you'd like to teleport to.

'''RainChance''': This defines the chance to rain on that region when a weather is called (RainChance=50 means 50% chance of raining), the others 50% means it'll snow.

'''Rect''': This describes the exact boundaries of this region, by coordinates. The first two numbers are the coordinate of the upper left corner of the region, and the second two are the coordinates of the lower right. In the case of Fellucca it stretches from 0,0 to 6144,4096 (RECT=0,0,6144,4096). Since 56B you also need to add a fith argument, the map this region uses so it's RECT=0,0,6144,4096,0 (if the map is 0 you can leave it empty, otherwise you MUST NOT leave it empty or you'll have conflicting regions.

'''Flags''': The region flags allow you to control what goes on in a particular region. They describe whether or not a region is to be guarded, what types of magic are allowed to be cast there, who can be harmed here, or whether or not it is allowed to rain there. Basically anything you could ever want. Here's how you use them:

Just add this line to a region script:

FLAGS=#

Of course you're going to want to replace that # with an actual number! Where do we get those numbers? They're predefined in the game, but they give us a nice handy list. I just showed it to you.

Say we want to make a region that is guarded and safe from harm. We would simply add the two numbers together:

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

There you go. Your FLAGS would be set to 06000. "But.. but.." you're saying. "Didn't you tell me that DEFNAMEs were supposed to prevent me from working with scary numbers?" (See [[Chapter 1]].) Of course I did! And there's a way to do this without using any scary number at all. Here it is:

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

That's it. Now your region is both safe and guarded.

Which, as you may learn quickly as a new admin, is a big mistake. Making a region safe and guarded at the same time prevents the guards from actually killing anything, so they pile up and call each other, and soon you have a huge laggy mess of guards hacking at something that can't be killed (because it's a safe region). Just take my word for it and don't make a region safe and guarded.

Here's a quick list for the region flags (you should check you sphere_defs.scp for more, cause they may be changed):

<tt>[DEFNAME region_flags] 
region_antimagic_all 00001 // all magic banned here. 
region_antimagic_recall_in 00002 // teleport,recall in to this, and mark 
region_antimagic_recall_out 00004 // can't recall out of here. 
region_antimagic_gate 00008 // can't open gates from or to this place. 
region_antimagic_teleport 00010 // can't teleport into here. 
region_antimagic_damage 00020 // just no bad magic here 
region_flag_ship 00040 // this is a ship region. ship commands 
region_flag_nobuilding 00080 // no building in this area 
region_flag_globalname 00100 // make sure the name is avail globally. 
region_flag_announce 00200 // announce to all who enter. 
region_flag_insta_logout 00400 // instant log out is allowed here. (hotel) 
region_flag_underground 00800 // dungeon type area. (no weather) 
region_flag_nodecay 01000 // things on the ground don't decay here. 
region_flag_safe 02000 // this region is safe from all harm. 
region_flag_guarded 04000 // try tag.guardowner 
region_flag_no_pvp 08000 // players cannot directly harm each other here. </tt>

And that's about it for the sphere_mapX.scp files.

==sphere_book.scp==
Spherebook.scp is one of the most pointless files you will ever encounter. How many times, when you logged onto a shard, did you actually stop to READ those tips, or to READ the updates screen that comes up every time? I know most of my players refused to. But, in any case, that is what's in this file. And books. Did I mention books? Those impossible-to-write-correctly, rarely-used items that waste RAM in-game?

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

These are the sections that define the messages that pop up when you log in. Anything written after these tags will appear in the appropriate message. You'll have to figure out exactly what spacing is best for those little info boxes. It does take some time, and there's really no way to explain it. Just do it and you'll figure it out. Remember, there is no wordwrap. Or at least there wasn't in the past.

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

You guessed it. These are the tips that pop up on startup. "War is unhealthy for children and other living things." is one of them. Very appropriate right now, I would say.

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

Creates a book with a DEFNAME of title. Putting a page number x after the DEFNAME will add your text to that particular page. Look at the example books for clues on how to do this. The major difficulty with books is that the game uses a variable-width font, so you don't know an exact number of letters you can have on one line. For example, you can fit more i's on one line than w's or M's, since those letters are bigger. You can start a paragraph by typing a TAB text (clicking yout TAB button :P)

==sphere_name.scp==

This is an easy file. It's just lists of names under sections with various DEFNAMEs. It's these names that are important, not the contents, since you will almost NEVER write your own list of names. I've been using this emulator for two years now, and I have never modified this file once.

To access this list of names, you write this in a script:

'''NAME=#NAMES_HUMANMALE'''

It will automatically replace it with a random name from the '''NAMES_HUMANMALE''' list.

To make a list of names, it'll look like that:

<tt>[NAMES A_DEFNAME_YOU_WANT] 
NUMBER_OF_NAMES 
NAMES </tt>

for example:

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

Difficult file huh? I almost didn't give it a section to itself.

==sphere_newb.scp==
There! I did it! No vain attempt at humor under the title! :)

In any case, this is another file that a lot of questions are asked about. "How do I make players start with 10000 gold?" people ask. Or, "How do I give all blacksmiths 800 ingots?" Now, I'm not saying I would like to play on a shard where you start with 10000 gold or blacksmiths start with 800 ingots. But this file would be the place to do it.

<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>

This is what a typical script looks like. It looks kinda like a template doesn't it? Well there's a good reason for that. It really is a template. It just uses the '''ITEMNEWBIE''' tag rather than the '''ITEM''' tag. Look at the section in Chapter 1 on Templates for more information on how to structure this file!

The only real item of note is that these sections MUST have specific names that the server looks for. You cannot add a new newbie section, no matter how much you'd like to. Sorry!

==sphere_skill.scp (SKILLCLASSES)==
Skill classes are what defines how much you can train at each skill/stat and you can also add triggers to it.
A SkillClass script would look like this:

<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>

Now let's understand it:

'''EVENTS''': It means everyone with this skillclass will also call the events specified in this field (to add more events just use a ",", for example: EVENTS=e_1,e_2,and so on)

'''STATSUM''': This is how much the som of your players stats can be, for example, if I have 100 str, 100 dex and 100 int, I've reached 300 stats, so I've reached STATSUM and can't have more (except for magic items and such things)

'''SKILLSUM''': The same thing as STATSUM but for skills.

'''STR/DEX/INT''': This is how much can the player have at this specific stat (except for magic items and such)

'''ALCHEMY''': The same thing as the STR, DEX and INT fields, but for skills (in this case alchemy, but of course you can change to any other)

==sphere_serv_triggers.scp==
This file hold special trigger "functions" that are fired by the server its self at certain times depending on the function, below are a list of the functions found in this file and a breif explain of what the function will do for you.

'''f_onaccount_login'''

This function is called after the client has entered the password.

:ARGS --> username of the client logging in
:ARGO --> the client logging in
:RETURN 0 --> normal action (login)
:RETURN 1 --> disconnect the client

'''f_onaccount_delete'''

This function is called before an account is being deleted.

:ARGS --> username of the account being deleted.
:RETURN 0 --> normal action (delete)
:RETURN 1 --> account not deleted

'''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'''

[[Chapter 3]]

[[Category:Tutorials]]

Chapter 2

2014-03-26T20:11:50Z

Matex:

{{Languages|Chapter_2}}

==spheretables.scp==

Spheretables.scp is the very first file read by SPHERE after SPHERE.ini, and therefore it is the most important. Almost all of the secondary settings are contained within this file, wich makes this very important. Now, let's talk about this very important file in topics:

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

The first thing you'll see when you open this file is a list of resources. This is marked by (SURPRISE!) a [RESOURCE] tag. It looks something like this:

<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>

This tells sphere what files to load and in what order to do so. You must change it carefully sometimes, put scripts with a lot of DEFNAMES, REGIONS, and other global used settings first, to avoid errors when sphere starts (although those errors won't harm your server). For example, we looked at a gold script in Chapter 1 that had a line like this:

TYPE=t_gold

Now, unless SPHERE loads sphere_defs.scp before the script containing the gold, it will have no idea what t_gold means, and will give you an error. This is because t_gold is defined within sphere_defs.scp.

Item files should be loaded before template files, and finally character files. Other files may come after this, but these particular files must load in that order. The loot on monsters is comprised of items and templates, and unless SPHERE has already loaded the file containing these items and templates, you will get hundreds of fun errors to track down and correct. Actually, it isn't very hard to correct, but it's irritating to start up the program and have a thousand errors scroll up your screen.

'''Note''': ''You can make sphere load a full folder instead of putting each file, that's why we have this scripts/ as the last file on the [RESOURCES] tag, so sphere loads all other scripts that might have been out of the list.''

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

The next section is self-explanatory, [OBSCENE]. This defines "illegal names". If a player creates a character with a name on this list, it will tell him that the name is unavailable and to pick another. If you are a punk who enjoys cussing at others, this list might be a good place to expand your knowledge of obscenities.

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

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] ==

These sections define the commands available to the various account plevels. Any command not listed is automatically assumed to be in the plevel 4 category. This includes self-defined functions (see [[Chapter 6]]). As you can see, there is quite an extensive list of functions and commands.

'''Note''': ''You don't have to put every function you make in this section as you can have various sections in different scripts, although I recommend that you put them here just for organization purposes.''

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

This is the list of those words you say when casting a spell (An, Lor, In, etc). You can play with them, but it'll become very confusing. =P

==Sphere.ini==

Sphere.ini contains all of the internal options for the Sphere emulator. In order to configure your shard, this is the file you will start with. In order to explain this better, I'm just going to add more explanatory comments throughout the file. My comments and additions/changes will be in '''bold text'''.

<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 Eastern Time (US & Canada). Change this to fit your timezone''' 
 
// Official staff language 
Lang=English 
// Start this as a system service on Win2000, XP, NT 
NTService=0 '''Enabling this removes the ability to use the console.''' 
 
// MySql configuration. 
//MYSQL=0 '''Set this to =1 to enable MySQL''' 
//MySqlHost='''localhost This will almost always be localhost if the MYSQL host is located on the same computer as your 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 is a safer encryption method for saving passwords. More information on it [http://en.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 '''Default client uses encryption''' 
UseCrypt=1 
 
// Set this to 1 to allow login to unencrypted clients '''You can use tools such as [http://stud4.tuwien.ac.at/~e9425109/UO_RICE.htm UO Rice] and [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 means that all commands will be logged''' 
 
// 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=automatic detect, 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 '''Formula is now DELAY = 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 '''If set to 0, vendors also take gold from the bank''' 
 
// Disable weather effects? 
NoWeather=1 
 
// Default light level in dungeons 
DungeonLight=27 '''0 is brightest, 30 is darkest''' 
 
// Day light level 0-30 '''0 is brightest, 30 is darkest''' 
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 '''If both of these are enabled, it means the player has to keep turning to face his opponent in order to strike''' 
 
/////////////////////////////////////////////////////////////// 
//////// 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 '''or [TAME], if the creature is tamed''' 
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 is 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 is 30.0 skill''' 
 
// Max skill player's will start with on skills they haven't chosen during char create 
MaxBaseSkill=200 '''Set this to 0 for players to start with no skills other than the selected ones''' 
 
// 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 seconds for food deregeneration 
// 60*60*24 = 1 day of real life time 
Regen3=60*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) '''This makes npcs look for food (specified on their FOODTYPE sections) and grass to eat''' 
// 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 '''Enables new Unicode fixes''' 
// EF_Scripts_Ret_Strings = 00000004 
// EF_New_Triggers = 00000008 
// EF_Scripts_Parse_Verbs = 00000010 
// EF_Intrinsic_Locals = 00000020 //'''Allows locals to be referenced differently. For example: <local.X> can be referenced as just <X>''' 
// EF_Item_Strict_Comparison = 00000040 //'''Disables similars items being compared instead of specific items, such as cloth, leather, hides, log, boards, arrow, bolt being compared when the server tries to find an arrow.''' 
// EF_WalkCheck = 00000100 '''//Fixes a lot of house looting bugs, and other walkchecking related problems.''' 
// 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 //'''Does magic ignore a players armor statistics?''' 
// OF_Magic_CanHarmSelf = 00000002 //'''Can a player harm himself with magic? (using Magic Arrow to unparalyze oneself, for example)''' 
// OF_Magic_StackStats = 00000004 
// OF_Archery_CanMove = 00000010 //'''Can a player move and shoot at the same time?''' 
// OF_Magic_PreCast = 00000020 //'''Allow pre-casting of spells, or freeze a player in place while they cast?''' 
// OF_Items_AutoName = 00000040 
// OF_FileCommands = 00000080 //'''This enables all file commands, such as writefile, etc.''' 
// OF_NoItemNaming = 00000100 //'''If enabled, prevents Sphere from naming crafted items such as "sword craft by Player''' 
// OF_NoHouseMuteSpeech = 00000200 //'''Can players inside a house hear players outside, and vice-versa?''' 
// OF_Multithreaded = 00000400 //'''Do not set while server is running !!! (Make *Nix server unstable) Puts account handling in a second thread''' 
// 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''' It isn't present in sphere.ini, but it can be used (just check REVISIONS.txt). You use it like that:

MAPx=max_x,max_y,sector_size,real_map_number.

For example: MAP1=7168,4096,512,-1

will change map 1 size to 7168,4096, the sector sizes of map 1 to 512 tiles and the -1 means it'll call the default mul file for that map.

Another example:

MAP50=7168,4096,64,3

Will activate a map number 50 that has 7168,4096 as size, 64 as sector size and loads map3.mul, statics3.mul and staidx3.mul as it's map file.

==sphere_region.scp==

This script deals with the caracteristics of the places, like what you can mine or lumber, what happens when you enter that place and that kind of things. It also contains most of the resources sections.
Let's start by explaining those:

<tt>[REGIONRESOURCE x]</tt>

This section contains the the skill needed to gather that resource, what resource it gives to the player and the time for it to regen.
Let's take a look at this example (you'll see a commented text "//t_tree" if you have read the previous chapter you'll surelly know what this is, it's a defname)

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

Basically this section defines a resource, something that you can gather from the landscape. It compares skill and amount. This particular one says that you may gather a maximum of 9 logs at 1.0 skill and a maximum of 30 logs at 80.0 skill. Anything after that simply increases your chances of getting 30 logs. See that SKILL line? The syntax is SKILL=lower,high. And the AMOUNT line sets the AMOUNT=min,max.
How does it know what to give you? This line: REAP=i_log. This tells the server to create an i_log item if this resource is taken. So you can put anything you want to be gatherable in this REAP setting.
The next line, REGEN, defines how long this resource will take to reappear, in seconds. As we can see here, it's 60*60*10 seconds, or 10 hours. As a GM, if you walk around where players have been chopping wood or mining, you'll see little worldgem bits all over the ground. They look like spawnpoints, but are really resource markers. They mark where a specific resource has been gathered, how much has been gathered, and what type of resource it is. They also have a TIMER which counts down from this very high number (36000) and then decay when it reaches zero.

<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, you must be saying. What are all these things? mr_iron? mr_agapite? I don't see those anywhere in the file. Now, I bet you'll go to sphere_defs.scp to see if they are DEFNAMEs for something else. And the truth is, they are, but the definitions can be found in sphereitem_ore.scp.

<tt>RESOURCES=50.0 mr_iron</tt>

This should look slightly familiar. Would it look even more familiar if the whole thing looked like this?

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

I bet it would, if you were paying attention during the earlier lessons in Chapter 1. This is a weighted list of resources, in a slightly different format than you're used to. But it works exactly the same way. It's also one of the ONLY places in SPHERE scripting that you can use fractional numbers like 0.1 or 0.2. Actually you can't use them here either, but SPHERE successfully hides this as long as you use them in ALL of the RESOURCES. (By the way, do not try to script a RESOURCES identifier as a random selector. SPHERE wont like that. Use the format provided to you.)

[REGIONTYPE r_default_rock t_rock] ''Understanding:'' That r_dafault_rock defines the defname of that REGIONTYPE, which is how you'll access it in other scripts (wait for next section =P). The t_rock is the defname (see sphere_defs.scp for it) of the type of a rock, which shows sphere where your players can gather that resource (you could change it to t_water so they could mine ores on water, which isn't a good idea actually :P)

Hopefully that clears up the sphere_region.scp file for you. We'll tell you in the next section how to use these REGIONTYPE settings to make resources actually available in game.

==sphere_mapX.scp==

Welcome to one of the easiest files in all of SPHERE. This is the spheremap.scp file. It's also the only file that's almost completely done for you. It is a very rare occasion that you need to change this file.

Actually, on that note, I might as well say it from the start. If you change this file, you must restart your server for the changes to take effect. If you do a resync, you'll get over 1000 "Conflicting region" errors.

This section will tell you how to make new regions, like that you go with the .go command.

There are currently 5 files in the default scripts pack, one for each map (Fellucca, Trammel, Ilshenar, Malas and Tokuno) being each one enumerated from 0 to 4 (sphere_map0,sphere_map1,and so on).

I'll use the region of Fellucca as an example for this part of the tutorial, and now here's the script:

<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>

Let's understand those lines now:

'''[AREADEF somedef]''': As you have probably noticed a_world is a defname which defines the region for the server so it can be processed.

'''Name''': This line contains the name of the region, which is shown when you do .where inside the region and it also makes you go to that place when doing .go "region name" (do not make 2 regions with the same name, the last that has been loaded will replace the first when you do .go command (which can fuck up a lot of things)).

'''Events''': This defines what will happen in that region and what resources are gatherable here (remember the REGIONTYPE section? It can be used as an event here.). Besides the resources gatherable it'll also show sphere what triggers to call from the events (you've probably realized now that the REGIONTYPE section is an event for regions :P), like the @Enter trigger and the others (see [[Triggers]]).

'''Group''': This is just an axis setting, this separates the regions in groups (duh) when you go to the Travel Menu.

'''P''': This is the place you go when you do .go "region name". Almost all regions will have a P value and it's usually a convenient location in the region to teleport to, or else it's the center of the region. If you are making your own new region, be sure to pick a place you'd like to teleport to.

'''RainChance''': This defines the chance to rain on that region when a weather is called (RainChance=50 means 50% chance of raining), the others 50% means it'll snow.

'''Rect''': This describes the exact boundaries of this region, by coordinates. The first two numbers are the coordinate of the upper left corner of the region, and the second two are the coordinates of the lower right. In the case of Fellucca it stretches from 0,0 to 6144,4096 (RECT=0,0,6144,4096). Since 56B you also need to add a fith argument, the map this region uses so it's RECT=0,0,6144,4096,0 (if the map is 0 you can leave it empty, otherwise you MUST NOT leave it empty or you'll have conflicting regions.

'''Flags''': The region flags allow you to control what goes on in a particular region. They describe whether or not a region is to be guarded, what types of magic are allowed to be cast there, who can be harmed here, or whether or not it is allowed to rain there. Basically anything you could ever want. Here's how you use them:

Just add this line to a region script:

FLAGS=#

Of course you're going to want to replace that # with an actual number! Where do we get those numbers? They're predefined in the game, but they give us a nice handy list. I just showed it to you.

Say we want to make a region that is guarded and safe from harm. We would simply add the two numbers together:

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

There you go. Your FLAGS would be set to 06000. "But.. but.." you're saying. "Didn't you tell me that DEFNAMEs were supposed to prevent me from working with scary numbers?" (See [[Chapter 1]].) Of course I did! And there's a way to do this without using any scary number at all. Here it is:

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

That's it. Now your region is both safe and guarded.

Which, as you may learn quickly as a new admin, is a big mistake. Making a region safe and guarded at the same time prevents the guards from actually killing anything, so they pile up and call each other, and soon you have a huge laggy mess of guards hacking at something that can't be killed (because it's a safe region). Just take my word for it and don't make a region safe and guarded.

Here's a quick list for the region flags (you should check you sphere_defs.scp for more, cause they may be changed):

<tt>[DEFNAME region_flags] 
region_antimagic_all 00001 // all magic banned here. 
region_antimagic_recall_in 00002 // teleport,recall in to this, and mark 
region_antimagic_recall_out 00004 // can't recall out of here. 
region_antimagic_gate 00008 // can't open gates from or to this place. 
region_antimagic_teleport 00010 // can't teleport into here. 
region_antimagic_damage 00020 // just no bad magic here 
region_flag_ship 00040 // this is a ship region. ship commands 
region_flag_nobuilding 00080 // no building in this area 
region_flag_globalname 00100 // make sure the name is avail globally. 
region_flag_announce 00200 // announce to all who enter. 
region_flag_insta_logout 00400 // instant log out is allowed here. (hotel) 
region_flag_underground 00800 // dungeon type area. (no weather) 
region_flag_nodecay 01000 // things on the ground don't decay here. 
region_flag_safe 02000 // this region is safe from all harm. 
region_flag_guarded 04000 // try tag.guardowner 
region_flag_no_pvp 08000 // players cannot directly harm each other here. </tt>

And that's about it for the sphere_mapX.scp files.

==sphere_book.scp==
Spherebook.scp is one of the most pointless files you will ever encounter. How many times, when you logged onto a shard, did you actually stop to READ those tips, or to READ the updates screen that comes up every time? I know most of my players refused to. But, in any case, that is what's in this file. And books. Did I mention books? Those impossible-to-write-correctly, rarely-used items that waste RAM in-game?

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

These are the sections that define the messages that pop up when you log in. Anything written after these tags will appear in the appropriate message. You'll have to figure out exactly what spacing is best for those little info boxes. It does take some time, and there's really no way to explain it. Just do it and you'll figure it out. Remember, there is no wordwrap. Or at least there wasn't in the past.

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

You guessed it. These are the tips that pop up on startup. "War is unhealthy for children and other living things." is one of them. Very appropriate right now, I would say.

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

Creates a book with a DEFNAME of title. Putting a page number x after the DEFNAME will add your text to that particular page. Look at the example books for clues on how to do this. The major difficulty with books is that the game uses a variable-width font, so you don't know an exact number of letters you can have on one line. For example, you can fit more i's on one line than w's or M's, since those letters are bigger. You can start a paragraph by typing a TAB text (clicking yout TAB button :P)

==sphere_name.scp==

This is an easy file. It's just lists of names under sections with various DEFNAMEs. It's these names that are important, not the contents, since you will almost NEVER write your own list of names. I've been using this emulator for two years now, and I have never modified this file once.

To access this list of names, you write this in a script:

'''NAME=#NAMES_HUMANMALE'''

It will automatically replace it with a random name from the '''NAMES_HUMANMALE''' list.

To make a list of names, it'll look like that:

<tt>[NAMES A_DEFNAME_YOU_WANT] 
NUMBER_OF_NAMES 
NAMES </tt>

for example:

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

Difficult file huh? I almost didn't give it a section to itself.

==sphere_newb.scp==
There! I did it! No vain attempt at humor under the title! :)

In any case, this is another file that a lot of questions are asked about. "How do I make players start with 10000 gold?" people ask. Or, "How do I give all blacksmiths 800 ingots?" Now, I'm not saying I would like to play on a shard where you start with 10000 gold or blacksmiths start with 800 ingots. But this file would be the place to do it.

<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>

This is what a typical script looks like. It looks kinda like a template doesn't it? Well there's a good reason for that. It really is a template. It just uses the '''ITEMNEWBIE''' tag rather than the '''ITEM''' tag. Look at the section in Chapter 1 on Templates for more information on how to structure this file!

The only real item of note is that these sections MUST have specific names that the server looks for. You cannot add a new newbie section, no matter how much you'd like to. Sorry!

==sphere_skill.scp (SKILLCLASSES)==
Skill classes are what defines how much you can train at each skill/stat and you can also add triggers to it.
A SkillClass script would look like this:

<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>

Now let's understand it:

'''EVENTS''': It means everyone with this skillclass will also call the events specified in this field (to add more events just use a ",", for example: EVENTS=e_1,e_2,and so on)

'''STATSUM''': This is how much the som of your players stats can be, for example, if I have 100 str, 100 dex and 100 int, I've reached 300 stats, so I've reached STATSUM and can't have more (except for magic items and such things)

'''SKILLSUM''': The same thing as STATSUM but for skills.

'''STR/DEX/INT''': This is how much can the player have at this specific stat (except for magic items and such)

'''ALCHEMY''': The same thing as the STR, DEX and INT fields, but for skills (in this case alchemy, but of course you can change to any other)

==sphere_serv_triggers.scp==
This file hold special trigger "functions" that are fired by the server its self at certain times depending on the function, below are a list of the functions found in this file and a breif explain of what the function will do for you.

'''f_onaccount_login'''

This function is called after the client has entered the password.

:ARGS --> username of the client logging in
:ARGO --> the client logging in
:RETURN 0 --> normal action (login)
:RETURN 1 --> disconnect the client

'''f_onaccount_delete'''

This function is called before an account is being deleted.

:ARGS --> username of the account being deleted.
:RETURN 0 --> normal action (delete)
:RETURN 1 --> account not deleted

'''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'''

[[Chapter 3]]

[[Category:Tutorials]]

De:Configuring Sphere.ini

2014-03-26T20:11:23Z

Matex:

{{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 seconds for food deregeneration
// 60*60*24 = 1 day of real life time
Regen3=60*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/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]]

Chapter 2

2014-03-26T20:10:58Z

Matex:

{{Languages|Chapter_2}}

==spheretables.scp==

Spheretables.scp is the very first file read by SPHERE after SPHERE.ini, and therefore it is the most important. Almost all of the secondary settings are contained within this file, wich makes this very important. Now, let's talk about this very important file in topics:

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

The first thing you'll see when you open this file is a list of resources. This is marked by (SURPRISE!) a [RESOURCE] tag. It looks something like this:

<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>

This tells sphere what files to load and in what order to do so. You must change it carefully sometimes, put scripts with a lot of DEFNAMES, REGIONS, and other global used settings first, to avoid errors when sphere starts (although those errors won't harm your server). For example, we looked at a gold script in Chapter 1 that had a line like this:

TYPE=t_gold

Now, unless SPHERE loads sphere_defs.scp before the script containing the gold, it will have no idea what t_gold means, and will give you an error. This is because t_gold is defined within sphere_defs.scp.

Item files should be loaded before template files, and finally character files. Other files may come after this, but these particular files must load in that order. The loot on monsters is comprised of items and templates, and unless SPHERE has already loaded the file containing these items and templates, you will get hundreds of fun errors to track down and correct. Actually, it isn't very hard to correct, but it's irritating to start up the program and have a thousand errors scroll up your screen.

'''Note''': ''You can make sphere load a full folder instead of putting each file, that's why we have this scripts/ as the last file on the [RESOURCES] tag, so sphere loads all other scripts that might have been out of the list.''

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

The next section is self-explanatory, [OBSCENE]. This defines "illegal names". If a player creates a character with a name on this list, it will tell him that the name is unavailable and to pick another. If you are a punk who enjoys cussing at others, this list might be a good place to expand your knowledge of obscenities.

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

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] ==

These sections define the commands available to the various account plevels. Any command not listed is automatically assumed to be in the plevel 4 category. This includes self-defined functions (see [[Chapter 6]]). As you can see, there is quite an extensive list of functions and commands.

'''Note''': ''You don't have to put every function you make in this section as you can have various sections in different scripts, although I recommend that you put them here just for organization purposes.''

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

This is the list of those words you say when casting a spell (An, Lor, In, etc). You can play with them, but it'll become very confusing. =P

==Sphere.ini==

Sphere.ini contains all of the internal options for the Sphere emulator. In order to configure your shard, this is the file you will start with. In order to explain this better, I'm just going to add more explanatory comments throughout the file. My comments and additions/changes will be in '''bold text'''.

<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 Eastern Time (US & Canada). Change this to fit your timezone''' 
 
// Official staff language 
Lang=English 
// Start this as a system service on Win2000, XP, NT 
NTService=0 '''Enabling this removes the ability to use the console.''' 
 
// MySql configuration. 
//MYSQL=0 '''Set this to =1 to enable MySQL''' 
//MySqlHost='''localhost This will almost always be localhost if the MYSQL host is located on the same computer as your 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 is a safer encryption method for saving passwords. More information on it [http://en.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 '''Default client uses encryption''' 
UseCrypt=1 
 
// Set this to 1 to allow login to unencrypted clients '''You can use tools such as [http://stud4.tuwien.ac.at/~e9425109/UO_RICE.htm UO Rice] and [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 means that all commands will be logged''' 
 
// 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=automatic detect, 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 '''Formula is now DELAY = 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 '''If set to 0, vendors also take gold from the bank''' 
 
// Disable weather effects? 
NoWeather=1 
 
// Default light level in dungeons 
DungeonLight=27 '''0 is brightest, 30 is darkest''' 
 
// Day light level 0-30 '''0 is brightest, 30 is darkest''' 
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 '''If both of these are enabled, it means the player has to keep turning to face his opponent in order to strike''' 
 
/////////////////////////////////////////////////////////////// 
//////// 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 '''or [TAME], if the creature is tamed''' 
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 is 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 is 30.0 skill''' 
 
// Max skill player's will start with on skills they haven't chosen during char create 
MaxBaseSkill=200 '''Set this to 0 for players to start with no skills other than the selected ones''' 
 
// 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 deregeneration 
// 60*60*24 = 1 day of real life time 
Regen3=60*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) '''This makes npcs look for food (specified on their FOODTYPE sections) and grass to eat''' 
// 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 '''Enables new Unicode fixes''' 
// EF_Scripts_Ret_Strings = 00000004 
// EF_New_Triggers = 00000008 
// EF_Scripts_Parse_Verbs = 00000010 
// EF_Intrinsic_Locals = 00000020 //'''Allows locals to be referenced differently. For example: <local.X> can be referenced as just <X>''' 
// EF_Item_Strict_Comparison = 00000040 //'''Disables similars items being compared instead of specific items, such as cloth, leather, hides, log, boards, arrow, bolt being compared when the server tries to find an arrow.''' 
// EF_WalkCheck = 00000100 '''//Fixes a lot of house looting bugs, and other walkchecking related problems.''' 
// 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 //'''Does magic ignore a players armor statistics?''' 
// OF_Magic_CanHarmSelf = 00000002 //'''Can a player harm himself with magic? (using Magic Arrow to unparalyze oneself, for example)''' 
// OF_Magic_StackStats = 00000004 
// OF_Archery_CanMove = 00000010 //'''Can a player move and shoot at the same time?''' 
// OF_Magic_PreCast = 00000020 //'''Allow pre-casting of spells, or freeze a player in place while they cast?''' 
// OF_Items_AutoName = 00000040 
// OF_FileCommands = 00000080 //'''This enables all file commands, such as writefile, etc.''' 
// OF_NoItemNaming = 00000100 //'''If enabled, prevents Sphere from naming crafted items such as "sword craft by Player''' 
// OF_NoHouseMuteSpeech = 00000200 //'''Can players inside a house hear players outside, and vice-versa?''' 
// OF_Multithreaded = 00000400 //'''Do not set while server is running !!! (Make *Nix server unstable) Puts account handling in a second thread''' 
// 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''' It isn't present in sphere.ini, but it can be used (just check REVISIONS.txt). You use it like that:

MAPx=max_x,max_y,sector_size,real_map_number.

For example: MAP1=7168,4096,512,-1

will change map 1 size to 7168,4096, the sector sizes of map 1 to 512 tiles and the -1 means it'll call the default mul file for that map.

Another example:

MAP50=7168,4096,64,3

Will activate a map number 50 that has 7168,4096 as size, 64 as sector size and loads map3.mul, statics3.mul and staidx3.mul as it's map file.

==sphere_region.scp==

This script deals with the caracteristics of the places, like what you can mine or lumber, what happens when you enter that place and that kind of things. It also contains most of the resources sections.
Let's start by explaining those:

<tt>[REGIONRESOURCE x]</tt>

This section contains the the skill needed to gather that resource, what resource it gives to the player and the time for it to regen.
Let's take a look at this example (you'll see a commented text "//t_tree" if you have read the previous chapter you'll surelly know what this is, it's a defname)

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

Basically this section defines a resource, something that you can gather from the landscape. It compares skill and amount. This particular one says that you may gather a maximum of 9 logs at 1.0 skill and a maximum of 30 logs at 80.0 skill. Anything after that simply increases your chances of getting 30 logs. See that SKILL line? The syntax is SKILL=lower,high. And the AMOUNT line sets the AMOUNT=min,max.
How does it know what to give you? This line: REAP=i_log. This tells the server to create an i_log item if this resource is taken. So you can put anything you want to be gatherable in this REAP setting.
The next line, REGEN, defines how long this resource will take to reappear, in seconds. As we can see here, it's 60*60*10 seconds, or 10 hours. As a GM, if you walk around where players have been chopping wood or mining, you'll see little worldgem bits all over the ground. They look like spawnpoints, but are really resource markers. They mark where a specific resource has been gathered, how much has been gathered, and what type of resource it is. They also have a TIMER which counts down from this very high number (36000) and then decay when it reaches zero.

<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, you must be saying. What are all these things? mr_iron? mr_agapite? I don't see those anywhere in the file. Now, I bet you'll go to sphere_defs.scp to see if they are DEFNAMEs for something else. And the truth is, they are, but the definitions can be found in sphereitem_ore.scp.

<tt>RESOURCES=50.0 mr_iron</tt>

This should look slightly familiar. Would it look even more familiar if the whole thing looked like this?

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

I bet it would, if you were paying attention during the earlier lessons in Chapter 1. This is a weighted list of resources, in a slightly different format than you're used to. But it works exactly the same way. It's also one of the ONLY places in SPHERE scripting that you can use fractional numbers like 0.1 or 0.2. Actually you can't use them here either, but SPHERE successfully hides this as long as you use them in ALL of the RESOURCES. (By the way, do not try to script a RESOURCES identifier as a random selector. SPHERE wont like that. Use the format provided to you.)

[REGIONTYPE r_default_rock t_rock] ''Understanding:'' That r_dafault_rock defines the defname of that REGIONTYPE, which is how you'll access it in other scripts (wait for next section =P). The t_rock is the defname (see sphere_defs.scp for it) of the type of a rock, which shows sphere where your players can gather that resource (you could change it to t_water so they could mine ores on water, which isn't a good idea actually :P)

Hopefully that clears up the sphere_region.scp file for you. We'll tell you in the next section how to use these REGIONTYPE settings to make resources actually available in game.

==sphere_mapX.scp==

Welcome to one of the easiest files in all of SPHERE. This is the spheremap.scp file. It's also the only file that's almost completely done for you. It is a very rare occasion that you need to change this file.

Actually, on that note, I might as well say it from the start. If you change this file, you must restart your server for the changes to take effect. If you do a resync, you'll get over 1000 "Conflicting region" errors.

This section will tell you how to make new regions, like that you go with the .go command.

There are currently 5 files in the default scripts pack, one for each map (Fellucca, Trammel, Ilshenar, Malas and Tokuno) being each one enumerated from 0 to 4 (sphere_map0,sphere_map1,and so on).

I'll use the region of Fellucca as an example for this part of the tutorial, and now here's the script:

<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>

Let's understand those lines now:

'''[AREADEF somedef]''': As you have probably noticed a_world is a defname which defines the region for the server so it can be processed.

'''Name''': This line contains the name of the region, which is shown when you do .where inside the region and it also makes you go to that place when doing .go "region name" (do not make 2 regions with the same name, the last that has been loaded will replace the first when you do .go command (which can fuck up a lot of things)).

'''Events''': This defines what will happen in that region and what resources are gatherable here (remember the REGIONTYPE section? It can be used as an event here.). Besides the resources gatherable it'll also show sphere what triggers to call from the events (you've probably realized now that the REGIONTYPE section is an event for regions :P), like the @Enter trigger and the others (see [[Triggers]]).

'''Group''': This is just an axis setting, this separates the regions in groups (duh) when you go to the Travel Menu.

'''P''': This is the place you go when you do .go "region name". Almost all regions will have a P value and it's usually a convenient location in the region to teleport to, or else it's the center of the region. If you are making your own new region, be sure to pick a place you'd like to teleport to.

'''RainChance''': This defines the chance to rain on that region when a weather is called (RainChance=50 means 50% chance of raining), the others 50% means it'll snow.

'''Rect''': This describes the exact boundaries of this region, by coordinates. The first two numbers are the coordinate of the upper left corner of the region, and the second two are the coordinates of the lower right. In the case of Fellucca it stretches from 0,0 to 6144,4096 (RECT=0,0,6144,4096). Since 56B you also need to add a fith argument, the map this region uses so it's RECT=0,0,6144,4096,0 (if the map is 0 you can leave it empty, otherwise you MUST NOT leave it empty or you'll have conflicting regions.

'''Flags''': The region flags allow you to control what goes on in a particular region. They describe whether or not a region is to be guarded, what types of magic are allowed to be cast there, who can be harmed here, or whether or not it is allowed to rain there. Basically anything you could ever want. Here's how you use them:

Just add this line to a region script:

FLAGS=#

Of course you're going to want to replace that # with an actual number! Where do we get those numbers? They're predefined in the game, but they give us a nice handy list. I just showed it to you.

Say we want to make a region that is guarded and safe from harm. We would simply add the two numbers together:

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

There you go. Your FLAGS would be set to 06000. "But.. but.." you're saying. "Didn't you tell me that DEFNAMEs were supposed to prevent me from working with scary numbers?" (See [[Chapter 1]].) Of course I did! And there's a way to do this without using any scary number at all. Here it is:

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

That's it. Now your region is both safe and guarded.

Which, as you may learn quickly as a new admin, is a big mistake. Making a region safe and guarded at the same time prevents the guards from actually killing anything, so they pile up and call each other, and soon you have a huge laggy mess of guards hacking at something that can't be killed (because it's a safe region). Just take my word for it and don't make a region safe and guarded.

Here's a quick list for the region flags (you should check you sphere_defs.scp for more, cause they may be changed):

<tt>[DEFNAME region_flags] 
region_antimagic_all 00001 // all magic banned here. 
region_antimagic_recall_in 00002 // teleport,recall in to this, and mark 
region_antimagic_recall_out 00004 // can't recall out of here. 
region_antimagic_gate 00008 // can't open gates from or to this place. 
region_antimagic_teleport 00010 // can't teleport into here. 
region_antimagic_damage 00020 // just no bad magic here 
region_flag_ship 00040 // this is a ship region. ship commands 
region_flag_nobuilding 00080 // no building in this area 
region_flag_globalname 00100 // make sure the name is avail globally. 
region_flag_announce 00200 // announce to all who enter. 
region_flag_insta_logout 00400 // instant log out is allowed here. (hotel) 
region_flag_underground 00800 // dungeon type area. (no weather) 
region_flag_nodecay 01000 // things on the ground don't decay here. 
region_flag_safe 02000 // this region is safe from all harm. 
region_flag_guarded 04000 // try tag.guardowner 
region_flag_no_pvp 08000 // players cannot directly harm each other here. </tt>

And that's about it for the sphere_mapX.scp files.

==sphere_book.scp==
Spherebook.scp is one of the most pointless files you will ever encounter. How many times, when you logged onto a shard, did you actually stop to READ those tips, or to READ the updates screen that comes up every time? I know most of my players refused to. But, in any case, that is what's in this file. And books. Did I mention books? Those impossible-to-write-correctly, rarely-used items that waste RAM in-game?

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

These are the sections that define the messages that pop up when you log in. Anything written after these tags will appear in the appropriate message. You'll have to figure out exactly what spacing is best for those little info boxes. It does take some time, and there's really no way to explain it. Just do it and you'll figure it out. Remember, there is no wordwrap. Or at least there wasn't in the past.

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

You guessed it. These are the tips that pop up on startup. "War is unhealthy for children and other living things." is one of them. Very appropriate right now, I would say.

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

Creates a book with a DEFNAME of title. Putting a page number x after the DEFNAME will add your text to that particular page. Look at the example books for clues on how to do this. The major difficulty with books is that the game uses a variable-width font, so you don't know an exact number of letters you can have on one line. For example, you can fit more i's on one line than w's or M's, since those letters are bigger. You can start a paragraph by typing a TAB text (clicking yout TAB button :P)

==sphere_name.scp==

This is an easy file. It's just lists of names under sections with various DEFNAMEs. It's these names that are important, not the contents, since you will almost NEVER write your own list of names. I've been using this emulator for two years now, and I have never modified this file once.

To access this list of names, you write this in a script:

'''NAME=#NAMES_HUMANMALE'''

It will automatically replace it with a random name from the '''NAMES_HUMANMALE''' list.

To make a list of names, it'll look like that:

<tt>[NAMES A_DEFNAME_YOU_WANT] 
NUMBER_OF_NAMES 
NAMES </tt>

for example:

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

Difficult file huh? I almost didn't give it a section to itself.

==sphere_newb.scp==
There! I did it! No vain attempt at humor under the title! :)

In any case, this is another file that a lot of questions are asked about. "How do I make players start with 10000 gold?" people ask. Or, "How do I give all blacksmiths 800 ingots?" Now, I'm not saying I would like to play on a shard where you start with 10000 gold or blacksmiths start with 800 ingots. But this file would be the place to do it.

<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>

This is what a typical script looks like. It looks kinda like a template doesn't it? Well there's a good reason for that. It really is a template. It just uses the '''ITEMNEWBIE''' tag rather than the '''ITEM''' tag. Look at the section in Chapter 1 on Templates for more information on how to structure this file!

The only real item of note is that these sections MUST have specific names that the server looks for. You cannot add a new newbie section, no matter how much you'd like to. Sorry!

==sphere_skill.scp (SKILLCLASSES)==
Skill classes are what defines how much you can train at each skill/stat and you can also add triggers to it.
A SkillClass script would look like this:

<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>

Now let's understand it:

'''EVENTS''': It means everyone with this skillclass will also call the events specified in this field (to add more events just use a ",", for example: EVENTS=e_1,e_2,and so on)

'''STATSUM''': This is how much the som of your players stats can be, for example, if I have 100 str, 100 dex and 100 int, I've reached 300 stats, so I've reached STATSUM and can't have more (except for magic items and such things)

'''SKILLSUM''': The same thing as STATSUM but for skills.

'''STR/DEX/INT''': This is how much can the player have at this specific stat (except for magic items and such)

'''ALCHEMY''': The same thing as the STR, DEX and INT fields, but for skills (in this case alchemy, but of course you can change to any other)

==sphere_serv_triggers.scp==
This file hold special trigger "functions" that are fired by the server its self at certain times depending on the function, below are a list of the functions found in this file and a breif explain of what the function will do for you.

'''f_onaccount_login'''

This function is called after the client has entered the password.

:ARGS --> username of the client logging in
:ARGO --> the client logging in
:RETURN 0 --> normal action (login)
:RETURN 1 --> disconnect the client

'''f_onaccount_delete'''

This function is called before an account is being deleted.

:ARGS --> username of the account being deleted.
:RETURN 0 --> normal action (delete)
:RETURN 1 --> account not deleted

'''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'''

[[Chapter 3]]

[[Category:Tutorials]]

Configuring Sphere.ini

2014-03-26T20:10:20Z

Matex:

{{Languages|Configuring_Sphere.ini}}

Sphere.ini contains all of the internal options for the Sphere emulator. In order to configure your shard, this is the file you will start with. The file itself is pretty self-explanatory, but in order to avoid common mistakes, we're going to add more explanatory comments throughout the file. Comments and additions/changes will be in <tt>'''bold blue text'''</tt>.

Remember to uncomment every line you're gonna use. Example:

If you want to use additional map2, this:

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

Should be this:

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

And so on, with every setting you want to use (MySQL, AutoResdisp, etc).

Let's check the sphere.ini file!

<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>'''// Enabling this also removes the ability to use the console''' </tt>
<spherescript color="darkgreen">NTService=0

// MySql configuration.</spherescript>
<tt>'''// If you want to enable MYSQL, set 1''' </tt>
<spherescript color="darkgreen">//MYSQL=0</spherescript>
<tt>'''// This is where the MySQL host is located, localhost if it's on the same machine''' </tt>
<spherescript color="darkgreen">//MySqlHost=</spherescript>
<tt>'''// The username for the desired database''' </tt>
<spherescript color="darkgreen">//MySqlUser=</spherescript>
<tt>'''// The password for the user''' </tt>
<spherescript color="darkgreen">//MySqlPassword=</spherescript>
<tt>'''// The name of the database. This is _NOT_ the host, you must set the name of the DB''' </tt>
<spherescript color="darkgreen">//MySqlDatabase=

///////////////////////////////////////////////////////////////
//////// File Locations
///////////////////////////////////////////////////////////////
// Directory where spheretables.scp is located, from there we will
// load any additional scripts</spherescript>
<tt>'''// This can be used to load the same script pack,''' 
'''// using a different .exe for testing.''' </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>'''// Some kind of map patches, used for Map0 and Map1, for example.''' 
'''// The island Occlo (Map0) is Haven in Map1. This option handles that.''' 
'''// More recent client versions no longer use map patches, since a separate MAP1.MUL file was''' 
'''// added to the UO installation.''' </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 is a safer way to store passwords. [http://en.wikipedia.org/wiki/MD5 More Information]''' </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>'''// Like on some paid forums, this is useful.''' </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>'''// The official clients use encryption.''' </tt>
<spherescript color="darkgreen">UseCrypt=1

// Set this to 1 to allow login to unencrypted clients</spherescript>
<tt>'''// You can use tools such as [http://stud4.tuwien.ac.at/~e9425109/UO_RICE.htm UO Rice] and [http://www.uogateway.com/ UOGateway] to remove encryption on a client.''' </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>'''// With zero it will log EVERY command used.''' </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=Pre-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>'''// The formula is 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>'''// If 0 vendors will take gold from bank and backpack''' </tt>
<spherescript color="darkgreen">PayFromPackOnly=0

// Disable weather effects?
NoWeather=1

// Default light level in dungeons</spherescript>
<tt>'''// 0 = Bright; 3 = Dark.''' </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." Will not be displayed.''' </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>'''// And [TAME] if the character is tamed.''' </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>'''// Remember that in skills: 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>'''// To avoid double title as: Lord Lord Knight''' </tt>
<spherescript color="darkgreen">// NPCNoFameTitle=0

// Max level of skill trainable on dummies, archery butte ecc..</spherescript>
<tt>'''// Remember that in skills: 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>'''// If set to 0, players will start _only_ with their selected skills.''' </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 seconds for food degeneration
// 60*60*24 = 1 day of real life time
Regen3=60*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. '''Enables UNICODE fixes''' 
// EF_New_Triggers = 00000008 '''// Adds more triggers''' 
// EF_Intrinsic_Locals = 00000020 '''// Locals can be reference differently. <LOCAL.X> can be referenced as <X>. 
// EF_Item_Strict_Comparison = 00000040 
// EF_NewPositionChecks = 00000080 // Do not set while server is running !!! 
// EF_WalkCheck = 00000100 '''// Fixes house looting bugs, and other walkchecking related problems.''' 
// 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 '''// This enables all FILE commands, information about this command is [[File| here]]''' 
// OF_NoItemNaming = 00000100 '''// If enabled, prevents Sphere from naming crafted items ("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>'''// For help configuring this section, see [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]]

Configuring Sphere.ini

2014-03-26T20:09:52Z

Matex:

{{Languages|Configuring_Sphere.ini}}

Sphere.ini contains all of the internal options for the Sphere emulator. In order to configure your shard, this is the file you will start with. The file itself is pretty self-explanatory, but in order to avoid common mistakes, we're going to add more explanatory comments throughout the file. Comments and additions/changes will be in <tt>'''bold blue text'''</tt>.

Remember to uncomment every line you're gonna use. Example:

If you want to use additional map2, this:

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

Should be this:

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

And so on, with every setting you want to use (MySQL, AutoResdisp, etc).

Let's check the sphere.ini file!

<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>'''// Enabling this also removes the ability to use the console''' </tt>
<spherescript color="darkgreen">NTService=0

// MySql configuration.</spherescript>
<tt>'''// If you want to enable MYSQL, set 1''' </tt>
<spherescript color="darkgreen">//MYSQL=0</spherescript>
<tt>'''// This is where the MySQL host is located, localhost if it's on the same machine''' </tt>
<spherescript color="darkgreen">//MySqlHost=</spherescript>
<tt>'''// The username for the desired database''' </tt>
<spherescript color="darkgreen">//MySqlUser=</spherescript>
<tt>'''// The password for the user''' </tt>
<spherescript color="darkgreen">//MySqlPassword=</spherescript>
<tt>'''// The name of the database. This is _NOT_ the host, you must set the name of the DB''' </tt>
<spherescript color="darkgreen">//MySqlDatabase=

///////////////////////////////////////////////////////////////
//////// File Locations
///////////////////////////////////////////////////////////////
// Directory where spheretables.scp is located, from there we will
// load any additional scripts</spherescript>
<tt>'''// This can be used to load the same script pack,''' 
'''// using a different .exe for testing.''' </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>'''// Some kind of map patches, used for Map0 and Map1, for example.''' 
'''// The island Occlo (Map0) is Haven in Map1. This option handles that.''' 
'''// More recent client versions no longer use map patches, since a separate MAP1.MUL file was''' 
'''// added to the UO installation.''' </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 is a safer way to store passwords. [http://en.wikipedia.org/wiki/MD5 More Information]''' </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>'''// Like on some paid forums, this is useful.''' </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>'''// The official clients use encryption.''' </tt>
<spherescript color="darkgreen">UseCrypt=1

// Set this to 1 to allow login to unencrypted clients</spherescript>
<tt>'''// You can use tools such as [http://stud4.tuwien.ac.at/~e9425109/UO_RICE.htm UO Rice] and [http://www.uogateway.com/ UOGateway] to remove encryption on a client.''' </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>'''// With zero it will log EVERY command used.''' </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=Pre-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>'''// The formula is 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>'''// If 0 vendors will take gold from bank and backpack''' </tt>
<spherescript color="darkgreen">PayFromPackOnly=0

// Disable weather effects?
NoWeather=1

// Default light level in dungeons</spherescript>
<tt>'''// 0 = Bright; 3 = Dark.''' </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." Will not be displayed.''' </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>'''// And [TAME] if the character is tamed.''' </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>'''// Remember that in skills: 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>'''// To avoid double title as: Lord Lord Knight''' </tt>
<spherescript color="darkgreen">// NPCNoFameTitle=0

// Max level of skill trainable on dummies, archery butte ecc..</spherescript>
<tt>'''// Remember that in skills: 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>'''// If set to 0, players will start _only_ with their selected skills.''' </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 seconds for food regeneration
// 60*60*24 = 1 day of real life time
Regen3=60*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. '''Enables UNICODE fixes''' 
// EF_New_Triggers = 00000008 '''// Adds more triggers''' 
// EF_Intrinsic_Locals = 00000020 '''// Locals can be reference differently. <LOCAL.X> can be referenced as <X>. 
// EF_Item_Strict_Comparison = 00000040 
// EF_NewPositionChecks = 00000080 // Do not set while server is running !!! 
// EF_WalkCheck = 00000100 '''// Fixes house looting bugs, and other walkchecking related problems.''' 
// 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 '''// This enables all FILE commands, information about this command is [[File| here]]''' 
// OF_NoItemNaming = 00000100 '''// If enabled, prevents Sphere from naming crafted items ("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>'''// For help configuring this section, see [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]]