Configuration

Tutorial on how to configure EasyConomy

The Basics

EasyConomy has these files that you can configure:

• config.yml

• messages_LANGUAGE.yml

You can find them in the EasyConomy folder in the plugins folder of your server. This guide will guide you through each file and each setting.

The config.yml file

This file is for all basic configuration (not for message configuration, we'll get to that later)

language: en

prefix: "&3EasyConomy &8| &7"

enable-logging: true

update-checker: true

permissions:
  README: >
    IF YOU WANT THE PLUGIN TO USE PERMISSIONS,
    WRITE THE PERMISSIONS DOWN IN THE "".
    EMPTY QUOTATION MARKS => BALANCE AND OTHERSBALANCE AND PAY FOR EVERYONE
    AND MODIFY FOR OP ONLY
  balance: ""
  othersBalance: ""
  pay: ""
  modify: ""
  baltop: ""

startingBalance: 0

minimumTransactionAmount: 0.1

decimalsShown: -1

baltopPlayers: 10

names:
  currencyNamePlural: "Dollars"
  currencyNameSingular: "Dollar"
  currencyFormatPlural: "%s Dollars"
  currencyFormatSingular: "%s Dollar"

CONFIG_VERSION_NEVER_CHANGE_THIS: 4

• language: You can change this setting so that the plugin loads a different language file, e.g. "de" for the German messages.

• prefix: This appears in front of all messages. You can set it to "" so that nothing appears in front of all messages, or change it to anything you like! (The &-Symbol is for color-coding, more on that later)

• enable-logging: If this is set to "true", a note will appear in the console every time someone transfers money, gets money etc. If you have a larger server where this spams the console, set it to false. Doing so will also mean that you will not be able to trace what your players are doing!

• update-checker: On every server restart/reload, the plugin sends a request to spigotmc.org to figure out what the newest version is. If you want to disable this request, simply set this option to false.

• permissions: Just read what it says under "readme". If you don't know what permissions even are, this is a great tutorial on that

• startingBalance: The amount of money a player gets when he joins for the first time

• minimumTransactionAmount: The minimum amount of money a player has to transfer to another player (so that people cant send 0.000000001$ to annoy the others)

• decimalsShown: You can decide how many decimal places will be shown to the user. -1 means as detailed as possible, 1 means only 1 decimal is shown, 2 only 2 etc.

• baltopPlayers: This is the amount of players that are in baltop. If you want to disable baltop just set the value to -1.

• names: You can set the name of the currency here. The default is Dollars, but if you want to use Euros just set the nameSingular to "Euro" and the namePlural to "Euros". You can set this to anything you want.

• CONFIG_VERSION_NEVER_CHANGE_THIS: NEVER CHANGE THIS SETTING!!

Changing the messages of the plugin

NEVER EVER edit these files directly. ALWAYS COPY AND PASTE an existing file INTO A NEW ONE and change THE NEW ONE. Then set the language option in the config.yml to the new file.

1. Shut your server down !!!

2. Copy an existing message file, paste it and rename it to messages_XX.yml (you can use anything in XX)

3. Change the "language" entry in the config.yml to whatever you used instead of XX

4. Change any message in your new messages file.

Things to keep in consideration:

• You can color any message with & color codes. All color codes: http://ess.khhq.net/mc/

• The plugin uses the placeholder %s internally. It gets replaced with whatever makes sense in that message. If the original message uses %s, figure out what they stand for and use them wherever you like in your translation.

  • Because of this, the order actually matters! There are a few messages with multiple %s, where you have to include the %s in the same order.

• You can change the prefix in the config.yml