Update

- Fixed some documentation
- Fixed some alignment

7 files changed, 133 insertions, 45 deletions

diff --git a/db/castle_db.txt b/db/castle_db.txt
index 45a1443d5..12e222eb6 100644
--- a/db/castle_db.txt
+++ b/db/castle_db.txt
@@ -3,44 +3,72 @@
 // Structure of Database:
 // CastleID,MapName,CastleName,OnGuildBreakEventName,Flag
 //
-// 01. CastleID					Unique ID of the castle. Must remain unique across all map-servers.
-// 02. MapName					Map name to be considered as the castle map.
-// 03. CastleName				Name of the castle (used by scripts and guardian name tags).
-// 04. OnGuildBreakEventName	NPC unique name to invoke ::OnGuildBreak on, when a occupied
-//								castle is abandoned during guild break.
-// 05. Flag						Switch flag (reserved as of athena-dev mod0796~0801, not used by server).
-
-0,aldeg_cas01,Neuschwanstein,Agit#aldeg_cas01,1		// kRO : Noisyubantian
-1,aldeg_cas02,Hohenschwangau,Agit#aldeg_cas02,1		// kRO : Hohensyubangawoo
-2,aldeg_cas03,Nuernberg,Agit#aldeg_cas03,1			// kRO : Nyirenverk
-3,aldeg_cas04,Wuerzburg,Agit#aldeg_cas04,1			// kRO : Byirtsburi
-4,aldeg_cas05,Rothenburg,Agit#aldeg_cas05,1			// kRO : Rotenburk
-5,gefg_cas01,Repherion,Agit#gefg_cas01,1			// kRO : Reprion
-6,gefg_cas02,Eeyolbriggar,Agit#gefg_cas02,1			// kRO : Yolbriger
-7,gefg_cas03,Yesnelph,Agit#gefg_cas03,1				// kRO : Isinlife
-8,gefg_cas04,Bergel,Agit#gefg_cas04,1				// kRO : Berigel
-9,gefg_cas05,Mersetzdeitz,Agit#gefg_cas05,1			// kRO : Melsedetsu
-10,payg_cas01,Bright Arbor,Agit#payg_cas01,1		// kRO : Mingting
-11,payg_cas02,Scarlet Palace,Agit#payg_cas02,1		// kRO : Tiantan
-12,payg_cas03,Holy Shadow,Agit#payg_cas03,1			// kRO : Fuying
-13,payg_cas04,Sacred Altar,Agit#payg_cas04,1		// kRO : Honglou
-14,payg_cas05,Bamboo Grove Hill,Agit#payg_cas05,1	// kRO : Zhulinxian
-15,prtg_cas01,Kriemhild,Agit#prtg_cas01,1			// kRO : Creamhilt
-16,prtg_cas02,Swanhild,Agit#prtg_cas02,1			// kRO : Sbanhealt
-17,prtg_cas03,Fadhgridh,Agit#prtg_cas03,1			// kRO : Lazrigees
-18,prtg_cas04,Skoegul,Agit#prtg_cas04,1				// kRO : Squagul
-19,prtg_cas05,Gondul,Agit#prtg_cas05,1				// kRO : Guindull
+// 01. CastleID                  Unique ID of the castle. Must remain unique across all map-servers.
+// 02. MapName                   Map name to be considered as the castle map.
+// 03. CastleName                Name of the castle (used by scripts and guardian name tags).
+// 04. OnGuildBreakEventName     NPC unique name to invoke ::OnGuildBreak on, when a occupied
+//                               castle is abandoned during guild break.
+// 05. Flag                      Switch flag (reserved as of athena-dev mod0796~0801, not used by server).
+
+
+//================
+// Al De Baran
+//================
+0,aldeg_cas01,Neuschwanstein,Agit#aldeg_cas01,1       // kRO : Noisyubantian
+1,aldeg_cas02,Hohenschwangau,Agit#aldeg_cas02,1       // kRO : Hohensyubangawoo
+2,aldeg_cas03,Nuernberg,Agit#aldeg_cas03,1            // kRO : Nyirenverk
+3,aldeg_cas04,Wuerzburg,Agit#aldeg_cas04,1            // kRO : Byirtsburi
+4,aldeg_cas05,Rothenburg,Agit#aldeg_cas05,1           // kRO : Rotenburk
+
+//================
+// Geffen
+//================
+5,gefg_cas01,Repherion,Agit#gefg_cas01,1              // kRO : Reprion
+6,gefg_cas02,Eeyolbriggar,Agit#gefg_cas02,1           // kRO : Yolbriger
+7,gefg_cas03,Yesnelph,Agit#gefg_cas03,1               // kRO : Isinlife
+8,gefg_cas04,Bergel,Agit#gefg_cas04,1                 // kRO : Berigel
+9,gefg_cas05,Mersetzdeitz,Agit#gefg_cas05,1           // kRO : Melsedetsu
+
+//================
+// Payon
+//================
+10,payg_cas01,Bright Arbor,Agit#payg_cas01,1          // kRO : Mingting
+11,payg_cas02,Scarlet Palace,Agit#payg_cas02,1        // kRO : Tiantan
+12,payg_cas03,Holy Shadow,Agit#payg_cas03,1           // kRO : Fuying
+13,payg_cas04,Sacred Altar,Agit#payg_cas04,1          // kRO : Honglou
+14,payg_cas05,Bamboo Grove Hill,Agit#payg_cas05,1     // kRO : Zhulinxian
+
+//================
+// Prontera
+//================
+15,prtg_cas01,Kriemhild,Agit#prtg_cas01,1             // kRO : Creamhilt
+16,prtg_cas02,Swanhild,Agit#prtg_cas02,1              // kRO : Sbanhealt
+17,prtg_cas03,Fadhgridh,Agit#prtg_cas03,1             // kRO : Lazrigees
+18,prtg_cas04,Skoegul,Agit#prtg_cas04,1               // kRO : Squagul
+19,prtg_cas05,Gondul,Agit#prtg_cas05,1                // kRO : Guindull
+
+//================
+// Novice Guilds
+//================
 20,nguild_alde,Earth,Agit_N01,2
 21,nguild_gef,Air,Agit_N02,2
 22,nguild_pay,Water,Agit_N03,2
 23,nguild_prt,Fire,Agit_N04,2
-24,schg_cas01,Himinn,Manager#schg_cas01,1			// kRO : Himinn
-25,schg_cas02,Andlangr,Manager#schg_cas02,1			// kRO : Andlangr
-26,schg_cas03,Viblainn,Manager#schg_cas03,1			// kRO : Viblainn
-27,schg_cas04,Hljod,Manager#schg_cas04,1			// kRO : Hljod
-28,schg_cas05,Skidbladnir,Manager#schg_cas05,1		// kRO : Skidbladnir
-29,arug_cas01,Mardol,Manager#arug_cas01,1			// kRO : Mardol
-30,arug_cas02,Cyr,Manager#arug_cas02,1				// kRO : Cyr
-31,arug_cas03,Horn,Manager#arug_cas03,1				// kRO : Horn
-32,arug_cas04,Gefn,Manager#arug_cas04,1				// kRO : Gefn
-33,arug_cas05,Bandis,Manager#arug_cas05,1			// kRO : Bandis
+
+//================
+// Yuno
+//================
+24,schg_cas01,Himinn,Manager#schg_cas01,1             // kRO : Himinn
+25,schg_cas02,Andlangr,Manager#schg_cas02,1           // kRO : Andlangr
+26,schg_cas03,Viblainn,Manager#schg_cas03,1           // kRO : Viblainn
+27,schg_cas04,Hljod,Manager#schg_cas04,1              // kRO : Hljod
+28,schg_cas05,Skidbladnir,Manager#schg_cas05,1        // kRO : Skidbladnir
+
+//================
+// Rachel
+//================
+29,arug_cas01,Mardol,Manager#arug_cas01,1             // kRO : Mardol
+30,arug_cas02,Cyr,Manager#arug_cas02,1                // kRO : Cyr
+31,arug_cas03,Horn,Manager#arug_cas03,1               // kRO : Horn
+32,arug_cas04,Gefn,Manager#arug_cas04,1               // kRO : Gefn
+33,arug_cas05,Bandis,Manager#arug_cas05,1             // kRO : Bandis
diff --git a/db/pre-re/item_chain.conf b/db/pre-re/item_chain.conf
index 795c2f700..f7591b934 100644
--- a/db/pre-re/item_chain.conf
+++ b/db/pre-re/item_chain.conf
@@ -8,8 +8,17 @@
 //=                                                  
 //=            http://hercules.ws/board/                        
 //================= More Information =================
-// <link~u> <desc~!>
+// http://hercules.ws/board/topic/1244-official-item-grouppackagechain
 //====================================================
+// Structure of file:
+/*
+
+ ITMCHAIN_<Name>: {
+   <Item_Name>: <chance>
+ }
+
+*/
+
 ITMCHAIN_ORE: {
 	Iron_Ore: 600
 	Iron: 380
diff --git a/db/pre-re/item_group.conf b/db/pre-re/item_group.conf
index 533e2f0ae..b2f4b1ac4 100644
--- a/db/pre-re/item_group.conf
+++ b/db/pre-re/item_group.conf
@@ -8,9 +8,16 @@
 //=                                                  
 //=            http://hercules.ws/board/                        
 //================= More Information =================
-// <link~u> <desc~!>
+// http://hercules.ws/board/topic/1244-official-item-grouppackagechain
 //====================================================
-// <Container_Item_Name>: ( <...> "Item_Name" or ("Item_Name",Repeat_Count) )
+// Structure of file:
+/*
+ <Container_Item_Name>: (
+      "Item_Name" or 
+      ("Item_Name",Repeat_Count)
+ )
+*/
+
 Old_Card_Album: (
 	("Poring_Card",8),
 	("Fabre_Card",10),
diff --git a/db/pre-re/item_packages.conf b/db/pre-re/item_packages.conf
index f2f467681..acbd88752 100644
--- a/db/pre-re/item_packages.conf
+++ b/db/pre-re/item_packages.conf
@@ -8,8 +8,22 @@
 //=                                                  
 //=            http://hercules.ws/board/                        
 //================= More Information =================
-// <link~u> <desc~!>
+// http://hercules.ws/board/topic/1244-official-item-grouppackagechain
 //====================================================
+// Structure of file:
+/*
+<Container_Item_Name>: {
+    <Entry_Item_Name>: {
+        Random: True/False - Signs whether a item is randomed or should be given whenever the packageis consumed.
+        Count: 30 - Stands for how much <Entry_Item_Name> will be obtained.
+        Expire: 2 - Signs how many hours this item will last (makes a rental item).
+        Announce: True/False - Signs whether to relay a special item obtain announcement when this item comes out of the package.
+        Rate: 50 - If 'Random' is True, a rate from 1 to 10000 (0.01% - 100%) will be given.
+        Named: True/False - Signs whether the item should have the owner's name in it.
+	}
+}
+*/
+
 Special_Box: {
 	Wrapped_Mask: {
 		Rate: 3
diff --git a/db/re/item_chain.conf b/db/re/item_chain.conf
index 795c2f700..f7591b934 100644
--- a/db/re/item_chain.conf
+++ b/db/re/item_chain.conf
@@ -8,8 +8,17 @@
 //=                                                  
 //=            http://hercules.ws/board/                        
 //================= More Information =================
-// <link~u> <desc~!>
+// http://hercules.ws/board/topic/1244-official-item-grouppackagechain
 //====================================================
+// Structure of file:
+/*
+
+ ITMCHAIN_<Name>: {
+   <Item_Name>: <chance>
+ }
+
+*/
+
 ITMCHAIN_ORE: {
 	Iron_Ore: 600
 	Iron: 380
diff --git a/db/re/item_group.conf b/db/re/item_group.conf
index 3308cd96c..e392ae2b6 100644
--- a/db/re/item_group.conf
+++ b/db/re/item_group.conf
@@ -8,9 +8,16 @@
 //=                                                  
 //=            http://hercules.ws/board/                        
 //================= More Information =================
-// <link~u> <desc~!>
+// http://hercules.ws/board/topic/1244-official-item-grouppackagechain
 //====================================================
-// <Container_Item_Name>: ( <...> "Item_Name" or ("Item_Name",Repeat_Count) )
+// Structure of file:
+/*
+ <Container_Item_Name>: (
+      "Item_Name" or 
+      ("Item_Name",Repeat_Count)
+ )
+*/
+
 Old_Card_Album: (
 	("Poring_Card",8),
 	("Fabre_Card",10),
diff --git a/db/re/item_packages.conf b/db/re/item_packages.conf
index d0a13e290..c4c782d0f 100644
--- a/db/re/item_packages.conf
+++ b/db/re/item_packages.conf
@@ -8,8 +8,22 @@
 //=                                                  
 //=            http://hercules.ws/board/                        
 //================= More Information =================
-// <link~u> <desc~!>
+// http://hercules.ws/board/topic/1244-official-item-grouppackagechain
 //====================================================
+// Structure of file:
+/*
+<Container_Item_Name>: {
+    <Entry_Item_Name>: {
+        Random: True/False - Signs whether a item is randomed or should be given whenever the packageis consumed.
+        Count: 30 - Stands for how much <Entry_Item_Name> will be obtained.
+        Expire: 2 - Signs how many hours this item will last (makes a rental item).
+        Announce: True/False - Signs whether to relay a special item obtain announcement when this item comes out of the package.
+        Rate: 50 - If 'Random' is True, a rate from 1 to 10000 (0.01% - 100%) will be given.
+        Named: True/False - Signs whether the item should have the owner's name in it.
+	}
+}
+*/
+
 Special_Box: {
 	Wrapped_Mask: {
 		Rate: 3