S e m i R a n d o m   v e r   0 . 8 0 
 
 A u t h o r :                   B a l l b a r i a n 
 
 H o m e   P a g e :             h t t p : / / w w w . d o m 3 m i n i o n s . c o m / ~ s e m i r a n d / 
 
 S u b m i t   F i l e s :       s e m i r a n d @ d o m 3 m i n i o n s . c o m 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 S h o u l d   r u n   o n   W i n d o w s   &   U n i x   s y s t e m s .   - -   I   h a v e   n o t   t e s t e d   i t   o n   U n i x ! 
 
 W r i t t e n   i n   Y A B A S I C ,   b u t   i t   i s   n o t   r e q u i r e d   t o   r u n   t h i s   p r o g r a m . 
 
 I t   w i l l   b e   n e e d e d   i f   y o u   w a n t   t o   f i d d l e   w i t h   t h e   s o u r c e   c o d e . 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 
 
 W h a t   i t   i s : 
 
 = = = = = = = = = = = 
 
 S e m i R a n d o m i z e r   i s   a   p r o j e c t   i n s p i r e d   b y   G a n d a l f   P a r k e r ' s   " S e m i - R a n d o m   m a p s "   
 
 a r t i c l e   a t :     h t t p : / / w w w . d o m 2 m i n i o n s . c o m / ~ m i n i o n / S e m i R a n d o m . s h t m l   
 
 
 
 M o r e   s p e c i f i c a l l y ,   i t   w a s   i n s p i r e d   b y   t h i s   q u o t e : 
 
 " A n y w a y ,   I   h a d   a   t h o u g h t   a b o u t   a   p r o j e c t   w h i c h   m i g h t   b e   a b l e   t o   b l e n d   t h e   b e s t   
 
 o f   b o t h   m e t h o d s .   V a r i a t i o n s   w o u l d   b e   c r e a t e d   i n   p i e c e s   o f   . m a p   c o d e ,   t h e n   
 
 r a n d o m l y   s e l e c t e d   t o   p a s t e   t o g e t h e r   i n t o   t h e   d o w n l o a d a b l e   f i l e .   T h e r e   c o u l d   b e   
 
 a   D r a g o n s   D e n   p r o v i n c e ,   W o o i n g   W o o d s ,   o r   t h e   F a s t   F o o d   F o r e s t .   T h e   p o p u l a t i o n ,   
 
 s t r u c t u r e s ,   u n i t s ,   m a g i c   s i t e s   c a n   a l l   b e   d e s i g n e d   a r o u n d   a   n a m e .   I t   c o u l d   b e   
 
 e v e r   g r o w i n g   a s   s m a l l   1 - p r o v i n c e   f i l e s   w e r e   a d d e d   a r o u n d   s i n g l e   t h e m e s .   
 
 W e r e w o l v e s ,   o r   v a m p i r e s ,   o r   t r o l l s ,   o r   d r y a d s . . .   w e l l   y o u   g e t   t h e   p i c t u r e . 
 
 
 
 W i t h   e n o u g h   p r o v i n c e   f i l e s   a   r a n d o m l y   g e n e r a t e d   m a p   c o u l d   b e   u n i q u e   e a c h   t i m e   
 
 b u t   s t i l l   b e   a b i t   m o r e   l o g i c a l   a b o u t   w h a t   y o u   r u n   i n t o .   I n   t h e   f o l l o w i n g   o f   m y   
 
 u s u a l   s t u f f   a   m a p   i m a g e   s e l e c t e d   f r o m   m y   d a i l y   r a n d o m l y - g e n e r a t e d   o n e s   c o u l d   b e   
 
 u s e d   o v e r   a n d   o v e r .   O r   m a y b e   a   G O O D   m a p   d o n e   b y   s o m e o n e   w i t h   a   p a i n t   p r o g r a m .   
 
 B u t   p o s s i b l y   s o m e   i n t e l l i g e n t   c o d i n g   c o u l d   b e   d o n e   t o   r e a d   a   . m a p   f i l e   a n d   d o   
 
 t h e   b i t - m a t h   o f   t h e   t e r r a i n   c o m m a n d s   t o   m a t c h   a   p r o v i n c e   d e s c r i p t i o n   t o   p r o p e r   
 
 l o c a t i o n s .   S u c h   a s ,   t h e   D r a g o n   D e n   m i g h t   h a v e   a   g r o u p   o f   d r a g o n s   i n   a   m o u n t a i n   
 
 c a s t l e   w i t h   m o u n t a i n - t y p e   i n d e p e n d e n t   p o p u l a t i o n   a n d   m o u n t a i n - t y p e   m a g i c   s i t e s .   
 
 T h e   p r o g r a m   c o u l d   s e a r c h   f o r   a   m o u n t a i n   t e r r a i n   p r o v i n c e   t o   p u t   t h a t   i n t o . "   
 
 -   G a n d a l f   P a r k e r 
 
 
 
 T h i s   i s   m y   t a k e   o n   h i s   f i n e   i d e a .     : ) 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 
 
 W h a t   i t   d o e s : 
 
 = = = = = = = = = = = = = 
 
 S e m i R a n d o m i z e r   ( S R )   t a k e s   a n   e x i s t i n g   m a p   f i l e   t h a t   y o u   s p e c i f y   a n d   a p p e n d s   
 
 p i e c e s   o f   m a p   c o d e   t o   i t .     T h e s e   p i e c e s   a r e   s t o r e d   i n   w h a t   I   h a v e   n a m e d   " G A N "   
 
 f i l e s   i n   h o n o r   o f   G a n d a l f ' s   i n s p i r a t i o n .     Y o u   s p e c i f y   w h a t   p e r c e n t a g e   o f   t h e   
 
 p r o v i n c e s   t o   m o d i f y   a n d   S R   w i l l   s e l e c t   t h a t   m a n y   r a n d o m   l o c a t i o n s   o n   t h e   m a p   
 
 a n d   t r y   t o   m a t c h   t h e m   u p   w i t h   e x i s t i n g   g a n   f i l e s .     S e v e r a l   f a c t o r s   i n f l u e n c e   
 
 w h a t   c o n s t i t u t e s   a   m a t c h :     t e r r a i n ,   t e r r a i n   p a t t e r n s ,   c l i m a t e ,   p r o v i n c e   s i z e ,   
 
 a n d   u n i q u e n e s s . 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 
 
 S e t t i n g   i t   u p : 
 
 = = = = = = = = = = = = = = 
 
 N o t e :   T h i s   c o v e r s   a   w i n d o w s   s y s t e m ,   I   a m   n o t   f a m i l i a r   w i t h   U n i x ,   t h o u g h   i t   
 
 s h o u l d   r u n   u n d e r   U n i x   a s   w e l l . 
 
 1 .   D o w n l o a d   &   u n z i p   t h e   f i l e s   i n t o   t h e   d i r e c t o r y   o f   y o u r   c h o i c e .   
 
       I   n a m e d   m i n e   " S e m i R a n d o m " . 
 
 2 .   Y o u   s h o u l d   n o w   h a v e   t h e   f o l l o w i n g : 
 
         G A N _ B I N                       - d i r e c t o r y   w h e r e   t h e   p r o v i n c e   f i l e s   r e s i d e . 
 
         N A M E _ V A U L T                 - d i r e c t o r y   w h e r e   t h e   d a t a   l i s t s   r e s i d e . 
 
         G a n L i s t . t x t               - l i s t   o f   g a n   f i l e s   t h a t   S R   c a n   u s e . 
 
         N a m e G e n T e s t . y a b       - s i m p l e   s c r i p t   t h a t   I   u s e   f o r   t e s t i n g   n a m e   g e n e r a t i o n . 
 
         N a m e L i s t . t x t             - l i s t   o f   D A T A   f i l e s   t h a t   S R   c a n   u s e . 
 
         O r i g . c f g                     - a   d e f a u l t   c o n f i g   i n   c a s e   y o u   b u g g e r   y o u r s .   : ) 
 
         S e m i R a n d o m . c f g         - w h e r e   S R   s e t t i n g s   c a n   b e   c h a n g e d . 
 
         S e m i R a n d o m . e x e         - E x e c u t a b l e   v e r s i o n .   R e m o v e   . e x e   e x t e n s i o n   f o r   U n i x . 
 
         S e m i R a n d o m . y a b         - T h e   Y A B A S I C   s o u r c e   c o d e . 
 
       
 
 3 .   O p e n   S e m i R a n d o m . c f g   w i t h   a n y   t e x t   e d i t o r   a n d   c h a n g e   l i n e   # 1   t o   y o u r   s y s t e m s 
 
       p a t h   t o   t h e   d i r e c t o r y   i n   w h i c h   y o u   p l a c e d   t h e   a b o v e   l i s t e d   f i l e s .   I f   I   
 
       u n z i p p e d   m i n e   f r o m   t h e   d e s k t o p ,   m y   p a t h   w o u l d   b e : 
 
         C : \ D o c u m e n t s   A n d   S e t t i n g s \ M e \ D e s k t o p \ S e m i R a n d o m 
 
 
 
 H o p e f u l l y   i n   t h e   n e a r   f u t u r e   t h e r e   w i l l   b e   a   s i m p l e   s e t u p   p r o g r a m   t o   t a k e   c a r e   
 
 o f   t h e s e   s t e p s   o r   m a y b e   a   k i n d   s o u l   w i l l   t a k e   a d v a n t a g e   o f   t h e   a u t o m a t i o n   
 
 f e a t u r e s   a n d   r u n   i t   f r o m   t h e i r   s e r v e r   f o r   a n   o n l i n e   v e r s i o n . 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 
 
 I   j u s t   w a n t   m y   m a p   S e m i R a n d o m i z e d : 
 
 = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = 
 
 J u s t   p a s t e   a   c o p y   o f   y o u r   m a p   f i l e   i n   t h e   s a m e   d i r e c t o r y   a s   t h e   e x e c u t a b l e   
 
 ( S e m i R a n d o m . e x e )   a n d   r u n   t h e   p r o g r a m .   W i t h   t h e   d e f a u l t   c o n f i g u r a t i o n ,   y o u   w i l l   
 
 b e   a s k e d   t o   s u p p l y   t h e   n a m e   o f   t h e   m a p   f i l e   t h a t   y o u   w i s h   t o   S e m i R a n d o m i z e .   
 
 E n t e r   t h e   n a m e   o f   y o u r   f i l e ,   b u t   l e a v e   o f f   t h e   e x t e n s i o n   ( . m a p ) .   Y o u   w i l l   g e t   
 
 i n f o r m a t i v e   m e s s a g e s   a n d   a   f a n c y ,   h i g h   t e c h ,   a n i m a t e d   2 D   p r o g r e s s   i n d i c a t o r   
 
 f o l l o w e d   s h o r t l y   b y   a   s i m p l e   " H a v e   a   N i c e   D a y ! "   a n d   a   p r o g r a m   f i n i s h e d   m e s s a g e .   
 
 H i t   e n t e r   a n d   t h e   w i n d o w   w i l l   c l o s e .   Y o u r   m a p   f i l e   i s   n o w   S e m i R a n d o m i z e d . 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 
 
 I   j u s t   w a n t   t o   f i d d l e   w i t h   S R ' s   s e t t i n g s : 
 
 = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = 
 
 O k ,   h e r e   i s   a   l i n e   b y   l i n e   m a p   o f   t h e   S e m i R a n d o m . c f g : 
 
 1 .   P a t h $                   >   P a t h   u s e d   b y   S R   t o   f i n d   y o u r   g a n   &   d a t a   f i l e s . 
 
 2 .   f i d d l e P e r c e n t   >   P e r c e n t   o f   p r o v i n c e s   i n   t h e   s e l e c t e d   m a p   f i l e   t o   a t t e m p t   t o   m o d i f y . 
 
 3 .   f i d d l e N a m e         >   0 = D o n ' t   m e s s   w i t h   n a m e s .   1 = L e t   G A N s   h a n d l e   t h e   n a m e s . 
 
 4 .   s h o w N e e d             >   0 = D o n ' t   s h o w   n e e d   t e x t   i n   m a p   f i l e .   1 = S h o w   m e   t h e   n e e d ! 
 
 5 .   h o t P e r c e n t         >   P e r c e n t   o f   p r o v i n c e s   i n   t h e   s o u t h   c o n s i d e r e d   h o t   c l i m a t e . 
 
 6 .   c o l P e r c e n t         >   P e r c e n t   o f   p r o v i n c e s   i n   t h e   n o r t h   c o n s i d e r e d   c o l d   c l i m a t e . 
 
 7 .   c l d b a n d 1             >   R e a l   w o r l d   s t y l e   c l i m a t e .   H a r d   p r o v   # ' s   f r o m   1   t o   v a l u e   =   s o u t h e r n   c o l d . 
 
 8 .   t m p b a n d 1             >   R e a l   w o r l d   s t y l e   c l i m a t e .   c l d b a n d 1   t o   v a l u e   =   s o u t h e r n   t e m p e a r a t e   c l i m a t e . 
 
 9 .   h o t b a n d               >   R e a l   w o r l d   s t y l e   c l i m a t e .   t m p b a n d 1   t o   v a l u e   =   h o t   c l i m a t e .   ( E q u a t o r ) 
 
 1 0 . t m p b a n d 2             >   R e a l   w o r l d   s t y l e   c l i m a t e .   h o t b a n d   t o   v a l u e   =   n o r t h e r n   t e m p e r a t e   c l i m a t e . 
 
 1 1 . c l d b a n d 2             >   R e a l   w o r l d   s t y l e   c l i m a t e .   t m p b a n d 2   t o   v a l u e   =   n o r h t e r n   c o l d   c l i m a t e . 
 
 1 2 . m a p $                     >   R e s e r v e d   f o r   e x t e r n a l   a p p   t o   a p p e n d   a   m a p   n a m e   f o r   m o d i f i c a t i o n . 
 
 
 
 J u s t   a   f e w   c o m m e n t s : 
 
 S e t   f i d d l e P e r c e n t   b e t w e e n   1 - 1 0 0 .   1   w i l l   b a r e l y   t o u c h   t h e   m a p   i f   a t   a l l .   1 0 0   w i l l   
 
 a t t e m p t   t o   p o t e n t i a l l y   m o d i f y   m o s t   i f   n o t   a l l   o f   t h e   p r o v i n c e s   w i t h   t h e   l i m i t   
 
 b e i n g   t h e   s u p p l y   o f   m a t c h i n g   G A N   s c r i p t s .     T h i s   c a n   b e   s e t   a b o v e   1 0 0 .     T h e   
 
 e f f e c t   w i l l   b e   t o   a l l o w   S R   t o   s p e n d   m o r e   t i m e   t r y i n g   t o   f i n d   a   s u i t a b l e   m a t c h . 
 
 
 
 S e t t i n g   s h o w N e e d   t o   1   w i l l   c a u s e   S R   t o   p r i n t   a   m e s s a g e   i n   t h e   m a p   f i l e   w h e n e v e r 
 
 i t   p i c k s   a   p r o v i n c e   f o r   m o d i f i c a t i o n ,   b u t   n o   G A N   f i l e   e x i s t s   i n   t h e   G A N   l i b r a r y   
 
 t h a t   m a t c h e s   t h e   t e r r a i n ,   O R   i t   o n l y   h a d   U N I Q U E   t y p e   G A N s   t h a t   h a d   a l r e a d y   b e e n   
 
 p l a c e d   e l s e w h e r e   i n   t h e   m a p   f i l e . 
 
 
 
 A h ,   C l i m a t e s .   T h e   d e f a u l t   s e t t i n g   i s   t o   u s e   h o t P e r c e n t   &   c o l ( d ) P e r c e n t .   I f   y o u   
 
 d e c i d e   t o   u s e   t h e   " b a n d "   m e t h o d ,   t h e n   y o u   n e e d   t o   s e t   t h e s e   2   t o   - 1 .   T h e   o p p o s i t e   
 
 i s   t r u e   i f   y o u   d e c i d e   t o   s w i t c h   b a c k   t o   u s i n g   t h e   d e f a u l t   m e t h o d .   I n   t h i s   c a s e   
 
 y o u   w o u l d   s e t   t h e   5   b a n d   l i n e s   b a c k   t o   - 1 .     O r   j u s t   t u r n   t h e   c l i m a t e   o p t i o n   o f f   
 
 a l l t o g e t h e r   b y   s e t t i n g   t h e m   a l l   t o   - 1 .   T h i s   w o u l d   c a u s e   G A N   s c r i p t s   m a r k e d   f o r   
 
 t e m p e r a t u r e   z o n e s   t o   n o t   b e   p l a c e d   h o w e v e r . 
 
 
 
 T h e   l a s t   l i n e   ( m a p $ )   i s   i n t e n d e d   t o   b e   r e s e r v e d   f o r   a n   e x t e r n a l   a p p l i c a t i o n   t o   
 
 d i r e c t   S R   t o   a   m a p   f i l e ,   b u t   i t   c a n   a l s o   b e   u s e d   a s   a   w a y   t o   b y p a s s   t h e   m a p   
 
 s e l e c t i o n   f r o m   w i t h i n   t h e   p r o g r a m   i t s e l f .   T h i s   i s   u s e f u l   w h e n   t e s t i n g   G A N   
 
 l i b r a r i e s   a n d   n a m e   s e t s   w h e n   y o u   a r e   r e p e a t e d l y   p r o c e s s i n g   t h e   s a m e   m a p   o v e r   
 
 a n d   o v e r . 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 
 
 H o w   t o   a d d   G A N   s c r i p t s   ( p r o v i n c e   f i l e s ) : 
 
 = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = 
 
 O k ,   I   e n v i s i o n   a n   o n l i n e   r e p o s i t o r y   w h e r e   G A N   s c r i p t   a u t h o r s   c a n   u p l o a d   t h e i r   
 
 w o n d e r o u s   c r e a t i o n s   a n d   o t h e r s   c a n   d o w n l o a d   a n d   d r o p   a   s i n g l e   G A N   i n t o   t h e i r   
 
 e x i s t i n g   l i b r a r y ,   o r   e n t i r e   s e t s .   A s   i t   i s   n o w   t h i s   i s   a   s i m p l e   t w o   s t e p   p r o c e s s : 
 
 1 .   S a v e   t h e   d o w n l o a d e d   G A N   f i l e s   i n   y o u r   S e m i R a n d o m i z e / G A N _ B I N   d i r e c t o r y . 
 
 2 .   O p e n   G a n L i s t . t x t   a n d   p a s t e   t h e   n a m e s   o f   t h e   f i l e s   i n t o   t h e   l i s t   m i n u s   t h e   
 
       " . g a n "   e x t e n s i o n ) . 
 
 
 
 T h a t ' s   i t .   T h i s   c a n   b e   r e a l l y   e a s y   i f   t h e   G A N   a u t h o r   w i l l   i n c l u d e   a   t e x t   f i l e   
 
 w i t h   a   p r e p a r e d   l i s t   o f   t h e   G A N   f i l e n a m e s   t h a t   a   u s e r   c a n   s i m p l y   c o p y   a n d   p a s t e   
 
 i n t o   t h e i r   o w n   l i s t . 
 
 
 
 * * * U p d a t e * * * 
 
 G a n d a l f   h a s   k i n d l y   d o n a t e d   s e r v e r   s p a c e .   T h e   S e m i R a n d o m   h o m e   p a g e   i s   n o w   a t : 
 
 h t t p : / / w w w . d o m 3 m i n i o n s . c o m / ~ s e m i r a n d / 
 
 
 
 G a n ,   D a t a   &   S e t   f i l e s   m a y   b e   s u b m i t t e d   t o : 
 
 s e m i r a n d @ d o m 3 m i n i o n s . c o m 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 
 
 H o w   t o   a d d   D A T A   w o r d   l i s t s   f o r   n a m e s   &   i t e m s : 
 
 = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = 
 
 T h i s   i s   a   s i m i l a r   p r o c e s s   t o   a d d i n g   G A N   f i l e s . 
 
 1 .   S a v e   t h e   d o w n l o a d e d   D A T A   f i l e s   i n   y o u r   S e m i R a n d o m i z e / N A M E _ V A U L T   d i r e c t o r y . 
 
 2 .   O p e n   N a m e L i s t . t x t   a n d   p a s t e   t h e   n a m e s   o f   t h e   f i l e s   i n t o   t h e   l i s t   ( m i n u s   t h e   
 
       " . t x t "   e x t e n s i o n ) . 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 
 
 H o w   t o   a u t h o r   G A N   s c r i p t s   ( p r o v i n c e   f i l e s ) : 
 
 = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = 
 
 I t   i s   a s s u m e d   t h a t   y o u   a r e   f a m i l i a r   w i t h   m a p   c o m m a n d s   a n d   m a p   e d i t i n g .   T h e   
 
 f o r m a t   i s   p r e t t y   s i m p l e   f o r   e d i t i n g   G A N   s c r i p t s   a n d   t h e r e   a r e   j u s t   a   f e w   r u l e s   
 
 &   s u g g e s t e d   s t e p s : 
 
 1 .   L o o k   a t   e x i s t i n g   G A N s   a s   a   g u i d e . 
 
 2 .   Y o u   d o   n o t   n e e d   t o   a d d   # n o s t a r t .     T h i s   i s   a d d e d   a u t o m a t i c a l l y . 
 
 3 .   Y o u   d o   n o t   n e e d   t o   a d d   # s e t l a n d   o r   # l a n d .     T h i s   i s   h a n d l e d   i n   t h e   f i l e n a m e .   ( s e e   b e l o w ) 
 
 
 
 G A N   F I L E N A M E   F L A G S : 
 
 - - - - - - - - - - - - - - - - - - - 
 
 < C l i m a t e s > 
 
 _ H O T _       H o t   Z o n e   ( s o u t h e r n   m a p ) 
 
 _ C L D _       C o l d   Z o n e   ( n o r t h e r n   m a p ) 
 
 _ T M P _       T e m p e r a t e   Z o n e   ( m i d   m a p ) 
 
 
 
 < P a t t e r n s > 
 
 _ I S _         I S L A N D 
 
 _ L K _         L A K E 
 
 _ V C _         V O L C A N O 
 
 _ P N _         P E N N 
 
 _ V L _         V A L L E Y 
 
 _ C O _         C O A S T 
 
 _ L O _         L O S T 
 
 
 
 < T r e a t m e n t > 
 
 _ R _           R E P L A C E     -   ( # l a n d )         S e t   a c t i v e   p r o v   &   k i l l   e v e r y o n e   i n   i t .   U s e d   t o   R E P L A C E   r a n d o m l y   p l a c e d   u n i t s . 
 
 _ A _           A D D             -   ( # s e t l a n d )   S e t   a c t i v e   p r o v .     U n i t s   a d d e d   t o   e x i s t i n g . 
 
 _ M _           M U L T I P L E   -   M o r e   t h a n   o n e   o f   a   s i n g l e   p r o v i n c e   g a n   m a y   b e   a d d e d   t o   t h e   m a p   f i l e . 
 
 _ U _           U N I Q U E       -   O n c e   a   s i n g l e   i n s t a n c e   o f   t h e   p r o v i n c e   g a n   i s   " p i c k e d " ,   i t   c a n   n o t   b e   p i c k e d   a g a i n . 
 
 
 
 < T e r r a i n > 
 
 _ S / L / N _       S m a l l / L a r g e / N o r m a l 
 
 _ P L N _           P l a i n s 
 
 _ S E A _           S e a 
 
 _ W T R _           S o m e   w a t e r 
 
 _ M N T _           M o u n t a i n 
 
 _ S W P _           S w a m p 
 
 _ W S T _           W a s t e 
 
 _ F S T _           F o r e s t 
 
 _ F R M _           F a r m 
 
 _ M S T _           M a n y   S i t e s 
 
 _ D E P _           D e e p 
 
 _ C A V _           C a v e 
 
 _ F S _             F i r e   S i t e 
 
 _ A S _             A i r   S i t e 
 
 _ W S _             W a t e r   S i t e 
 
 _ E S _             E a r t h   S i t e 
 
 _ S S _             A s t r a l   S i t e 
 
 _ D S _             D e a t h   S i t e 
 
 _ N S _             N a t u r e   S i t e 
 
 _ B S _             B l o o d   S i t e 
 
 _ P S _             P r i e s t   S i t e 
 
 _ E M T _           E d g e   M o u n t a i n 
 
 
 
 S P E C I A L   G A N   C O M M A N D S : 
 
 - - - - - - - - - - - - - - - - - - - - - 
 
 @ < v a l u e >   < c o m m a n d > 
 
     - > s e l e c t   a   r a n d o m   l i n e   f r o m   t h e   f o l l o w i n g   < v a l u e >   l i n e s   t o   f o l l o w   t h i s   < c o m m a n d > . 
 
 
 
 E x a m p l e   # 1 : 
 
     @ 3   c o m m a n d e r 
 
     " M i n o t a u r   L o r d " 
 
     2 4 0   - -   P r i e s t 
 
     - -   n o   c o m m a n d e r 
 
       R e s u l t =   " # c o m m a n d e r   2 4 0   - -   P r i e s t "   < -   1   i n   3   c h a n c e   t o   b e   p r i n t e d   i n   m a p   f i l e . 
 
 
 
 E x a m p l e   # 2 : 
 
     @ 1   l a n d n a m e 
 
     " I c k y   S w a m p " 
 
       R e s u l t =   " # l a n d n a m e   < p r o v i n c e # >   " I c k y   S w a m p "   < -   1 0 0 %   c h a n c e   t o   b e   p r i n t e d   i n   m a p   f i l e . 
 
 
 
 E x a m p l e   # 3 : 
 
     @ 2   
 
     # m a g _ a s t r a l   1 
 
     # m a g _ f i r e   1 
 
       R e s u l t =   " # m a g _ f i r e   1 "   < -   1   i n   2   c h a n c e   t o   b e   p r i n t e d .   N o t e   t h e   s p a c e   f o l l o w i n g   " 2   " . 
 
 
 
 E x a m p l e   # 4 : 
 
     @ 2   u n i t s 
 
     1 0   1 7   - -   A r c h e r 
 
     - -   n o   A r c h e r 
 
       R e s u l t =   " - -   n o   A r c h e r "   < -   1   i n   2   c h a n c e   t o   b e   p r i n t e d .   i e   5 0 %   c h a n c e   o f   t h e s e   u n i t s . 
 
 
 
 @ R A N D O M   < c o m m a n d >   < n a m e   o r   i t e m   l i s t > 
 
     - > s e l e c t   a   r a n d o m   n a m e   o r   i t e m   t o   f o l l o w   < c o m m a n d > . 
 
 
 
 E x a m p l e   # 1 : 
 
     @ R A N D O M   l a n d n a m e   F O R E S T 
 
       R e s u l t =   " # l a n d n a m e   < p r o v # >   " S i m p l e   W o o d s " "   < -   R n d   n a m e   f r o m   D A T A 1   +   r n d   n a m e   f r o m   D A T A 2 . 
 
           O R 
 
       R e s u l t =   " # l a n d n a m e   < p r o v # >   " O h m y g   F o r e s t " "   < -   G e n e r a t e d   n a m e   +   r n d   n a m e   f r o m   D A T A 2 . 
 
 
 
 E x a m p l e   # 2 : 
 
     @ R A N D O M   c o m n a m e   C O M M A N D E R 
 
       R e s u l t =   " # c o m n a m e   " K u l l r a y " "   < -   G e n e r a t e d   n a m e . 
 
 
 
 E x a m p l e   # 3 : 
 
     @ R A N D O M   c o m n a m e   C O M M A N D E R 
 
     @ R A N D O M   a d d i t e m   H E L M E T 
 
     @ R A N D O M   a d d i t e m   1 H A N D W E A P O N 
 
     @ R A N D O M   a d d i t e m   S H I E L D 
 
     @ R A N D O M   a d d i t e m   A R M O R H V Y 
 
     @ R A N D O M   a d d i t e m   B O O T S 
 
     @ R A N D O M   a d d i t e m   M I S C I T E M 
 
       R e s u l t =     < -   R a n d o m   i t e m   f r o m   t h e   n a m e d   i t e m   l i s t . 
 
                         # a d d i t e m   " S t a r s h i n e   S k u l l c a p " 
 
                         # a d d i t e m   " J a d e   K n i f e " 
 
                         # a d d i t e m   " W e i g h t l e s s   T o w e r   S h i e l d " 
 
                         # a d d i t e m   " S i l v e r   H a u b e r k " 
 
                         # a d d i t e m   " B o o t s   o f   S t o n e " 
 
                         # a d d i t e m   " B r a c e r s   o f   P r o t e c t i o n " 
 
       ( N O T E :   I   r e c o m m e n d   o n l y   1   o r   2   M I S C   i t e m s   a s   d u p l i c a t e s   a r e   p o s s i b l e ! ) 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 
 
 A   s i m p l e   p r o v i n c e   t u t o r i a l :   ( W O R K   I N   P R O G R E S S ! ) 
 
 = = = = = = = = = = = = = = = = = = = = = = = = = = = 
 
 I   h a v e   a n   i d e a   f o r   a   s i m p l e ,   c o m m o n   p r o v i n c e .   I   w a n t   a   s c a t t e r i n g   o f   h u m a n   
 
 m e d i e v a l - t y p e   p l a i n s   p r o v i n c e s .   B o r i n g ,   I   k n o w .   T h e   t h i n g   i s ,   I   w a n t   t h e m   t o   
 
 h a v e   g o o d   p r i e s t   s u p p o r t   a n d   a   l i t t l e   b i t   o f   v a r i e t y .   S i n c e   I   c h o s e   t o   u s e   
 
 p l a i n s   ( a   c o m m o n   t e r r a i n )   a n d   I   i n t e n d   t o   a l l o w   m u l t i p l e   i n s t a n c e s   o f   t h i s   
 
 p r o v i n c e   a p p e a r   i n   t h e   m a p ,   I   w i l l   n e e d   t o   m i x   i t   u p   a   b i t .   B u t   f i r s t ,   l e t ' s   
 
 c r e a t e   t h e   G A N   f i l e . 
 
 
 
 A   G A N   f i l e   i s   j u s t   a   t e x t   f i l e   ( . t x t ) .   T h e y   c a n   b e   o p e n e d   w i t h   a n y   t e x t   e d i t o r .   
 
 B e f o r e   w e   c r e a t e   t h e   f i l e ,   w e   n e e d   t o   k n o w   w h a t   t o   n a m e   i t .   T h e   n a m e   o f   t h e   G A N   
 
 f i l e   i s   w h e r e   a l l   o f   t h e   f l a g s   a r e   t h a t   t e l l   S R   h o w   t o   h a n d l e   i t   a n d   w h e r e   t h i s   
 
 p r o v i n c e   c a n   b e   p l a c e d   i n   a   m a p . 
 
 
 
 I   c r e a t e   a   t e x t   f i l e   a n d   n a m e   i t   a s   f o l l o w s : 
 
 B A L L 7 _ T M P _ M _ R _ N _ P L N _ . g a n 
 
 
 
 H e r e   i s   a   b r e a k   d o w n   o f   t h e   n a m e   a n d   w h a t   t h e   p i e c e s   m e a n : 
 
 B A L L 7   =   M y   c h o s e n   a u t h o r   n a m e   f o l l o w e d   b y   a n   I D   ( 7 )   t o   h e l p   m e   q u i c k l y   i d e n t i f y   
 
                 a   g i v e n   p r o v i n c e   a n d   t o   p r e v e n t   c o n f l i c t s . 
 
 _ T M P _   =   T h i s   i s   m y   c h o s e n   c l i m a t e   ( T e m p e r a t e ) .   A n y   o f   t h e   _ T A G S _   c a n   b e   p l a c e d   
 
                 a n y w h e r e   i n   t h e   f i l e n a m e   a n d   w o r k . 
 
 _ M _       =   M u l t i p l e ,   s o   t h a t   t h i s   p r o v i n c e   c a n   a p p e a r   m o r e   t h a n   o n c e   i n   a   g i v e n   m a p . 
 
 _ R _       =   I   w a n t   t o   r e p l a c e   t h e   i n h a b i t a n t s   c r e a t e d   b y   D o m 3   f o r   t h i s   p r o v i n c e . 
 
 _ N _       =   N o r m a l   s i z e d   p r o v i n c e s .   T h i s   c o u l d   b e   e x c l u d e d   ( i t ' s   v a l u e   i s   0 ) ,   b u t   I   
 
                 l i k e   i t   f o r   c l a r i t y . 
 
 _ P L N _   =   P l a i n s   i s   t h e   t e r r a i n   t o   m a t c h   t h i s   c u s t o m   p r o v i n c e   t o . 
 
 
 
 N o w   S R   w i l l   k n o w   w h e r e   t o   p u t   m y   G A N   i f   a n   o p e n i n g   c o m e s   u p . 
 
 W i t h   t h e   f i l e   o p e n   i n   a   t e x t   e d i t o r ,   I   c a n   s t a r t   a d d i n g   s t u f f .   : ) 
 
 
 
 I   w a n t   t o   a s s i g n   n a m e s   t o   m y   p r o v i n c e s .   N o r m a l l y   i n   a   m a p   f i l e   y o u   w o u l d   u s e   
 
 s o m e t h i n g   l i k e :   
 
 # l a n d n a m e   1 0 1   " F r o g   B e l c h   P r a i r i e " 
 
 
 
 W e   a r e   n o t   m a k i n g   i t   f o r   p r o v i n c e   # 1 0 1 .   S o   i n s t e a d ,   t o   n a m e   a   s i n g l e   U n i q u e   
 
 p r o v i n c e   i n   a   G A N ,   w e   w o u l d   u s e : 
 
 # l a n d n a m e   " F r o g   B e l c h   P r a i r i e " 
 
 
 
 F o r   t h i s   p r o v i n c e ,   w e   w a n t   M u l t i p l e   i n s t a n c e s ,   s o   w e   h a v e   t w o   w a y s   w e   c o u l d   
 
 d o   i t .   O n e   i s   t o   c h o o s e   f r o m   a   f i n i t e   l i s t   t h a t   w e   d e f i n e   i n   t h e   G A N : 
 
 @ 3   l a n d n a m e 
 
 " F r o g   B e l c h   P r a i r i e " 
 
 " D e a d   T o a d   P r a i r i e " 
 
 " P r a i r i e   o f   B u r i e d   T o e s " 
 
 
 
 T h e   s e c o n d   o p t i o n   i s   t o   u s e   t h e   D A T A   l i b r a r i e s : 
 
 @ R A N D O M   l a n d n a m e   P L A I N S 
 
 
 
 O p t i o n   1   w o u l d   r e t u r n   o n e   o f   t h e   t h r e e   d e f i n e d   n a m e s   a n d   p r i n t : 
 
 # l a n d n a m e   3 9 1   " D e a d   T o a d   P r a i r i e " 
 
 
 
 O p t i o n   2   c o u l d   r e t u r n   a   h u g e   v a r i e t y   o f   p o s s i b l e   n a m e s   a n d   w i l l   b e   t h e   o p t i o n   
 
 t h a t   I   c h o o s e   f o r   m y   G A N . 
 
 ( W O R K   I N   P R O G R E S S ! ) 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 
 
 H o w   t o   a u t h o r   w o r d   l i s t s   f o r   n a m e s   &   i t e m s : 
 
 = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = 
 
 Y o u   c a n   d e f i n e   y o u r   o w n   w o r d l i s t s .   H e r e   a r e   t h e   r u l e s : 
 
 1 .   M u s t   b e   n a m e d   l i k e   < T E R R A I N > _ D A T A 1 . t x t   &   < T E R R A I N > _ D A T A 2 . t x t 
 
       f o r   u s e   w i t h   @ R A N D O M   l a n d n a m e   < T E R R A I N > . 
 
 
 
 2 .   M u s t   b e   n a m e d   l i k e   < I T E M > _ D A T A 1 . t x t   f o r   u s e   w i t h 
 
       @ R A N D O M   a d d i t e m   < I T E M > . 
 
 
 
 3 .   M U S T   b e   n a m e d   l i k e   < N A M E > _ D A T A 1 . t x t   f o r   u s e   w i t h 
 
       @ R A N D O M   c o m n a m e   < N A M E > . 
 
 
 
 N o t e   t h a t   c o m n a m e   i s   d i f f e r e n t   i n   t h a t   r e g a r d l e s s   o f   w h i c h   f i l e   i t   p o i n t s   a t ,   i t   
 
 w i l l   s t i l l   g e n e r a t e   a   r a n d o m   s t r i n g   f r o m   a   r a n d o m   l i b r a r y .   T h e   d e f a u l t   i s   t o   p o i n t   
 
 t o   C O M M A N D E R   ( C O M M A N D E R _ D A T A 1 . t x t ) . 
 
 
 
 T h e   w o r d   l i s t s   a r e   j u s t   s i m p l e   t e x t   f i l e s .   L o o k   a t   t h e   e x i s t i n g   o n e s   a n d   y o u   w i l l   
 
 s e e   h o w   s i m p l e   t h e y   a r e   t o   m o d i f y .   A d d i n g   n e w   f i l e s   i s   j u s t   a   m a t t e r   o f   g e t t i n g   
 
 t h e   _ D A T A 1 / _ D A T A 2   t h i n g   d o w n   a n d   r e m e m b e r i n g   t h a t   i f   y o u   c r e a t e   G A N s   p o i n t i n g   a t   
 
 t h e s e   n e w   w o r d   l i s t s ,   y o u   w i l l   n e e d   t o   i n c l u d e   t h e m   w i t h   t h e   G A N s   a s   a   s e t   s o   t h a t   
 
 o t h e r s   m a y   e n j o y   y o u r   f i n e   w o r k .     I f   y o u   d o   n o t ,   t h e n   S R   w i l l   c r a s h   a n d   b u r n   w h e n   
 
 i t   t r i e s   t o   g e n e r a t e   a   n a m e   f o r   y o u r   s p e c i a l   p r o v i n c e s . 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 
 
 E x t e r n a l   A u t o m a t i o n : 
 
 = = = = = = = = = = = = = = = = = = = = 
 
 ( W O R K   I N   P R O G R E S S ! ) 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 
 
 C r e d i t s : 
 
 = = = = = = = = 
 
 G a n d a l f   f o r   h i s   c o n c e p t s   a n d   h e l p i n g   m e   t o   r e a c h   a   l i t t l e   f u r t h e r   t h a n   I   w o u l d   h a v e   o t h e r w i s e . 
 
 E d i   f o r   a l l o w i n g   m e   t o   i n c l u d e   p i e c e s   o f   h i s   c o n t e n t   r i c h   F a e r u n   m a p   f i l e   a s   s p e c i a l   p r o v i n c e s . 
 
 
 
 