Field Detail

• root

  protected java.util.Map<java.lang.String,java.lang.Object> root

Constructor Detail

• YAMLNode

  public YAMLNode(java.util.Map<java.lang.String,java.lang.Object> root,
                  boolean writeDefaults)

Method Detail

• getMap

  public java.util.Map<java.lang.String,java.lang.Object> getMap()

  Return the underlying map.

  Returns:

  the map

• clear

  public void clear()

  Clear all nodes.

• getProperty

  public java.lang.Object getProperty(java.lang.String path)

  Gets a property at a location. This will either return an Object or null, with null meaning that no configuration value exists at that location. This could potentially return a default value (not yet implemented) as defined by a plugin, if this is a plugin-tied configuration.

  Parameters:

  path - path to node (dot notation)

  Returns:

  object or null

• setProperty

  public void setProperty(java.lang.String path,
                          java.lang.Object value)

  Set the property at a location. This will override existing configuration data to have it conform to key/value mappings.

  Parameters:

  path - the path

  value - the new value

• addNode

  public YAMLNode addNode(java.lang.String path)

  Adds a new node to the given path. The returned object is a reference to the new node. This method will replace an existing node at the same path. See setProperty.

  Parameters:

  path - the path

  Returns:

  a node for the path

• getString

  public java.lang.String getString(java.lang.String path)

  Gets a string at a location. This will either return an String or null, with null meaning that no configuration value exists at that location. If the object at the particular location is not actually a string, it will be converted to its string representation.

  Parameters:

  path - path to node (dot notation)

  Returns:

  string or null

• getVector

  public Vector3 getVector(java.lang.String path)

  Gets a vector at a location. This will either return an Vector or a null. If the object at the particular location is not actually a string, it will be converted to its string representation.

  Parameters:

  path - path to node (dot notation)

  Returns:

  string or default

• getVector2

  public Vector2 getVector2(java.lang.String path)

  Gets a 2D vector at a location. This will either return an Vector or a null. If the object at the particular location is not actually a string, it will be converted to its string representation.

  Parameters:

  path - path to node (dot notation)

  Returns:

  string or default

• getVector

  public Vector3 getVector(java.lang.String path,
                           Vector3 def)

  Gets a string at a location. This will either return an Vector or the default value. If the object at the particular location is not actually a string, it will be converted to its string representation.

  Parameters:

  path - path to node (dot notation)

  def - default value

  Returns:

  string or default

• getString

  public java.lang.String getString(java.lang.String path,
                                    java.lang.String def)

  Gets a string at a location. This will either return an String or the default value. If the object at the particular location is not actually a string, it will be converted to its string representation.

  Parameters:

  path - path to node (dot notation)

  def - default value

  Returns:

  string or default

• getInt

  public java.lang.Integer getInt(java.lang.String path)

  Gets an integer at a location. This will either return an integer or null. If the object at the particular location is not actually a integer, the default value will be returned. However, other number types will be casted to an integer.

  Parameters:

  path - path to node (dot notation)

  Returns:

  integer or null

• getInt

  public int getInt(java.lang.String path,
                    int def)

  Gets an integer at a location. This will either return an integer or the default value. If the object at the particular location is not actually a integer, the default value will be returned. However, other number types will be casted to an integer.

  Parameters:

  path - path to node (dot notation)

  def - default value

  Returns:

  int or default

• getDouble

  public java.lang.Double getDouble(java.lang.String path)

  Gets a double at a location. This will either return an double or null. If the object at the particular location is not actually a double, the default value will be returned. However, other number types will be casted to an double.

  Parameters:

  path - path to node (dot notation)

  Returns:

  double or null

• getDouble

  public double getDouble(java.lang.String path,
                          double def)

  Gets a double at a location. This will either return an double or the default value. If the object at the particular location is not actually a double, the default value will be returned. However, other number types will be casted to an double.

  Parameters:

  path - path to node (dot notation)

  def - default value

  Returns:

  double or default

• getBoolean

  public java.lang.Boolean getBoolean(java.lang.String path)

  Gets a boolean at a location. This will either return an boolean or null. If the object at the particular location is not actually a boolean, the default value will be returned.

  Parameters:

  path - path to node (dot notation)

  Returns:

  boolean or null

• getBoolean

  public boolean getBoolean(java.lang.String path,
                            boolean def)

  Gets a boolean at a location. This will either return an boolean or the default value. If the object at the particular location is not actually a boolean, the default value will be returned.

  Parameters:

  path - path to node (dot notation)

  def - default value

  Returns:

  boolean or default

• getKeys

  public java.util.List<java.lang.String> getKeys(java.lang.String path)

  Get a list of keys at a location. If the map at the particular location does not exist or it is not a map, null will be returned.

  Parameters:

  path - path to node (dot notation)

  Returns:

  list of keys

• getList

  public java.util.List<java.lang.Object> getList(java.lang.String path)

  Gets a list of objects at a location. If the list is not defined, null will be returned. The node must be an actual list.

  Parameters:

  path - path to node (dot notation)

  Returns:

  boolean or default

• getStringList

  public java.util.List<java.lang.String> getStringList(java.lang.String path,
                                                        java.util.List<java.lang.String> def)

  Gets a list of strings. Non-valid entries will not be in the list. There will be no null slots. If the list is not defined, the default will be returned. 'null' can be passed for the default and an empty list will be returned instead. If an item in the list is not a string, it will be converted to a string. The node must be an actual list and not just a string.

  Parameters:

  path - path to node (dot notation)

  def - default value or null for an empty list as default

  Returns:

  list of strings

• getIntList

  public java.util.List<java.lang.Integer> getIntList(java.lang.String path,
                                                      java.util.List<java.lang.Integer> def)

  Gets a list of integers. Non-valid entries will not be in the list. There will be no null slots. If the list is not defined, the default will be returned. 'null' can be passed for the default and an empty list will be returned instead. The node must be an actual list and not just an integer.

  Parameters:

  path - path to node (dot notation)

  def - default value or null for an empty list as default

  Returns:

  list of integers

• getDoubleList

  public java.util.List<java.lang.Double> getDoubleList(java.lang.String path,
                                                        java.util.List<java.lang.Double> def)

  Gets a list of doubles. Non-valid entries will not be in the list. There will be no null slots. If the list is not defined, the default will be returned. 'null' can be passed for the default and an empty list will be returned instead. The node must be an actual list and cannot be just a double.

  Parameters:

  path - path to node (dot notation)

  def - default value or null for an empty list as default

  Returns:

  list of integers

• getBooleanList

  public java.util.List<java.lang.Boolean> getBooleanList(java.lang.String path,
                                                          java.util.List<java.lang.Boolean> def)

  Gets a list of booleans. Non-valid entries will not be in the list. There will be no null slots. If the list is not defined, the default will be returned. 'null' can be passed for the default and an empty list will be returned instead. The node must be an actual list and cannot be just a boolean,

  Parameters:

  path - path to node (dot notation)

  def - default value or null for an empty list as default

  Returns:

  list of integers

• getVectorList

  public java.util.List<Vector3> getVectorList(java.lang.String path,
                                               java.util.List<Vector3> def)

  Gets a list of vectors. Non-valid entries will not be in the list. There will be no null slots. If the list is not defined, the default will be returned. 'null' can be passed for the default and an empty list will be returned instead. The node must be an actual node and cannot be just a vector,

  Parameters:

  path - path to node (dot notation)

  def - default value or null for an empty list as default

  Returns:

  list of integers

• getVector2List

  public java.util.List<Vector2> getVector2List(java.lang.String path,
                                                java.util.List<Vector2> def)

  Gets a list of 2D vectors. Non-valid entries will not be in the list. There will be no null slots. If the list is not defined, the default will be returned. 'null' can be passed for the default and an empty list will be returned instead. The node must be an actual node and cannot be just a vector,

  Parameters:

  path - path to node (dot notation)

  def - default value or null for an empty list as default

  Returns:

  list of integers

• getBlockVector2List

  public java.util.List<BlockVector2> getBlockVector2List(java.lang.String path,
                                                          java.util.List<BlockVector2> def)

  Gets a list of 2D vectors. Non-valid entries will not be in the list. There will be no null slots. If the list is not defined, the default will be returned. 'null' can be passed for the default and an empty list will be returned instead. The node must be an actual node and cannot be just a vector,

  Parameters:

  path - path to node (dot notation)

  def - default value or null for an empty list as default

  Returns:

  list of integers

• getNodeList

  public java.util.List<YAMLNode> getNodeList(java.lang.String path,
                                              java.util.List<YAMLNode> def)

  Gets a list of nodes. Non-valid entries will not be in the list. There will be no null slots. If the list is not defined, the default will be returned. 'null' can be passed for the default and an empty list will be returned instead. The node must be an actual node and cannot be just a boolean,

  Parameters:

  path - path to node (dot notation)

  def - default value or null for an empty list as default

  Returns:

  list of integers

• getNode

  @Nullable
  public YAMLNode getNode(java.lang.String path)

  Get a configuration node at a path. If the node doesn't exist or the path does not lead to a node, null will be returned. A node has key/value mappings.

  Parameters:

  path - the path

  Returns:

  node or null

• getNodes

  public java.util.Map<java.lang.String,YAMLNode> getNodes(java.lang.String path)

  Get a list of nodes at a location. If the map at the particular location does not exist or it is not a map, null will be returned.

  Parameters:

  path - path to node (dot notation)

  Returns:

  map of nodes

• removeProperty

  public void removeProperty(java.lang.String path)

  Remove the property at a location. This will override existing configuration data to have it conform to key/value mappings.

  Parameters:

  path - a path

• writeDefaults

  public boolean writeDefaults()

• setWriteDefaults

  public void setWriteDefaults(boolean writeDefaults)