Standardized formatting of database files.

Signed-off-by: Euphy <euphy.raliel@rathena.org>

db/elemental_db.txt

@@ -2,9 +2,10 @@
 //
 // Structure of Database:
 // ID,Sprite_Name,Name,LV,HP,SP,Range1,ATK1,ATK2,DEF,MDEF,STR,AGI,VIT,INT,DEX,LUK,Range2,Range3,Scale,Race,Element,Speed,aDelay,aMotion,dMotion
-// NOTE
+//
+// Notes:
 // Summoned Elemental’s STATs are affected by the Caster’s Base Level and STATs.
-// So all value added here will be added and will not override the calculated STATs of the summoned elemental.
+// In other words, all values specified will be added to (and will not override) the calculated STATs of the summoned elemental.
 
 // Monster Elementals
 2114,EL_AGNI_S,Agni,100,0,1,1,0,0,0,0,0,0,0,0,0,0,5,12,0,0,83,200,504,1020,360

db/elemental_skill_db.txt

@@ -3,7 +3,8 @@
 // Structure of Database:
 // ElementalID,SkillID,SkillLevel,ReqMode
 //
-// Spirit Modes: 1 = Passive, 2 = Defensive, 4 = Aggressive
+// Spirit Modes:
+//	1 = Passive, 2 = Defensive, 4 = Aggressive
 
 // EL_AGNI_S
 2114,8413,1,1	//EL_PYROTECHNIC,Pyrotechnic

db/item_cash_db2.txt

@@ -1,9 +1,10 @@
-// This file contains the items sold in the ingame cash shop
+// Cash Shop Database
+// Contains the items sold in the ingame cash shop.
 //
-// The structure of the file is
-// type, item ID, price
+// Structure of Database:
+// Type,ItemID,Price
 //
-// type:
+// Type:
 //    0: New
 //    1: Hot
 //    2: Limited
@@ -13,5 +14,5 @@
 //    6: Heal
 //    7: Other
 //
-// price:
-//    price of the defined item in cash points
+// Price:
+//    Item cost, in cash points (#CASHPOINTS).

db/item_nouse.txt

@@ -1,10 +1,15 @@
 // Item Usage Restriction Configuration File
-// Defines if an item cannot be used under certain circumstances
-// Syntax: <item_id>, <flag>, <group_id_override>
-// flag:
+// Defines if an item cannot be used under special circumstances.
+//
+// Structure of Database:
+// ItemID,Flag,Group ID Override
+//
+// Flag:
 //	1 = Cannot use item while sitting
-//	X = more to come soon [TODO]
-// group_id_override: group id necessary to override this setting
+//	... [more to come]
+//
+// Group ID Override:
+//	Group ID necessary to override this setting.
 
 619,1,100	// Unripe_Apple
 620,1,100	// Orange_Juice

db/item_stack.txt

@@ -1,16 +1,21 @@
 // Item Stacking Restriction File
 // Prevents an item to be stacked more than x times in given
 // inventory types. Generally used by 3rd class related skill items.
-// Format: <item id>,<stack limit amount>,<type>
+//
+// Structure of Database:
+// ItemID,MaxStackAmount,Type
+//
+// MaxStackAmount:
+//	Stack limit for the item. Use 0 to disable a restriction.
+//
 // Type mask values:
-//  &1: Character inventory restriction
-//  &2: Character cart restriction
-//  &4: Account storage restriction
-//  &8: Guild storage restriction
+//	&1: Character inventory restriction
+//	&2: Character cart restriction
+//	&4: Account storage restriction
+//	&8: Guild storage restriction
+//
 // Example:
-//  512,4,12  // Will not allow more than 4 Apples in storages.
-// Note:
-//  Stack limit of 0 will disable a restriction.
+// 512,4,12  // Will not allow more than 4 Apples in storages.
 
 // Rune Knight
 12725,20,1  // Nauthiz Rune

db/magicmushroom_db.txt

@@ -1,6 +1,8 @@
-// Magic Mushroom DB.
-// Database for skills that are randomly used through Magic Mushroom status change.
-// Format: SkillID
+// Magic Mushroom DB
+// List of skills that are randomly used through Magic Mushroom status change.
+//
+// Structure of Database:
+// SkillID
 
 7	//SM_MAGNUM
 8	//SM_ENDURE

db/mob_classchange.txt

@@ -1,4 +1,5 @@
-// SA_CLASSCHANGE Summonable Monsters Database
+// Class Change Summonable Monsters Database
+// List of monsters generated through Abracadabra's SA_CLASSCHANGE ability.
 //
 // Structure of Database:
 // MobID,DummyName,Rate

db/pre-re/attr_fix.txt

@@ -1,7 +1,8 @@
-// Elemental attribute damage adjustment tables
+// Elemental Attribute Damage Adjustment Tables
 //
-// Row: target's defense element
-// Column: attacker's weapon element
+// Structure of Database:
+// Columns - attacker's weapon element
+// Rows    - target's defense element
 
 1,10	// lv1 Attribute table
 //Neut Watr Erth Fire Wind Pois Holy Shdw Gho  Und

db/pre-re/exp_guild.txt

@@ -1,4 +1,4 @@
-// Guild LvUp experience value table
+// Guild Experience Tables
 2000000
 4000000
 8000000

db/pre-re/exp_homun.txt

@@ -1,4 +1,4 @@
-//Homunculus LvUp experience value table
+// Homunculus Experience Tables
 50
 110
 180

db/pre-re/instance_db.txt

@@ -2,7 +2,7 @@
 //
 // Structure of Database:
 // ID,Name,LimitTime,EnterMap,EnterX,EnterY,Map1,Map2,Map3,Map4,Map5,Map6,Map7,Map8
-//
+
 0,Endless Tower,14400,1@tower,50,355,1@tower,2@tower,3@tower,4@tower,5@tower,6@tower
 1,Sealed Catacomb,7200,1@cata,100,224,1@cata,2@cata
 2,Orc's Memory,3600,1@orcs,179,15,1@orcs,2@orcs

db/pre-re/item_buyingstore.txt

@@ -1,8 +1,9 @@
 // Buying Store Item List
-// List of items, that can be sold to buying stores.
-// Format: <item id>
-// Example:
-//  512  // Apple
+// List of items that can be sold to buying stores.
+//
+// Structure of Database:
+// ItemID
+//
 // Note:
 //  Items are in same order as data\buyingstoreitemlist.txt, which
 //  must be edited as well for the client to accept added items.

db/pre-re/item_cash_db.txt

@@ -1,9 +1,10 @@
-// This file contains the items sold in the ingame cash shop
+// Cash Shop Database
+// Contains the items sold in the ingame cash shop.
 //
-// The structure of the file is
-// type, item ID, price
+// Structure of Database:
+// Type,ItemID,Price
 //
-// type:
+// Type:
 //    0: New
 //    1: Hot
 //    2: Limited
@@ -13,5 +14,5 @@
 //    6: Heal
 //    7: Other
 //
-// price:
-//    price of the defined item in cash points
+// Price:
+//    Item cost, in cash points (#CASHPOINTS).

db/pre-re/item_delay.txt

@@ -1,8 +1,10 @@
 // Item Delay Database
-// There is a max concurrent number of entries modifiable in src/map/itemdb.h as MAX_ITEMDELAYS
 //
-// Structure:
+// Structure of Database:
 // Item ID,Delay in Milliseconds
+//
+// NOTE:
+// There is a max concurrent number of entries set in src/map/itemdb.h as MAX_ITEMDELAYS.
 
 //12202,60000	//Str_Dish10_
 //12203,60000	//Agi_Dish10_

db/pre-re/item_noequip.txt

@@ -1,12 +1,15 @@
-// The equipment/items/cards restriction file 
-// here you define which items may not be used at PvP / GvG 
-// format: <item id>,<mode>
-// mode
+// Forbidden Items Database
+// Defines restrictions on equipment, items, and cards in map types and zones.
+//
+// Structure of Database:
+// ItemID,Flag
+//
+// Legend for 'Flag' field (bitmask):
 // 1    - restricted in normal maps
 // 2    - restricted in PVP
 // 4    - restricted in GVG
 // 8    - restricted in Battlegrounds
-// Restricted zones - they're configured by 'restricted <number>' mapflag
+// Restricted zones - configured by 'restricted <number>' mapflag
 // 32   - restricted in zone 1
 // 64   - restricted in zone 2
 // 128  - restricted in zone 3
@@ -14,16 +17,18 @@
 // 512  - restricted in zone 5
 // 1024 - restricted in zone 6
 // 2048 - restricted in zone 7
+//
+// Examples:
+// 1201,1   // Knife can't be worn on normal maps
+// 608,4    // Yggdrasil Seed can't be consumed in both GvG and WoE Castles
+// 4174,6   // Deviling Card has no effect in every PVP or GVG map, and during WoE
+// 501,32   // Red Potion can't be consumed on maps marked as 'restricted zone 1'
+// 519,322  // Milk can't be consumed in PVP and maps marked as 'restricted zone 2' or 'restricted zone 4' (256+64+2)
+
+//----------------------------------------------------------------------------
+// Normal maps
+//----------------------------------------------------------------------------
 
-//Examples:
-//1201,1 you can't use KNIFE(ID 1201) on normal maps
-//608,4 you can't use Yggdrasil Seed(ID 608) on both GvG and WoE Castles
-//4174,6 Forbid Deviling Card in every PVP or GVG map, and during woes.
-//501,32 you can't use Red Potion on map marked as 'restricted zone 1'
-//502,64 you can't use Orange Potion on map marked as 'restricted zone 2'
-//503,128 you can't use Yellow Potion on map marked as 'restricted zone 3'
-// you can even mix modes
-//519,322 (256+64+2) you can't use Milk on PVP, and maps marked as 'restricted zone 2' and 'restricted zone 4'
 
 //----------------------------------------------------------------------------
 // PVP

db/pre-re/item_trade.txt

@@ -1,19 +1,24 @@
-//Item Trading Restrictions File
-//Specify here special rules for item trading.
-//Item ID, TradeMask, Group-Level Override
-//Trading mask values:
-//1:Item can't be droped
-//2:Item can't be traded (nor vended)
-//4:Wedded partner can override restriction 2.
-//8:Item can't be sold to npcs
-//16:Item can't be placed in the cart
-//32:Item can't be placed in the storage
-//64:Item can't be placed in the guild storage
-//128:Item can't be attached to mail
-//256:Item can't be auctioned
-//Example:
-//1161,67,50 //Balmung: No drop, No trade, No Guild Store (1+2+64 =67),
-//only groups of group-level 50 and up can override the setting.
+// Item Trade Restrictions Database
+// Defines special trade rules for individual items.
+//
+// Structure of Database:
+// Item ID, TradeMask,Group Level Override
+//
+// Legend for 'TradeMask' field (bitmask):
+// 1   - item can't be dropped
+// 2   - item can't be traded (nor vended)
+// 4   - wedded partner can override restriction 2
+// 8   - item can't be sold to npcs
+// 16  - item can't be placed in the cart
+// 32  - item can't be placed in the storage
+// 64  - item can't be placed in the guild storage
+// 128 - item can't be attached to mail
+// 256 - item can't be auctioned
+//
+// Example:
+// 1161,67,50
+//	Balmung cannot be dropped, traded, or placed in Guild Storage (1+2+64).
+//	Only groups of group-level 50 and up can override this setting.
 
 // Wedding Related items
 2634,507,100	// Wedding Ring

db/pre-re/job_param_db.txt

@@ -1,18 +1,15 @@
-// Maximum parameters for specific job!
-// ====================================================
+// Max Parameter Database
+// Sets maximum stat parameters for specific jobs.
+//
 // Structure of Database:
-//	JobID,MaxParam
-//		or
-//	JobID,MaxStr,MaxAgi,MaxVit,MaxInt,MaxDex,MaxLuk
-// ====================================================
-// JobID: Using Job constanta on 'db/const.txt'
+// JobID,MaxParam
+//	OR
+// JobID,MaxStr,MaxAgi,MaxVit,MaxInt,MaxDex,MaxLuk
+//
+// JobID: Job constants in 'db/const.txt'
 // MaxParams: Value between 10 ~ 32767 (SHRT_MAX)
-// ====================================================
+//
 // Examples:
-//Job_Novice,60
-//	Normally, Novice's max. param is using 'max_parameter' on conf/battle/player.conf.
-//	By with this config, Novice's max. param will be 60, for all params.
-//Job_Swordman,90
-//	Normally, Swordman's max. param is using 'max_parameter' on conf/battle/player.conf.
-//	By with this config, Swordman's max. param will be 90, for all params.
-// ====================================================
+// Job_Novice,60
+//	Normally, Novice's max. param uses 'max_parameter' in 'conf/battle/player.conf'.
+//	With this config, Novice's max. param will be 60 (for all stats).

db/pre-re/refine_db.txt

@@ -1,18 +1,17 @@
-// Pre-renewal Version
+// Refine Database [Pre-Renewal]
 //
+// Structure of Database:
 // Type,Stats per level,Random bonus start level,Random bonus value,Chance+1:Bonus+1,Chance+2:Bonus+2,Chance+3:Bonus+3,...
 //
-// IMPORTANT: changing the number of upgrade levels requires modifying MAX_REFINE in status.h
-//
 // For armors, values of 100 add 1 armor defense.
 // For weapons, values of 100 add 1 ATK.
 //
 // Type:
-// 0 - Armors
-// 1 - Level 1 weapons
-// 2 - Level 2 weapons
-// 3 - Level 3 weapons
-// 4 - Level 4 weapons
+//	0 - Armors
+//	1 - Level 1 weapons
+//	2 - Level 2 weapons
+//	3 - Level 3 weapons
+//	4 - Level 4 weapons
 //
 // Stats per level:
 // This value is applied for every upgrade level.
@@ -26,6 +25,9 @@
 //
 // Chance:
 // 100 = 100%
+//
+// Notes:
+// Changing the number of upgrade levels requires modifying MAX_REFINE in src/map/status.h.
 
 // Armors
 0,70,0,0,100:0,100:0,100:0,100:0,60:0,40:0,40:0,20:0,20:0,10:0

db/pre-re/skill_cast_db.txt

@@ -2,19 +2,18 @@
 //
 // Structure of Database:
 // SkillID,CastingTime,AfterCastActDelay,AfterCastWalkDelay,Duration1,Duration2,Cool Down
-//== Explained:
-// CastingTime : time to cast this skill, in miliseconds
-// AfterCastActDelay : "normal" delay, character cannot use skills, in miliseconds
-// AfterCastWalkDleay : amount of time before character can move again, in miliseconds
-// Duration1 / Duration2 : usually the durations used by the skill, at special cases it is used to hold special data
-// Cool Down : amount of time until character can re-use this skill, in miliseconds
-//== Extra
-// On all fields you can use ':' as a delimiter to level-specific values,
-// - Example using SM_PROVOKE
-// - Original:6,0,0,0,30000,0,1000
-// - ModifiedTo:6,0,0,0,30000,0,1000:2500:3000:etc
-// - Makes lvl 1 have 1000 (1s) cool down, lvl 2 2500 (2.5s), lvl 3 3000, and so on.
-//==========================================
+//
+// CastingTime: time to cast this skill, in milliseconds
+// AfterCastActDelay: "normal" delay, character cannot use skills, in milliseconds
+// AfterCastWalkDleay: amount of time before character can move again, in milliseconds
+// Duration1/Duration2: usually the durations used by the skill, at special cases it is used to hold special data
+// Cool Down: amount of time until character can re-use this skill, in milliseconds
+//
+// On all fields you can use ':' as a delimiter for level-specific values.
+// For example:
+// - Original: 6,0,0,0,30000,0,1000
+// - Modified: 6,0,0,0,30000,0,1000:2500:3000:...
+// Gives Level 1 1000ms cool down, Level 2 2500ms, Level 3 3000ms, and so on.
 
 
 //===== Swordman ===========================

db/pre-re/skill_nocast_db.txt

@@ -1,25 +1,26 @@
 // Forbidden Skills Database
+// Defines unusable skills in map types and zones.
 //
 // Structure of Database:
 // SkillID,Flag
 //
 // Legend for 'Flag' field (bitmask):
-//  1 = Cannot be used in normal maps
-//  2 = Cannot be used in PvP maps (use this instead of 1 for PK-mode servers)
-//  4 = Cannot be used in GvG maps
-//  8 = Cannot be used in Battleground maps
-//  16 = Cannot be cloned (clones will not copy this skill)
-//  Restricted zones - they're configured by 'restricted <number>' mapflag
-//  32 = Cannot be used in zone 1 maps
-//  64 = Cannot be used in zone 2 maps
-//  128 = Cannot be used in zone 3 maps
-//  256 = Cannot be used in zone 4 maps
-//  512 = Cannot be used in zone 5 maps
-//  1024 = Cannot be used in zone 6 maps
-//  2048 = Cannot be used in zone 7 maps
+// 1    - cannot be used in normal maps
+// 2    - cannot be used in PvP maps (use this instead of 1 for PK-mode servers)
+// 4    - cannot be used in GvG maps
+// 8    - cannot be used in Battleground maps
+// 16   - cannot be cloned (clones will not copy this skill)
+// Restricted zones - configured by 'restricted <number>' mapflag
+// 32   - cannot be used in zone 1 maps
+// 64   - cannot be used in zone 2 maps
+// 128  - cannot be used in zone 3 maps
+// 256  - cannot be used in zone 4 maps
+// 512  - cannot be used in zone 5 maps
+// 1024 - cannot be used in zone 6 maps
+// 2048 - cannot be used in zone 7 maps
 //
 // Example:
-// 8,6 = Endure cannot be used in PvP and GvG maps (2+4)
+// 8,6  // Endure cannot be used in PvP and GvG maps (2+4)
 
 //----------------------------------------------------------------------------
 // Normal

db/pre-re/skill_unit_db.txt

@@ -1,3 +1,6 @@
+// Skill Unit Database
+//
+// Structure of Database:
 // ID,unit ID,unit ID 2,layout,range,interval,target,flag
 //
 // layout = -1:special, 0:1*1, 1:3*3, 2:5*5, up to 5:11*11
@@ -19,7 +22,6 @@
 // 	Example: 0x006 = 0x002+0x004 -> Cannot be stacked nor cast near targets
 //
 // Notes:
-// ------
 //    0x89,0x8a,0x8b without indication
 //
 //    u1   u2 lay  r intr target  flag

db/produce_db.txt

@@ -3,11 +3,9 @@
 // Structure of Database:
 // ProduceItemID,ItemLV,RequireSkill,RequireSkillLv,MaterialID1,MaterialAmount1,......
 //
-// Comments:
-// If MaterialAmount = 0, then you just need that item in your inventory (guides)
-// For example, Mine Bottle is 7138,32,228,7131,0,713,1,1050,1,1051,1
-// 7131 is the Guide needed to create mine bottles and the amount needed of this item is 0 (.. ,7131,0, ..).
-
+// Notes:
+// If MaterialAmount is 0, the player must have that item in their inventory (i.e. guides).
+// For example, Mine Bottle requires 0x Marine Sphere Creation Guide (ID 7131).
 
 //===== Weapon === ItemLV=1~3 ==================
 

db/re/attr_fix.txt

@@ -1,7 +1,8 @@
-// Elemental attribute damage adjustment tables
+// Elemental Attribute Damage Adjustment Tables
 //
-// Row: target's defense element
-// Column: attacker's weapon element
+// Structure of Database:
+// Columns - attacker's weapon element
+// Rows    - target's defense element
 
 1,10	// lv1 Attribute table
 //Neut Watr Erth Fire Wind Pois Holy Shdw Gho  Und

db/re/exp_guild.txt

@@ -1,4 +1,4 @@
-// Guild LvUp experience value table
+// Guild Experience Tables
 100000
 400000
 900000

db/re/exp_homun.txt

@@ -1,4 +1,4 @@
-//Homunculus LvUp experience value table
+// Homunculus Experience Tables
 347
 545
 891

db/re/instance_db.txt

@@ -2,7 +2,7 @@
 //
 // Structure of Database:
 // ID,Name,LimitTime,EnterMap,EnterX,EnterY,Map1,Map2,Map3,Map4,Map5,Map6,Map7,Map8
-//
+
 0,Endless Tower,14400,1@tower,50,355,1@tower,2@tower,3@tower,4@tower,5@tower,6@tower
 1,Sealed Catacomb,7200,1@cata,100,224,1@cata,2@cata
 2,Orc's Memory,3600,1@orcs,179,15,1@orcs,2@orcs

db/re/item_buyingstore.txt

@@ -1,8 +1,9 @@
 // Buying Store Item List
-// List of items, that can be sold to buying stores.
-// Format: <item id>
-// Example:
-//  512  // Apple
+// List of items that can be sold to buying stores.
+//
+// Structure of Database:
+// ItemID
+//
 // Note:
 //  Items are in same order as data\buyingstoreitemlist.txt, which
 //  must be edited as well for the client to accept added items.

db/re/item_cash_db.txt

@@ -1,9 +1,10 @@
-// This file contains the items sold in the ingame cash shop
+// Cash Shop Database
+// Contains the items sold in the ingame cash shop.
 //
-// The structure of the file is
-// type, item ID, price
+// Structure of Database:
+// Type,ItemID,Price
 //
-// type:
+// Type:
 //    0: New
 //    1: Hot
 //    2: Limited
@@ -13,5 +14,5 @@
 //    6: Heal
 //    7: Other
 //
-// price:
-//    price of the defined item in cash points
+// Price:
+//    Item cost, in cash points (#CASHPOINTS).

db/re/item_delay.txt

@@ -1,8 +1,10 @@
 // Item Delay Database
-// There is a max concurrent number of entries modifiable in src/map/itemdb.h as MAX_ITEMDELAYS
 //
-// Structure:
+// Structure of Database:
 // Item ID,Delay in Milliseconds
+//
+// NOTE:
+// There is a max concurrent number of entries set in src/map/itemdb.h as MAX_ITEMDELAYS.
 
 //12202,60000	//Str_Dish10_
 //12203,60000	//Agi_Dish10_

db/re/item_noequip.txt

@@ -1,12 +1,15 @@
-// The equipment/items/cards restriction file 
-// here you define which items may not be used at PvP / GvG 
-// format: <item id>,<mode>
-// mode
+// Forbidden Items Database
+// Defines restrictions on equipment, items, and cards in map types and zones.
+//
+// Structure of Database:
+// ItemID,Flag
+//
+// Legend for 'Flag' field (bitmask):
 // 1    - restricted in normal maps
 // 2    - restricted in PVP
 // 4    - restricted in GVG
 // 8    - restricted in Battlegrounds
-// Restricted zones - they're configured by 'restricted <number>' mapflag
+// Restricted zones - configured by 'restricted <number>' mapflag
 // 32   - restricted in zone 1
 // 64   - restricted in zone 2
 // 128  - restricted in zone 3
@@ -14,16 +17,13 @@
 // 512  - restricted in zone 5
 // 1024 - restricted in zone 6
 // 2048 - restricted in zone 7
-
-//Examples:
-//1201,1 you can't use KNIFE(ID 1201) on normal maps
-//608,4 you can't use Yggdrasil Seed(ID 608) on both GvG and WoE Castles
-//4174,6 Forbid Deviling Card in every PVP or GVG map, and during woes.
-//501,32 you can't use Red Potion on map marked as 'restricted zone 1'
-//502,64 you can't use Orange Potion on map marked as 'restricted zone 2'
-//503,128 you can't use Yellow Potion on map marked as 'restricted zone 3'
-// you can even mix modes
-//519,322 (256+64+2) you can't use Milk on PVP, and maps marked as 'restricted zone 2' and 'restricted zone 4'
+//
+// Examples:
+// 1201,1   // Knife can't be worn on normal maps
+// 608,4    // Yggdrasil Seed can't be consumed in both GvG and WoE Castles
+// 4174,6   // Deviling Card has no effect in every PVP or GVG map, and during WoE
+// 501,32   // Red Potion can't be consumed on maps marked as 'restricted zone 1'
+// 519,322  // Milk can't be consumed in PVP and maps marked as 'restricted zone 2' or 'restricted zone 4' (256+64+2)
 
 //----------------------------------------------------------------------------
 // Normal maps

db/re/item_package.txt

@@ -1,6 +1,7 @@
-// ====================================
+// Item Package Database
+//
+// Structure of Database:
 // GroupID,ItemID,Rate{,Amount,Random,isAnnounced,Duration,isNamed,isBound}
-// ====================================
 
 IG_Special_Box,Wrapped_Mask,3,1,1
 IG_Special_Box,Poison_Bottle,10,2,1

db/re/item_trade.txt

@@ -1,19 +1,24 @@
-//Item Trading Restrictions File
-//Specify here special rules for item trading.
-//Item ID, TradeMask, Group-Level Override
-//Trading mask values:
-//1:Item can't be dropped
-//2:Item can't be traded (nor vended)
-//4:Wedded partner can override restriction 2.
-//8:Item can't be sold to npcs
-//16:Item can't be placed in the cart
-//32:Item can't be placed in the storage
-//64:Item can't be placed in the guild storage
-//128:Item can't be attached to mail
-//256:Item can't be auctioned
-//Example:
-//1161,67,50 //Balmung: No drop, No trade, No Guild Store (1+2+64 =67),
-//only groups of group-level 50 and up can override the setting.
+// Item Trade Restrictions Database
+// Defines special trade rules for individual items.
+//
+// Structure of Database:
+// Item ID, TradeMask,Group Level Override
+//
+// Legend for 'TradeMask' field (bitmask):
+// 1   - item can't be dropped
+// 2   - item can't be traded (nor vended)
+// 4   - wedded partner can override restriction 2
+// 8   - item can't be sold to npcs
+// 16  - item can't be placed in the cart
+// 32  - item can't be placed in the storage
+// 64  - item can't be placed in the guild storage
+// 128 - item can't be attached to mail
+// 256 - item can't be auctioned
+//
+// Example:
+// 1161,67,50
+//	Balmung cannot be dropped, traded, or placed in Guild Storage (1+2+64).
+//	Only groups of group-level 50 and up can override this setting.
 
 // Wedding Related items
 2634,507,100	// Wedding Ring

db/re/job_param_db.txt

@@ -1,18 +1,15 @@
-// Maximum parameters for specific job!
-// ====================================================
+// Max Parameter Database
+// Sets maximum stat parameters for specific jobs.
+//
 // Structure of Database:
-//	JobID,MaxParam
-//		or
-//	JobID,MaxStr,MaxAgi,MaxVit,MaxInt,MaxDex,MaxLuk
-// ====================================================
-// JobID: Using Job constanta on 'db/const.txt'
+// JobID,MaxParam
+//	OR
+// JobID,MaxStr,MaxAgi,MaxVit,MaxInt,MaxDex,MaxLuk
+//
+// JobID: Job constants in 'db/const.txt'
 // MaxParams: Value between 10 ~ 32767 (SHRT_MAX)
-// ====================================================
+//
 // Examples:
-//Job_Novice,60
-//	Normally, Novice's max. param is using 'max_parameter' on conf/battle/player.conf.
-//	By with this config, Novice's max. param will be 60, for all params.
-//Job_Swordman,90
-//	Normally, Swordman's max. param is using 'max_parameter' on conf/battle/player.conf.
-//	By with this config, Swordman's max. param will be 90, for all params.
-// ====================================================
+// Job_Novice,60
+//	Normally, Novice's max. param uses 'max_parameter' in 'conf/battle/player.conf'.
+//	With this config, Novice's max. param will be 60 (for all stats).

db/re/refine_db.txt

@@ -1,18 +1,17 @@
-// Renewal Version
+// Refine Database [Renewal]
 //
+// Structure of Database:
 // Type,Stats per level,Random bonus start level,Random bonus value,Chance+1:Bonus+1,Chance+2:Bonus+2,Chance+3:Bonus+3,...
 //
-// IMPORTANT: changing the number of upgrade levels requires modifying MAX_REFINE in status.h
-//
 // For armors, values of 100 add 1 armor defense.
 // For weapons, values of 100 add 1 ATK&MATK.
 //
 // Type:
-// 0 - Armors
-// 1 - Level 1 weapons
-// 2 - Level 2 weapons
-// 3 - Level 3 weapons
-// 4 - Level 4 weapons
+//	0 - Armors
+//	1 - Level 1 weapons
+//	2 - Level 2 weapons
+//	3 - Level 3 weapons
+//	4 - Level 4 weapons
 //
 // Stats per level:
 // This value is applied for every upgrade level.
@@ -27,7 +26,9 @@
 // Chance:
 // 100 = 100%
 //
-// A note about renewal Armors, there may or may not be another bonus, according to iRO wiki: Every upgrade gives floor[( 3 + current upgrade ) / 4] equipment DEF)
+// Notes:
+// Changing the number of upgrade levels requires modifying MAX_REFINE in src/map/status.h.
+// For Renewal Armors, there may or may not be another bonus, according to iRO wiki: Every upgrade gives floor[( 3 + current upgrade ) / 4] equipment DEF)
 
 0,0,0,0,100:100,100:100,100:100,100:100,60:200,40:200,40:200,20:200,20:300,10:300,8:300,8:300,8:400,8:400,7:400,7:400,7:500,7:500,5:500,5:500
 // Level 1 weapons

db/re/skill_cast_db.txt

@@ -2,20 +2,19 @@
 //
 // Structure of Database:
 // SkillID,CastingTime,AfterCastActDelay,AfterCastWalkDelay,Duration1,Duration2,Cool Down,Fixed Casting Time
-//== Explained:
-// CastingTime : time to cast this skill, in miliseconds
-// AfterCastActDelay : "normal" delay, character cannot use skills, in miliseconds
-// AfterCastWalkDleay : amount of time before character can move again, in miliseconds
-// Duration1 / Duration2 : usually the durations used by the skill, at special cases it is used to hold special data
-// Cool Down : amount of time until character can re-use this skill, in miliseconds
+//
+// CastingTime: time to cast this skill, in miliseconds
+// AfterCastActDelay: "normal" delay, character cannot use skills, in miliseconds
+// AfterCastWalkDleay: amount of time before character can move again, in miliseconds
+// Duration1/Duration2: usually the durations used by the skill, at special cases it is used to hold special data
+// Cool Down: amount of time until character can re-use this skill, in miliseconds
 // Fixed Casting Time: the skills fixed casting time (when 0, uses 20% of cast time and less than 0 means no fixed cast time)
-//== Extra
-// On all fields you can use ':' as a delimiter to level-specific values,
-// - Example using SM_PROVOKE
-// - Original:6,0,0,0,30000,0,1000
-// - ModifiedTo:6,0,0,0,30000,0,1000:2500:3000:etc
-// - Makes lvl 1 have 1000 (1s) cool down, lvl 2 2500 (2.5s), lvl 3 3000, and so on.
-//==========================================
+//
+// On all fields you can use ':' as a delimiter for level-specific values.
+// For example:
+// - Original: 6,0,0,0,30000,0,1000
+// - Modified: 6,0,0,0,30000,0,1000:2500:3000:...
+// Gives Level 1 1000ms cool down, Level 2 2500ms, Level 3 3000ms, and so on.
 
 
 //===== Swordman ===========================

db/re/skill_nocast_db.txt

@@ -1,25 +1,26 @@
 // Forbidden Skills Database
+// Defines unusable skills in map types and zones.
 //
 // Structure of Database:
 // SkillID,Flag
 //
 // Legend for 'Flag' field (bitmask):
-//  1 = Cannot be used in normal maps
-//  2 = Cannot be used in PvP maps (use this instead of 1 for PK-mode servers)
-//  4 = Cannot be used in GvG maps
-//  8 = Cannot be used in Battleground maps
-//  16 = Cannot be cloned (clones will not copy this skill)
-//  Restricted zones - they're configured by 'restricted <number>' mapflag
-//  32 = Cannot be used in zone 1 maps
-//  64 = Cannot be used in zone 2 maps
-//  128 = Cannot be used in zone 3 maps
-//  256 = Cannot be used in zone 4 maps
-//  512 = Cannot be used in zone 5 maps
-//  1024 = Cannot be used in zone 6 maps
-//  2048 = Cannot be used in zone 7 maps
+// 1    - cannot be used in normal maps
+// 2    - cannot be used in PvP maps (use this instead of 1 for PK-mode servers)
+// 4    - cannot be used in GvG maps
+// 8    - cannot be used in Battleground maps
+// 16   - cannot be cloned (clones will not copy this skill)
+// Restricted zones - configured by 'restricted <number>' mapflag
+// 32   - cannot be used in zone 1 maps
+// 64   - cannot be used in zone 2 maps
+// 128  - cannot be used in zone 3 maps
+// 256  - cannot be used in zone 4 maps
+// 512  - cannot be used in zone 5 maps
+// 1024 - cannot be used in zone 6 maps
+// 2048 - cannot be used in zone 7 maps
 //
 // Example:
-// 8,6 = Endure cannot be used in PvP and GvG maps (2+4)
+// 8,6  // Endure cannot be used in PvP and GvG maps (2+4)
 
 //----------------------------------------------------------------------------
 // Normal

db/re/skill_unit_db.txt

@@ -1,3 +1,6 @@
+// Skill Unit Database
+//
+// Structure of Database:
 // ID,unit ID,unit ID 2,layout,range,interval,target,flag
 //
 // layout = -1:special, 0:1*1, 1:3*3, 2:5*5, up to 5:11*11
@@ -19,7 +22,6 @@
 // 	Example: 0x006 = 0x002+0x004 -> Cannot be stacked nor cast near targets
 //
 // Notes:
-// ------
 //    0x89,0x8a,0x8b without indication
 //
 //    u1   u2 lay  r intr target  flag

db/size_fix.txt

@@ -1,6 +1,10 @@
-// Database for size fix for weapon damage.
+// Size Fix Tables
+// Contains size fixes for weapon damage.
+//
+// Struture of Database:
+// Columns - Weapon type
+// Rows    - Target size
 
-//Columns: Weapon type, Rows: Target size.
 //Unarmed, Knife, 1H Sword, 2H Sword, 1H Spear, 2H Spears, 1H Axe, 2H Axe, Mace, 2H Mace, Staff, Bow, Knuckle, Musical Instrument, Whip, Book, Katar, Revolver, Rifle, Shotgun, Gatling Gun, Grenade Launcher, Fuuma Shuriken, 2H Staff
 100,100, 75, 75, 75, 75, 50, 50, 75,100,100,100,100, 75, 75,100, 75,100,100,100,100,100,100,100	// Size: Small
 100, 75,100, 75, 75, 75, 75, 75,100,100,100,100, 75,100,100,100,100,100,100,100,100,100,100,100	// Size: Medium

db/skill_copyable_db.txt

@@ -1,27 +1,32 @@
-// Available Skills for Intimidate/Plagiarism or Reproduce
-// ====================================================
+// Copyable Skills Database
+// List of skills able to be copied by Intimidate/Plagiarism and Reproduce.
+//
+// Sources:
 // http://irowiki.org/wiki/Intimidate
 //    -> "Intimidate will copy any 2nd class skill"
 // http://irowiki.org/wiki/Reproduce/List_of_reproducible_skills
-//    -> "Players can reproduce 1-x, 2-x, and 3-x skills and Expanded Class, but cannot
-//        reproduce transcendent skills"
-// ====================================================
+//    -> "Players can reproduce 1-x, 2-x, and 3-x skills and Expanded Class,
+//        but cannot reproduce transcendent skills"
+//
 // Structure of Database:
-//    SkillName,Option{,JobAllowed{,RequirementRemoved}}
-// ====================================================
-// Option is using bitmask of skill that can be copied by:
+// SkillName,Option{,JobAllowed{,RequirementRemoved}}
+//
+// Option (bitmask) determines how a skill can be copied.
 //	1 = Plagiarism
 //	2 = Reproduce
-// JobAllowed, the skill only can be copied by:
-//	(0 or the default value makes all jobs can copy the skill)
-//	1	= Rogue
-//	2	= Stalker
-//	4	= Shadow Chaser
-//	8	= Trans. Shadow Chaser
-//	16	= Baby Rouge
-//	32	= Baby Shadow Chaser
-// RequirementRemoved, decide which requirement(s) that will be removed while checking.
-//	   0 = makes the requirement(s) same like original requirement(s)
+//
+// JobAllowed (bitmask) restricts copying the skill to certain classes.
+// By default, all jobs can copy the skill (0).
+//	 1 = Rogue
+//	 2 = Stalker
+//	 4 = Shadow Chaser
+//	 8 = Trans. Shadow Chaser
+//	16 = Baby Rouge
+//	32 = Baby Shadow Chaser
+//	
+// RequirementRemoved (bitmask) removes requirements when casting a copied skill.
+// See 'skill_require_db.txt' for specific skill requirements.
+//	   0 = uses original requirement(s)
 //	   1 = hp
 //	   2 = maxhptrigger
 //	   4 = sp
@@ -35,19 +40,15 @@
 //	1024 = spirit sphere
 //	2048 = items (with the amount)
 //	4096 = equipments
-// (see 'skill_require_db.txt' for requirement(s) detail)
-// ====================================================
-// Example of advanced usage:
-//AS_SONICBLOW,2,63,64
-// AS_SONICBLOW can be copied by all jobs by only Plagiarism. To use the copied skill,
-// doesn't need to use katar weapon (Sonic Blow weapon type requirement)
 //
-//CR_ACIDDEMONSTRATION,3,10
-// CR_ACIDDEMONSTRATION only can be copied by Stalker/Trans. Shadow Chaser by Plagiarism
-// or Reproduce.
-// This mode just like previous battle config which there was option only allow Trans.
-// Skills only can be copied by Trans. class (Stalker/Trans. Shadow Chaser).
-// ====================================================
+// Examples:
+// AS_SONICBLOW,2,63,64
+//	Sonic Blow can be copied by all jobs with only Plagiarism.
+//	To use the copied skill, a Katar is not needed (a Sonic Blow weapon type requirement).
+//
+// CR_ACIDDEMONSTRATION,3,10
+//	Acid Demonstration can only be copied by Stalker/Trans. Shadow Chaser with Plagiarism or Reproduce.
+//	This mode simulates the previous battle config, which allowed only Trans. classes to copy Trans. skills.
 
 //Swordsman
 SM_BASH,3   //Bash

db/skill_nonearnpc_db.txt

@@ -1,24 +1,30 @@
-// Database of Additional Range and NPC Type that used by INF2_NO_NEARNPC
-// <skill_name>,<additional_range>{,<npc_type>}
-// ====================================================
-// additional_range: If this value is 0, splash range value will be used from skill_db,
-//      or if it is 0, range+layout's range from skill_unit_db. Otherwise, the range
-//      will be added.
-// npc_type (bitmask): 1 = warp portal, 2 = shop NPC, 4 = normal NPC script, 8 = tomb
-// ====================================================
-// Example:
-//MG_SAFETYWALL,2
-// MG_SAFETYWALL can't be placed if the ground's target is near from NPC by 2 cells
-// (MG_SAFETYWALL doesn't have splash, layout range, and range value, so must add the
-// 'additional_range', or it will be pointless)
+// Skill Distance-to-NPC Database
+// Prevents skills from being used near NPC types using INF2_NO_NEARNPC.
 //
-//GS_DESPERADO,2
-// GS_DESPERADO can't be casted if the caster is standing near from NPC within range
-// 5 cells. (Why? GS_DESPERADO has 3 cells of splash range +2 'additional_range' here)
+// Structure of Database:
+// SkillName,AdditionalRange{,NPC Type}
 //
-//SC_CHAOSPANIC,0,1
-// SC_CHAOSPANIC can't be placed on the ground that near the warp portal with range 2
-// cells. (Because SC_CHAOSPANIC doens't have splash range, it uses layout range)
+// AdditionalRange:
+//	Number of cells from an NPC where the skill can be cast.
+//	If zero, this will read the splash range value from skill_db;
+//	if that is also zero, range+layout's range from skill_unit_db will be used.
+//
+// NPC Type (bitmask):
+//	1 = warp portal, 2 = shop NPC, 4 = normal NPC script, 8 = tomb
+//
+// Examples:
+// MG_SAFETYWALL,2
+//	Safety Wall can't be placed within 2 ground cells of an NPC.
+//	(MG_SAFETYWALL doesn't have splash, layout range, and range value,
+//	so we must add the 'additional_range', or it will be pointless.)
+//
+// GS_DESPERADO,2
+//	Desperado can't be casted if the caster is standing within 5 cells of an NPC.
+//	(Why? GS_DESPERADO has 3 cells of splash range +2 'additional_range' here.)
+//
+// SC_CHAOSPANIC,0,1
+//	Chaos Panic can't be placed within 2 ground cells of a warp portal.
+//	(Because SC_CHAOSPANIC doesn't have splash range, it uses layout range.)
 
 SC_CHAOSPANIC,0,1
 SC_MAELSTROM,0,1

db/spellbook_db.txt

@@ -3,7 +3,7 @@
 // Structure of Database:
 // SkillID,PreservePoints,Required Book
 //
-// To add more entries, increase MAX_SKILL_SPELLBOOK_DB in skill.h.
+// NOTE: To add more entries, increase MAX_SKILL_SPELLBOOK_DB in skill.h.
 
 //Mage
 14,7,6190	//Cold Bolt