VaultEconomy
# VaultEconomy
**VaultEconomy** — это многофункциональный серверный плагин для Minecraft, объединяющий в себе экономику, аукцион, телепортацию, чат-модерацию, PvP-контроль, утилиты и административные инструменты в одном решении.
Плагин предназначен для **Survival / Economy / RPG серверов**, где важны стабильность, гибкая настройка и минимальное количество зависимостей.
—
## 📌 Основная информация
– **Название:** VaultEconomy
– **Версия:** 1.0.4 в даной версии обнавили сохранения валют (ранше был баг)
– **Статус:** Beta (стабильное ядро)
– **Платформы:** Bukkit, Spigot, Paper
– **Minecraft:** 1.13+
– **Зависимости:** Vault
– **Интеграция:** Vault Economy API
—
## 🎯 Назначение плагина
VaultEconomy создан как **единый центр управления сервером**, который заменяет десятки отдельных плагинов:
– экономика и кастомные валюты
– аукцион с GUI
– дома, варпы и спавн
– PvP-контроль
– чат и префиксы
– фильтр чата
– утилиты
– модерация и админ-команды
Один JAR-файл — одна система.
—
# 💰 Экономика
## Основная валюта
– Полная поддержка Vault
– Встроенная серверная валюта
– Совместимость с другими плагинами
– Сохранение данных
### Команды
– `/bits`, `/bal`, `/money` — баланс
– `/baltop` — топ по деньгам
—
## 🪙 Кастомные валюты (Points)
VaultEconomy поддерживает **неограниченное количество кастомных валют**.
### Возможности
– Создание валют
– Выдача и изъятие
– Хранение данных
– Не зависит от основной экономики
### Команды
– `/point create <название>`
– `/point give <валюта> <игрок> <количество>`
– `/point take <валюта> <игрок> <количество>`
– `/point remove <валюта>`
—
# 🏷 Аукцион (Auction System)
Полностью серверный GUI-аукцион.
### Возможности
– Продажа предметов через GUI
– Категории товаров
– Ограничение слотов
– Комиссия сервера
– Блокировка в PvP
– Возврат истёкших лотов
– Глобальные уведомления
### Категории
– Все товары
– Оружие
– Инструменты
– Ресурсы
– Мои товары
### Команды
– `/ah` — открыть аукцион
– `/ahelp` — помощь
### Слоты
Количество активных лотов зависит от прав:
# VaultEconomy
**VaultEconomy** — это многофункциональный серверный плагин для Minecraft, объединяющий в себе экономику, аукцион, телепортацию, чат-модерацию, PvP-контроль, утилиты и административные инструменты в одном решении.
Плагин предназначен для **Survival / Economy / RPG серверов**, где важны стабильность, гибкая настройка и минимальное количество зависимостей.
—
## 📌 Основная информация
– **Название:** VaultEconomy
– **Версия:** 1.1.2
– **Статус:** Beta (стабильное ядро)
– **Платформы:** Bukkit, Spigot, Paper
– **Minecraft:** 1.13+
– **Зависимости:** Vault
– **Интеграция:** Vault Economy API
—
## 🎯 Назначение плагина
VaultEconomy создан как **единый центр управления сервером**, который заменяет десятки отдельных плагинов:
– экономика и кастомные валюты
– аукцион с GUI
– дома, варпы и спавн
– PvP-контроль
– чат и префиксы
– фильтр чата
– утилиты
– модерация и админ-команды
Один JAR-файл — одна система.
—
# 💰 Экономика
## Основная валюта
– Полная поддержка Vault
– Встроенная серверная валюта
– Совместимость с другими плагинами
– Сохранение данных
### Команды
– `/bits`, `/bal`, `/money` — баланс
– `/baltop` — топ по деньгам
—
## 🪙 Кастомные валюты (Points)
VaultEconomy поддерживает **неограниченное количество кастомных валют**.
### Возможности
– Создание валют
– Выдача и изъятие
– Хранение данных
– Не зависит от основной экономики
### Команды
– `/point create <название>`
– `/point give <валюта> <игрок> <количество>`
– `/point take <валюта> <игрок> <количество>`
– `/point remove <валюта>`
—
# 🏷 Аукцион (Auction System)
Полностью серверный GUI-аукцион.
### Возможности
– Продажа предметов через GUI
– Категории товаров
– Ограничение слотов
– Комиссия сервера
– Блокировка в PvP
– Возврат истёкших лотов
– Глобальные уведомления
### Категории
– Все товары
– Оружие
– Инструменты
– Ресурсы
– Мои товары
### Команды
– `/ah` — открыть аукцион
– `/ahelp` — помощь
### Слоты
Количество активных лотов зависит от прав:
-auction.slot.group.1
-auction.slot.group.5
-auction.slot.group.10
-auction.slot.group.100
—
# 🏠 Телепортация и локации
## Дома
– `/sethome`
– `/home`
– `/delhome`
– `/homelist`
Количество домов определяется правами.
—
## Варпы
– `/setwarp`
– `/warp`
– `/delwarp`
– `/warplist`
—
## Спавн
– `/setspawn`
– `/spawn`
—
## Телепортация игроков
– `/tp`
– `/tpa`
– `/tpahere`
– `/tpaaccept`
– `/tpadeny`
—
# 🧰 Виртуальные утилиты
– `/craft` — виртуальный верстак
– `/anvil` — виртуальная наковальня
– `/ec` — эндер-сундук
– `/repair` — починка предметов
Все утилиты:
– не ломают ванильную механику
– управляются правами
– не нагружают сервер
—
# 🧪 Кастомные зелья
## Potion of Strength III
**Крафт (3×3):**

—
### Ограничения
– Не выпадает с мобов
– Не продаётся
– Не варится
—
# 💬 Чат и модерация
## Префиксы
– `/prefix set <текст>`
– `/prefix reset`
## Игнор
– `/ignore <игрок>`
## Очистка чата
– `/clearchat`
—
## Фильтр чата
### Возможности
– Проверка сообщений
– Предупреждения
– Автоматический мут
– Bypass-права
### Команды
– `/filter add <слово>`
– `/filter remove <слово>`
– `/filter list`
– `/filter toggle`
—
## Система клана!

—
# ⚔ PvP-контроль
– Отслеживание PvP-статуса
– Блокировка команд в бою
– Защита от abuse
—
# 🛡 Модерация и админка
### Команды
– `/fly`
– `/god`
– `/gamemode`
– `/heal`
– `/feed`
– `/sp`
– `/ve reload`
### `/ve reload`
Выполняет полный reload:
– config.yml
– pvp.yml
– auction-messages.yml
– economy
– points
– prefix system
Без перезапуска сервера.
—
# 🔐 Права
Плагин полностью совместим с **LuckPerms**.
### Основные группы
– `vaulteconomy.user`
– `vaulteconomy.moderator`
– `vaulteconomy.admin`
—
# ⚙ Конфигурация
Файлы:
– `config.yml`
– `pvp.yml`
– `filter.yml`
– `auction-messages.yml`
Большинство изменений применяется без рестарта.
# 🔐 Permissions — VaultEconomy
VaultEconomy использует **гибкую систему прав (permissions)**,
которая позволяет точно контролировать доступ игроков, модераторов
и администраторов ко всем функциям плагина.
Плагин полностью совместим с **LuckPerms**, **PermissionsEx** и аналогами.
—
## 👤 Player Permissions (Игрок)
### `vaulteconomy.user`
**Базовое право обычного игрока**
📌 Обычно выдаётся всем игрокам по умолчанию
📌 Включает основные команды выживания
Включает:
– телепорты
– дома
– варпы
– экономику
– аукцион
– базовые утилиты
—
### 💰 Экономика
#### `vaulteconomy.balance`
Позволяет смотреть баланс:
– `/bits`
– `/bal`
– `/money`
—
#### `vaulteconomy.baltop`
Позволяет смотреть топ игроков по деньгам:
– `/baltop`
—
### 🪙 Кастомные валюты (Points)
#### `vaulteconomy.point.use`
Позволяет:
– смотреть список валют
– передавать валюту другим игрокам
Команда:
– `/point`
—
## 🏠 Дома, варпы, спавн
#### `vaulteconomy.spawn`
Телепорт на серверный спавн:
– `/spawn`
—
#### `vaulteconomy.spawn.set`
Установка спавна сервера:
– `/setspawn`
(обычно только для админов)
—
#### `vaulteconomy.home`
Телепорт домой:
– `/home`
—
#### `vaulteconomy.sethome`
Установка дома:
– `/sethome`
—
#### `vaulteconomy.delhome`
Удаление дома:
– `/delhome`
—
#### `vaulteconomy.homelist`
Список всех домов игрока:
– `/homelist`
—
#### `vaulteconomy.warp`
Телепорт на публичные варпы:
– `/warp`
—
#### `vaulteconomy.warplist`
Просмотр списка варпов:
– `/warplist`
—
#### `vaulteconomy.setwarp`
Создание варпа:
– `/setwarp`
—
#### `vaulteconomy.delwarp`
Удаление варпа:
– `/delwarp`
—
#### `vaulteconomy.back`
Возврат на предыдущую точку:
– `/back`
(после смерти или телепорта)
—
## 🌍 Телепортация между игроками
#### `vaulteconomy.tp`
Мгновенный телепорт:
– `/tp`
(обычно для админов)
—
#### `vaulteconomy.tpa`
Отправка запроса на телепорт:
– `/tpa`
—
#### `vaulteconomy.tpahere`
Запрос телепорта игрока к себе:
– `/tpahere`
—
#### `vaulteconomy.tpaaccept`
Принять запрос телепорта:
– `/tpaaccept`
—
#### `vaulteconomy.tpadeny`
Отклонить запрос телепорта:
– `/tpadeny`
—
## 🧰 Утилиты
#### `vaulteconomy.craft`
Виртуальный верстак:
– `/craft`
—
#### `vaulteconomy.anvil`
Виртуальная наковальня:
– `/anvil`
—
#### `vaulteconomy.enderchest`
Открытие эндер-сундука:
– `/ec`
—
#### `vaulteconomy.repair`
Починка предмета в руке:
– `/repair`
—
## 🗨️ Чат и общение
#### `vaulteconomy.clearchat`
Очистка чата:
– `/clearchat`
—
#### `vaulteconomy.ignore`
Игнор сообщений игрока:
– `/ignore`
—
## 🛡️ Чат-фильтр (Модерация)
#### `vaulteconomy.filter.admin`
Полный доступ к фильтру чата:
– `/filter add`
– `/filter remove`
– `/filter list`
– `/filter toggle`
—
#### `vaulteconomy.filter.bypass`
Игрок **не проверяется фильтром**
(сообщения не блокируются)
—
## ⚔️ PvP
#### `vaulteconomy.pvp.command.bypass`
Позволяет использовать команды во время PvP
—
#### `vaulteconomy.pvp.bypass`
Полный bypass PvP-ограничений
—
## ❤️ Модерация
#### `vaulteconomy.heal`
Полное лечение:
– `/heal`
—
#### `vaulteconomy.feed`
Восстановление голода:
– `/feed`
—
#### `vaulteconomy.spawnmob`
Спавн мобов:
– `/sp`
—
## 👑 Админские команды
#### `vaulteconomy.fly`
Режим полёта:
– `/fly`
—
#### `vaulteconomy.god`
Бессмертие:
– `/god`
—
#### `vaulteconomy.gamemode`
Смена режима игры:
– `/gamemode`
– `/gm`
—
#### `vaulteconomy.prefix`
Управление префиксом:
– `/prefix`
—
#### `vaulteconomy.reload`
Полный перезапуск плагина:
– `/ve reload`
—
#### `vaulteconomy.admin`
🔥 **Полный доступ ко всем функциям VaultEconomy**
Обычно выдаётся:
– администраторам
– владельцу сервера
—
## 🛒 Аукцион
#### `vaulteconomy.auction`
Доступ к аукциону:
– `/ah`
—
#### `vaulteconomy.auction.sell`
Право выставлять предметы на аукцион
—
#### `auction.slot.group.<число>`
Количество слотов на аукционе
Примеры:
– `auction.slot.group.1` → 1 слот
– `auction.slot.group.5` → 5 слотов
– `auction.slot.group.100` → 100 слотов
—
## 🧪 Кастомные зелья
❗ **НЕ ТРЕБУЮТ permissions**
– Зелье Силы III — через крафт
– Зелье Силы IV — через наковальню
– Защита от дюпа встроена
– Подделка через /give невозможна
—
## ✅ Рекомендуемая настройка (LuckPerms)
“`bash
/lp group default permission set vaulteconomy.user true
/lp group default permission set vaulteconomy.auction true
/lp group vip permission set auction.slot.group.5 true
/lp group moderator permission set vaulteconomy.moderator true
/lp group admin permission set vaulteconomy.admin true
—
# 🚀 Производительность
– Без NMS
– Минимальная нагрузка
– Совместим с Paper
– Подходит для больших серверов
—
# 🔗 Ссылки
– GitHub: https://github.com/Pritfort340/VaultEconomy
– Discord: https://discord.gg/kDyVhPGfU
– Telegram: https://t.me/pdQQdYmjE45MjBk
Variants-CIT
# Variants-CIT
An alternative CIT format designed to handle large amounts of variants.
This mod excels in scenarios where one item has many variants all based on the same pieces of data. It yields better performances when extreme amounts of CITs are available, and uses a resource format that is less redundant, requiring only one short file to configure all possible variants of an item at once.
Assigning models on a case-by-case basis (similar to how Optifine-CIT handles it) is still possible, but does not boast the same performances.
## Resource Pack Format
This is a quick showcase. Refer to **The Wiki** for a complete guide.
The format revolves around item variants being automatically associated to models or textures with matching names.
Instead of defining separate conditions for every variants, you define a single rule that governs all variants in a collection, (so-called **modules**). This module defines what item is affected, how to figure out its variants, and where the variant models are located.
### Fully automatic variants-to-model association
Here’s a simple module that would change the texture of enchanted books :
“`jsonc
{
“items”: “enchanted_book”, // The affected item type(s)
“modelPrefix”: “book_cit/”, // The folder containing the possible models/textures.
“assetGen”: “item_model/generated”, // Auto-generate models from textures (if missing)
“type”: “stored_entchantment”, // How to compute the item’s “variant ID”
“parameters”: { // Extra options specific to the module’s type
“levelSeparator”: “_lvl_” // Include enchantment level in the variant ID
}
}
“`
Here, a book with the enchantment `minecraft:unbreaking` at level 2 will have the variant ID `minecraft:unbreaking_lvl_2`, and thus use the texture stored at `/assets/minecraft/textures/item/book_cit/unbreaking_lvl_2.png`.
This single module will work for every possible enchantment, vanilla or modded, so long as a corresponding texture exists.
### Automatic variants based on custom data
The module above has a purpose-made type for enchanted books. If no type exists for a specific use-case, you can still use more generic modules to get a variant from any component:
“`jsonc
{
“items”: “minecraft:suspicious_stew”,
“modelPrefix”: “item/suspicious_stew_cit/”,
“assetGen”: “item_model/generated”,
“type”: “component_data”,
“parameters”: {
“componentType”: “suspicious_stew_effects”, // The component containing the variant ID
“nbtPath”: “[0].id” // The location of the variant ID in the component.
}
}
“`
#### Processing data that can’t be used as-is:
“`jsonc
{
“items”: “diamond_sword”,
“modelPrefix”: “item/named_swords/”,
“assetGen”: “item_model/handheld”,
“type”: “component_data”,
“parameters”:
{
“componentType”: “custom_name”,
“transform”: [
{
“function”: “regex”,
// Pattern matching,..
“regex”: “(?i)(.*’s )?(Great |Grand )?(?.*(sword|dagger))( of doom)?”,
// … and preserve only a portion of the name.
“substitution”: “$var”
// (E.g: “steev18’s great Steel Sword” => “Steel Sword”)
}
{
// Turns any text into a valid identifier
“function”: “sanitize”
// (E.g: “Steel Sword” => “minecraft:steel_sword”)
}
]
}
}
“`
#### Combining multiple pieces of data from different sources:
“`jsonc
{
“items”: “minecraft:diamond_sword”,
“modelPrefix”: “item/trimmed_diamond_sword/”,
“assetGen”: “item_model/handheld”,
“type”: “component_format”,
“parameters”:
{
// How to combine various pieces of data into a variant ID
// (E.g: sentry_diamond)
“format”: “${pattern}_${material}”,
// Where to find those pieces of data.
“variables”: {
“pattern”: {
“componentType”: “trim”,
“nbtPath”: “.pattern”
},
“material”: {
“componentType”: “trim”,
“nbtPath”: “.material”,
“transform”: “discard_namespace”
}
}
}
}
“`
### Case-by-case variants
For systems that don’t really follow any rules, (or if you have too few variants to care about automatism), you can use a format closer to Optifine-CIT’s paradigms:
“`jsonc
{
“items”: “trident”,
“modelPrefix”: “item/godly_tridents/”,
“assetGen”: “item_model/trident”,
“type”: “predicates”,
“parameters”: {
“predicates”:
[
{
“variantId”: “zeus_smite”,
“precondition”: {
“enchantments.channeling”: { “greater_or_equals”: 1 }
}
},
{
“variantId”: “jupiter_syphon”,
“precondition”: {
“enchantments.riptide”: { “greater_or_equals”: 1 }
}
}
// etc
]
}
}
“`