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:
Last Modified: 10/27/2007
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. | |
Structure | |
OnMount |
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 | |
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) | |
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. | |
Related Files | |
uoclient.cfg | |
vitals.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 | |
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) |
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 | |
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 | |
Explanation | |
ObjType should be >= 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) | |
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) | |
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})] | |
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. |
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 | |
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) | |
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) | |
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. |
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 | |
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 not implimented yet | |
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') | |
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. | |
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) | |
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 64x64 tile zones and will internally expand to fill all of these zones the Range is contained in. This sucks, we know. | |
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) | |
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 64x64 tile zones and will internally expand to fill all of these zones the Range is contained in. This sucks, we know. | |
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 | |
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 | |
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 | |
Maps the UO 'MultiID' number with the graphic number for the multi. | |
Structure | |
House (int multid) | |
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) | |
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 64x64 tile zones and will internally expand to fill all of these zones the Range is contained in. This sucks, we know. | |
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) | |
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 64x64 tile zones and will internally expand to fill all of these zones the Range is contained in. This sucks, we know. | |
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) | |
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 privilages 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 |
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) | |
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 | |
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) | |
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 '1.26.4', '2.0.0', 'ignition', 'uorice', and 'none'. Here, 'ignition', 'uorice', and 'none' all mean 'no encryption'. | |
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. |
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) | |
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. | |
'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. | |
'Light' 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 64x64 tile zones and will internally expand to fill all of these zones the Range is contained in. This sucks, we know. |
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 | |
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. | |
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 | |
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 | |
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 | |
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)] | |
Explanation | |
TotalStatsAtCreation takes a comma-delimited lists of values and/or ranges (default = '65,80'). Example: TotalStatsAtCreation=65,80,90-95,100-110 | |
If MovementUsesStamina, 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! | |
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) | |
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 | |
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 | |
Explanation | |
CityName and Description are sent to the client! no larger than 30 characters please. | |
x,y,z 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) | |
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 |
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 | |
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 skills.cfg entries for each skillID up to MaxSkillID (default 51). | |
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. | |
Related Files | |
attributes.cfg | |
pol.cfg | |
skills.cfg | |
vitals.cfg |
uoconvert.cfg | |
---|---|
Location: | root directory only |
Number Allowed | 1 |
Required to Start? | Yes |
Required/Used by | |
UOConvert | |
Purpose | |
Defining what Multi IDs are what type (Boat, House, Stairs). Defining what Item IDs are Mounts. Configures options for UOConvert. | |
Structure | |
# | |
Explanation | |
MultiIDs depends on your multi.mul/idx. | |
ItemIDs depends on your 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) | |
Explanation | |
Packet ID must be a byte integer, i.e. 12 or 0xAE. | |
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) | |
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) | |
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)] | |
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) | |
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 64x64 tile zones and will internally expand to fill all of these zones the Range is contained in. This sucks, we know. | |
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) | |
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"). |
If you know if any information is incorrect on these pages, mail your corrections to polteam@polserver.com
Copyright ©2003-2006 David Carpman and POL Development Team, all rights reserved. DO NOT REPRODUCE, MIRROR, ALTER, SPINDLE, MUTILATE, OR SIT ON.