本帖最后由 yuxuanchiadm 于 2013-2-13 04:54 编辑

利用Forge API开发联机MOD【基础篇】【第三章】
建立你的配置文件类
作者：yuxuanchiadm

索引贴地址：http://www.mcbbs.net/thread-38211-1-1.html

请确定你已经阅读完成第二章的内容:
http://www.mcbbs.net/thread-38283-1-1.html
否则不要阅读此贴！

序：
在上一章里，我们已经学会了制作一个简单的MOD，并且制作出了一个。然而，很多MOD都有一个完整的配置文件，而我们的MOD没有：(，不要沮丧，现在我将要教你制作一个配置文件管理类，虽然现在没有什么用，但是以后用得到！

为你的MOD制作一个配置文件管理类：
/**知识点：什么是类和对象
类是OOP编程（面向对象的编程）中的重要元素，什么，你不知道神马是类？好吧，你居然有耐心看到这里，请容我一拜（楼主扯蛋中），如果把类比作蓝图，对象比作汽车，那么类和对象的关系就如同蓝图和汽车一样。一个蓝图可以制作出很多汽车，蓝图的样子决定了汽车的样子，然而汽车也可以换挡，添加装饰品，所以对象不一定要一样，但是一定要有蓝图的样子，否则这就是一个失败品。
**/
首先在myFirstMod包下建立一个新类：myFirstModConfig。这个配置文件管理类我们要实现单实例的功能，也就是只能存在一个myFirstModConfig类的实例，否则多个实例对一个文件进行操作，就可能出现问题。
/**知识点：什么是单实例模式
单实例模式时面向对象编程中一个重要的元素，一般用于需要对一个文件或其他内容操作的场景。顾名思义，单实例模式下的类只能有一个实例，这样就提高了应用程序的安全性。日后在扩展这个程序时，也不容易在此处发生错误。单实例模式的实现，一般是在类的内部创建一个指向这个类本身的某个实例的静态变量，并且让构造函数在外部不可见（Private），然后创建一个静态初始化函数，在运行中第一次使用这个类时对其内部的那个静态变量和其他内容进行初始化。
**/
注意：导入类啥的自行导入就行了，以后就不提醒了。
首先，创建一个私有静态变量，类型为myFirstModConfig，也就是储存这个类的唯一实例的变量。

  1. private static myFirstModConfig instance;
复制代码

然后创建一个私有成员变量，类型为Configuration（Forge提供的基本配置文件管理类）
  1. private Configuration config;
复制代码

然后，添加这个类的私有构造函数，参数列表需要一个File类型的参数，此参数期望传入一个以此MOD配置文件为路径的File对象。

  2. private myFirstModConfig(File configFile)
  3. {
  4.     if(!configFile.exists())
  5.     {
  6.         try
  7.         {
  8.             configFile.createNewFile();
  9.         }
  10.         catch(IOException e)
  11.         {
  12.             System.out.println(e);
  13.             return;
  14.         }
  15.     }
  16.     config = new Configuration(configFile);
  17.     config.load();
  18. }
复制代码

/**知识点：什么是构造函数
构造函数是OOP编程（面向对象的编程）中的重要元素，假设你要把汽车蓝图变成一个实际汽车，那么你需要建造它，构造函数的作用就是建造类的对象，构造函数在类初始化时调用，构造函数调用完成时，你将得到一个完整的类的对象。
**/
然后，创建一个初始化函数，用于在需要使用这个类时初始化它。


  2. public static void InitliazeConfig(File ConfigFile)
  3. {
  4.     if(myFirstModConfig.instance != null)
  5.     {
  6.         return;
  7.     }
  8.     myFirstModConfig.instance = new myFirstModConfig(ConfigFile);
  9. }
复制代码

然后，创建三个获取方块ID、物品ID、和其他配置信息的函数：
  1. public static String GetGeneralProperties(String PropertyName, String DefaultValue) throws Exception
  2. {
  3.     if(myFirstModConfig.instance == null)
  4.     {
  5.         throw new Exception("没有初始化配置文件！");
  6.     }
  7.     return myFirstModConfig.instance.config.get("general", PropertyName, DefaultValue).value;
  8. }
  9. public static int GetItemID(String ItemName, int DefaultValue) throws Exception
  10. {
  11.     if(myFirstModConfig.instance == null)
  12.     {
  13.         throw new Exception("没有初始化配置文件！");
  14.     }
  15.     return myFirstModConfig.instance.config.getItem("item", "ID." + ItemName, DefaultValue).getInt() - 256;
  16.     //为什么要减256呢，这还得从上古时期开始说起。从前有个叫Notch的男人，开发了Minecraft。在制作物品和方块系统时，错误的将物品和方块归为同一类。但方块能使用的ID却在原版只有256，而物品则有很多。后来，Minecraft发现了这个问题，于是将物品在初始化时传入的ID统一加上了256。但治标不治本，方块ID任然只有256个。1万年后，出现了一个可以将方块范围限制提到4096的MOD，万恶（弥天大雾）的Forge迅速将其吸入Forge本身。于是方块和物品的ID又开始冲突了。但物品在初始化时还是只加上256，因为很多物品都使用了4096以下的ID，所以必须将其移到其他范围。但由于目前很多的神作地图等精美的艺术作品都使用的是现在的ID，一旦更改，这些存档（全银河系的Minecraft存档）将报废。最后，就出现了现在的坑爹局面。所以，最好还是在此地减去256，抵消这个副作用，干脆就使用可能会导致冲突的ID范围，也总比卡在半中拦腰强。
  17. }
  18. public static int GetBlockID(String BlockName, int DefaultID) throws Exception
  19. {
  20.     if(myFirstModConfig.instance == null)
  21.     {
  22.         throw new Exception("没有初始化配置文件！");
  23.     }
  24.     return myFirstModConfig.instance.config.getBlock("ID." + BlockName, DefaultID).getInt();
  25. }
复制代码
最后，创建一个储存配置文件的函数：

  2. public static void SaveConfig()
  3. {
  4.     myFirstModConfig.instance.config.save();
  5. }
复制代码

这时，你的代码应该是这样：

  2. package myFirstMod;import net.minecraftforge.common.Configuration;
  3. import java.io.File;
  4. import java.io.IOException;public class myFirstModConfig
  5. {
  6.     private static myFirstModConfig instance;
  7.     private Configuration config;
  8.     public static void InitliazeConfig(File ConfigFile)
  9.     {
  10.         if(myFirstModConfig.instance != null)
  11.         {
  12.             return;
  13.         }
  14.         myFirstModConfig.instance = new myFirstModConfig(ConfigFile);
  15.     }
  16.     private myFirstModConfig(File configFile)
  17.     {
  18.         if(!configFile.exists())
  19.         {
  20.             try
  21.             {
  22.                 configFile.createNewFile();
  23.             }
  24.             catch(IOException e)
  25.             {
  26.                 System.out.println(e);
  27.                 return;
  28.             }
  29.         }
  30.         config = new Configuration(configFile);
  31.         config.load();
  32.     }
  33.     public static void SaveConfig()
  34.     {
  35.         myFirstModConfig.instance.config.save();
  36.     }
  37.     public static String GetGeneralProperties(String PropertyName, String DefaultValue) throws Exception
  38.     {
  39.         if(myFirstModConfig.instance == null)
  40.         {
  41.             throw new Exception("没有初始化配置文件！");
  42.         }
  43.         return myFirstModConfig.instance.config.get("general", PropertyName, DefaultValue).value;
  44.     }
  45.     public static int GetItemID(String ItemName, int DefaultValue) throws Exception
  46.     {
  47.         if(myFirstModConfig.instance == null)
  48.         {
  49.             throw new Exception("没有初始化配置文件！");
  50.         }
  51.         return myFirstModConfig.instance.config.getItem("item", "ID." + ItemName, DefaultValue).getInt();
  52.     }
  53.     public static int GetBlockID(String BlockName, int DefaultID) throws Exception
  54.     {
  55.         if(myFirstModConfig.instance == null)
  56.         {
  57.             throw new Exception("没有初始化配置文件！");
  58.         }
  59.         return myFirstModConfig.instance.config.getBlock("ID." + BlockName, DefaultID).getInt();
  60.     }
  61. }
复制代码

总结：
你已经制作出了一个配置文件管理类，为自己干上一杯吧：)，虽然现在没什么用，但是你已经迈出了制作更高级MOD的第一步！如果你有较好的JAVA基础，你可以在mod_myFirstMod类里自己玩玩你的配置文件管理类。