# 2. Configuration

Inside file `/plugins/LTItemMail/config.yml` there is a few important settings.

***

```yaml
plugin:
    language: 'english'
    tag: '&6[LTIM]'
```

`plugin.language`**:** Sets the language that will be used for commands and activities of the plugin.  You can choose between:

* english: English US
* portuguese: Portuguese BR
* vietnamese: Vietnamese, currently obsolete due to lack of update.





`plugin.tag`**:** Sets the plugin tag that will show in some plugin messages. You can customize it using bukkit color and formatting codes: [https://htmlcolorcodes.com/bukkit-color-codes/](https://htmlcolorcodes.com/bukkit-color-codes/)

<figure><img src="https://content.gitbook.com/content/qZxnCgc0tcgBWZFUPqit/blobs/S1yRVQyGHUbvwq39lgt1/image.png" alt=""><figcaption><p>Exemplo de tag definida no arquivo config.yml</p></figcaption></figure>

***

```yaml
database:
    type: 'flatfile'
    convert: false
    mysql:
        host: '127.0.0.1:3306'
        user: 'root'
        password: ''
        database: 'ltitemmail'
```

`database.type`**:** Sets the data storage type. You can choose between:

* flatfile: A local file extracted inside plugin folder
* mysql



`database.convert`: Imports data from the old storage type to the new one.

If you are using the local file (flatfile) for data storage, you must set the plugin to use MySQL and activate database conversion.

It is also possible to convert from MySQL to flatfile if you set the plugin to use the local file (keeping MySQL login configured) and activating the database conversion.



`database.mysql.host`**:** MySQL server host (IP:Port).



`database.mysql.user`**:** MySQL username.



`database.mysql.password`**:** MySQL password.



`database.mysql.database`**:** MySQL database name.

***

```yaml
mail:
    display: 'CHAT'
    cost:
        per-item: false
        value: 30.0
    name: '&3&lMail&r&4'
```

`mail.display`**:** You can choose to show new mail notification as a title, chat message or toast notification.

Examples:

* `CHAT`:

<figure><img src="https://content.gitbook.com/content/qZxnCgc0tcgBWZFUPqit/blobs/3tI67hL2ZgmJWiaj2a7D/image.png" alt=""><figcaption><p>Chat notification</p></figcaption></figure>

* `TITLE`:

<figure><img src="https://content.gitbook.com/content/qZxnCgc0tcgBWZFUPqit/blobs/KIuF5cJ64EQN2ykGnD38/image.png" alt=""><figcaption><p>Title notification</p></figcaption></figure>

* `TOAST`:

<figure><img src="https://content.gitbook.com/content/qZxnCgc0tcgBWZFUPqit/blobs/mrh1lItFB5oRkHMUGl6A/image.png" alt=""><figcaption><p>Toast notification</p></figcaption></figure>



`mail.cost.per-item`**:** If enabled, mail price will be multiplied by the number items inside mail inventory.



`mail.cost.value`**:** Sets the current mail price.



`mail.name`**:** Sets the mail inventory name. You can customize it using bukkit color and formatting codes: [https://htmlcolorcodes.com/bukkit-color-codes/](https://htmlcolorcodes.com/bukkit-color-codes/)

<figure><img src="https://content.gitbook.com/content/qZxnCgc0tcgBWZFUPqit/blobs/17wj1NRs7tGPHa16a9mh/image.png" alt=""><figcaption><p>Exemplo de nome definido no arquivo config.yml</p></figcaption></figure>

***

### Configuration file:

```yaml
plugin:
    #Enable or disable LTItemMail. Default: true
    #
    #Habilita ou desabilita o LTItemMail. Padrão: true
    enable: true
    #Pre-installed languages support: portuguese, english, vietnamese. Default: english
    #
    #Suporte de idiomas pré-instalados: portuguese, english, vietnamese. Padrão: english
    #Para pt-BR, selecione: portuguese
    language: 'english'
    #Here you can customize the plugin tag that appears in chat. Default: [LTIM]
    #
    #Aqui você pode customizar a tag do plugin que aparece no chat. Padrão: [LTIM]
    tag: '&6[LTIM]'
    #Choose if you want to use LTItemMail in your Bungee network.
    #
    #Escolha se quer usar o LTItemMail na sua rede Bungee.
    bungee-mode: false
    debug: false
database:
    type: 'flatfile' #'flatfile' or 'mysql' | 'flatfile' ou 'mysql'
    #You can use my plugin in bungee mode as long as it is installed on every server you want to use (except proxy).
    #And you must use the same MySQL database.
    #Remember to set bungee-mode 'true'.
    #
    #Você pode usar meu plugin no modo Bungee desde que ele esteja instalado em todos os servidores que você irá utilizá-lo (exceto na proxy).
    #E o mesmo banco de dados MySQL deve estar sendo usado.
    #Lembre-se de definir bungee-mode 'true'.
    flatfile:
        #Do not change it unless you have manually changed the name of the database file.
        #
        #Não mude a menos que tenha mudado manualmente o nome do arquivo banco de dados.
        file: 'mailboxes.db'
    mysql:
        host: '127.0.0.1:3306'
        user: 'root'
        password: ''
        database: 'ltitemmail'
hook:
    #Set 'true' if you wish to use economy plugins (set the mail price).
    #
    #Defina 'true' se desejar usar um plugin de economia (defina o preço do corrêio).
    vault: false
    #Set 'true' if you wish to show mailbox blocks on the map.
    #
    #Defina 'true' se desejar mostrar blocos de caixa de corrêio no mapa.
    dynmap: false
    #Set 'true' if you wish to show mailbox blocks on the map.
    #
    #Defina 'true' se desejar mostrar blocos de caixa de corrêio no mapa.
    bluemap: false
    #Set 'true' if you wish to show holograms above mailbox blocks.
    #
    #Defina 'true' se desejar mostrar hologramas acima do blocos de caixa de corrêio.
    decentholograms: false
    #My plugin has an in-built protection for mailbox blocks, but you can use some extra protection with the plugins listed below:
    #
    #Meu plugin tem uma proteção imbutida para blocos de caixa de corrêio, mas você pode usar uma proteção extra com os plugins abaixo:
    griefprevention: false
    redprotect: false
    towny: false
    worldguard: false
mail:
    #Set 'true' if you wish to show titles instead of chat messages. Default: false
    #
    #Defina 'true' de desejar mostrar títulos em vez de mensagens no chat. Padrão: false
    use-title: false
    cost:
        #Set 'true' to multiply the price by the number of items. Default: false
        #
        #Defina 'true' para multiplicar o preço pelo número de itens. Padrão: false
        per-item: false
        #Price to send items. Default: 1.5 (per item) and 30.0 (per mail)
        #
        #Preço para enviar itens. Padrão: 1.5 (por item) e 30.0 (por corrêio)
        value: 30.0
    #Name of the mail inventory. Default: Mail
    #
    #Nome do inventário de corrêio. Padrão: Mail
    name: '&3&lMail&r&4'
#Should administrators be warned about new updates? Default: true
#
#Os administratores devem ser notificados sobre novas atualizações? Padrão: true
update:
    check: true
    periodic-notification: true
#Do not touch it!
config-version: 11
```

***

### Language files:

#### Portuguese (BR):

```yaml
player:
    permissionerror: 'Você não tem permissão para fazer isso.'
    inventoryfull: '% não tem % slot(s) livre(s).'
    missingerror: 'Você deve especificar o nome do jogador.'
    neverplayederror: 'O jogador especificado nunca entrou neste servidor.'
    error: 'Você precisa ser um jogador para fazer isso!'
    syntaxerror: 'Erro de sintaxe!'
    selferror: 'Você não pode enviar itens para você mesmo.'
    openedboxes: 'Corrêios deletados de'
    banned: 'Você está banido! O motivo pode ser visto digitando /itemmail info'
mailbox:
    closed: 'Caixa fechada.'
    sent: 'Enviando corrêio para %...'
    from: 'Novo corrêio de'
    special: 'Corrêio especial!!!'
    aborted: 'Envio cancelado.'
    nonew: 'Não há novos corrêios.'
    iderror: 'ID do corrêio deve ser um número inteiro.'
    deleted: 'Deletado'
    empty: 'Vazio'
    nolost: 'Não há itens perdidos neste corrêio.'
    emptylist: 'Não há corrêios deletados do jogador'
    blocked: 'Algo impediu este corrêio. Entrega cancelada.'
    label: '&6&lEtiqueta:'
    cost: '&a&lCusto:'
    costerror: 'Plugin de economia não encontrado.'
    costupdate: 'Clique para atualizar o preço atual do corrêio.'
    returned: 'enviou de volta pra você.'
transaction:
    error: 'Transação mal sucedida!'
    nomoney: 'Você não tem $% para pagar ao corrêio.'
    paid: 'Você pagou $% ao corrêio.'
    notinstalled: 'Vault não está instalado!'
    costs: 'Preço:'
block:
    breakerror: 'Você não tem permissão para quebrar esta caixa de corrêio.'
    placeerror: 'Você não tem permissão para colocar uma caixa de corrêio.'
    useerror: 'Você não tem permissão para usar uma caixa de corrêio.'
    ownererror: 'Você não é o dono desta caixa de corrêio para fazer isso.'
    belowerror: 'O bloco debaixo deve ser uma cerca.'
    adminbroke: 'Você quebrou a caixa de corrêio de'
command:
    invalid: 'Comando inválido. Digite % para ver a lista de comandos.'
    player:
        itemmail: 'Lista de comandos para jogadores.'
        version: 'Mostra a versão atual do plugin.'
        list: 'Lista de todos os corrêios recebidos.'
        open: 'Abre um corrêio.'
        delete: 'Deleta um corrêio.'
        mailitem: 'Inicia um novo corrêio pra colocar itens dentro e enviar para outro jogador.'
        costs: 'Mostra preço de envio.'
        info:
            info: 'Mostra informações relevantes sobre o jogador.'
            registry: 'Data de registro:'
            banned:
                banned: 'Banido:'
                nop: 'Não'
                yep: 'Sim'
                reason: 'Motivo do banimento:'
            sent: 'Corrêios enviados:'
            received: 'Corrêios recebidos:'
    admin:
        itemmailadmin: 'Lista de comandos para admins.'
        update: 'Verifica se há novas atualizações.'
        list: 'Lista de todos os corrêios deletados de um jogador.'
        recover: 'Recupera items perdidos de corrêios deletados (se houver algum).'
        reload: 'Recarrega as configurações do plugin e idioma/tradução.'
        ban:
            ban: 'Bane um jogador específico.'
            banned: 'banido!'
            already: 'já está banido!'
        unban:
            unban: 'Desbane um jogador específico.'
            unbanned: 'desbanido!'
            already: 'já está desbanido!'
        banlist:
            banlist: 'Lista de banimentos.'
            list: 'Jogadores banidos:'
            empty: 'Não há jogadores banidos.'
#Não toque nisso!
language-version: 9
```



#### English (US):

```yaml
player:
    permissionerror: 'You do not have permission to do that.'
    inventoryfull: '% does not have % free slot(s).'
    missingerror: 'You must specify a player!'
    neverplayederror: 'The specified player never joined this server.'
    error: 'You must be a player to do that!'
    syntaxerror: 'Syntax error!'
    selferror: 'You can not send items to yourself.'
    openedboxes: 'Deleted mails of'
    banned: 'You are banned! Ban reason available in /itemmail info'
mailbox:
    closed: 'Mail closed.'
    sent: 'Sending mail to %...'
    from: 'New mail from'
    special: 'Special Mail!!!'
    aborted: 'Shipping canceled!'
    nonew: 'No new mails.'
    iderror: 'Mail ID must be a number.'
    deleted: 'Deleted'
    empty: 'Empty'
    nolost: 'There is no lost items in this mail.'
    emptylist: 'No deleted mails for player'
    blocked: 'Something blocked this mail. Delivery cancelled.'
    label: '&6&lLabel:'
    cost: '&a&lCost:'
    costerror: 'Economy plugin not found.'
    costupdate: 'Click to update the current mail price.'
    returned: 'sent it back to you.'
transaction:
    error: 'Transaction not succeeded!'
    nomoney: 'You do not have $% to pay to the post office.'
    paid: 'You paid $% to the post office.'
    notinstalled: 'Vault is not installed!'
    costs: 'Price:'
block:
    breakerror: 'You do not have permission to break that mailbox.'
    placeerror: 'You do not have permission to place a mailbox.'
    useerror: 'You do not have permission to use a mailbox.'
    ownererror: 'You are not the mailbox owner to do that.'
    belowerror: 'Below block must be a fence.'
    adminbroke: 'You broke the mailbox of'
command:
    invalid: 'Invalid command. Type % to see the command list.'
    player:
        itemmail: 'Lists player commands.'
        version: 'Shows the current plugin version.'
        list: 'Lists all mails received.'
        open: 'Opens a mail.'
        delete: 'Deletes a mail.'
        mailitem: 'Opens a new mail to put items inside and send it to another player.'
        costs: 'Shows mail price.'
        info:
            info: 'Shows relevant informations about the player.'
            registry: 'Registry date:'
            banned:
                banned: 'Banned:'
                nop: 'No'
                yep: 'Yes'
                reason: 'Ban reason:'
            sent: 'Mails sent:'
            received: 'Mails received:'
    admin:
        itemmailadmin: 'Lists admin commands.'
        update: 'Checks for new updates.'
        list: 'Lists deleted mails of a player.'
        recover: 'Recovers lost items from a deleted mail (if there is any).'
        reload: 'Reloads plugin config and language settings.'
        ban:
            ban: 'Ban a specific player.'
            banned: 'banned!'
            already: 'is banned already!'
        unban:
            unban: 'Unban a specific player.'
            unbanned: 'unbanned!'
            already: 'is unbanned already!'
        banlist:
            banlist: 'Banned list.'
            list: 'Players banned:'
            empty: 'No players banned.'
#Do not touch it!
language-version: 9
```



#### Vietnamese (obsolete):

```yaml
#Translation created by DUYSONGLOI: https://github.com/DUYSONGLOI
player:
    permissionerror: 'Bạn không có quyền để làm điều này'
    inventoryfull: '% không có đủ % slots còn trống để gửi.'
    missingerror: 'bạn phải chỉ định người chơi!'
    error: 'Bạn phải là người chơi để làm điều này!'
    selferror: 'Không thể gửi cho chính mình.'
mailbox:
    closed: 'Đã tắt MailBox!'
    sent: 'Vật phẩm đã gửi cho %.'
    from: 'Mailbox từ:'
    special: 'hộp thư đặc biệt!!!'
    aborted: 'Box Trống! Đã bị hủy.'
transaction:
    error: 'Giao dịch không thành công!'
    nomoney: 'Bạn không có % để gửi.'
    paid: 'Đã thanh toán % cho ngân hàng!'
#Đừng thay đổi nó trong bất kỳ trường hợp nào!
language-version: 3
```
