Definition

Pub files contain client side data on Items, Npc's, spells and classes.

Files

• dat001.eif (Items)
• dtn001.enf (Npc's)
• dsl001.esf (Spells)
• dat001.ecf (Classes)

Editing tools

These files can be edited via notepad software, but this is not recommended as there are tools that have been created specifically for editing these files. These tools are as follows:

* editPub v070210

• pubedit v1.3 (''old, but still useful. not recommended for rookies.'')

''notes: Search the forum for these programs, credits to Rena Zaras''

Location

They are hosted and edited server side, ready to be patched into the client when logging in to the game server. Where they are usually found: ''' Server Side ''' EOSERV:

 \eoserv-trunk\data\pub\ 

SEOSE:

 \seose-bin\Data\ 

''' Client Side '''

 \%GAME_DIR%\pub\ 

Specifics

Here we'll explain all of the files uses and fields you will see when editing them (based on the fields in "editPub v070210"). Specifics are as follows:

Items

Items include all character equipment, static and usable ''pickups'' you will find in a typical EO game server. The item fields are as follows:

* '''ID'''

This is the number ID of the item, starting at 1 and increasing for each new item in the file. This ID can be used to ''spawn'' items into the players inventory.

* '''Name'''

This is self-explanatory. Defines the name of an item.

* '''Icon'''

The ''icon'' is a number ID which identifies the location of the item graphic in the "GFX file".

* '''Item Type'''

This defines an items function. There are 26 item types, they are as follows:

'''0. Static'''

''These are purely cosmetic items and have no function.''

'''1. Unknown'''

''????''

'''2. Gold'''

''This item is used as game currency.''

'''3. Potion'''

''This item restores the users "HP and TP", the amount to restore is defined in the field labeled "HP" and "TP".''

'''4. Scroll'''

''This item warps the user to the exact location set in the fields "Warp Map", "Warp X" and "Warp Y".''

'''5. Unknown'''

''????''

'''6. Reward'''

''This item rewards the user with "exp points", the amount is defined in the field "Experience".''

'''7. Unknown'''

''????''

'''8. Unknown'''

''????''

'''9. Key'''

''This item is used to open locked warps and chests found on maps. A unique "Key ID" is required and must also be used in the map to identify the exact key to open the lock.''

'''10. Weapons & Equipment'''

''Weapons and equipment have multiple fields that define their graphic ID, conditions and each of their strengths. They are as follows:''

'''''GFX ID'''''

Defines the ID of the number which identifies the location of the item graphic in the "GFX file".

'''''Attributes'''''

Fields consisting of HP, TP, Min/Max Dmg, Accuracy, Evasion and Defense. These fields determine the equipments strengths.

'''HP = Health Points, TP = Tech Points?, MinDmg = Minimum Damage, MaxDmg = Maximum Damage.'''

'''''Stats'''''

Fields consisting of Str, Int, Wis, Agi, Con and Cha. These fields determine the character buffs received from the equipment.

'''''Requirements'''''

'''Str = Strength, Int = Intelligence, Wis = Wisdom, Agi = Agility, Con = Constitution, Cha = Charisma.'''

Fields consisting of Class, Level, Str, Int, Wis, Agi, Con and Cha. These fields determine the conditions a player must meet before being able to use or equip the item.

'''''Resistance'''''

Fields consisting of Light, Dark, Earth, Air, Water and Fire. These fields determine the elemental strengths of an item, and are not fully developed.

'''''Unknown Values'''''

Fields consisting of Element?, UnkB, UnkE and UnkF. These are currently unknown functions.

'''11. Shields'''

'''12. Clothing'''

'''13. Hat'''

'''14. Boots'''

'''15. Gloves'''

'''16. Charm'''

'''17. Belt'''

'''18. Necklace'''

'''19. Ring'''

'''20. Bracelet'''

'''21. Bracer'''

'' For 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 and 21, See 10. Weapons & Equipment.''

'''22. Alcohol'''

''This item renders the user 'drunk', in which any text they enter into the chatbox becomes 'muddled up'. A 'bubble' animation is played on the character sprite for the duration of the effect.''

'''23. Animation'''

''This item plays a special effect graphic on the user. The graphic is determined by the field "GFX ID".''

'''24. Hair Dye'''

''This item changes the users hair colour. The colour is determined by the field "Colour".''

'''25. Cure'''

''This item removes and destroys a cursed item from the characters equipment.''

'''26. Unknown'''

''????''

• '''Size'''

The item size is defined here, by the amount of ''squares'' it holds in the users inventory. Choices are 1x1, 1x2, 1x3, 2x1, 2x2, 2x3 and 2x4.

• '''Rarity'''

The colour of an items label is determined by the ''rarity'' of the item. Choices are common, uncommon, rare, rarest, lore (cannot be dropped or traded), cursed (needs cure to be removed from the players paperdoll), unknown, unknown.

• '''Weight'''

The weight of an item in the players inventory. Max = 0/255.

• '''Unnamed field / equip type'''

This field works only with equipment (''See 10. Weapons & Equipment''). It determines specific ways for the items graphic to appear on the characters sprite. Choices are normal, ranged, ammo, wings, unknown, unknown.

• '''Special Values'''

This is used to set specific parameters for all item types, [EX: GFX ID].

Npc's

These include all monsters and non-combat Npc's you will find in a typical EO game server. The Npc fields are as follows:

• '''ID'''

This is the number ID of the Npc, starting at 1 and increasing for each new Npc in the file. This ID can be used to ''spawn'' Npc's into the map.

* '''Name'''

This is self-explanatory. Defines the name of an Npc.

* '''GFX'''

The ''GFX'' is a number ID which identifies the location of the Npc graphic in the "GFX file".

* '''Npc Types'''

This defines an Npc's function. There are 20 Npc types, they are as follows:

'''0. Non-Combat'''

''These do nothing.''

'''1. Passive'''

''These are defensive Npc's, they will only attack once they have been attacked.''

'''2. Agressive'''

''These are offensive Npc's, they will hunt any players in their 'view range' continuously until they are removed from the map.''

'''3. Unknown'''

''????''

'''4. Unknown'''

''????''

'''5. Unknown'''

''????''

'''6. Shop'''

''This Npc opens a dialog where a player can buy and sell items. The "Shop ID" is linked with shops.ini config file found in the trunk > data folder.''

'''7. Inn'''

''This Npc opens a dialog where a player can try a quiz to become a citizen of a town, leave citizenship, or replenish health for a set price (usually determined by the total HP the character has). The Npc ID is linked to the home.ini config file found in the trunk > data folder. You can also edit the quiz options, home location and name in the config file''

'''8. Unknown'''

''????''

'''9. Bank'''

''This Npc opens a dialog where a player can choose to take out or diposit cash and spend cash on "locker upgrades" in which you can increase the amount of slots there are available in the characters locker.''

'''10. Barber'''

''This Npc opens a dialog where the player can change their hair style and colour, for a set price (increasing with the characters level). You can click on the sprite window to rotate the view.''

'''11. Guild'''

''This Npc opens a dialog where the player can create, join, edit and delete guilds. Creating a guild usually costs money and requires a set amount of volunteers before it can be created.''

'''12. Priest'''

''This Npc plays animations around 2 players who are getting married (See 13. Law).''

'''13. Law'''

''This Npc opens a dialog where two players can pay and accept eachothers proposal in marriage. Marriage isn't fully supported yet, but in original EO, would usually require two "Love Rings", a "Tuxedo" and a "White Dress". Expect to see customizable marriage settings in later revs.''

'''14. Skill Trainer'''

''This Npc opens a dialog where a player can buy new spells and reset their characters spells & skills. Resetting usually requires that the player remove all equipment from their paperdoll. I believe Skill Trainers aren't fully supported yet.''

'''15. Quest'''

''This Npc opens dialogs where a player can view and accept quests and obtain rewards for completing them. This "Npc Type" is used by Apollo's "EOPlus Quest Engine" and is assosiated with a quest file by the field "Quest Script". It is also used for the wiseman in regular EO.''

'''16. Unknown'''

''????''

'''17. Unknown'''

''????''

'''18. Unknown'''

''????''

'''19. Unknown'''

''????''

'''20. Unknown'''

''????''

• '''Child'''

Set the Npc as a "Child" to another Npc, this will make it act defensively toward it's parent Npc (''See Parent''). Choices are 0 - normal and 1 - Boss Spawn.

• '''Parent'''

Set the Npc as a "Parent" to another Npc, this will cause all "child" Npc's (''See Child'') to act defensive around it when attacked. Choices are 0 - normal and 1 - Boss.

• '''Attributes'''

There are fields here that determine the strengths of combat Npc's (''See Passive & Aggressive''). The fields are HP, Experience, Min/Max Dmg, Accuracy, Evasion, Defense and Quest Script (''See Quest'').

• '''Unknown Values'''

These are all the unknown values in the Npc file. The fields are UnkA, UnkB, UnkC, UnkD, Weakness?(''See Items Unknown Value, Element?''), UnkF, UnkG, UnkH.

Spells

These include all spells you will find in a typical EO game server. The Spells fields are as follows:

• '''ID'''

This is the number ID of the Spell, starting at 1 and increasing for each new Spell in the file.

* '''Name'''

This is self-explanatory. Defines the name of a Spell.

* '''Channel'''

The channel is the spells ''nickname'' or ''action'' that flashes over the characters head when the spell is used. It also appears in the bottom left status field of the game client.

* '''Animation'''

The Amination is the ID of the spells animation graphic located in the GFX file.

* '''Icon'''

The icon is the ID of the spells icon located in the GFX file.

* '''Healing Spell'''

This field determines whether the spell has healing properties or not. Choices are 0 - non-restore spell or 1 - restore spell.

* '''Spell Effect'''

This determines whether the spell effects players or Npc's, or uses the bard effect (''musical guitar or harp dialog''). Choices are 0 - healing spell, 1 - damage spell or 2 - bard.

* '''Spell Target'''

This determines the targetted object of the spell. Choices are 0 - none?, 1 - ally and 2 - enemy.

* '''Spell Type'''

This determines the AOE (''area of effect'') of a spell. Choices are 0 - normal (''target with mouse click''), 1 - self, 2 - unknown and 3 - group (''player party'').

* '''Attributes'''

These define the cost, strength and cast time of a spell. Fields include "Cast time", "TP cost", "SP cost", "Heal" and "Min/Max Dmg".

* '''Unknown values'''

These are all of the unknown values in the spells file. The fields are UnkA, Element? (''See Npc's unknown value, Weakness?''), UnkC, UnkD, UnkE, UnkF, UnkG, UnkH, UnkI, UnkJ, UnkK, UnkL, UnkM, UnkN, UnkO, UnkP, UnkQ and UnkR.

Classes

These include all character classes and sub-classes you will find in a typical EO game server. The fields are as follows:

• '''ID'''

This is the number ID of the Class, starting at 1 and increasing for each new Class in the file.

* '''Name'''

This is self-explanatory. Defines the name of a Class.

* '''Sub Class'''

This lets you choose a class you must acquire before being able use it. Clicking it reveals a drop-down menu with all of the classes available for the Sub Class.

* '''Attributes'''

These are the fields that determine the base stats of each class, and the ID of the ''stat table'' located in the EOServ trunk > data > formulas.ini

These fields are not fully supported by EOServ and are as follows: "Stat Table", "Base Str", "Base Int", "Base Wis", "Base Agi", "Base Con" and "Base Cha".

EOF

Each Pub file is closed with the last index item being EOF("End Of File") to indicate that was the last item. Each Pub file is closed with the highest ID being named "EOF". Errors will occur when eof's are not present within each of the files.