Standardized formatting of database files.

Signed-off-by: Euphy <euphy.raliel@rathena.org>
2013-12-29 15:58:17 -05:00
parent cf1798265c
commit 7083ecf079
45 changed files with 377 additions and 319 deletions
--- a/db/elemental_db.txt
+++ b/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
--- a/db/elemental_skill_db.txt
+++ b/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
--- a/db/item_cash_db2.txt
+++ b/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).
--- a/db/item_nouse.txt
+++ b/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
--- a/db/item_stack.txt
+++ b/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
--- a/db/magicmushroom_db.txt
+++ b/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
--- a/db/mob_classchange.txt
+++ b/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
--- a/db/pre-re/attr_fix.txt
+++ b/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
--- a/db/pre-re/exp_guild.txt
+++ b/db/pre-re/exp_guild.txt
@@ -1,4 +1,4 @@
-// Guild LvUp experience value table
+// Guild Experience Tables
 2000000
 4000000
 8000000
--- a/db/pre-re/exp_homun.txt
+++ b/db/pre-re/exp_homun.txt
@@ -1,4 +1,4 @@
-//Homunculus LvUp experience value table
+// Homunculus Experience Tables
 50
 110
 180
--- a/db/pre-re/instance_db.txt
+++ b/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
--- a/db/pre-re/item_buyingstore.txt
+++ b/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.
--- a/db/pre-re/item_cash_db.txt
+++ b/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).
--- a/db/pre-re/item_delay.txt
+++ b/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_
--- a/db/pre-re/item_noequip.txt
+++ b/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
--- a/db/pre-re/item_trade.txt
+++ b/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
--- a/db/pre-re/job_basehpsp_db.txt
+++ b/db/pre-re/job_basehpsp_db.txt
@@ -1,13 +1,15 @@
-//===============================
-//Base HP/SP Table
-//Support up-to lv. 500
-//StartLevel,EndLevel,JobID,Type,Base value for Lv 1,2,...,Base value for lv 'Max level'
-//Type: 0 - BaseHP; 1 - BaseSP
-//===============================
+// Base HP/SP Tables
+// Supports up to base level 500.
+//
+// Structure of Database:
+// StartLevel,EndLevel,JobID,Type,Base value for Lv 1,2,...,Base value for lv 'Max level'
+//
+// Type:
+//	0 = BaseHP, 1 = BaseSP

 //===============================
-//Base HP Table
-//According to base HP calculation on http://irowiki.org/wiki/Max_HP
+// Base HP Table
+// According to base HP calculation on http://irowiki.org/wiki/Max_HP
 //===============================

 //Novice, Super Novice, Novice High, Baby Novice, Super Baby, Super Novice (Expanded), Super Baby (Expanded)
@@ -91,8 +93,8 @@
 1,500,4051,0,40,47,54,62,71,81,91,102,114,127,140,154,169,185,201,218,236,255,274,294,315,337,359,382,406,431,456,482,509,537,565,594,624,655,686,718,751,785,819,854,890,927,964,1002,1041,1081,1121,1162,1204,1247,1290,1334,1379,1425,1471,1518,1566,1615,1664,1714,1765,1817,1869,1922,1976,2031,2086,2142,2199,2257,2315,2374,2434,2495,2556,2618,2681,2745,2809,2874,2940,3007,3074,3142,3211,3281,3351,3422,3494,3567,3640,3714,3789,3865,3941,4018,4096,4175,4254,4334,4415,4497,4579,4662,4746,4831,4916,5002,5089,5177,5265,5354,5444,5535,5626,5718,5811,5905,5999,6094,6190,6287,6384,6482,6581,6681,6781,6882,6984,7087,7190,7294,7399,7505,7611,7718,7826,7935,8044,8154,8265,8377,8489,8602,8716,8831,8946,9062,9179,9297,9415,9534,9654,9775,9896,10018,10141,10265,10389,10514,10640,10767,10894,11022,11151,11281,11411,11542,11674,11807,11940,12074,12209,12345,12481,12618,12756,12895,13034,13174,13315,13457,13599,13742,13886,14031,14176,14322,14469,14617,14765,14914,15064,15215,15366,15518,15671,15825,15979,16134,16290,16447,16604,16762,16921,17081,17241,17402,17564,17727,17890,18054,18219,18385,18551,18718,18886,19055,19224,19394,19565,19737,19909,20082,20256,20431,20606,20782,20959,21137,21315,21494,21674,21855,22036,22218,22401,22585,22769,22954,23140,23327,23514,23702,23891,24081,24271,24462,24654,24847,25040,25234,25429,25625,25821,26018,26216,26415,26614,26814,27015,27217,27419,27622,27826,28031,28236,28442,28649,28857,29065,29274,29484,29695,29906,30118,30331,30545,30759,30974,31190,31407,31624,31842,32061,32281,32501,32722,32944,33167,33390,33614,33839,34065,34291,34518,34746,34975,35204,35434,35665,35897,36129,36362,36596,36831,37066,37302,37539,37777,38015,38254,38494,38735,38976,39218,39461,39705,39949,40194,40440,40687,40934,41182,41431,41681,41931,42182,42434,42687,42940,43194,43449,43705,43961,44218,44476,44735,44994,45254,45515,45777,46039,46302,46566,46831,47096,47362,47629,47897,48165,48434,48704,48975,49246,49518,49791,50065,50339,50614,50890,51167,51444,51722,52001,52281,52561,52842,53124,53407,53690,53974,54259,54545,54831,55118,55406,55695,55984,56274,56565,56857,57149,57442,57736,58031,58326,58622,58919,59217,59515,59814,60114,60415,60716,61018,61321,61625,61929,62234,62540,62847,63154,63462,63771,64081,64391,64702,65014,65327,65640,65954,66269,66585,66901,67218,67536,67855,68174,68494,68815,69137,69459,69782,70106,70431,70756,71082,71409,71737,72065,72394,72724,73055,73386,73718,74051,74385,74719,75054,75390,75727,76064,76402,76741,77081,77421,77762,78104,78447,78790,79134,79479,79825,80171,80518,80866,81215,81564,81914,82265,82617,82969,83322,83676,84031,84386,84742,85099,85457,85815,86174,86534,86895,87256,87618,87981,88345,88709,89074,89440,89807,90174,90542,90911,91281,91651,92022,92394,92767,93140,93514,93889,94265,94641,95018,95396,95775,96154,96534

 //===============================
-//Base SP Table
-//According to base SP calculation on http://irowiki.org/wiki/Max_SP
+// Base SP Table
+// According to base SP calculation on http://irowiki.org/wiki/Max_SP
 //===============================

 //Novice, Super Novice, Novice High, Baby Novice, Super Baby, Super Novice (Expanded), Super Baby (Expanded)
--- a/db/pre-re/job_exp.txt
+++ b/db/pre-re/job_exp.txt
--- a/db/pre-re/job_param_db.txt
+++ b/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).
--- a/db/pre-re/refine_db.txt
+++ b/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
--- a/db/pre-re/skill_cast_db.txt
+++ b/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 ===========================
--- a/db/pre-re/skill_nocast_db.txt
+++ b/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
--- a/db/pre-re/skill_unit_db.txt
+++ b/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
--- a/db/produce_db.txt
+++ b/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 ==================

--- a/db/re/attr_fix.txt
+++ b/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
--- a/db/re/exp_guild.txt
+++ b/db/re/exp_guild.txt
@@ -1,4 +1,4 @@
-// Guild LvUp experience value table
+// Guild Experience Tables
 100000
 400000
 900000
--- a/db/re/exp_homun.txt
+++ b/db/re/exp_homun.txt
@@ -1,4 +1,4 @@
-//Homunculus LvUp experience value table
+// Homunculus Experience Tables
 347
 545
 891
--- a/db/re/instance_db.txt
+++ b/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
--- a/db/re/item_buyingstore.txt
+++ b/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.
--- a/db/re/item_cash_db.txt
+++ b/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).
--- a/db/re/item_delay.txt
+++ b/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_
--- a/db/re/item_noequip.txt
+++ b/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
--- a/db/re/item_package.txt
+++ b/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
--- a/db/re/item_trade.txt
+++ b/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
--- a/db/re/job_basehpsp_db.txt
+++ b/db/re/job_basehpsp_db.txt
@@ -1,13 +1,15 @@
-//===============================
-//Base HP/SP Table
-//Support up-to lv. 500
-//StartLevel,EndLevel,JobID,Type,Base value for Lv 1,2,...,Base value for lv 'Max level'
-//Type: 0 - BaseHP; 1 - BaseSP
-//===============================
+// Base HP/SP Tables
+// Supports up to base level 500.
+//
+// Structure of Database:
+// StartLevel,EndLevel,JobID,Type,Base value for Lv 1,2,...,Base value for 'Max level'
+//
+// Type:
+//	0 = BaseHP, 1 = BaseSP

 //===============================
-//Base HP Table
-//According to base HP calculation on http://irowiki.org/wiki/Max_HP
+// Base HP Table
+// According to base HP calculation on http://irowiki.org/wiki/Max_HP
 //===============================

 //Novice, Super Novice, Novice High, Baby Novice, Super Baby, Super Novice (Expanded), Super Baby (Expanded)
@@ -91,8 +93,8 @@
 1,500,4051,0,40,47,54,62,71,81,91,102,114,127,140,154,169,185,201,218,236,255,274,294,315,337,359,382,406,431,456,482,509,537,565,594,624,655,686,718,751,785,819,854,890,927,964,1002,1041,1081,1121,1162,1204,1247,1290,1334,1379,1425,1471,1518,1566,1615,1664,1714,1765,1817,1869,1922,1976,2031,2086,2142,2199,2257,2315,2374,2434,2495,2556,2618,2681,2745,2809,2874,2940,3007,3074,3142,3211,3281,3351,3422,3494,3567,3640,3714,3789,3865,3941,4018,4096,4175,4254,4334,4415,4497,4579,4662,4746,4831,4916,5002,5089,5177,5265,5354,5444,5535,5626,5718,5811,5905,5999,6094,6190,6287,6384,6482,6581,6681,6781,6882,6984,7087,7190,7294,7399,7505,7611,7718,7826,7935,8044,8154,8265,8377,8489,8602,8716,8831,8946,9062,9179,9297,9415,9534,9654,9775,9896,10018,10141,10265,10389,10514,10640,10767,10894,11022,11151,11281,11411,11542,11674,11807,11940,12074,12209,12345,12481,12618,12756,12895,13034,13174,13315,13457,13599,13742,13886,14031,14176,14322,14469,14617,14765,14914,15064,15215,15366,15518,15671,15825,15979,16134,16290,16447,16604,16762,16921,17081,17241,17402,17564,17727,17890,18054,18219,18385,18551,18718,18886,19055,19224,19394,19565,19737,19909,20082,20256,20431,20606,20782,20959,21137,21315,21494,21674,21855,22036,22218,22401,22585,22769,22954,23140,23327,23514,23702,23891,24081,24271,24462,24654,24847,25040,25234,25429,25625,25821,26018,26216,26415,26614,26814,27015,27217,27419,27622,27826,28031,28236,28442,28649,28857,29065,29274,29484,29695,29906,30118,30331,30545,30759,30974,31190,31407,31624,31842,32061,32281,32501,32722,32944,33167,33390,33614,33839,34065,34291,34518,34746,34975,35204,35434,35665,35897,36129,36362,36596,36831,37066,37302,37539,37777,38015,38254,38494,38735,38976,39218,39461,39705,39949,40194,40440,40687,40934,41182,41431,41681,41931,42182,42434,42687,42940,43194,43449,43705,43961,44218,44476,44735,44994,45254,45515,45777,46039,46302,46566,46831,47096,47362,47629,47897,48165,48434,48704,48975,49246,49518,49791,50065,50339,50614,50890,51167,51444,51722,52001,52281,52561,52842,53124,53407,53690,53974,54259,54545,54831,55118,55406,55695,55984,56274,56565,56857,57149,57442,57736,58031,58326,58622,58919,59217,59515,59814,60114,60415,60716,61018,61321,61625,61929,62234,62540,62847,63154,63462,63771,64081,64391,64702,65014,65327,65640,65954,66269,66585,66901,67218,67536,67855,68174,68494,68815,69137,69459,69782,70106,70431,70756,71082,71409,71737,72065,72394,72724,73055,73386,73718,74051,74385,74719,75054,75390,75727,76064,76402,76741,77081,77421,77762,78104,78447,78790,79134,79479,79825,80171,80518,80866,81215,81564,81914,82265,82617,82969,83322,83676,84031,84386,84742,85099,85457,85815,86174,86534,86895,87256,87618,87981,88345,88709,89074,89440,89807,90174,90542,90911,91281,91651,92022,92394,92767,93140,93514,93889,94265,94641,95018,95396,95775,96154,96534

 //===============================
-//Base SP Table
-//According to base SP calculation on http://irowiki.org/wiki/Max_SP
+// Base SP Table
+// According to base SP calculation on http://irowiki.org/wiki/Max_SP
 //===============================

 //Novice, Super Novice, Novice High, Baby Novice, Super Baby, Super Novice (Expanded), Super Baby (Expanded)
--- a/db/re/job_exp.txt
+++ b/db/re/job_exp.txt
--- a/db/re/job_param_db.txt
+++ b/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).
--- a/db/re/refine_db.txt
+++ b/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
--- a/db/re/skill_cast_db.txt
+++ b/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 ===========================
--- a/db/re/skill_nocast_db.txt
+++ b/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
--- a/db/re/skill_unit_db.txt
+++ b/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
--- a/db/size_fix.txt
+++ b/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
--- a/db/skill_copyable_db.txt
+++ b/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
--- a/db/skill_nonearnpc_db.txt
+++ b/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
--- a/db/spellbook_db.txt
+++ b/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