MessagesAPI | 1.8 - 1.13.2

database  :  
  host   :  localhost  
  port   :  '3307'  
  database   :  db  
  user   :  username  
  password   :  pass123 
 #Storage type: mysql or yaml  
 #Recommended: yaml   
storage   :  yaml

#List of nations, only YAML storage type   
nations  :  
  UNIVERSAL   :  uni  
  ENGLISH   :  en  
  CZECH   :  cz  
  SLOVAK   :  sk

#List of messages, only YAML data storage 
messages: 
  NO_PERMISSION: 
    en: 
      BOTH: '&fYou don''t have enough permissions!' 
  PREFIX: 
    uni: 
      BOTH: '&f[&aMessagesAPI&f]&a ' 
  MESSAGESAPI_HELP: 
    en: 
      BOTH: "&c&lMessagesAPI - Help Menu \n&b/nation <nation> - Changes a nation\n\ 
        &b/gender <f/m> - Changes a gender" 
    cz: 
      BOTH: "&c&lMessagesAPI - Help Menu \n&b/nation <nation> - Upraví tvůj nation\n\ 
        &b/gender <f/m> - Upraví tvůj gender" 
  MESSAGESAPI_UNKNOWN_GENDER: 
    en: 
      BOTH: '&cSorry, but this gender doesn''t exist !' 
  MESSAGESAPI_UNKNOWN_NATION: 
    en: 
      BOTH: '&cSorry, but this nation doesn''t exist !' 
  MESSAGESAPI_UNKNOWN_MESSAGE: 
    uni: 
      BOTH: '&cSorry, but this we don''t have any message to this action !' 
  MESSAGESAPI_GENDER_FEMALE: 
    en: 
      BOTH: FEMALE 
  MESSAGESAPI_GENDER_MALE: 
    en: 
      BOTH: MALE 
  MESSAGESAPI_NATION_CHANGED: 
    en: 
      BOTH: '&aYou have successfully changed your nation to &b%nation%' 
  MESSAGESAPI_NATIONSLIST_HEADER: 
    en: 
      BOTH: '&c&l --- List of supported nations ---' 
  MESSAGESAPI_NOPERM: 
    en: 
      BOTH: '&cYou don''t have enough permissions to do this command !' 
  MESSAGESAPI_RELOAD: 
    en: 
      BOTH: '&aReloaded !' 
  MESSAGESAPI_GENDER_CHANGED: 
    en: 
      MALE: '&aYou have successfully changed your gender to &b%gender%' 
      FEMALE: '&aYou have successfully changed your gender to &d%gender%'

#Player list - only YAML 
players: 
  d93d0fb8-3458-3f9b-b1f1-004f6906a992: 
    name: apik007 
    nation: CZECH 
    gender: MALE

package   testapp   ;  

 import   eu.mrapik.messagesapi.MsgAPI   ;  
 import   eu.mrapik.messagesapi.model.Gender   ;  
 import   eu.mrapik.messagesapi.model.Message   ;  
 import   eu.mrapik.messagesapi.model.Nation   ;  
 import   eu.mrapik.messagesapi.model.User   ;  
 import   org.bukkit.entity.Player   ;  
 import   org.bukkit.event.EventHandler   ;  
 import   org.bukkit.event.Listener   ;  
 import   org.bukkit.event.player.PlayerJoinEvent   ;  
 import   org.bukkit.plugin.java.JavaPlugin   ;  

 public   class  TestApp  extends  JavaPlugin  implements  Listener  {  

     private  MsgAPI api  ;  

    @Override 
     public   void  onEnable  (   )   {  

         //Init  
        api  =   new  MsgAPI  (   )   ;  

         //To be sure, every used nation should be registered  
        api.  registerNation   (  api.  createNation   (   "CZECH"  ,  "cz"   )   )   ;  
        api.  registerNation   (  api.  createNation   (   "SLOVAK"  ,  "sk"   )   )   ;  

         //This just adds the messages to cache-storage, it won't save it to YAML/MySQL  
        api.  addMessage   (  api.  createMessage   (   "TEST"  ,  "&aHey girl, how are you?"  ,  "ENGLISH"  , Gender.  FEMALE   )   )   ;  
        api.  addMessage   (  api.  createMessage   (   "TEST"  ,  "&aHey boy, how are you?"  ,  "ENGLISH"  , Gender.  MALE   )   )   ;  
        api.  addMessage   (  api.  createMessage   (   "TEST"  ,  "&aHey holka, jak je?"  ,  "CZECH"  , Gender.  FEMALE   )   )   ;  
        api.  addMessage   (  api.  createMessage   (   "TEST"  ,  "&aHey kluku, jak je?"  ,  "CZECH"  , Gender.  MALE   )   )   ;  

         //Example of creating messages using factory method  
        Message msg  =  api.  createMessage   (   "TEST2"  ,  "Hey girl, how are you?"  ,  "ENGLISH"  , Gender.  FEMALE   )   ;  

         //This will save data to the central storage (YAML or MySQL)  
        api.  registerMessage   (  msg  )   ;  
        api.  registerMessage   (  api.  createMessage   (   "TEST2"  ,  "(F) Hej, ako?"  ,  "SLOVAK"  , Gender.  FEMALE   )   )   ;  
        api.  registerMessage   (  api.  createMessage   (   "TEST2"  ,  "(M) Hey, ako?"  ,  "SLOVAK"  , Gender.  MALE   )   )   ;  

         //Want to add universal message for both genders and all nations? Like plugin prefix?  
        api.  registerMessage   (  api.  createMessage   (   "UNIVERSAL"  ,  "MyPrefix"  , api.  getUniversalNation   (   )  , Gender.  BOTH   )   )   ;  
         //Or just...  
        api.  registerMessage   (  api.  createUniversalMessage   (   "UNIVERSAL"  ,  "MyPrefix"   )   )   ;  

         this  .  getServer   (   )  .  getPluginManager   (   )  .  registerEvents   (   this  ,  this   )   ;  
     }  

    @Override 
     public   void  onDisable  (   )   {  
     }  

    @EventHandler 
     public   void  onPlayerJoin  (  PlayerJoinEvent event  )   {  
        Player player  =  event.  getPlayer   (   )   ;  

         //You can use getUser(UUID) or getOnlineUser(Player) - not accessing the database  
        User user  =  api.  getOnlineUser   (  player  )   ;  
         //Getting nation and gender  
        Nation nation  =  user.  getNation   (   )   ;  
        Gender gender  =  user.  getGender   (   )   ;  
         //Alternative methods without using User  
        nation  =  api.  getNation   (  player.  getUniqueId   (   )   )   ;  
        gender  =  api.  getGender   (  player.  getUniqueId   (   )   )   ;  

         //Getting message, it automatically loads gender and nation  
        Message msg  =  api.  getMessage   (   "TEST"  , event.  getPlayer   (   )   )   ;  
         //Getting just the final string, similar to msg.getString();  
          String   message  =  api.  getMessageString   (   "TEST"  , event.  getPlayer   (   )   )   ;  

         //Using colorizer method which replaces all & symbols with §  
        event.  setJoinMessage   (  api.  colorize   (  message  )   )   ;  

     }  

 }