com.codelanx.codelanxlib.config

Interface Lang

All Superinterfaces:

PluginFile

All Known Implementing Classes:

InternalLang

public interface Lang
extends PluginFile

Represents a single value that is dynamically retrieved from a FileDataType. This value should be usable with a Formatter and is typically implemented through an enum

Since:

0.1.0

Version:

0.1.0

Author:

1Rogue

Method Summary

Modifier and Type	Method and Description
static String	color(String color) Converts pre-made strings to have chat colors in them
static Lang	createLang(String format) Returns a raw Lang object that can be used for dynamic creation of Lang variables
static Lang	defaultFormat(String option) Returns a Lang object representing the default formatting for all CodelanxLib plugins.
default String	format(Object... args) Formats a Lang enum constant with the supplied arguments
String	getDefault() The default value of this YAML string
Lang	getFormat() Returns the format specifier for this Lang file.
static Lang	getFormat(org.bukkit.plugin.Plugin plugin) Returns an acceptable message format for the plugin at hand
default String	pluralFormat(int amount, Object... args) Will format a string with "PLURAL" or "PLURALA" tokens in them.
static void	sendMessage(org.bukkit.command.CommandSender target, Lang format, Lang message, Object... args) Sends a message but does not include getFormat(), instead it uses a supplied format
static void	sendMessage(org.bukkit.command.CommandSender target, Lang message, Object... args) Sends a formatted string and prepends the getFormat() to it.
static void	sendRawMessage(org.bukkit.command.CommandSender target, Lang message, Object... args) Sends a raw message without additional formatting aside from translating color codes

Methods inherited from interface com.codelanx.codelanxlib.config.PluginFile

getConfig, getFileLocation, getPath, init, save, save

Method Detail

getFormat

Lang getFormat()

Returns the format specifier for this Lang file. This should be a constant in the enum and represent a value that is used for all messages universally.

Returns:

The format specifier for this Lang

Since:

0.1.0

getDefault

String getDefault()

The default value of this YAML string

Specified by:

getDefault in interface PluginFile

Returns:

The default value

Since:

0.1.0

format

default String format(Object... args)

Formats a Lang enum constant with the supplied arguments

Parameters:

args - The arguments to supply

Returns:

The formatted string

Since:

0.1.0

pluralFormat

default String pluralFormat(int amount,
                            Object... args)

Will format a string with "PLURAL" or "PLURALA" tokens in them.

• PLURALA: Token that will evaluate gramatically. An int value of 1 will return "is <amount> 'word'", otherwise it will be "are <amount> 'word'".
• PLURAL: Token that will evaluate the word. An int value of 1 will return the first word, value of 2 the second word.

Parameters:

amount - The amount representative of the data token

args - The arguments to replace any other tokens with.

Returns:

The formatting string value for plurals

Since:

0.1.0

createLang

static Lang createLang(String format)

Returns a raw Lang object that can be used for dynamic creation of Lang variables

Parameters:

format - The string to wrap in a Lang object

Returns:

A Lang object that will

Since:

0.1.0

defaultFormat

static Lang defaultFormat(String option)

Returns a Lang object representing the default formatting for all CodelanxLib plugins. The option parameter can be supplemented with null which will default to "CL-Lib". The returned format is:

"&f[&9" + option == null ? "CL-Lib" : option + "&f] %amp;s"

Parameters:

option - The optional "title" string for the format

Returns:

A Lang object representing the default format

Since:

0.1.0

getFormat

static Lang getFormat(org.bukkit.plugin.Plugin plugin)

Returns an acceptable message format for the plugin at hand

Parameters:

plugin - A Plugin that needs a format

Returns:

A relevant Lang format

Since:

0.1.0

color

static String color(String color)

Converts pre-made strings to have chat colors in them

Parameters:

color - String with un-converted color codes

Returns:

string with correct chat colors included

Since:

0.1.0

sendMessage

static void sendMessage(org.bukkit.command.CommandSender target,
                        Lang message,
                        Object... args)

Sends a formatted string and prepends the getFormat() to it.

Parameters:

target - The target to send to

message - The message to colorize and send

args - Arguments to supply to the Lang message

Since:

0.1.0

sendMessage

static void sendMessage(org.bukkit.command.CommandSender target,
                        Lang format,
                        Lang message,
                        Object... args)

Sends a message but does not include getFormat(), instead it uses a supplied format

Parameters:

target - The target to send to

format - The format provided

message - The message to colorize and send

args - Arguments to supply to the Lang message

Since:

0.1.0

sendRawMessage

static void sendRawMessage(org.bukkit.command.CommandSender target,
                           Lang message,
                           Object... args)

Sends a raw message without additional formatting aside from translating color codes

Parameters:

target - The target to send to

message - The message to colorize and send

args - Arguments to supply to the Lang message

Since:

0.1.0