Plugin settings

Page is outdated!
Information is current for versions lower than 2.0.0

You will most likely change these settings only once and forget about them :)
The main plugin settings are in the config.yml file.
First, let's take a look at it.

Spoiler

Now we will analyze each setting separately and understand what they are for.


Step 1: Basic Settings

Property Values Description
enabled Boolean type Enable or disable the plug-in
language Can take any value corresponding to the file name in the folder /lang Plugin language
auto-update Boolean type System of auto-updates. If this option is enabled, you will automatically be notified when new versions are released
metrics Boolean type Metrics. The plugin sends anonymous usage statistics to the server MCStats. This makes my life a little easier, so please do not turn this setting off
worlds Setting up the plugin in certain worlds
worlds.mode BLACKLIST
WHITELIST
Mode of operation of the list of worlds
worlds.list Names of worlds, each with a new line:
- first_world
- second_world
If the operating mode is selected BLACKLIST , then in the worlds from this list the plugin will not work, and if WHITELIST , the plugin, on the contrary, will work ONLY in the worlds from this list.
level-system EXP
SKILLAPI
BATTLELEVELS
SKILLS
HEROES
RAC
RPGPL
This setting determines which level system will be used. Levels will be needed to restrict access to objects and slots, as well as to purchase slots.
class-system PERMISSIONS
SKILLAPI
HEROES
RAC
This setting determines which class system will be used. Classes will be needed to restrict access to objects.
If the system PERMISSIONS is selected, then the player must have a resolution in the format: rpginventory.class.<class_name>


Step 2: Item settings

There are only two settings that apply to all items created in RPGInventory.

items.lore-pattern
This is a template for describing the subject. It is written in the list, it can contain string literals.
Consider a template that uses all flags and one string literal:

lore-pattern:
- _UNBREAKABLE_
- _DROP_
- _LEVEL_
- _CLASS_
- _SEPARATOR_
- _LORE_
- _SEPARATOR_
- _SKILLS_
- _SEPARATOR_
- _STATS_
- '&6&lPowered by RPGInventory'

n the game it will look like the screenshot on the right.
The example shows a flag which sootvestvtuet, but still explain:

_UNBREAKABLE_ - In the first place we have the inscription “Nelomaya” it is displayed only for unbreakable objects and in the case with the omnipotent ring it did not lead out.

_DROP_ - In the second place is an inscription that is displayed only for items that do not fall out after death. Our ring fits this category.

_LEVEL_ - Then the required level of the subject

_CLASS_ - And the required class

_LORE_ - Artistic description of the subject

_SKILLS_ - Active properties of the object

_STATS_ - Passive properties of the object

_SEPARATOR_ - Delimiter. As we see, it repeats itself in the template several times and does not carry any information load. This is simply a division of the description of the subject for better readability.

And the last type is a string literal:
'Any text' - Here we can write any text, if we want it to be displayed for all objects created with RPGInventory. The text must be enclosed in single quotes and may contain color codes.

items.separator
This setting specifies what will be used as a delimiter. By default, an empty value is used (an empty string), but you can put something of your own.


Step 3: Containers settings

A container is almost any graphical interface, be it a chest, a distributor or a hopper.

backpacks.expiration-time
This setting determines the “shelf life” of backpacks.
Field Format: positive integer
f during the specified number of days the backpack will not be opened once, its contents will be cleared. This is to ensure that your server is not cluttered with unnecessary “dead souls”.
To disable this function, use the value 0, but this is not strongly advised.

backpacks.limit
This setting sets the maximum number of backpacks that can be in the user's inventory. In order for the player not to score all the inventory with backpacks.
Field Format: positive integer
Default: 1

containers.block
Lock containers.
Takes values boolean type.

containers.list
Containers from this list can not be opened by ordinary users who do not have the right rpginventory.container

List of available containers:

  • CHEST - Includes a double chest and a chest-trap
  • ENDER_CHEST
  • DISPENSER
  • DROPPER
  • FURNACE
  • WORKBENCH
  • ENCHANTING
  • BREWING
  • MERCHANT
  • ANVIL
  • BEACON
  • HOPPER

Step 4: GUI Settings

These settings affect the appearance of your inventory.

Graphical settings are divided into two groups:

  1. Resource Pack Settings
  2. Alternate view settings

Resource Pack Settings

resource-pack.url
Link to resource-pack RPGInventory.
for example: https://dl.dropboxusercontent.com/u/105899524/RPGInventory/ResourcePack_ru.zip

resource-pack.hash
SHA-1 resource-pack hash. It is necessary for the game to be able to identify the resource pack and not to download it again if it has already been downloaded.

resource-pack.fill
These objects fill the entire space, where there are no slots.
Format of the field: Texture


Step 5: Battle system

Slightly change the Minecraft battle system.

attack.require-weapon
If true, the player will only be able to attack enemies when he has weapons in his hands, or to be more precise, only when the weapon slot is active. If the player tries to attack the target, when the other slot is active, the damage simply will not pass.

attack.force-weapon
If it is true, then during the attack the weapon slot will automatically become active, but only there is a weapon in it.

attack.auto-held
If the player picks up an object from the ground and it gets into the weapon slot, then this slot will automatically become active. For example, you have an empty weapon slot, you picked up the sword and it automatically “will undertake” in your hand.

attack.own-pet
Is it possible to attack their pets. If true, then the damage passes, if false - no.


Step 7: Slots system

These are not RPGInventory slots. This refers to the base slots.

Customize Values Description
slots.enabledBoolean typeEnabling/disabling the purchasing system of slots
slots.lockedTextureTexture to be used as a placeholder for inaccessible slots
slots.buyableTextureThe texture that will be used as a filler for available slots
slots.freeAn integer from 0 to 36Number of slots available to the player for free
slots.money.enabledBoolean typeDo I need money to unlock slots
slots.money.clost.line1
slots.money.clost.line2
slots.money.clost.line3
Non-negative numberThe amount of money to unlock slots from the 1st, 2nd and 3rd line of the inventory.
slots.level.enabledBoolean typeDo I need a level to unlock the slot
slots.level.spendBoolean typeWill the level be spent when buying a slot
slots.level.required.line1
slots.level.required.line2
slots.level.required.line3
Non-negative numberThe level required to unlock slots in the 1st, 2nd and 3rd line inventory