POL Configuration Files
This is a list of all the files that are read by or used by the Core. Any other files are used by user scripts and are not listed here.
In the following config file explanations, some punctuation is used to show repetition, arbitrary values, and optional entries:- No punctuation: text must be the same verbatim.
- enclosed in brackets [ ]: text is an optional entry.
- enclosed in parenthesis ( ): text is an arbitrary value.
- enclosed in curly braces { }: text is the default value.
- elipsis ... : repeat entries are allowed.
Last Modified: 01/05/2018
- animxlate.cfg
- armrzone.cfg
- attributes.cfg
- auxsvc.cfg
- bannedips.cfg
- boats.cfg
- circles.cfg
- cmds.cfg
- combat.cfg
- console.cfg
- ecompile.cfg
- equip.cfg
- extobj.cfg
- fileaccess.cfg
- itemdesc.cfg
- justice.cfg
- light.cfg
- menus.cfg
- movecost.cfg
- multis.cfg
- music.cfg
- nocast.cfg
- npcdesc.cfg
- party.cfg
- pkg.cfg
- pkgroots.cfg
- pol.cfg
- regions.cfg
- repsys.cfg
- resource.cfg
- resourcetype.cfg
- servers.cfg
- servspecopt.cfg
- spells.cfg
- stacking.cfg
- startloc.cfg
- syshook.cfg
- uoclient.cfg
- uoconvert.cfg
- uopacket.cfg
- uoskills.cfg
- vitals.cfg
- watch.cfg
- weather.cfg
- www.cfg
animxlate.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines the mappings for animation codes for standing and while on horseback. Mobile types based on graphic and translation between the two different animation packets | |
Structure | |
OnMount { [(int normal animation) (int mounted animation)]... } MobileType (string type) { [OldAnimX (int action) [int framecount {default 5}] [int repeatcount {default 5}] [int backward {default 0}] [int repeatflag {default 0}] [int delay {default 1}] [NewAnim (int anim) [int action {default 0}] [int subaction {default 0}] [Graphic (int graphic)] } | |
Explanation | |
Actions while on a mount: format is normal-animation on-mount-animation | |
MobileType format: MountTranslation 1/0 defines if the OnMount table can be used (only valid for humans) Graphic int defines the mobile graphics for this type OldAnimX and NewAnimX (where X is between 0 and 34) defines the animation pkt for each action NewAnim is used for 7.0.9.0 clients |
armrzone.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines armor zones for character layers, and chance to hit each zone. | |
Structure | |
ArmorZone { Name (string zone name) Chance (int chance to hit) [Layer (int UO client layer)]... } [ArmorZone...] | |
Explanation | |
Chance is a percent chance to hit this zone. I.e. 'Body' might be a 44 percent chance to hit, and 'Head' a 14 percent chance. | |
Layer is for the different equipped item layers the UO client uses. For example, items that are only equipped on the arms (like platemail arms) are layer 19. You may define multiple layers per zone. |
attributes.cfg | |
---|---|
Location: | Any Package |
Number Allowed | any |
Required to Start? | Yes |
Required/Used by | |
Core | |
Purpose | |
Defines Attribute names and aliases | |
Structure | |
Attribute (Attribute_Name) { [Alias (Alias_Name)]... [GetIntrinsicModFunction (script_name:exported_func_name)] [Delay (Skill Delay for skills with buttons on Skill Window)] [Unhides (Unhides on skill use (0/1)] [Script (Location of script for skills with buttons on Skill Window)] [DefaultCap (cap in tenth of attribute {default ssopt:DefaultAttributeCap}] [DisableCoreChecks (0/1 {default 0}] } [Attribute...] | |
Explanation | |
Attribute_Name defines the UNIQUE name for this attribute, like 'Cooking', 'Tactics', 'Strength', etc. | |
Aliases are optional and any number maybe be assigned for each attribute. This way 'STR' may be used in place of 'Strength' | |
At the LEAST, these attributes must be defined: 'Strength', 'Intelligence', 'Dexterity', 'Parry', and 'Tactics' for use in internal calculations. | |
GetIntrinsicModFunction returns a value between -30000 and +30000 that is added to the Attribute "base" value to obtain the "effective" value for the attribute. The function is called when UO.EM RecalVitals is called. | |
DisableCoreChecks if true the core will not check during skill_use ( from skillwindow ) for active skills,active spells, frozen, paralyzed or delay | |
Related Files | |
uoclient.cfg | |
vitals.cfg | |
servspecopt.cfg |
auxsvc.cfg | |
---|---|
Location: | Any Package |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines an Auxilliary Interface Service script in the current package. | |
Structure | |
AuxService { Port (intger port) Script (string script filename) [IPMatch (IPaddress)[/(netmask)]] } | |
Explanation | |
Port is a different port than the gameserver uses. This will be the port your AUX interface external program uses to connect to the server. | |
Script is the script filename the core will call when it receives an AUX connection (the 'program' in the file will be called) | |
Example IPMatch value: 192.168.0.0/255.255.255.0 would prevent anyone with an IP address other than 192.168.0.* from connecting. The illegal ip will be treated by immediately closing the connection. |
bannedips.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines IP address ranges that are not allowed to connect to the game server. | |
Structure | |
BannedIP { IPMatch (IPaddress)[/(netmask)] } [BannedIP...] | |
Explanation | |
If netmask is not defined, the default is 255.255.255.255 (exact IP match). |
boats.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | Yes |
Required/Used by | |
Core | |
Purpose | |
Defines the locations of all item components for each boat 'facing' graphic. | |
Structure | |
Boat { MultiId (int boat multi id) TillerMan (int item graphic) (x offset) (y offset) PortGangplankExtended (int item graphic) (x offset) (y offset) PortGangplankRetracted (int item graphic) (x offset) (y offset) StarboardGangplankExtended (int item graphic) (x offset) (y offset) StarboardGangplankRetracted (int item graphic) (x offset) (y offset) Hold (int item graphic) (x offset) (y offset) [Rope (int item graphic) (x offset) (y offset)] [Wheel (int item graphic) (x offset) (y offset)] [Hull (int item graphic) (x offset) (y offset)] [Tiller (int item graphic) (x offset) (y offset)] [Rudder (int item graphic) (x offset) (y offset)] [Sails (int item graphic) (x offset) (y offset)] [Storage (int item graphic) (x offset) (y offset)] [WeaponSlot (int item graphic) (x offset) (y offset)] } [Boat...] | |
Explanation | |
MultiId usually equals grapphic-0x4000. | |
All the x,y tile distance offsets are from the ship's mast. As normal on the map, positive X is east, positive Y is south. It doesn't matter what 'facing' of the boat this is for, parts of the boat that are east of the mast are defined with positive X values, parts south of the mast are defined with positive Y values, and vice versa. |
circles.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Configures the 'spell circles', groups of increasing power spells. | |
Structure | |
Circle (int number) { Mana (int manacost) Difficulty (int spell difficulty) PointValue (int skill gain value) Delay (int second casting delay) } [Circle...] | |
Explanation | |
This file used to determine mana, skill gain, etc. for each group of spells, but it's probably obselete now. |
cmds.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | Yes |
Required/Used by | |
Core | |
Purpose | |
Configures the command level heirarchy for the server. | |
Structure | |
CmdLevel (cmdlevel name) { DIR (string path to this cmdlevel's textcmd directory) [DIR...] Alias (string alias name for this cmdlevel) [Alias...] } [CmdLevel...] {each successive element is one level higher than the last} | |
Explanation | |
Command levels are defined in increasing order of power. Command level 'numbers' will be assigned automatically from this file. | |
If you change the cmdlevel names from player/coun/seer/gm/admin/test, it is recommended you define 'Alias' lines to associate these basic cmdlevels with your custom cmdlevels. This way, package cmds.cfg files will place their commands into your command structure. | |
Additional DIR properties allow you to specify additional commands in packages, just set your path to i.e. /pkg/mypkg/textcmd/admin . |
combat.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines some combat-specific options. | |
Structure | |
[DisplayParrySuccessMessages (0/1) {default 0})] [WarmodeInhibitsRegen (0/1) {default 0})] [WarModeDelay (int Seconds) {default 1})] [SingleCombat (0/1 {default 0})] [CoreHitSounds (0/1 {default 0})] [ScriptedAttackChecks (0/1 {default 0})] [ResetSwingOnTurn (0/1 {default 0})] [SendSwingPacket (0/1 {default 1})] [SendDamagePacket (0/1 {default 0})] [AttackWhileFrozen (0/1 {default 1})] [SendAttackMsg (0/1 {default 1})] | |
Explanation | |
WarModeDelay: is a delay between ability to toggle war mode status via client. Does not affect using SetWarMode method. | |
SingleCombat: allows players to attack themselves. | |
CoreHitSounds: If enabled, the core handles sending sounds for hit on combat. When mobile hit is an NPC, it uses the NPC's DamagedSound from the NPCTemplate. If disabled, scripts must handle this. | |
ScriptedAttackChecks: If enabled, the combat hook must check distance, line of sight, visibility, and if both combatants are alive. | |
ResetSwingOnTurn: Should SwingTimer be reset with projectile weapon on facing change | |
SendSwingPacket: Should packet 0x2F be send on swing. | |
SendDamagePacket: Should 0xB (0xBF sub 0x22 for clients<4.0.7a) be send on damage | |
AttackWhileFrozen: if set to false attack checks if chr is frozen or paralyzed | |
SendAttackMsg: setting this to 0 stops the core repsys system sending "is attacking you" messages |
console.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Configures command characters that activate scripts when typed on the POL console. | |
Structure | |
Commands { [CMD (letter) (script) [(description}]] [CMD...] } | |
Explanation | |
'letter' is case sensative, so 'a' can run a different script than 'A'. And '^A' is activated with CTRL-A | |
'script' must be placed in /scripts/console. | |
'?' is the help command - it prints the descriptions of all the other console commands. | |
The number keys (0-9) are reserved for the shutdown scripts (after a certain delay) | |
'^C' (CTRL-C) is reserved for immediate core shutdown. | |
There are three special command script names: [lock] locks the console, no further console commands may be entered. [unlock] unlocks the console from the locked state, and [lock/unlock] toggles the lock status of the console. | |
Reloadable with ReloadConfiguration() (polsys.em) or SIGHUP under linux |
ecompile.cfg | |
---|---|
Location: | same directory as ecompile.exe only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
ecompile | |
Purpose | |
Configures module, include, and package paths for compiling. | |
Structure | |
ModuleDirectory (path to .em files) IncludeDirectory (path to parent dir of non-packaged includes) PolScriptRoot (path to non-packaged scripts) PackageRoot (path to package root) [PackageRoot...] [GenerateListing (0/1 {default 0})] [GenerateDebugInfo (0/1 {default 0})] [GenerateDebugTextInfo (0/1 {default 0})] [DisplayWarnings (0/1 {default 0})] //same as -w flag [CompileAspPages (0/1 {default 0})] //same as -a flag [OnlyCompileUpdatedScripts (0/1 {default 0})] //same as -u flag [GenerateDependencyInfo (0/1 {default 0})] //Generate .dep files whether or not updating [DisplayUpToDateScripts (0/1 {default 0})] //Display the "xxx/script.ecl is up-to-date" message, or not. [AutoCompileByDefault (0/1 {default 0})] //If set, and you don't pass any script names or -r or -A, //will perform an auto compile. [UpdateOnlyOnAutoCompile (0/1 {default 0})] //If set, autocompile will only update modified scripts. [DisplaySummary (0/1 {default 0})] //Displays overall totals after compilation, unless compilation //aborted due to a compile error. [OptimizeObjectMembers (0/1 {default 1})] //-m flag will set it to 0 [ErrorOnWarning (0/1 {default 0})] //same as -y flag [ThreadedCompilation (0/1 {default 0})] //uses multiple thread to speed up compilation [ParanoiaWarnings (0/1 {default 0})] //will complain about {} syntax | |
Explanation | |
The 'generate' properties allow default behavior for generating listing or debug files. | |
If not found, ecompile will try to locate module and include directories from the system environment variables ECOMPILE_PATH_EM and ECOMPILE_PATH_INC. | |
use ECOMPILE_CFG_PATH environment variable to find ecompile.cfg. (note that normally it tries to look where the executable is. Some shells don't always pass this, particularly if you're using batch files or shell scripts - try putting the full path to ecompile in your batch file) | |
Using this file allows 'packaged includes' because now ecompile knows about the path to packages, allowing it to find include files using the normal package descriptor format ':pkgname:includename:' |
equip.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core, on behalf of UO::EquipFromTemplate | |
Purpose | |
Defines default outfit templates, usually for NPCs, using EquipFromTemplate(character,templatename). | |
Structure | |
Equipment (templatename) { [Armor (item name or objtype) [(color)]] [Weapon (item name or objtype) [(color)]] [Equip (item name or objtype) [(color)]] } [Equipment...] | |
Explanation | |
Note 'Armor', 'Weapon', and 'Equip' are all equvilent, they no longer hold any seperate meaning. | |
Careful with comment lines in this file, they might cause problems. |
extobj.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | no |
Required/Used by | |
Core | |
Purpose | |
Defines objtypes for internal objects. If the file 'extobj.local.cfg' exists, the entries will be used in that file instead (to keep changes from being destroyed if a new extobj.cfg is installed from, say, the official distribution) | |
Structure | |
[Tillerman (int objtype {default 0x1F010})] [Port_Plank (int objtype {default 0x1F011})] [Starboard_Plank (int objtype {default 0x1F012})] [Hold (int objtype {default 0x1F013})] [Rope (int objtype {default 0x1F014})] [Wheel (int objtype {default 0x1F015})] [Hull (int objtype {default 0x1F016})] [Tiller (int objtype {default 0x1F017})] [Rudder (int objtype {default 0x1F018})] [Sails (int objtype {default 0x1F019})] [Storage (int objtype {default 0x1F01A})] [Waponslot (int objtype {default 0x1F01B})] [Wrestling (int objtype {default 0x1F020})] [Mount (int objtype {default 0x1F021})] [Shield (int objtype {default 0x1F022})] [Secure_Trade_Container (int objtype {default 0x1FF01})] [Wornitems_Container (int objtype {default 0x1FF02})] | |
Explanation | |
Note: Subtract 0x10000 for quick POL098 backward compatibility if you don't use HSA expansion. |
fileaccess.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
per-package file.em access | |
Purpose | |
Specifies what packages have file read/write/append access. | |
Structure | |
FileAccess { [Package (string package name, or *)]... [Directory (string directory name in pkg syntax, or *)]... [Extension (string file extension name, or *)]... [AllowRead (0/1 {default 0})] [AllowWrite (0/1 {default 0})] [AllowAppend (0/1 {default 0})] [AllowRemote (0/1 {default 0})] } | |
Explanation | |
'*' above means it applies to all packages. | |
AllowRemote means the package has access to other files, not just files in its package directory. | |
Package matches the string name in a pkg.cfg. You can define multiple Package properties. | |
Directory in package syntax, can be defined multiple times. Example ::config means root folder config, :mypkg:test means subfolder test of mypkg. Limits the access to given directory and its subfolders. | |
Extension examples are '.cfg', '.htm', etc. You can define multiple Extension properties. | |
This config is reloadable on-demand. Use ReloadConfiguration() (polsys.em) or SIGHUP under linux. |
itemdesc.cfg | |
---|---|
Location: | /config and/or any package |
Number Allowed | any |
Required to Start? | Yes |
Required/Used by | |
Core | |
CreateItem functions | |
Purpose | |
Defines Item descriptions, to be assigned to individual items on creation. Note each UObject class expects different properties to be present, so each will be listed below. An actual itemdesc.cfg file would not look exactly like this. Class Name must be one of: ITEM CONTAINER SPELLBOOK DOOR HOUSE BOAT MAP WEAPON ARMOR. | |
Structure | |
(Class Name) (integer unique 'objtype') { (PropertyName) (value) [PropertyName...] } Item (objtype) { Name (string unique object name) [Name...] Graphic (int tile number) [Color (int color {default 0})] [Facing (int facing {default 0})] [Desc (string description {default empty})] [Tooltip (string tooltip {default empty})] [WalkOnScript (string scriptname)] [Script (string scriptname)] [EquipScript (string scriptname)] [UnequipScript (string scriptname)] [ControlScript (string scriptname)] [CreateScript (string scriptname)] [DestroyScript (string scriptname)] [MethodScript (string scriptname)] [RequiresAttention (0/1 {default 1})] [Lockable (0/1 {default 0})] [VendorSellsFor (int gold {default 0})] [VendorBuysFor (int gold {default 0})] [DecayTime (int minutes {default servspecopt.cfg option})] [SaveOnExit (0/1 {default 1})] [Movable (0/1)] [DoubleClickRange (int range {default servspecopt.cfg option})] [UseRequiresLOS (0/1 {default 1})] [GhostsCanUse (0/1 {default 0})] [CanUseWhileFrozen (0/1 {default 0})] [CanUseWhileParalyzed (0/1 {default 0})] [Newbie (0/1 {default 0})] [Insured (0/1 {default 0})] [Invisible (0/1 {default 0})] [DecaysOnMultis (0/1 {default 0})] [BlocksCastingIfInHand (0/1 {default 0})] [StrRequired (int strength {default 0})] [MaxHP (int max {default 0})] [Weight (int weight {default tiledata value})] [OldObjtype (int old objtype)]... [StackingIgnoresCProps (propname1) [(propname2)]... ] [Resource (string resource name) (int amount)] [Resource...] [FireResist (int/(die-string value))] [ColdResist (int/(die-string value))] [EnergyResist (int/(die-string value))] [PoisonResist (int/(die-string value))] [PhysicalResist (int/(die-string value))] [FireDamage (int/(die-string value))] [ColdDamage (int/(die-string value))] [EnergyDamage (int/(die-string value))] [PoisonDamage (int/(die-string value))] [PhysicalDamage (int/(die-string value))] [StackLimit (int {default 60000})] [NoDrop (0/1 {default 0})] [CProp (string name, string value, will set a CProp on the item at creation)] [Cprop (...)] } Container (objtype) { {everything Item can have, plus: } Gump (int gump graphic) MinX (int gump pixel coordinate) MaxX (int gump pixel coordinate) MinY (int gump pixel coordinate) MaxY (int gump pixel coordinate) [MaxWeight (int weight {default to servspecopt.cfg})] [MaxItems (int number {default to servspecopt.cfg})] [MaxSlots (int 1-255 {default to servspecopt.cfg})] [NoDropException (0/1 {default 0})] [CanInsertScript (string scriptname)] [OnInsertScript (string scriptname)] [CanRemoveScript (string scriptname)] [OnRemoveScript (string scriptname)] } Spellbook (objtype) { {everything Container can have, plus: } SpellType (string {"Magic", "Paladin", "Necro", "Bushido", "Ninjitsu" or "SpellWeaving"}) } Door (objtype) { {everything Item can have, plus: } OpenGraphic (int tile number, graphic when door is opened) XMod (int x modification when door toggled) YMod (int y modification when door toggled) } House (objtype) { {everything Item can have, plus: } MultiID (int multiID number for this house) } Boat (objtype) { {everything Item can have, plus: } MultiID (int multiID number for this house) } Map (objtype) { {everything Item can have, plus: } Editable (0/1 {default 1})] } Weapon (objtype) { {everything Item can have, plus: } Speed (int weapon attack speed) [Delay (int weapon delay in ms {default 0})] Damage (die-string value) Attribute (string attribute name for skill this weapon requires) [Anim (int animation ID number for attack {default 0x9})] [MountedAnim (int animationID on mount {defaults to value in animxlate.cfg})] [HitSound (int soundID)] [MissSound (int soundID)] [HitScript (string script name)] MaxHP (int max) [Projectile (0/1 {default 0})] [ProjectileType (int objtype of projectile)] [ProjectileAnim (int tile number of animation)] [ProjectileSound (int soundID for projectile shoot)] [TwoHanded (0/1 {default 0})] [MinRange (int minimum range to attack {default 2 if projectile weapon, 0 else})] [MaxRange (int maximum range to attack {default 20 if projectile weapon, 1 else})] } Armor (objtype) { {everything Item can have, plus: } AR (int armor rating) MaxHP (int max) [OnHitScript (string script name)] [Coverage (string armor zone name {defaults to layer number zone})] [Coverage...] } ...and lots of any of these in the file... | |
Explanation | |
Note: if objtype < 0x4000, the 'graphic' property is not required, it is assumed objtype=graphic in this case. | |
Valid ranges for custom items are 0x5000-0xEFFF (0xF000-0xFFFF reserved by core) | |
Properties having to do with equipping an item is only meaningful if the item is actualy equippable (determined by the graphic number's tiledata flags). | |
Item Create, Destroy, and Control scripts are in pkg format or in scripts/control. Method scripts must be packaged. | |
Container scripts are in pkg format, or in scripts/control | |
RequiresAttention 1 causes container gumps to close when you move, or to unhide you if the item is used. | |
StackingIgnoresCProps is a space-delimited list of case-sensative CProp names that are ignored when stacking 2 of this item objtype. See also stacking.cfg for a global list. | |
Spellbook: Recognized scroll objects are: Magic: 0x1F2D - 0x1F6C, Necro 0x2260 - 0x226F, Paladin: 0x2270 - 0x227C, Bushido: 0x238D - 0x2392, Ninjitsu: 0x23A1 - 0x23A8, SpellWeaving: 0x2D51 - 0x2D60. The list of spellids for spells.cfg is now as follows: Magery = 1+, Necro = 101+, Paladin = 201+, Bushido = 401+, Ninjitsu = 501+, SpellWeaving = 601+. Sorry this is hardcoded :P | |
Weapon: If Delay != 0 Core will use it to calculate Weapon speed. Speed Entry is optional ONLY if Delay is populated. | |
Related Files | |
spells.cfg | |
stacking.cfg |
justice.cfg | |
---|---|
Location: | /regions only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines the justice regions (protected by guards). See also regions.cfg. | |
Structure | |
Region (region name) { Range (x-west) (y-north) (x-east) (y-south) [Realm (string realmname {default "britannia"})] [Guarded (0/1 {default 0})] [EnterText (string message)] [LeaveText (string message)] [EnterScript (string script)] [LeaveScript (string script)] } [Region...] | |
Explanation | |
Note that if "EnterText" and "LeaveText" of the region you are leaving and the region you are entering are the same, no text will be sent. | |
Important: regions only override regions found earlier in the file. So the first region should cover the entire map, and further regions override portions of the world. | |
This file is preferred over regions.cfg for the above properties. | |
IMPORTANT: Regions are limited to POL's internal 4x4 tile zones and will internally expand to fill all of these zones the Range is contained in. | |
Related Files | |
regions.cfg |
light.cfg | |
---|---|
Location: | /regions only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines the light regions (light levels sent to clients). See also regions.cfg. | |
Structure | |
Region (region name) { Range (x-west) (y-north) (x-east) (y-south) [Realm (string realmname {default "britannia"})] [Light (int light level {default 0}] } [Region...] | |
Explanation | |
Important: regions only override regions found earlier in the file. So the first region should cover the entire map, and further regions override portions of the world. | |
This file is preferred over regions.cfg for the above properties. | |
IMPORTANT: Regions are limited to POL's internal 4x4 tile zones and will internally expand to fill all of these zones the Range is contained in. | |
Related Files | |
regions.cfg |
menus.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | Yes |
Required/Used by | |
Core | |
SelectMenuItem2() | |
Purpose | |
Configures old-style static menus for client selection (i.e. tailoring, fletching, etc.) | |
Structure | |
ItemMenu { Name (string unique name) Title (string title to show on menu) Entry (objtype number to show) (string description) [Entry...] [SubMenu (string menuname) (objtype number to show) (Description Of SubMenu)] [SubMenu...] } [ItemMenu...] | |
Explanation | |
The 'Name' property must exactly match with the 'SubMenu' menuname for the submenu element. | |
Static menus in this file are used with UO::SelectMenuItem2() |
movecost.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines the stamina cost to move based on percent maximum weight carried. | |
Structure | |
MovementCost { [(integer percent max carried) (real multiplier for movement)]... [Over (real multiplier for movement if over maximum)] } -or- Walking { {same as above} } Running { {same as above} } [Walking_Mounted { {same as above} }] [Running_Mounted { {same as above} }] | |
Explanation | |
You can specify a number of percentage capacity lines, and values in between will be linearly interpolated. 'Over' defines cost if maximum carrying capacity was exceeded. | |
Maximum carrying capacity is determined as ((Strength * 7) / 2) + 40. The multiplier used will be the current weight/max capacity. This multiplier is multiplied by 8 to find the amount of stamina 'hundreths' to consume per move. So a multiplier of 10 will consume 0.8 of a stamina 'point' per move. | |
The 'MovementCost' section overrides both the 'Walking' and 'Running' sections if present. If you don't declare Mounted sections, Core will use unmounted values. | |
Used only of MovementUsesStamina=1 in servspecopt[.local].cfg | |
Related Files | |
servspecopt.cfg |
multis.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | Yes |
Required/Used by | |
Core | |
Purpose | |
This file is usually automatically generated by uoconvert. Maps the UO 'MultiID' number with the graphic number for the multi. | |
Structure | |
House (int multid) { [static (objtype) (xoffset) (yoffset) (zoffset)] [dynamic (objtype) (xoffset) (yoffset) (zoffset)] } [House...] Boat (int multid) { [static (objtype) (xoffset) (yoffset) (zoffset)] [dynamic (objtype) (xoffset) (yoffset) (zoffset)] } [Boat...] Stairs (int multid) { [static (objtype) (xoffset) (yoffset) (zoffset)] [dynamic (objtype) (xoffset) (yoffset) (zoffset)] } [Stairs...] | |
Explanation | |
Use InsideUO to get the MultiIDs. Multi Graphics start at 0x4000 and are equal to 0x4000 + MultiID. |
music.cfg | |
---|---|
Location: | /regions only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines the music regions. See also regions.cfg. | |
Structure | |
Region (region name) { Range (x-west) (y-north) (x-east) (y-south) [Realm (string realmname {default "britannia"})] [Midi (int music number)] } [Region...] | |
Explanation | |
Important: regions only override regions found earlier in the file. So the first region should cover the entire map, and further regions override portions of the world. | |
This file is preferred over regions.cfg for the above properties. | |
IMPORTANT: Regions are limited to POL's internal 4x4 tile zones and will internally expand to fill all of these zones the Range is contained in. | |
Related Files | |
regions.cfg |
nocast.cfg | |
---|---|
Location: | /regions only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines the "no spell casting allowed" regions. See also regions.cfg. | |
Structure | |
Region (region name) { Range (x-west) (y-north) (x-east) (y-south) [Realm (string realmname {default "britannia"})] [Nocast (0/1 {default 0})] } [Region...] | |
Explanation | |
Important: regions only override regions found earlier in the file. So the first region should cover the entire map, and further regions override portions of the world. | |
This file is preferred over regions.cfg for the above properties. | |
IMPORTANT: Regions are limited to POL's internal 4x4 tile zones and will internally expand to fill all of these zones the Range is contained in. | |
Related Files | |
regions.cfg |
npcdesc.cfg | |
---|---|
Location: | /config and/or any package |
Number Allowed | at least 1 in /config, can be packaged. |
Required to Start? | No |
Required/Used by | |
Core | |
CreateNpcFromTemplate | |
Purpose | |
Configures NPC Templates for creating new NPCs and assigning properties to them. | |
Structure | |
NpcTemplate (string unique templatename) { Name (string paperdoll name) ObjType (integer body model type) Script (string AI script) Gender (0=male 1=female) TrueColor (int original body skin color) Color (int current body skin color) AR (die-string natural armor rating) [FireResist] (int/die-string)] [ColdResist] (int/die-string)] [EnergyResist] (int/die-string)] [PoisonResist] (int/die-string)] [PhysicalResist] (int/die-string)] Alignment ('good' 'neutral' or 'evil) [(VitalName) (die-string value)] [VitalName...] [(AttributeName) (die-string value)] [AttributeName...] // Intrinsic weapon creation AttackSpeed (int intrinsic weapon speed, no weapon will be created if missing) [AttackDelay (int intrinsic weapon delay in ms {default 0})] AttackDamage (die-string damage for intrinsic weapon) AttackAttribute (string attribute name used for intrinsic weapon) [AttackHitSound (int sound ID for intrinsic weapon {default 0})] [AttackMissSound (int sound ID for intrinsic weapon {default 0})] [AttackHitScript (string script for intrinsic weapon hit)] [AttackMinRange (int intrinsic weapon minimum range {default 0})] [AttackMaxRange (int intrinsic weapon maximum range {default 0})] [AttackAnimation (int animation ID {default 0 (wrestling)})] [AttackProjectile (0/1 if defined, sets the intrinsic weapon as a projectile weapon] [AttackProjectileAnim (int tile number of animation)] [AttackProjectileType (int objtype of projectile)] [AttackProjectileSound (int soundID for projectile shoot)] [AttackCProp (string name, string value, will set a CProp on the intrinsicn weapon)] [AttackCprop (...)] // Intrinsic shield creation Shield (int intrinsic shield armor, no shield will be created if missing) [ShieldOnHitScript (string script for intrinsic shield hit)] [ShieldCProp (string name, string value, will set a CProp on the intrinsicn shield)] [ShieldCprop (...)] [FireDamage] (int/(die-string value))] [ColdDamage] (int/(die-string value))] [EnergyDamage] (int/(die-string value))] [PoisonDamage] (int/(die-string value))] [PhysicalDamage] (int/(die-string value))] [MaxHp (int maximum hitpoints for intrinsic weapon {default 1}] [MoveMode (movemode string {default 'L'})] [Privs (string privilege) [(more privs)]...] [Settings (string priv set 'on') [(more privs)]...] [SpeechColor (int speech color {default 0x3B2})] [SpeechFont (int speech color {default 3})] [UseAdjustments (0/1 {default 1})] [RunSpeed (int 0-250 {default dexterity})] [SaveOnExit (0/1 {default 1})] [MethodScript (string scriptname)] [NoDropException (0/1 {default 0})] [CProp (string name, string value, will set a CProp on the npc at creation)] [Cprop (...)] } [NpcTemplate...] | |
Explanation | |
Movemode string is 'L' for land 'S' for sea, and 'A' for air. I.e. 'LS' would be good for a water elemental. | |
An 'intrinsic' weapon is used if the NPC does not have a weapon item equipped. It represents (usually), the Wrestling 'weapon' for the NPC. You can define sounds, damage, animation etc. | |
Vital and Attribute names can use the aliases defined in attributes.cfg and vitals.cfg, i.e. 'STR' instead of 'Strength'. A Die-string may be used for the value of any of these. | |
Privs and settings can be like 'invul losany' and any more seperated by spaces. Unless they also appear in 'Settings', the privileges are not active. | |
UseAdjustments 1 means the NPC will adjust its facing while moving to try to avoid small obsticles. If 0, the NPC will not move if it cannot move forward, and the move function will return 0. | |
RunSpeed is only useful from 0-250, the higher the number, the shorter delay between moves. | |
SpeechColor and Font are only used if NPC::Say() is used. | |
Alignment determines NPC's name color and their participation in the reputation system. | |
Of course, you may define other config properties and cprops in this file that are not used by the core. npcdesc.cfg may be accessed with the normal Config file access functions (ReadConfigFile, etc). Note CProps in this file will be assigned to each NPC created with that template. This takes extra memory than if you look up properties using the config file access functions. | |
If you have npcdes.cfg in a package, the NPC's template name becomes :packagename:templatename | |
If AttackDelay != 0 Core will use it to calculate Weapon speed. | |
Related Files | |
resource.cfg |
party.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines general settings and hooks for the party system. | |
Structure | |
General { //How many chars are allowed in a Party (normal clients only have 10 slots) [MaxPartyMembers int (default 10)] //Newer Clients (>=3.0.6e) does not automatically change "/# " //to private msg (they use "/t #") //set to true any public msg will be checked for "# " (0-9 0=slot 10) [TreatNoAsPrivate (1/0) (default 0)] //How long is an invite valid befor automatic decline //set to 0 disables the timeout [DeclineTimeout int seconds (default 10)] //Prefix for a private Msg (e.g. P:) [PrivateMsgPrefix string (default "")] //Member gets removed on logoff //if partyleader logoffs the next member becomes the leader [RemoveMemberOnLogoff (1/0) (default 0)] //rejoins party member on logon //RejoinPartyOnLogon is only used if RemoveMemberOnLogoff is true [RejoinPartyOnLogon (1/0) (default 0)] } HookList { // CanAddToParty(leader,member) return check true/false // called when a leader invites someone CanAddToParty (string exported_func_name) // OnAddToParty(who) return check none // called when a member is added to a party OnAddToParty(string exported_func_name) // CanRemoveMember(leader,member) return check true/false // called when leader wants to remove member CanRemoveMember (string exported_func_name) // CanLeaveParty (member) return check true/false // called when member wants to leave the party CanLeaveParty (string exported_func_name) // OnLeaveParty(who,fromwho) return check none // called when member leaves the party OnLeaveParty(string exported_func_name) // OnPublicChat(member,uctext) return check none // called when a member sends a PartyMsg e.g. for logging OnPublicChat (string exported_func_name) // OnPrivateChat(member,tomember,uctext) return check none // called when a member sends a PrivateMsg e.g. for logging OnPrivateChat (string exported_func_name) // OnDisband(partyref) return check none // called when a Party is about to be disbanded OnDisband (string exported_func_name) // ChangePublicChat(member,uctext) return new uctext/true/false // called when a member sends a PartyMsg return value is the new uctextarray, // or true for no change, or false to block the msg ChangePublicChat (string exported_func_name) // ChangePrivateChat(member,tomember,uctext) return new uctext/true/false // called when a member sends a PrivateMsg return value is the new uctextarray, // or true for no change, or false to block the msg ChangePrivateChat (string exported_func_name) // OnPartyCreate(party) return check none // called when a party is created OnPartyCreate (string exported_func_name) // OnDecline(who) return check none // called when a Char declines a partyinvite OnDecline (string exported_func_name) // OnLootPermChange(who) return check none // called when a Char changes the LootPermission OnLootPermChange (string exported_func_name) } | |
Explanation | |
HookList section is only needed if you wish to define party hooks. |
pkg.cfg | |
---|---|
Location: | Any package |
Number Allowed | 1 per package |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Package descriptor file. One is required for every package. It is read only on POL startup. | |
Structure | |
Enabled (0/1) Name (string package name) Requires (string package name) [(int version)] ... Replaces (string package name) ... Conflicts (string package name) ... [Version (string version number {default 0})] [CoreRequired (int core version without leading 0, or full version string)] [ProvidesSystemHomePage (0/1)] [Maintainer (string name)] [Email (string email)] | |
Explanation | |
Maintainer and Email aren't read by the core, but you should still include them in your own packages. | |
Requires and Replaces refer to other package names that relate to this packet. If a package is defined that is 'required' and is not found, or is not a new enough version, an error will be printed. | |
Version is normal version syntax, i.e 1.0, 2.3, 0.1.1.2, etc. | |
CoreVersion is the POL version that is required for the package to function. Values should be formed like 94 or 95, not 094 or 095. | |
Enabled 0 causes none of the scripts or configs in this package to be read | |
CoreRequired can take a full version string like "POL095-2003-02-01" | |
ProvidesSystemHomePage lets a SINGLE pkg to act as directory the root for the web server |
pkgroots.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines the local file system paths to the root directories for packages. /pol/pkg is automatically checked. | |
Structure | |
PackageRoot { dir (string fully qualified path) [dir...] } | |
Explanation | |
If my path was D:\beer\morepol, then subdirectories of that path would be searched for packages along with /pol/pkg |
pol.cfg | |
---|---|
Location: | root directory only |
Number Allowed | 1 |
Required to Start? | Yes |
Required/Used by | |
Core | |
Purpose | |
Configures many critical options for the POL server. | |
Structure | |
UoDataFileRoot=(path to UO MUL files) WorldDataPath=(path to POL Data files {default data/}) RealmDataPath=(path to POL Realm files {default realm/}) PidFilePath=(where POL will write its .pid file {default ./}) [ListenPort=(integer TCP port)] [ClientEncryptionVersion=(string {default none})] [CountResourceTiles=(1/0 {default 1}] [Multithread=(1/0 {default 1})] [WebServer=(1/0 {default 0})] [WebServerPort=(int port {default 8080})] [IgnoreLoadErrors=(1/0 {default 0})] [DebugPort=(int port {default 0})] [AccountDataSave=(1/0 {default -1})] [Verbose=(1/0 {default 0})] [LogLevel=(int level {default 0})] [SelectTimeout=(int {default 10})] [WatchRpm=(1/0 {default 0})] [WatchSysLoad=(1/0 {default 0})] [WatchMapCache=(1/0 {default 0})] [LogSysLoad=(1/0 {default 0})] [InhibitSaves=(1/0 {default 0})] [LogScriptCycles=(1/0 {default 0})] [ProfileCProps=(1/0 {default 0})] [WebServerLocalOnly=(1/0 {default 1})] [WebServerDebug=(1/0 {default 0})] [WebServerPassword=(string {default empty})] [CacheInteractiveScripts=(1/0 {default 1})] [ShowSpeechColors=(1/0 {default 0})] [RequireSpellbooks=(1/0 {default 1})] [EnableSecureTrading=(1/0 {default 0})] [RunawayScriptThreshold=(long {default 5000})] [InactivityWarningTimeout=(int minutes {default 4})] [InactivityDisconnectTimeout=(int minutes {default 5})] [MinCmdlevelToLogin=(int level {default 0})] [MinCmdLvlToIgnoreInactivity=(int level {default 1})] [MaxCallDepth=(int depth {default 100})] [ThreadStacktracesWhenStuck=(1/0 {default 0})] [DumpStackOnAssertionFailure=(1/0 {default 0})] [DisplayUnknownPackets=(1/0 {default 0})] [ExpLosChecksMap=(1/0 {default 1})] [EnableDebugLog=(1/0 {default 0})] [DebugPassword=(string {default empty})] [DebugLocalOnly=(1/0 {default 1})] [DebugLevel=(int level {default 0})] [ReportRunToCompletionScripts=(1/0 {default 1})] [ReportCriticalScripts=(1/0 {default 1})] [ReportMissingConfigs=(1/0 {default 1})] [MaximumClients=(int {default 300})] [MaximumClientsBypassCmdLevel=(int cmdlevel {default 1})] [AllowMultiClientsPerAccount=(1/0 {default 0})] [CharacterSlots=(int {default 5})] [MiniDumpType=(string small/large/variable {default variable})] [RetainCleartextPasswords=(1/0 {default 0})] [AssertionFailureAction=(abort/continue/shutdown/shutdown-nosave/shutdown-save-full/shutdown-save-incremental {default abort})] [ShutdownSaveType=(full/incremental {default full})] [TimestampEveryLine=(1/0 {default 0})] [MaxTileID=(0x3FFF/0x7FFF {default 0x3FFF})] [MaxObjtype=(0x20000/0xFFFFFFFF {default 0x20000})] [DiscardOldEvents=(1/0 {default 0})] [UseSingleThreadLogin=(1/0 {default 0})] [DisableNagle=(1/0 {default 0})] [ShowRealmInfo=(1/0 {default 0})] [EnforceMountObjtype=(1/0 {default 0})] [SingleThreadDecay=(1/0 {default 0})] [ThreadDecayStatistics=(1/0 {default 0})] [ReportCrashsAutomatically=(1/0 {default 0})] [ReportAdminEmail=(string email {default ""})] [ReportServer=(string servername {default "polserver.com"})] [ReportURL=(string url {default "/pol/report_program_abort.php"})] | |
Explanation | |
Your own pol.cfg should give descriptions on most of these. I'll describe them here if people want me to. | |
Clarification: for ClientEncryptionVersion, the allowable values are 'major.minor.build', '2.0.0x', 'ignition', 'uorice', and 'none'. Here, 'ignition', 'uorice', and 'none' all mean 'no encryption'. | |
Due to autocalculation 'major.minor.build' means setting a listener for client 7.0.4.1 '7.0.4' (no patch) | |
ListenPort is now optional, use uoclient.cfg Listener sections to define listening ports. | |
AssertionFailureAction options: abort: (like old behavior) aborts immediately, without saving data. continue: allows execution to continue. shutdown: attempts graceful shutdown. shutdown-nosave: attempts graceful shutdown, without saving data. If the assertion occurred during execution of a script, either 'shutdown', 'shutdown-nosave', or 'continue' will abort that script, displaying the script name and PC. | |
Hint: LogLevel can be used to debug issues at startup of POL and various other places (unloadall for example). By setting this higher than 1, up to 11 (just sounds good), it will force printing of better information to help you find out problems during Loading and such. Setting it for example, above 0, core will start spitting out "Checkpoint" data during startup to say what it is about to load/process. Such as the configuration, load realms, load multis, etc etc. | |
DiscardOldEvents: if set instead of discarding new event if queue is full it discards oldest event and adds the new event | |
AccountDataSave: -1 : old behaviour, saves accounts.txt immediately after an account change, 0 : saves only during worldsave (if needed), >0 : saves every X seconds and during worldsave (if needed) | |
UseSingleThreadLogin: if set all prelogin clients are handled inside the listener thread and not inside an extra thread this will reduce the amount of thread creates and destroys | |
DisableNagle: disables Nagle's algorithm. In theory, latency should improve if DisableNagle=1. | |
ShowRealmInfo: will report every once in a while the number of items, mobiles and multis per realm. | |
EnforceMountObjtype: will enforce that only items with the mount objtype (as defined in extobj.cfg) can be mounted. | |
AllowMultiClientsPerAccount: when true, will allow multiple characters from the same account to be logged in at the same time | |
ProfileCProps: when true, will record CProp usage statistics. Helps detecting unused CProps, at the cost of some RAM and an unnoticeable performance impact. It should be enabled from startup, or the core will be unable to detect the type of some CProps. |
regions.cfg | |
---|---|
Location: | /regions only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines the regions in the world and various settings on each. See Explanation about splitting up this file. | |
Structure | |
Region (region name) { Range (x-west) (y-north) (x-east) (y-south) [Realm (string realmname {default "britannia"})] [Guarded (0/1 {default 0})] [EnterText (string message)] [LeaveText (string message)] [EnterScript (string script)] [LeaveScript (string script)] [Midi (int music number)] [NoCast (0/1 {default 0})] [NoCombat (0/1 {default 0})] [LightLevel (int light level {default 0}] [WeatherType (int type {default 0})] [WeatherSeverity (int severity {default 0})] [WeatherAux (int {default 0})] [LightOverride (int light level override {default -1})] } [Region...] | |
Explanation | |
Important: regions only override regions found earlier in the file. So the first region should cover the entire map, and further regions override portions of the world. | |
Note that if "EnterText" and "LeaveText" of the region you are leaving and the region you are entering are the same, no text will be sent. | |
'Guarded', 'EnterText', and 'LeaveText' are for 'justice' regions, and may be split into /regions/justice.cfg. guard.cfg will be the prefered location for these properties | |
'Midi' are for 'music' regions, and may be split into /regions/music.cfg, the prefered location for these regions. | |
'NoCast' are for 'nocast' regions and may be split into /regions/nocast.cfg, the prefered location for these regions. | |
'NoCombat' regions will not allow the Clicking of a mobile to select as a new opponent if they are in this region. It will also reset opponent data for mob if one enters this region. This is a PvP specific addon. It does NOT check for npcs, this will have to be done via packethooks. When Entering a NoCombat region, while already in combat, if YOU are the attacker, it will reset your fight. If you are the one being attacked, it will reset the fight with the first "opponent" you have listed. | |
'LightLevel' are for 'light' regions and may be split into /regions/light.cfg, the prefered location for these regions. | |
'WeatherType', 'WeatherSeverity', 'WeatherAux', and 'LightOverride' are for 'weather' regions and may be split into /regions/weather.cfg, the prefered location for these regions. | |
IMPORTANT: Regions are limited to POL's internal 4x4 tile zones and will internally expand to fill all of these zones the Range is contained in. |
repsys.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | Yes |
Required/Used by | |
Core | |
Purpose | |
Defines coloring and timeouts for the reputation system. | |
Structure | |
NameColoring { Murderer (int color 38 is red) Criminal (int color 905 is grey) Attackable (int color 905 is grey) Innocent (int color 90 is blue) Invulnerable (int color) GuildAlly (int color 68 is green) GuildEnemy (int color 44 is something) } General { CriminalFlagInterval (int seconds) AggressorFlagTimeout (int seconds) PartyHelpFullCountsAsCriminal (1/0 default 0) } HookList { NameColor (string exported_func_name) HighLightColor (string exported_func_name) OnAttack (string exported_func_name) OnDamage (string exported_func_name) OnHelp (string exported_func_name) } | |
Explanation | |
NameColoring defines the single-click name colors for mobiles with various reputation states. | |
Repsys coloring for Invulnerable names will only occur when InvulTag in ServSpecOpt.cfg is set to 2. | |
HookList section is only needed if you wish to define repsys hooks. Currently name (single click) and highlight (health bar) colors are hookable: exported function NameColor(mobile, visible_to) // must return an Integer, the new color to be used, return -1 to let the core decide exported function HighLightColor(mobile, visible_to) // must return an Integer, the hightlight to be used (see below), return -1 to let the core decide exported function OnAttack(attacker, defender) // run when a mobile attacks another, return 1 to prevent POL from doing standard repsys actions exported function OnDamage(attacker, defender) // run when a mobile damages another, return 1 to prevent POL from doing standard repsys actions exported function OnHelp(helper, helped) // run when a mobile helps another, return 1 to prevent POL from doing standard repsys actions HighLightColor note: The client seems to only accept the following numbers 0 - None, 1 - Innocent, 2 - Friend, 3 - Attackable, 4 - Criminal, 5 - Enemy, 6 - Murderer, 7 - Invulnerable 8 - Unknown (blue gump, pure black mobile) | |
HighLightColor function should be made as fast as possible, as it is called many times. | |
PartyHelpFullCountsAsCriminal defines if HelpFull action counts as criminal act on murderers/criminals if in same party | |
Related Files | |
servspecopt.cfg |
resource.cfg | |
---|---|
Location: | /regions only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines the resource types in the world. Other .cfg files are then read for specific resource configurations. | |
Structure | |
ResourceSystem { ResourceType (string resource type) [ResourceType...] } | |
Explanation | |
Important: regions only override regions found earlier in the file. So the first region should cover the entire map, and further regions override portions of the world. | |
If the resource type is 'ore', then 'ore.cfg' in the same directory will be read for resource region configurations for the ore resource. | |
Most of the configuration is done in these other files, so please see resourcetype.cfg (note not an actual file, just denotes files like ore.cfg) | |
Related Files | |
resourcetype.cfg |
resourcetype.cfg | |
---|---|
Location: | /regions only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines the configuration for the resource filename. Note: 'resourcetype.cfg' does not exist, this only denotes files like 'ore.cfg' or 'wood.cfg'. See resource.cfg for how to define these resource types. | |
Structure | |
Global { InitialUnits (long number of resource units world has to start) [LandTile (int landtile ID)]... [ObjType (int arttile ID)]... } Region (string regionname) { Range (x-west) (y-north) (x-east) (y-south) UnitsPerArea (int resource units per tile) SecondsPerRegrow (int seconds delay between regrows) Capacity (int unit capacity for this region) } [Region...] | |
Explanation | |
Important: regions only override regions found earlier in the file. So the first region should cover the entire map, and further regions override portions of the world. | |
Landtiles are the 'map' tiles, and 'ObjType' is for static art tiles. These numbers are used to know what tiles grow this type of resource. I.e. a static tree type for wood. | |
Example: this file is for wood resources, and UnitsPerArea is 15. This means I can get a maximum of 15 wood from a tree until the resources 'regrow'. I could define another region that has very plentiful, or fast growing trees and adjust the UnitsPerArea and SecondsPerRegrow accordingly. | |
Related Files | |
resource.cfg |
servers.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | Yes |
Required/Used by | |
Core | |
Purpose | |
Defines the Game Servers the login server will forward clients to. Normally the game server and login server are the same machine on a POL shard, but you could run a minimal POL server to act as a login server for one or more game servers. | |
Structure | |
GameServer { Name (string name of server) IP (string ip address, or --ip-- or --lan--, see below) Port (int TCP port number) [IPMatch (IPaddrr)/(netmask)]... [AcctMatch (string account name)]... } [GameServer...] | |
Explanation | |
IP address must match the address in the clients' login.cfg files. This means if your game server is on a LAN not accessable from the internet (doing port forwarding from a router), you must define this game server IP as your router's internet IP address. | |
--ip-- attempts to find your non-LAN, non-localhost IP address. If you have a multihomed server, this may behave strangely. | |
--lan-- attempts to find you non-routable LAN IP address, if any (i.e. '192.168.*.*' or '10.*.*.*'). | |
Port is the listening port of the Game Server, not the login server (though they may be the same). See ListenPort in pol.cfg | |
Example IPMatch value: 192.168.0.0/255.255.255.0 would prevent anyone with an IP address other than 192.168.0.* from seeing the gameserver. | |
AcctMatch lines have one account name per line, and are those accounts to show the given server to on login to the 'login server'. | |
Related Files | |
movecost.cfg | |
pol.cfg |
servspecopt.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | no |
Required/Used by | |
Core | |
Purpose | |
Defines certain "Server Specific Options" that shard admins can set. If the file 'servspecopt.local.cfg' exists, the entries will be used in that file instead (to keep changes from being destroyed if a new servspecopt.cfg is installed from, say, the official distribution) | |
Structure | |
[AllowSecureTradingInWarMode (0/1)] [DefaultDecayTime (int minutes)] [DefaultDoubleclickRange (int range {default 2})] [DefaultAccessibleRange (int range {default DefaultDoubleclickRange})] [DefaultLightLevel (int level)] [MovementUsesStamina (0/1)] [TotalStatsAtCreation (string see below)] [DefaultContainerMaxItems (int 0-150)] [DefaultContainerMaxWeight (int 0-65535)] [UOFeatureEnable (int flags {default 0})] [MaxPathFindRange (int distance {default 50})] [HiddenTurnsCount (0/1 {default 1})] [ItemColorMask (int mask {default 0xfff})] [DecayItems (0/1 {default 1})] [UseTileFlagPrefix (0/1 {default 1})] [UseWinLFH (0/1 {default 0})] [EventVisibilityCoreChecks (0/1 {default 0})] [DoubleClickWait (int seconds {default 0})] [InvulTag (0/1/2 {default 1})] [StartingGold (int {default 100})] [PrivacyPaperdoll (0/1 {default 0})] [ForceNewObjCachePackets (0/1 {default 0})] [AllowMovingTrade (0/1 {default 0})] [CoreHandledLocks (0/1 {default 0})] [DefaultAttributeCap (int in tenths {default 1000})] [CoreSendsCaps (0/1 {default 0})] [SendStatLocks (0/1 {default 0})] [MaxContainerSlots (int {default 125})] [UseContainerSlots (0/1 {default 0})] [EditServer (0/1 {default 0})] [CarryingCapacityMod (double {default 1.0})] [SpeechRange (int range {default 12})] [WhisperRange (int range {default 2})] [YellRange (int range {default 25})] [CoreSendsSeason (0/1 {default 1})] [CoreHandledTags (int bitfield {default 0xffff})] [SupportFaces (0/1/2 {default 0})] [NewbieStartingEquipment (0/1 {default 1})] [SpeedhackPrevention (0/1 {default 0})] [ScriptedMerchantHandlers (0/1 {default 0})] [HonorUnequipScriptOnDeath (0/1 {default 0})] [SpeedHack_MountRunDelay (int milliseconds {default 80})] [SpeedHack_MountWalkDelay (int milliseconds {default 180})] [SpeedHack_FootRunDelay (int milliseconds {default 180})] [SpeedHack_FootWalkDelay (int milliseconds {default 380})] [SeperateSpeechTokens (0/1 {default 0})] [CoreGuildMessages (0/1 {default 1})] [MobilesBlockNpcMovement (0/1 {default 1})] [DefaultCharacterHeight (1-32 {default 15})] | |
Explanation | |
TotalStatsAtCreation: takes a comma-delimited lists of values and/or ranges (default = '65,80'). Example: TotalStatsAtCreation=65,80,90-95,100-110 | |
MovementUsesStamina: if enabled stamina costs are defined in movecost.cfg | |
DefaultContainerMaxItems: default is 125, DefaultContainerMaxWeight default is 250. itemdesc.cfg "MaxItems" and "MaxWeight" override these defaults. | |
UOFeatureEnable: will be sent as the last DWORD flag in the 0xA9 login message. See 095+ package for values and warnings. Core will block Bit 6 (support up to 6 Chars). To enable AoS stuff set Bit 5 (use 0x20), to enable SE stuff set Bit 7 and 5 (use 0xa0) and to enable ML stuff set Bit 8, 7 and 5 (use 0x1a0). | |
HiddenTurnsCount: will define whether or not turns made while hidden will count as a "move". | |
ItemColorMask: is a bitmask of what colors should be considered valid. It was left a mask instead of given as a range in order to allow specifying certain bits to be on. So, for instance, with the newer clients, a mask of 0x4fff will allow the third bit (value 4) of the most significant nibble to be turned on, but no others in that nibble. Bear in mind, older clients may well crash if you set colors to be outside of the non-default mask of 0xfff. | |
UseTileFlagPrefix: will control Core to prepend "a"/"an" according to tiles.cfg flags to formatted item names. | |
UseWinLFH: will enable usage of Windows XP/2003 low-fragmentation Heap for better memory management. | |
EventVisibilityCoreChecks: You have to do visibility checking by your Scripts if disabled or Core uses the old way. | |
DoubleClickWait: Time that must pass before a player can double click something again. | |
InvulTag: 0 Disables invul tags totally. 1 keeps them as they are now, giving [Invul] tag when single clicked. 2 will work only on 3.x+ clients, and makes the mob's highlight color Yellow with no [Invul] tag when single clicked. Only recommend using 2 if your shard requires a 3.x or higher client! | |
PrivacyPaperdoll: If enabled Paperdoll gives only char name for others. | |
ForceNewObjCachePackets: Forces to only send new ObjectCacheInfos for Tooltips (since 5.0.0) | |
AllowMovingTrade: 0 Disables moving more than 4 tiles away with an open trade window, cancels trading window. | |
CoreHandledLocks: If enabled, core will handle the change of skill locks and stat locks from the client (setting the attribute locks). | |
DefaultAttributeCap: defines which value POL should use as cap for attributes. | |
CoreSendsCaps: makes POL send attribute cap information in the Send Skills (0x3A) packet | |
SendStatLocks: makes POL send stat lock message (Client version > 3) | |
MaxContainerSlots: This will allow setting the internal overall allowed item count for containers. This is introduced for future KR support. | |
UseContainerSlots: check to can add bulk code to ensure not going over max slot capacity of 255 and a container's max slot capacity. | |
EditServer: for bypassing cryptseed packet | |
CarryingCapacityMod: * modifier for mobile max_weight | |
SpeechRange: definies the range of normal speech | |
WhisperRange: definies the range of whispered speech | |
YellRange: definies the range of yelled speech | |
CoreSendsSeason: Determines if the core should send season packet on char creation/logon/reconnect and realm change based on the season entry in realm.cfg | |
CoreHandledTags: bitfield to determine which tags are displayed on singleclick, current used bits are: 0x1 [title_guild] 0x2 [frozen] 0x4 [paralyzed] 0x8 [squelched] 0x10 [deafened] | |
SupportFaces: 0 disables faces support, 1 basic faces support, 2 roleplay faces (sets 0x2000 flag in 0xB9 packet) (KR/SA feature) | |
NewbieStartingEquipment: used to determine if equipped items created during the character creation should be newbied or not | |
SpeedhackPrevention: 1 activates the intern SpeedHackPrevention system | |
ScriptedMerchantHandlers: if enabled, the below change will come into effect:
when a player buys something from a merchant the core will not longer handle taking gold from the player, and moving items to the players pack.
When the event for EVID_MERCHANT_SOLD and EVID_MERCHANT_BOUGHT is sent it will be a struct { type := EVID_MERCHANT_SOLD or EVID_MERCHANT_BOUGHT, source := player buying, shoppinglist := array{ struct.item, struct.amount } } The shopping list items will still be items in the merchant's container. It is up to the script to split the items from the stacks there and move them to the player's pack. It is also up to the script to handle gold checks and consumption. | |
HonorUnequipScriptOnDeath: if enabled, the core will call unequip and unequiptest scripts on death and obey their return value | |
SpeedHack_MountRunDelay: hacks the movement speed, change it at your own risk | |
SpeedHack_MountWalkDelay: hacks the movement speed, change it at your own risk | |
SpeedHack_FootRunDelay: hacks the movement speed, change it at your own risk | |
SpeedHack_FootWalkDelay: hacks the movement speed, change it at your own risk | |
SeperateSpeechTokens:if enabled, RegisterForSpeechEvents() and EnableEvents/DisableEvents will behave differently for uo:EnableEvents/DisableEvents if SeperateSpeechTokens is set you can control which events you get, for NPCs you only get speech with tokens if you set SYSEVENT_TOKEN_SPEECH/SYSEVENT_TOKEN_GHOST_SPEECH and non Token speech with SYSEVENT_SPEECH,SYSEVENT_GHOST_SPEECH for RegisterForSpeechEvents() you get speech with and without Tokens when setting LISTENPT_HEAR_TOKENS and no speech without Tokens setting LISTENPT_NO_SPEECH Note: Token and nonToken Eventtype is still the same (SYSEVENT_SPEECH) | |
CoreGuildMessages: used to determine if core should handle guild and alliance messages | |
MobilesBlockNpcMovement: use to determine if mobiles block the movement of npcs | |
DefaultCharacterHeight: This is the default (and never changed so far) height for Characters and NPCs. Default value is 15. Back in the POL095 days is was 9, so consider 9-15 as your "safe" play range. Anything outside that range could cause weird movement behavior. Even small changes will have a great impact on LOS calculations and, more in general, on the combat system. It is also used to calculate wether a Character can fit under a low passage (e.g. dungeon stairs). Keep in mind a Titan and a Slime will have the same height. | |
Related Files | |
movecost.cfg | |
repsys.cfg |
spells.cfg | |
---|---|
Location: | /config and/or any package |
Number Allowed | any |
Required to Start? | No |
Required/Used by | |
Core | |
SpeakPowerWords() | |
ConsumeReagents() | |
StartSpellEffect() | |
GetSpellDifficulty() | |
Purpose | |
Defines the spells used by the UO Client | |
Structure | |
Spell (int spellid) { SpellID (int spellid) Name (string name) PowerWords (string power words) Script (string script name) Animation (int casting animation ID) [Circle (int Circle number)] [Reagent (string item name)]... [Mana (int manacost)] [Difficulty (int difficulty)] [PointValue (int skillbonus)] [Delay (int cast delay)] } [Spell...] | |
Explanation | |
Script is in current package or searches through /scripts | |
Animation is less or equal to 0x22 | |
If the Circle property is found, Mana,Difficulty,PointValue, and Delay is gathered from circles.cfg. | |
Reagent name corresponds to the "Name" property for the reagent's itemdesc.cfg entry. | |
SpellID: Magery = 1+, Necro = 101+, Paladin = 201+, Bushido = 401+, Ninjitsu = 501+, SpellWeaving = 601+. Sorry this is hardcoded :P | |
Related Files | |
itemdesc.cfg | |
circles.cfg |
stacking.cfg | |
---|---|
Location: | Any Package and/or /config |
Number Allowed | any |
Required to Start? | No |
Required/Used by | |
Core Item Stacking | |
Purpose | |
Specifies CProp names to ignore when stacking two items. | |
Structure | |
Stacking { IgnoreCprops [(propname1) [(propname2)]...] //space delimited } | |
Explanation | |
propnames are space-delimited, and are case-sensative. | |
This config may be packaged, so it's a good idea to only specify the cprops in the package which "belong" to that package. |
startloc.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | yes |
Required/Used by | |
Core | |
Purpose | |
Defines the starting locations for new clients. They must be in this order to match the character creation screens in the UO client: Yew, Minoc, Britain, Moonglow, Trinsic, Magincia, Jhelom, Skara Brae, Vesper | |
Structure | |
StartingLocation { City (string CityName) Description (string Description) MapID (int mapid {default 0}) Cliloc (int clilocid {default 1075072}) Coordinate (int x),(int y),(int z) Realm (string realm) } [StartingLocation...] | |
Explanation | |
CityName and Description are sent to the client! no larger than 30 characters please. | |
MapID is the same number as in mapX.mul files, needed for the client to show the map correctly | |
Cliloc values are the description of the start locations | |
x,y,z,realm is where the character will be placed after created. You could set all the locations to the same coordinate to force players to start in one town. |
syshook.cfg | |
---|---|
Location: | Any package |
Number Allowed | any |
Required to Start? | no |
Required/Used by | |
Core | |
Purpose | |
Defines the hook scripts to be called by the core at certain times. | |
Structure | |
SystemHookScript (string script_name_with_ecl) { (SyshookName) (string exported_func_name) } [SystemHookScript...] | |
Explanation | |
Defines the script file and function to call for the core to call. The script should be in the same package as the syshook.cfg. | |
The script_name_with_ecl should define a 'program' which will be run on server start. | |
The exported_func_name should be defined with the 'exported' keyword. | |
The list of SyshookNames: CheckSkill, OpenSpellbook, GetBookPage, CombatAdvancement, ParryAdvancement, Attack, Pushthrough, SpeechMul, HitMiss, OnCast, CanDecay, Ouch, CanDie, UnHide, CloseCustomHouse, WarmodeChange, CanTrade |
uoclient.cfg | |
---|---|
Location: | Any Package |
Number Allowed | 1 |
Required to Start? | Yes |
Required/Used by | |
Core | |
Purpose | |
Maps vital and attribute names onto UO Client idioms for character status. | |
Structure | |
General { Strength (string Strength) Intelligence (string Intelligence) Dexterity (string Dexterity) Hits (string Life) Mana (string Mana) Stamina (string Stamina) MaxSkillID (integer maximum UO client skill ID) [MethodScript (string scriptname)] } Protocol { # # EnableFlowControlPackets: use the 0x33 (0x00 / 0x01) pause/restart packets. # Though OSI seems to no longer send these packets, they seem to help with smoothness, # particularly with boat movement. # NOTE: causes clients 4.0.0e and newer to fail login EnableFlowControlPackets (integer 0/1) } Listener { Port (int port number 1024..65535) KeepClients (integer 0/1 {default 0}) Encryption (string encryption type {default none}) AOSResistances (integer 0/1) } [Listener ...] | |
Explanation | |
The right-hand-side "Strength", "Intelligence", and "Dexterity" are Attribute names that MUST be defined in attributes.cfg. | |
The right-hand-side "Life", "Mana", and "Stamina" are Vital names that MUST be defined in vitals.cfg. | |
MaxSkillID allows you to use new client skills, but setting it too high can crash older clients. You must define attributes.cfg/uoskills.cfg entries for each skillID up to MaxSkillID (default 57). | |
The Protocol and Listener sections are optional. | |
Each Listener section allows you to listen for different client encryption types on different ports. This means you can listen for "1.26.4" clients on port 5003 and "ignition" clients on port 5555. Valid encryption types are found in the pol.cfg section. If you use Listeners set ListenPort in pol.cfg to 0. | |
KeepClients: if set to 1 clients keep this listener port even after different gameserver select; actually 1 is the old behaviour and 0 the old behaviour of pol.cfg ListenPort | |
AOSResistances: This flag aids in deciding which version of Armor to send in the StatMsg packets. With this enabled, a client who uses an account with AOS Expansion enabled will see their Physical Resist instead of AR member. | |
MethodScript: General Methodscript for characters | |
Related Files | |
attributes.cfg | |
pol.cfg | |
uoskills.cfg | |
vitals.cfg |
uoconvert.cfg | |
---|---|
Location: | root directory only |
Number Allowed | 1 |
Required to Start? | Yes |
Required/Used by | |
UOConvert | |
Purpose | |
Defines options for uoconvert. Lists the MultiID of boats, houses and decorations ("stairs"). Defines which ItemIDs are valid mounts. | |
Structure | |
# # UseNoShoot: means uoconvert will determine whether or not something blocks LOS by use of # the NoShoot tiledata flag instead of the Blocking tiledata flag. # LOSThroughWindows: only matters if UseNoShoot is 1. If LOSThroughWindows is 1, then # items marked as windows in tiledata will not impede LOS. # # Both of these options default to false. When UseNoShoot is false, the old method of # determining sight blocking as being equivalent to ability to pass will be used for LOS. # LOSOptions { UseNoShoot (integer 0/1) LOSThroughWindows (integer 0/1) } # # MaxStaticsPerBlock: max. Amount of Static Items per Block of 8x8x256 # it is hard limited to 10000. default is 1000. # # WarningStaticsPerBlock: max. Amount of Static Items per Block of 8x8x256 - just a Warning Level # it is hard limited to 10000. default is 1000. # # ShowIllegalGraphicWarning: show warning if Static with illegal Graphic# found # 0 or 1. default is 1. # StaticOptions { MaxStaticsPerBlock (int statics number 0..10000) WarningStaticsPerBlock (int statics number 0..10000) ShowIllegalGraphicWarning (integer 0/1) } # # ShowRoofAndPlatformWarning: show warning if Roof and Platform Flag are used at same Tile # 0 or 1. default is 1. # TileOptions { ShowRoofAndPlatformWarning (integer 0/1) } MultiTypes { Boats (int MultiID) [(int MultiID) ...] Houses (int MultiID) [(int MultiID) ...] Stairs (int MultiID) [(int MultiID) ...] } Mounts { Tiles (int ItemID) [(int ItemID) ...] } ClientOptions { UseNewHSAFormat (integer 0/1 {default 0}) } | |
Explanation | |
MultiIDs are defined in multi.mul/idx. A multi can either be a "house", "boat" or "stairs" (decorations such as stairs, curtains, carpets, etc). | |
ItemIDs are defined in anim.mul and tiledata.mul. |
uopacket.cfg | |
---|---|
Location: | Any Package |
Number Allowed | any |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines a Packet Hook which allow the scripter to intercept incoming client messages and outgoing server messages. This allows the scripter to decide how to implement the UO client's feature-of-the-week, without having to wait for the POL team to create a customizable solution for each packet. You will need a UO Network Protocol document to successfully create packet hook scripts. Note not all client features can be completely implemented in packet hook scripts, some will require core support, which we will endevour to provide. | |
Structure | |
Packet (packet ID byte) { Length (fixed integer length or 'variable' without quotes) [Version (1,2 {default 1})] [ClientVersion (ClientVersion string {default 1.25.25.0})] [ReceiveFunction (string scriptname:functionname)] [SendFunction (string scriptname:functionname)] [SubCommandOffset (int)] [SubCommandLength (1, 2 or 4)] } [Packet...] SubPacket (main packet ID byte) { SubCommandID (int sub-command id) [Version (1,2 {default 1})] [ClientVersion (ClientVersion string {default 1.25.25.0})] [ReceiveFunction (string scriptname:functionname)] [SendFunction (string scriptname:functionname)] } [SubPacket...] | |
Explanation | |
Packet ID: must be a byte integer, i.e. 12 or 0xAE. | |
Version: is used to define multiple packethooks of the same packet type. This is due to major packet changes by EA. It allows you to hook packets that have a different packet structure based on the client version. Default is 1. Max right now is 2. | |
Client string: is used to determine the minimum required client version for a packethook to work with. Note, all pre-login packets before 6.0.5.0 do not know the client's version number in the core. | |
Length: MUST be exactly correct for fixed-length packets and in bytes (i.e. message 0x20 is 19 bytes), or the string 'variable' for variable-length packets (i.e. 0xAE unicode speech). | |
ReceiveFunction: is the function to intercept a packet coming from a client. SendFunction is to intercept an outgoing packet created by the core (i.e. player status update). Normally a Packet element will only define one of these two, unless the packet is bi-directional AND the core currently sends the packet. | |
SubCommandOffset: is the 0-based offset into the packet that contains the sub-command ID number, if applicable for this packet. SubCommandLength is the number of bytes to extract to determine the sub command (ex. 2 for 0xBF, 1 for 0x12). | |
SubCommandID: is the 2-byte ID to be found at the parent packet's SubCommandOffset. You need not define Receive and Send functions for the parent packet if you define subpacket entries. If a subcommand is received or being sent that is not hooked, the default behavior will occur. As normal, the parent packet entry must only be defined once. | |
Hint: Please do not try to hook Sub-Sub-Commands (like the 0xBF 0x06 Party System subsubcommands), instead use a case statement in the subcommand hook. | |
Hint: You can find examples in packethooks.txt |
uoskills.cfg | |
---|---|
Location: | Any Package |
Number Allowed | any |
Required to Start? | Yes |
Required/Used by | |
Core | |
Purpose | |
Maps Attribute names onto the UO Skill ID numbers. | |
Structure | |
Skill (SkillID) { Attribute (Attribute_name) } Additional entries required up to maximum UO skill id | |
Explanation | |
Attribute_name defines the Attribute associated with this UO Skill. Only one attribute may be mapped to a skill id. Attribute_name must be found in attributes.cfg! | |
SkillID must be an integer between 0 and 500, though any entries past the maximum UO skill id will not be sent to the UO client. | |
Related Files | |
uoclient.cfg | |
attributes.cfg |
vitals.cfg | |
---|---|
Location: | Any Package |
Number Allowed | any |
Required to Start? | Yes |
Required/Used by | |
Core | |
Purpose | |
Defines Attribute names and aliases | |
Structure | |
Vital (Vital_Name) { RegenRateFunction (string scriptname:exported_func_name) MaximumFunction (string scriptname:exported_func_name) [Alias (string Alias_Name)]... [UnderflowFunction (string scriptname:exported_func_name)] [RegenWhileDead (integer 0/1 {default 0})] } [Vital...] | |
Explanation | |
Vital_Name defines the UNIQUE name for this vital, like 'Mana', 'Stamina', etc. | |
Aliases are optional and any number maybe be assigned for each vital. This way 'Hits' may be used in place of 'Life' | |
At the LEAST, these attributes must be defined: 'Life', 'Stamina', 'Mana' for use in internal calculations. | |
RegenRateFunction should return value from -30000 to 30000. Regen rates are in 'hundredths of points per minute.' A current regen rate of 100 (1 point per 5 seconds) would therefore be 1200 (12 points per minute) | |
MaximumFunction should return the maximum value for this vital, an integer in 'hundreths' between 100 and 10000000 (1-100,000) | |
UnderflowFunction not implimented. | |
Related Files | |
uoclient.cfg | |
attributes.cfg |
watch.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Turns on certain spammy debugging messages. | |
Structure | |
[Combat (0 or 1)] [ProfileScripts (0 or 1)] | |
Explanation | |
If 'Combat 1' is in this file, information regarding combat damage, hits and misses, etc will be printed. | |
If 'ProfileScripts 1' is in this file, profiling information will be printed when any script exits. |
weather.cfg | |
---|---|
Location: | /regions only |
Number Allowed | 1 |
Required to Start? | No |
Required/Used by | |
Core | |
Purpose | |
Defines the weather regions. See also regions.cfg. | |
Structure | |
Region (region name) { Range (x-west) (y-north) (x-east) (y-south) [Realm (string realmname {default "britannia"})] [WeatherType (int type {default 255})] [WeatherSeverity (int severity {default 0})] [WeatherAux (int {default 0})] [LightOverride (int light level override {default -1})] } [Region...] | |
Explanation | |
Important: regions only override regions found earlier in the file. So the first region should cover the entire map, and further regions override portions of the world. | |
This file is preferred over regions.cfg for the above properties. | |
IMPORTANT: Regions are limited to POL's internal 4x4 tile zones and will internally expand to fill all of these zones the Range is contained in. | |
type: 0 - light rain ("It starts to rain") 1 - rain/thunder ("A fierce storm approaches") 2 - snow ("It begins to snow") 3 - brewing storm - ("A storm is brewing") 255 - None (Turns sound effects off) severity:is set on a 0-70 scale, 70=torrential rain, 0=light drizzle. aux: nothing lightoverride: light level amount overrides current level. -1 means no override. | |
Related Files | |
regions.cfg |
www.cfg | |
---|---|
Location: | /config only |
Number Allowed | 1 |
Required to Start? | no |
Required/Used by | |
Core | |
Purpose | |
Defines custom MIME types for web server. | |
Structure | |
MIME (string extension) { Extension (string extension) MIME (string mime) } [MIME...] | |
Explanation | |
This allows you to add new file types that the web server can handle, for example PNG images, PDF files or favicon.ico. If you don't supply a www.cfg, old defaults are used ("jpg", "jpeg" and "gif"). |