# ENGLISH BetterBags is a plugin that allows players to have a bag that adds features such as item auto-picking, upgradable levels, configurable restricted actions, supportable MiniMessage, player data saving, fully customizable items&messages, and more. ## Features > * Items auto-picking; can or cannot pick up only sellable items > * Upgradable levels for the bag > * Possible to restrict players in their actions (disable/enable the ability to manipulate items from the bag) > * Player's data in the `data/.yml` files > * Fully customizable items, messages, levels, sellable items > * Items in the bag can be sold by the only one button > * Includes selling multiplier which can be set by the permission (`betterbags.multiplier.`) or by the command (`/bags multiplier`) > * Fully supports MiniMessage ## Commands > * `/bags reload` - Reloads the plugin's configuration > * `/bags save` - Saves player data > * `/bags clear ` - Clears a player's (or multiple players) bag > * `/bags level ` - Sets a player's (or multiple players) bag level > * `/bags give ` - Gives a player (or multiple players) a bag > * `/bags multiplier ` - Sets a player's (or multiple players) bag multiplier > * `/bags open ` - Opens a player's (or multiple players) bag > * `/bags sell-all

` - Sells all items in a player's (or multiple players) bag > * `/bags help` - Shows this message ## Permissions > * `betterbags.usage` - Permission to use the `/bags` command > * `betterbags.reload` - Permission to the `/bags reload` command > * `betterbags.save` - Permission to the `/bags save` command > * `betterbags.clear` - Permission to the `/bags clear` command > * `betterbags.setlevel` - Permission to the `/bags level` command > * `betterbags.give` - Permission to the `/bags give` command > * `betterbags.multiplier` - Permission to the `/bags multiplier` command > * `betterbags.multiplier.` - Adds a `` multiplier for the player > * `betterbags.open` - Permission to the `/bags open` command > * `betterbags.sell-all` - Permission to the `/bags sell-all` command ## Placeholders > > * `%uuid%` - player's uuid > * `%player%` - player's name > * `%items-sum%` - sum of items in the bag > * `%current-level%` - current bag level > * `%current-capacity%` - current bag capacity > * `%current-slots%` - current bag slots > * `%current-cost%` - current bag cost > * `%next-level%` - next bag level > * `%next-capacity%` - next bag capacity > * `%next-slots%` - next bag slots > * `%next-cost%` - next bag cost ### English config files:

Configs

config.yml

``` # Should the bag automatically pick up all items that the player raises? auto-picking: true # boolean # If auto-picking is enabled, should the bag only pick up the items specified in items.yml? pickup-only-sellable: false # boolean # Do players have the ability to manually place items in the bag? player-put-ability: true # boolean # Do players have the ability to take items out of the bag? player-get-ability: true # boolean # Do players have the ability to move the bag in the inventory? # * false = ability to open the bag by clicking on it in the inventory bag-move-ability: false # boolean # Default slot for the bag (If the player cannot move it, it will stay in this position all the time) bag-slot: 4 # 0-8 - slots in the hotbar / # 9-35 - slots in the inventory # Will the bags have a button to sell all items? sell-all: true # boolean # Interval between data saves (in seconds) save-interval: 600 # integer / -1 to disable # Interval between checking for the bag presence for players (in seconds) update-interval: -1 # integer / -1 to disable # Should the bag be given after the player's respawn (death)? should-give-bag-on-respawn: true # boolean # Should the bag be given after the player joins the server? should-give-bag-on-join: true # boolean # Inventory label of the bag bag-inventory-label: "Player's bag %player% - Level %current-level%" ```

bags.yml

``` items: bag: name: "Bag %current-level% level." # item name description: # item description - "Items in the bag: %items-sum%" - "Capacity: %current-capacity% items." - "Number of slots: %current-slots%" material: PLAYER_HEAD # bag item/icon # If the material is a head, you can set a texture for it (base64): head-texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNjkxYzdiZDA0MTZmNjhkNmU5YjU4NmU3ODE4Mjg2M2E0ZmQwNGY5MDI5YzgwNWY5MjFhMTdjNzAzZDUyZWRlMSJ9fX0=" # If the item has a custom texture (custom model data) custom-model-data: 0 upgrade: name: "Upgrade from %current-level% to %next-level% level." description: - "The next level includes:" - "Capacity: %current-capacity% >> %next-capacity% items" - "Number of slots: %current-slots% >> %next-slots%" - "" - "Upgrade cost: %next-cost%$" material: MOSS_BLOCK # head-texture and custom-model-data are optional parameters sell-all: name: "Sell all items" material: BARRIER glowing: true # can set a glowing effect to the item # description is also optional next-page: name: "Next page" material: PLAYER_HEAD head-texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYWM5YzY3YTlmMTY4NWNkMWRhNDNlODQxZmU3ZWJiMTdmNmFmNmVhMTJhN2UxZjI3MjJmNWU3ZjA4OThkYjlmMyJ9fX0=" previous-page: name: "Previous page" material: PLAYER_HEAD head-texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMWExZWYzOThhMTdmMWFmNzQ3NzAxNDUxN2Y3ZjE0MWQ4ODZkZjQxYTMyYzczOGNjOGE4M2ZiNTAyOTdiZDkyMSJ9fX0=" ignore-item-value-true: name: "Sell everything without exceptions" material: RED_CANDLE description: - "All items will be sold regardless of their value" glowing: true ignore-item-value-false: name: "Sell everything with exceptions" material: GREEN_CANDLE description: - "When selling, items without value will be ignored" filler: name: "" material: RED_STAINED_GLASS_PANE levels: 1: # level (1 - by default) capacity: 20 # bag capacity AKA maximum number of items slots: 5 # available storage slots cost: 0 # cost to upgrade to this level 2: capacity: 40 slots: 8 cost: 1000 commands: # commands after purchasing the upgrade - "xp add %player% 10 levels" 3: capacity: 60 slots: 16 cost: 5000 # ... ```

messages.yml

``` no-economy-plugin-found: "Economy plugin not found. Disabling..." bag-clear-result: single: "The bag of player %target% has been successfully cleared." multiple: "The bags for %target% players have been successfully cleared." bag-level-result: single: "The bag of player %target% has been successfully set to %level% level." multiple: "The bags for %target% players have been successfully set to %level% level." give-bag-result: single: "The bag has been successfully given to player %target%." multiple: "The bags have been successfully given to %target% players." config-reloaded: "Configurations have been successfully reloaded." data-saved: "Data has been successfully saved." multiplier-set-result: single: "The sales multiplier for player %target% has been successfully set to %multiplier%." multiple: "The sales multipliers for %target% players have been successfully set to %multiplier%." sell-all: something: "%amount% items have been sold for %cost%$" nothing: "Nothing was sold." sell-all-command-result: single: "%amount% items from %target% have been sold for %cost%$" multiple: "%amount% items from %target% players have been sold for %cost%$" help-message: - "Commands:" - "/bags reload - Reload configuration" - "/bags save - Save player data" - "/bags clear - Clear players' bags" - "/bags level - Set bag levels for players" - "/bags give - Give bags to players" - "/bags sell-all

- Sell all items of players" - "/bags multiplier - Set sales multiplier for players" - "/bags open - Open the bag of the specified player" - "/bags help - Show help" bag-upgrade: success: "Bag successfully upgraded from %old% to %new% level for %cost%$." fail: "Not enough money to upgrade the bag to %new% level. Requires %cost%$" ```

items.yml

``` # list of items costs items: DIRT: 1 # sells for 1 COBBLESTONE: 25 DIAMOND_SWORD: 500 SAND: 1 # ... ```

# РУССКИЙ BetterBags — это плагин, который позволяет игрокам иметь сумку с такими функциями, как автоматический сбор предметов, улучшаемые уровни, настраиваемые ограниченные действия, поддержка MiniMessage, сохранение данных игроков, полностью настраиваемые предметы и сообщения и многое другое. ## Особенности > * Автоматический сбор предметов; возможность или невозможность подбирать только продаваемые предметы > * Улучшаемые уровни для сумки > * Возможность ограничивать действия игроков (отключение/включение возможности манипулировать предметами из сумки) > * Данные игрока в файлах `data/.yml` > * Полностью настраиваемые предметы, сообщения, уровни, продаваемые предметы > * Предметы в сумке можно продавать нажатием одной кнопки > * Включает множитель продажи, который можно установить с помощью разрешения (`betterbags.multiplier.`) или команды (`/bags multiplier`) > * Полная поддержка MiniMessage ## Команды > * `/bags reload` - Перезагружает конфигурацию плагина > * `/bags save` - Сохраняет данные игрока > * `/bags clear ` - Очищает сумку игрока (или нескольких игроков) > * `/bags level ` - Устанавливает уровень сумки игрока (или нескольких игроков) > * `/bags give ` - Выдает игроку (или нескольким игрокам) сумку > * `/bags multiplier ` - Устанавливает множитель сумки игрока (или нескольких игроков) > * `/bags open ` - Открывает сумку игрока (или нескольких игроков) > * `/bags sell-all

` - Продает все предметы в сумке игрока (или нескольких игроков) > * `/bags help` - Показывает это сообщение ## Разрешения > * `betterbags.usage` - Разрешение на использование команды `/bags` > * `betterbags.reload` - Разрешение на команду `/bags reload` > * `betterbags.save` - Разрешение на команду `/bags save` > * `betterbags.clear` - Разрешение на команду `/bags clear` > * `betterbags.setlevel` - Разрешение на команду `/bags level` > * `betterbags.give` - Разрешение на команду `/bags give` > * `betterbags.multiplier` - Разрешение на команду `/bags multiplier` > * `betterbags.multiplier.` - Добавляет множитель `` для игрока > * `betterbags.open` - Разрешение на команду `/bags open` > * `betterbags.sell-all` - Разрешение на команду `/bags sell-all` ## Плейсхолдеры > * `%uuid%` - uuid игрока > * `%player%` - имя игрока > * `%items-sum%` - сумма предметов в сумке > * `%current-level%` - текущий уровень сумки > * `%current-capacity%` - текущая вместимость сумки > * `%current-slots%` - текущие слоты сумки > * `%current-cost%` - текущая стоимость сумки > * `%next-level%` - следующий уровень сумки > * `%next-capacity%` - следующая вместимость сумки > * `%next-slots%` - следующие слоты сумки > * `%next-cost%` - следующая стоимость сумки P.S. Конфиг изначально на Русском Языке)

sonofstrange