VeinMiner

[![dono-badge](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/donate/kofi-singular_vector.svg)](https://ko-fi.com/miraculixx/donate)
[![enchant-badge](https://cdn.modrinth.com/data/cached_images/ea836ed1714c4f065aca5466c99c9e7d8f5baeff.png)](https://modrinth.com/project/veinminer-enchantment)
[![client-badge](https://cdn.modrinth.com/data/cached_images/9badc43c5a3708f90d24088df4f37c03acc943b8.png)](https://modrinth.com/project/veinminer-client)

## ⛏️ Veinminer
Mine a single block to mine the whole vein!
Highly configurable and works everywhere, even on your vanilla server.
Make the tedious mining experience to something satisfying and fun!
Veinminer works server side, so all clients are supported. Even cross loaders & versions for addons!

> ### Client Hotkey & Highlighting
> Add the [**Hotkey Addon**](https://modrinth.com/datapack/veinminer-client) to only veinmine when pressing a hotkey & get a mining preview
> ### Use as Enchantment?
> Add the [**Veinminer Enchantment Addon**](https://modrinth.com/datapack/veinminer-enchantment) to limit veinmining to only enchanted tools!

## ⚙️ Customization & Settings
![](https://i.postimg.cc/ZR85KZJM/output.webp)

**Veinminer comes in two different versions**
• **Version 2.x** -> Full customizable mod & plugin
• **Version 1.x** -> Light DataPack with vanilla & snapshot support
Both comes with preconfigured for ores and pickaxes. Read below how to extend it.


### Mod/Plugin Version (2.x)
The advanced (V2) version is a more powerful version that is only usable with Fabric/Quilt, Paper/PurPur/Folia & NeoForge servers.

| Command | Permission | Short Description |
|:———————–:|:——————–:|:———————————————————:|
| /veinminer **blocks** | `veinminer.blocks` | Edit blocks that are veinmineable with every tool |
| /veinminer **groups** | `veinminer.groups` | Edit blocks & tools with precise rules |
| /veinminer **toggle** | `veinminer.toggle` | Toggle Veinminer (server wide) |
| /veinminer **settings** | `veinminer.settings` | Change settings like cooldown, max chain and more |
| *Using Veinminer* | `veinminer.use` | If perm-restriction is active, this is needed to veinmine |

General Settings

To change a setting, enter `/veinminer settings … []`.
To check the current state, leave out the new value argument.

| Setting | Description | Default |
|:———————-:|:———————————————————:|:——-:|
| `mustSneak` | Players must sneak to veinmine | `false` |
| `cooldown` | Time between players are able to veinmine (in ticks) | `20` |
| `delay` | Time between each automated block breaking (in ticks) | `1` |
| `maxChain` | Max amount of blocks that can break from one source block | `100` |
| `needCorrectTool` | If blocks have a required tool, this must be used | `true` |
| `searchRadius` | Amount of blocks in between blocks to count connected | `1` |
| `permissionRestricted` | Only players with `veinminer.use` permission can veinmine | `false` |
| `mergeItemDrops` | All item drops are merged to the source block | `false` |
| `autoUpdate` | Check for updates and download new version if available | `true` |
| `durabilityDecrease` | If each mined block should reduce durability | `true` |
| `miningSpeedModifier` | Increase block mining duration based on vein size | `0.0` |

Block Groups – Advanced Settings

Block groups can hold multiple blocks together that will be treated like the same block.
`/veinminer groups create [] []`

All blocks inside one group will be mined together.
A block can be in multiple groups. New blocks can be added or removed from groups with the following commands:
`/veinminer groups edit add-block `
`/veinminer groups edit remove-block `

Groups can be limited to certain tools, for example group `wood` can only be mined by axes.
If no tool is added to a group, all tools are allowed. If a block is in multiple groups, all tools from those groups are allowed.
(If a block is in one unlimited tool group and one limited to axes, only axes work for this block)
`/veinminer groups edit add-tool `
`/veinminer groups edit remove-tool `

### Example (Logs)
“`
1. /veinminer groups create Logs
2. /veinminer groups edit Logs add-block #minecraft:logs
3. /veinminer groups edit Logs add-tool #minecraft:axes
“`

Block and item inputs allow block and item tags for easier editing.
For example, to add all logs enter `#minecraft:logs` into any block input.
Visit the wiki for a full list or look at a block with F3 under “looking at”.

You can also modify the group file directly inside `…/veinminer/default_groups.json` (`config/…` for mods, `plugins/…` for plugins)

Setting Overrides – Too Advanced Settings

Overrides are optional settings, that will override the normal setting if the player is effected by it.
See examples underneath for a better understanding, I don’t blame you if you think “why…”.

### Client Overrides
Those settings will be applied to all users that use the client addon (hotkey).
E.g. you want to have `mustSneak` enabled in general, but disabled for hotkey users:
– `/veinminer settings mustSneak true` – True for all
– `/veinminer settings client override mustSneak false` – False override for hotkey users

### Group Overrides
Those settings will be applied to all users that mine a block from this specific group.
Each group can have a different override, if a block is in multiple groups, only the override from the *oldest* group count (this behavior may see improvement later).
E.g. you dont want that your sand & dirt group consumes durability:
– `/veinminer settings decreaseDurability true` – True for all blocks
– `/veinminer groups shovel edit override decreaseDurability false` – False override for this group

If both, client and group overrides, collide the group override takes priority (`normal < client < group`). You can remove overrides with `/veinminer ... override unset `.

OP players will have all permissions. To manually grant permissions see [Luckperms](https://luckperms.net/) (NeoForge not supported yet).


### DataPack Version (1.x)
The DataPack (V1) version is a simple version that is usable on every server and world.
Enter the config command to open an interactive chat menu to edit all settings.

| Command | Permission | Description |
|:—————————:|:———–:|:————————————-:|
| /function veinminer:_config | `OP/Cheats` | Access the full settings menu in chat |

If you get prompted something like `{category:”pickaxe”, namespace:””, id:””}`, you need to fill in the item/block namespace & ID (press F3+H to see them), e.g. `{category:”pickaxe”, namespace:”minecraft”, id:”sand”}` for `minecraft:sand`

## Some Advice
– To veinmine, your tool must be able to mine the block in normal conditions (unless disabled in V2)
– While Veinminer is running very lightweight, mining unnatural big veins can lag the client and the server through the amount of items

If you need any help or want to share some ideas to add, just hop on our Discord ([dc.mutils.net](https://dc.mutils.net))

VectorGuard

# VectorGuard

**Production-grade combat anti-cheat for Paper servers.**

VectorGuard is a 100% server-side anti-cheat plugin focused exclusively on **combat detection**. It uses packet-level analysis, tick-based telemetry, and multi-signal detection to identify cheaters with high accuracy and minimal false positives.

Built from the ground up for modern Paper servers (1.20.x–1.21.x) with Java 21.

## Product Overview

VectorGuard is a combat-only anti-cheat designed to catch the most common PvP exploits while staying light on performance and fair on legitimate players. Every check uses multiple independent signals (rotation, timing, movement, cooldown usage, and hit validation) and applies buffered violations with decay, so one-off spikes do not punish normal players. Ping-aware thresholds and packet-timing compensation reduce false positives for high-latency players.

Administrators get a fast response workflow: clickable in-game alerts with action buttons, a threat score that aggregates risk across checks, and a visual report command for quick evidence review. A built-in GUI lets staff adjust thresholds, toggle checks, and tune punishments without editing files or restarting the server. Alerts can also be mirrored to Discord for off-server monitoring.

VectorGuard ships as a single jar with no external dependencies. PacketEvents is embedded, and the plugin runs entirely server-side with no client mod required.

## Features

### Detection Engine
– **19 combat checks** targeting the most common cheat modules including Mace PvP exploits, crystal PvP automation, bow manipulation, and inventory exploits
– **Multi-signal compound detection** — each check combines multiple independent signals for high confidence
– **Buffered violation system** with configurable decay — prevents single-tick flukes from triggering punishments
– **Latency compensation** — all checks account for player ping to avoid false-flagging high-ping players
– **Tick-based analytics** with per-player position history and rotation profiling

### Admin Experience
– **Clickable chat alerts** with action buttons: `[TP]` `[VL]` `[DBG]` `[RPT]`
– **Threat score system** — composite 0–100% risk assessment across all checks
– **Visual threat reports** via `/vg report `
– **Sound alerts** for online admins (configurable)
– **Discord webhook integration** for off-server monitoring
– **In-game GUI** for editing thresholds, toggling checks, and tuning punishments

### Architecture
– **100% server-side** — no client mod required
– **PacketEvents** embedded and shaded — zero external dependencies
– **Modular check system** — each check is independent and fully configurable
– **Performance profiler** built-in (`/vg profile`)
– **Multi-version support** — Paper 1.20.x through 1.21.x

## Checks

### Combat

| Check | Description |
|——-|————-|
| **Aimbot** | Detects snap rotations, acceleration spikes, over-smooth curves, and precision patterns consistent with aim assistance |
| **TriggerBot** | Identifies automated attack timing with near-zero reaction delay after crosshair alignment |
| **AutoTotem** | Catches unrealistically fast offhand totem swaps during lethal damage windows |
| **Reach** | Eye-to-hitbox distance verification with ping, sprint, and movement leniency |
| **Velocity** | Detects Anti-Knockback by verifying displacement after server-sent velocity packets |
| **Criticals** | Identifies fake critical hits via spoofed position packets (abnormal crit rate, ground-flag oscillation, tiny Y offsets) |
| **AutoClicker** | Catches robotic click patterns through timing variance analysis (stddev, CPS, coefficient of variation) |
| **KillAura** | Detects multi-target attacks, angle mismatch, wall attacks, and perfect cooldown abuse |
| **Sprint** | Identifies backwards sprinting, KeepSprint, and sprint-toggle patterns around attacks |
| **MaceSpoof** | Detects spoofed fall-distance position packets for fake Mace smash damage (Criticals-Mace exploit) |
| **MaceNoFall** | Catches NoFall + Mace combos: players deal Mace fall-bonus damage but evade fall damage on landing |
| **MaceSwap** | Identifies automated weapon switching to Mace during falls (AttributeSwap / auto-swap patterns) |
| **CrystalAura** | Detects automated crystal place-and-break cycles (superhuman crystal attacks/sec, place→break pairing, fast-break ratio) |
| **BowManipulation** | Catches BowSpam and BowAimbot via charge variance analysis, fire rate, and abnormal hit rates at distance |
| **InventoryCleaner** | Identifies inhuman inventory manipulation speed (AutoTotem swaps, chest stealing, combat inventory use) |
| **AutoWeapon** | Detects automated weapon switching around attacks (pre-attack swap ratio, A→B→A swap-back patterns) |
| **HitboxExpand** | Catches expanded entity hitboxes via lateral offset analysis and edge-hit rate tracking |
| **AutoArmor** | Detects automated armor equipping during combat (rapid armor clicks, anti-break durability swaps) |

### Packet

| Check | Description |
|——-|————-|
| **Timer** | Detects game speed manipulation via packet rate analysis (burst, sustained, and average rate monitoring) |

## Requirements

– **Java 21+**
– **Paper 1.20.x – 1.21.x** (or forks: Purpur, Pufferfish, etc.)
– No external dependencies — PacketEvents is embedded

## Installation

1. Download `VectorGuard-x.y.z.jar`
2. Place it in your server’s `plugins/` folder
3. Start or restart the server
4. Edit `plugins/VectorGuard/config.yml` to customize thresholds
5. Use `/vg reload` to apply changes without restarting

## Commands

| Command | Description |
|———|————-|
| `/vg reload` | Reload configuration |
| `/vg debug ` | Toggle debug output for a player (or all) |
| `/vg vl ` | View violation levels |
| `/vg report ` | Generate a visual threat report |
| `/vg gui` | Open the in-game config editor |
| `/vg profile [seconds]` | Run performance profiler |

## Permissions

| Permission | Default | Description |
|————|———|————-|
| `vectorguard.admin` | op | Access to all `/vg` commands and GUI |
| `vectorguard.alert` | op | Receive in-game cheat alerts with action buttons |
| `vectorguard.debug.view` | op | View debug output |
| `vectorguard.report` | true | Allows using `/vg report` to generate threat reports |

## Configuration

All settings are in `plugins/VectorGuard/config.yml`.

### Check Configuration
Each check has:
– `enabled` — toggle the check on/off
– `buffer-threshold` — buffer must exceed this to flag
– `buffer-decay-per-tick` — buffer decreases each tick
– `vl-per-breach` — violation level added per flag
– `vl-decay-per-tick` — VL decreases each tick
– `thresholds.*` — check-specific tuning values

### Punishment Stages
“`yaml
punishments:
alert-vl: 2.5 # Send alert to admins
setback-vl: 6.0 # Teleport player to last safe position
punish-vl: 12.0 # Execute punishment command
punish-command: “kick %player% Unfair combat behavior detected by VectorGuard.”
“`

### Discord Webhooks
“`yaml
notifications:
discord:
enabled: true
webhook-url: “https://discord.com/api/webhooks/…”
min-vl: 5.0
cooldown-ms: 10000
“`

### Admin Alerts
“`yaml
notifications:
admin:
sound-enabled: true
clickable-actions: true
show-threat-score: true
“`

## GUI Config Editor

Run `/vg gui` to open an interactive GUI where you can:
– Toggle checks on/off
– Edit buffer thresholds and VL values
– Adjust punishment thresholds and cooldowns
– Save changes to config and reload

## FAQ

**Q: Does this require players to install anything?**
A: No. VectorGuard is 100% server-side.

**Q: Is PacketEvents required as a separate plugin?**
A: No. PacketEvents is embedded inside the VectorGuard jar.

**Q: Does it work with Purpur/Pufferfish/other Paper forks?**
A: Yes, any Paper fork should work.

**Q: Will it conflict with other anti-cheats?**
A: VectorGuard focuses only on combat. It can coexist with movement-focused anti-cheats, but running two combat anti-cheats may cause duplicate flagging.

**Q: How do I reduce false positives?**
A: Increase the `buffer-threshold` and `ping-cutoff-ms` values for checks that are flagging incorrectly. The defaults are tuned conservatively.

## Credits

**Created by Mr. Dev**

## License

Copyright (c) 2025 NeonDev. All Rights Reserved.

This software and its source code are the exclusive property of NeonDev.

No part of this software, including but not limited to the source code, compiled
binaries, documentation, configuration files, or any associated assets, may be
used, copied, modified, merged, published, distributed, sublicensed, sold, or
otherwise exploited for any purpose without the prior written permission of the
copyright holder.

Unauthorized use, reproduction, or distribution of this software, or any portion
of it, is strictly prohibited and may result in civil and criminal penalties.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

VaultUnlocked

# What is Vault Unlocked?
**Note this is a fork of the original Vault, see the Enhanced Functionality section for what this provides over the original Vault**

VaultUnlocked is a versatile API designed to streamline the integration of permissions, chat, and economy systems for plugins. It provides developers with a unified interface, eliminating the need to individually hook or depend on each plugin. This tool was created as a response to the shortcomings of existing APIs like Register and other Permissions systems, which often suffer from either a lack of necessary features or overly complex implementations. VaultUnlocked’s goal is to simplify the process, making it more intuitive for developers to support various systems seamlessly.

With its user-friendly approach, VaultUnlocked offers extensive support for different systems, allowing plugins to operate smoothly within diverse environments. The API’s design prioritizes simplicity and effectiveness, addressing the frustrations developers faced with previous solutions. By providing a cohesive and easy-to-use platform, VaultUnlocked enhances the functionality of plugins, ensuring that they can easily connect with permissions, chat, and economy systems without the need for cumbersome workarounds or dependencies.

If you’re wondering if the plugin you use supports the extended VaultUnlocked functionality, including multiple currencies, look for the VaultUnlocked badge on the plugin page! If you’re a developer and looking to have your project review to get the VaultUnlocked Economy badge, please open a ticket here: [Github Badge Review](https://github.com/TheNewEconomy/VaultUnlockedAPI/issues/new?assignees=creatorfromhell&labels=badge+review&projects=&template=request-badge-review.yml&title=%5BBADGE+REVIEW%5D%3A+).

Badge:

[![Economy Badge](https://raw.githubusercontent.com/TheNewEconomy/VaultUnlockedAPI/refs/heads/master/.badge/economy%20badge.png)](https://github.com/TheNewEconomy/VaultUnlockedAPI)

## Enhanced Functionality(What VaultUnlocked Provides that Vault doesn’t):
VaultUnlocked offers significant improvements over the existing plugin, particularly for those that implement the updated API. It brings a range of enhanced functionalities, making it a more powerful and flexible tool for developers.

### Why VaultUnlocked
Choosing VaultUnlocked over Vault offers a range of benefits that make it a superior choice for plugin developers and server administrators. VaultUnlocked builds upon the foundation of Vault but introduces enhanced features, such as multicurrency support, better compatibility with popular plugins, and the ability to work seamlessly with advanced server frameworks like Folia. Additionally, VaultUnlocked is actively developed, ensuring that it stays up-to-date with the latest advancements and provides more reliable, precise operations, especially in complex economic systems. This combination of modern features and ongoing support makes VaultUnlocked the more robust and future-proof option for managing permissions, chat, and economy systems in your server environment.

### Additional Functionality:

– **Multicurrency Support:** Allows for the management of multiple currencies within the same environment.
– **Active Development:** Ensures continuous improvements and updates to the API.
– **Folia Support:** Provides compatibility with the Folia server framework.
– **Better Compatibility:** Improved integration with plugins like Towny, enhancing overall performance.
– **UUID Support:** Facilitates the use of universally unique identifiers, thanks to contributions from LlmDl.
– **BigDecimal Support:** Enables precise and accurate currency calculations, also contributed by LlmDl.

### Multicurrency Support

VaultUnlocked introduces multicurrency support, allowing servers to manage and operate with multiple currencies simultaneously. This functionality is particularly useful in complex economic systems where different regions or factions might use different types of currency. By providing a seamless way to handle various currencies, VaultUnlocked ensures that economic transactions are both flexible and accurate, catering to diverse gameplay needs.

### Active Development

One of the key strengths of VaultUnlocked is its ongoing active development. The developers behind VaultUnlocked are committed to continuously improving and updating the API, ensuring it remains compatible with the latest plugins and server frameworks. This active development approach guarantees that users benefit from the latest features, bug fixes, and optimizations, keeping the API relevant and reliable in the ever-evolving landscape of Minecraft plugins.

### Folia Support

VaultUnlocked also provides compatibility with Folia, a server framework known for its enhanced performance and scalability. Folia support means that plugins using VaultUnlocked can fully leverage the advanced capabilities of this framework, resulting in smoother and more efficient server operations. This makes VaultUnlocked an ideal choice for servers that prioritize high performance and stability.

### Better Compatibility

Improved compatibility with popular plugins, such as Towny, is another standout feature of VaultUnlocked. By ensuring better integration with these plugins, VaultUnlocked enhances the overall performance and user experience. This compatibility means fewer conflicts and smoother interactions between different plugins, allowing server administrators to build more cohesive and stable server environments.

### UUID Support

VaultUnlocked includes support for Universally Unique Identifiers (UUIDs), thanks to contributions from LlmDl. UUID support is crucial for modern Minecraft servers, as it ensures that player data remains consistent and accurate, even when players change their usernames. This feature enhances the reliability of player identification across various systems within the server, reducing the risk of errors or data loss.

### BigDecimal Support

VaultUnlocked introduces BigDecimal support, also contributed by LlmDl. This feature allows for precise and accurate currency calculations, which is essential in servers with complex economies. By using BigDecimal, VaultUnlocked can handle large numbers and fractional values with high precision, ensuring that all financial transactions within the server are accurate and reliable.

## **License**
VaultUnlocked is licensed under the LGPLv3 License. You can find more [here](https://www.gnu.org/licenses/lgpl-3.0.en.html).

## Configurations/Permissions

**Config:**

* update-check
* turns the update checker on/off

**Permissions:**

* vault.admin
* Allows access to vault info, and conversion commands
* Defaults to OP

## API/Source

* VaultUnlocked Source: [https://github.com/TheNewEconomy/VaultUnlocked](https://github.com/TheNewEconomy/VaultUnlocked)
* VaultUnlocked API Source: [https://github.com/TheNewEconomy/VaultUnlockedAPI](https://github.com/TheNewEconomy/VaultUnlockedAPI)

## bStats Collection
VaultUnlocked utilizes bStats to collect various metrics similar to the original Vault plugin. These include:

* A unique identifier
* The server’s version of Java
* Whether the server is in offline or online mode
* Plugin’s version
* Server’s version
* OS version/name and architecture
* core count for the CPU
* number of players online
* Metrics version
* Which Chat, Economy, and Permission hook is currently being used

You may opt out of the bStats metrics collection by editing plugins/bstats/config.yml and changing opt-out to true.

**Linking VaultUnlocked**
For information on implementing VaultUnlocked please refer to: [https://github.com/TheNewEconomy/VaultUnlockedAPI](https://github.com/TheNewEconomy/VaultUnlockedAPI)

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):**
![крафт](https://cdn.modrinth.com/data/cached_images/ee5016f6d50f79387c3818503c3466a613f49a38.png)

### Ограничения
– Не выпадает с мобов
– Не продаётся
– Не варится

# 💬 Чат и модерация

## Префиксы
– `/prefix set <текст>`
– `/prefix reset`

## Игнор
– `/ignore <игрок>`

## Очистка чата
– `/clearchat`

## Фильтр чата

### Возможности
– Проверка сообщений
– Предупреждения
– Автоматический мут
– Bypass-права

### Команды
– `/filter add <слово>`
– `/filter remove <слово>`
– `/filter list`
– `/filter toggle`

## Система клана!

![clan system](https://cdn.modrinth.com/data/cached_images/0a3fee00a61e826511a8ba61c283a64b3db5ecfa.png)

# ⚔ 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

VariZoo

This is a very simple yet practical plugin that expands the gameplay of Minecraft.

After the introduction of the “scale” (body size) attribute in Minecraft, I couldn’t wait to create this plugin. After several months of my own testing and expansion, the final product of this plugin is now presented to you.

Having said so much, what exactly does it do?
This plugin introduces body size transformation for all animals. Initially, this body size change is barely noticeable. However, you can breed animals by raising them, enabling the offspring to inherit the body size. After several generations of inheritance, your chickens can become even larger than the Ender Dragon! Yes, this is the real “Chicken Jockey”.

The plugin has been highly optimized and hardly has any negative impact on the server.

Unlike other similar plugins, all values of this plugin can be customized, and it can increase dropped items, mob health, etc. Considered and designed from multiple aspects. Currently, no bugs have been found.

config.yml

“`
# Do not modify this.
version: 3
# enabled the plugin
enabled: true
animal-spawn:
basic:
# The probability of animals being generated with body size attached
# Set to 0 or a negative number to disable. The maximum is 100
apply: 50.0
# Body size change value
# The ‘degree’ can be filled with a range or multiple numbers
degree: 0.86-1.16
# Secondary mutation on the basis
mutant:
# Particle effects produced when triggering mutation
particle:
# Leave blank to disable
type: GLOW
# Particle Quantity
count: 20
# The probability of mutation
# Set to 0 or a negative number to disable. The maximum is 100
apply: 3.0
# MULTIPLY: Simple multiplication
# MORE: Adaptive. Bigger gets even bigger, smaller gets even smaller
mode: MORE
# Change value
# The ‘degree’ can be filled with a range or multiple numbers
degree: 0.77, 1.3
black-list:
# Animals Unaffected
# https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
animal: []
# The Worlds Unaffected
world: []
# The Uninfluenced Spawning Reasons
# https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/CreatureSpawnEvent.SpawnReason.html
spawn-reason:
– SPAWNER
breed:
# Whether animals’ babies inherit the body size when giving birth
inheritance:
# The influence of parents on the body size of children
# Complex formulas can be used. Disable when left blank
# Available variables: {father}, {mother} for the body size of parents, {degree} corresponding to the proportion below
final-scale: ({father} * 1.1 + {mother} * 1.2) / {degree}
# Used in conjunction with the previous ‘final-scale’
degree: 2.1-2.5
# Enabling this option will make the babies not be affected by the secondary body size change of animal-spawn
skip-animal-spawn: false
# The prompt when breeding a baby
# Only supports MiniMessage color format. Disable when left blank
# Available variables: {scale} baby scale, {baby} baby name, {player} player name
actionbar: 新生命诞生啦! 是体型为 {scale} 的{baby}宝宝~
# Multiple Birth
multiple:
# The probability of multiple births
# Prohibited when set to 0 or a negative number. The maximum is 100
# Note that it should not be too high. The determination of multiple births is triggered every time breeding occurs. If it is too high, it will keep giving birth to children and cause the server to lag
apply: 9.0
# The interval between each childbirth
# The unit is ticks, 20 ticks = 1 second
delay: 3
# When enabling multiple births, in order to limit breeding, the following amount of health will be deducted each time breeding occurs
# Complex formulas can be used. Disable when left blank
# Available variables: {health} current health, {max_health} maximum health
hurt: ‘{health} * 0.05’
# Blacklist
# Granting players the varizoo.skip.breed permission can separately turn off the inheritance function to prevent some biological pastures from being destroyed
black-list:
# Animals Unaffected
animal:
– BEE
# The Worlds Unaffected
world: []
other:
# The influence of scale on maximum health. Health points will change proportionally
effect-health: true
# Whether the scale is retained when the animal transforms.
# For example, when a pig is struck by lightning and turns into a Piglin, the scale will still be inherited
transform: true
# Axolotls and fish will lose their original body size when released after being put into buckets
# This function can retain the body size and will correct fish buckets and dispensers
bucket-fish-fix: true
# Multiply the number of dropped items of animals by the following value
# Complex formulas can be used. Disable when left blank
# Available variables: {scale} Creature body size
increase-drops: sqrt({scale})
“`

Note: The plugin makes use of the “scale” attribute of mobs. Just like a mob’s health, attack, and speed, this “scale” attribute is native to the game. You can’t reverse the applied size transformations simply by deleting the plugin.

### If you have any new ideas or suggestions, I’ll do my best to implement them.

VanishV

## VanishV

### ✨ Features
– Vanish mode (on / off)
– Fly enabled while vanished
– Hidden from other players and TAB list
– Silent join & quit while vanished
– Vanish state saved between restarts
– PlaceholderAPI support (soft-depend, no hard dependency)

### 🧩 Commands
– `/vanish on`
– `/vanish off`
– `/vanish status`
– `/vanish reload`

### 🔐 Permissions
– `vanish.use`
– `vanish.see`
– `vanish.reload`

### ⚙️ Technical
– Java 17
– Paper / Spigot / Folia compatible
– Supports Minecraft 1.19 – 1.21.x
– MIT License

### 📦 Notes
– Placeholder: `%vanishv_status%`
– PlaceholderAPI is optional (auto-detected)

Vanish++

# Vanish++

## 👻 The Absolute Standard for Modern Admin Stealth.

**Stop getting caught. Start watching.**

Are you tired of “vanish” plugins that leave traces? Players tab-completing your name? Arrows bouncing off your invisible body? Mobs looking strangely at “empty” air?

**Vanish++** renders other vanish plugins obsolete. Built for modern **Paper**, **Folia**, **Purpur**, **Spigot**, and **Bukkit** servers, it uses advanced packet interception, native physics manipulation, and deep API hooks to ensure you are **mathematically undetectable**.

It works perfectly out of the box with zero configuration required, but offers granular control for those who need it.

## 🚀 Why Vanish++ is Unrivaled

🛡️ The “Matrix” Physics Engine (True Intangibility)

Most plugins just hide you visually. **Vanish++ removes you physically.**

* **Titan God Mode:** While vanished, you are strictly invincible. You take no damage, are immune to all potion effects, and cannot burn. You are a spectator in survival mode.
* **Smart Mob AI (True Sight):** Mobs completely ignore vanished players. Targeting is cancelled via `EntityTargetEvent` before the mob ever commits to an attack path. Mobs that had already locked on before you vanished are force-detargeted immediately.
* **Projectile Pass-Through:** We don’t use “teleport hacks.” Using native Paper events, arrows, tridents, and snowballs fly **physically through** your body. It is impossible to hit a vanished player.
* **Zero Collision:** You cannot push players, mobs, or boats, and they cannot push you. You are a ghost.
* **No Physical Triggers:** You can walk over Turtle Eggs, Crops, Pressure Plates, Tripwires, and Sculk Sensors without triggering a single vibration or block update.
* **Raid Prevention:** You won’t trigger Bad Omen raids while watching a village.

📶 Deep Protocol Invisibility (Packet-Level Hiding)

We hook directly into the server protocol to scrub your existence from clients. *(Requires ProtocolLib)*

* **Nuclear Tab-Completion Scrubbing:** If a normal player tries to Tab-Complete your name in Chat, Vanilla Commands, or Plugin Commands, **you are not there**. Your name is stripped from the packet sent to the client.
* **Server List Hiding:** The player count in the multiplayer server list is mathematically adjusted. If you are the only one online, the server says “0/20”.
* **Ghost View for Staff:** While normal players see nothing, Staff (with permission) see vanished players in the Tab List as **Gray, Italicized Spectators**, making it easy to coordinate.
* **Staff Glow Indicator:** Vanished players render with a glowing outline for staff — a clear visual indicator injected at the packet level. Non-staff never see it. Configurable via `vanish-appearance.staff-glow`.
* **Dynmap & EssentialsX Hooks:** Automatically hides you from dynamic web maps and `/who`, `/list`, or `/online` commands.

👁️ Immersion & Compatibility

* **Native Language Fake Messages:** When you vanish, the fake “Player left the game” message isn’t just text—it uses the **server’s native translation packet**. This means a German player sees the message in German, and a US player sees it in English. It is indistinguishable from a real disconnect.
* **Native TAB Plugin Support:** If you use **TAB (by NEZNAMY)**, Vanish++ hooks directly into it to display your vanish prefix automatically. No manual Placeholder configuration required.
* **Legacy Plugin Support:** Even without specific hooks, Vanish++ sets standard Bukkit Metadata (`”vanished”`). This means plugins like **CMI**, **TAB**, or custom skripts automatically respect your vanished status.
* **Silent Chests:** Open Chests, Shulker Boxes, Barrels, and Ender Chests silently. The container opens directly against the real inventory — no animation, no sound, no item duplication.
* **DiscordSRV Integration:** Registers as a native vanish hook in DiscordSRV. Join, quit, advancement, and death announcements are all suppressed on Discord — even if you reconnect while already vanished. Fake join/leave messages honour DiscordSRV’s full embed, colour, avatar, and webhook configuration from `messages.yml`. Staff notifications still appear in console and for players with the see permission.
* **Simple Voice Chat Integration:** Automatically isolates/mutes you in voice chat so you can’t be heard or hear proximity chat while stalking.
* **Smart Item Pickup:** Toggle item pickup with `/vanishpickup`. Don’t accidentally steal the diamonds you are watching a player mine.
* **`/msg` / `/tell` Detection Prevention:** Non-staff can no longer `/msg` or `/tell` a vanished player — they receive a vanilla-style “player not found” error. `/r` reply is blocked when the last target was a vanished sender. `/me` from a vanished player is restricted to staff-only audience. Configurable message text.

🔧 Granular Control & Safety

* **Spectator Quick-Switch:** Double-tap Shift while vanished to enter Spectator mode instantly. Double-tap again to return to your previous gamemode. Unvanishing forces you back automatically. Requires `vanishpp.spectator`. (`vanishpp.spectator.bypass` lets you stay in Spectator after unvanishing.)
* **`/vspec` Quick-Spectate:** Instantly enter spectator mode locked to any player with `/vspec `. Use `/vspec stop` to return to your previous location and gamemode. Requires `vanishpp.spec`.
* **`/vfollow` Camera Tracking:** Lock your camera to silently follow any player with `/vfollow `. A HUD indicator shows the active target. Stops automatically if the target disconnects. Requires `vanishpp.follow`.
* **`/vhistory` Audit Log:** Full vanish/unvanish history with timestamps, executor, and reason stored in the database. Requires `vanishpp.history`.
* **`/vstats` Vanish Time Statistics:** View total vanish time, session count, and longest session per player. Requires `vanishpp.stats`.
* **`/vadmin` Dashboard GUI:** In-game GUI overview of all vanished players, active rules, and quick actions. Requires `vanishpp.admin`.
* **`/vincognito` Fake Name Mode:** Replace your display name and tab entry with a configurable fake name while vanished. Requires `vanishpp.incognito`.
* **`/vwand` Toggle Wand:** Grants a Blaze Rod vanish wand — right-click to toggle vanish state. Configurable in `config.yml`. Requires `vanishpp.wand`.
* **`/vzone` No-Vanish Zones:** Define radius-based zones where vanishing/unvanishing is blocked or forced. Manage with `/vzone create|delete|list|reload`. Requires `vanishpp.zone`.
* **`/vautovanish` Auto-Join Vanish:** Players opt into automatic vanish on join. Persisted per UUID — survives restarts and server switches. Requires `vanishpp.autovanish`.
* **Bulk Vanish:** `/vanish all` vanishes every eligible online player at once. `/vanish world ` targets all players in a specific world. Vanish reason tracking: `/vanish [reason]` records a reason visible to staff via `/vhistory`.
* **Bossbar Vanish Indicator:** Optional persistent bossbar shown to vanished players as a stealth reminder. Configurable colour, style, and text in `config.yml`.
* **Live Config Editor (`/vconfig`):** Edit any setting in `config.yml` (Messages, Rules, Boolean toggles) directly in-game. Changes apply instantly without reloading.
* **Interactive Help (`/vhelp`):** Forget the wiki. The plugin includes a clickable, interactive guide explaining every command and feature.
* **Smart-Merge Migration:** Updates are stress-free. The plugin automatically detects old configs and migrates your custom messages/settings to the new version structure safely. Missing message keys are auto-written to `messages.yml` on load — upgrading never leaves a key undefined.
* **Personal Rules System (`/vrules`):** Decide exactly what you want to do while vanished. Supports named presets — save, load, list, and delete rule configurations with `/vrules preset `.
* *Want to break blocks?* Toggle it.
* *Want absolute peace?* Disable “Can Hit Entities”.
* *Afraid of leaking info?* Enable “Chat Confirmation”.
* *Need to drop items?* Enable “Can Drop Items”.
* **Vanish Scoreboard (`/vscoreboard`):** A fully configurable sidebar scoreboard shown automatically when you vanish. Displays world, TPS, player counts, real-time coordinates and direction, biome, ping, health, food, armor, time, and more. Coordinates refresh the instant you move via packet-level ProtocolLib listening — no tick lag. Supports all built-in placeholders plus full PlaceholderAPI. Column separators (`|`) are auto-aligned regardless of label length. Configured in `scoreboards.yml`, reloads with `/vreload`.
* **Heartbeat Synchronization:** Changed a permission in LuckPerms? Promoted someone via Console? The **Heartbeat Task** refreshes visuals instantly. No relogging required.
* **Setup Advisor:** On every startup, the plugin scans the active config and warns you if a hook is enabled but its dependency is missing, or if a PlaceholderAPI placeholder is used without PlaceholderAPI installed. Warnings are printed to the console *and* shown in-chat to all staff with `vanishpp.see` — so you always know when your setup is incomplete.
* **Dependency Warnings:** The plugin intelligently warns admins if ProtocolLib is missing, but allows you to silence these warnings permanently with `/vignore`.
* **Accidental Chat Prevention:** If enabled, typing in chat blocks the message and asks you to confirm with `/vchat confirm`. Never leak your presence by accident again.
* **Async Data Persistence:** All data is saved asynchronously. Server crash? Restart? Your vanish state is saved instantly. No accidental logins.
* **Native Velocity Proxy Plugin:** The companion `vanishpp-velocity` plugin provides a dedicated real-time messaging channel between all Paper servers and Velocity. Vanish state, config changes, and `/vanishreload` propagate network-wide instantly. Timed rule expiry notifications are delivered to the server the player is currently on — no reconnect required. Servers auto-detect the proxy on startup and fall back to standalone mode if none is present.
* **Database Connection Monitoring:** When database connectivity fails, staff are notified in-game so infrastructure issues don’t go unnoticed. Includes graceful error handling and connection pooling.

🔌 Developer & Integration APIs

* **Public VanishAPI:** A clean developer API (`VanishAPI`) exposes vanish state queries, vanish/unvanish calls, event hooks, and rule reads for third-party plugin integration. No internals required.
* **LuckPerms Context Integration:** Registers a `vanished` context node in LuckPerms so permissions can be conditionally granted or revoked while a player is vanished.
* **WorldGuard Region Flags:** Two new WorldGuard flags: `vanishpp-force-vanish` (auto-vanishes players entering the region) and `vanishpp-deny-vanish` (blocks toggling vanish inside the region).
* **Webhook Support:** Configurable HTTP webhooks fire on vanish/unvanish events for external integrations — Discord bots, dashboards, audit systems, anything.
* **Shift-Right-Click Invsee:** Shift-right-clicking a player while vanished opens their inventory via OpenInv or InvSee++ if installed, falling back to the built-in viewer. Permissions are granted for the duration and revoked on close.

## 📋 Commands

Most commands support an optional `[player]` argument, allowing admins to modify the state/rules of other staff members.

| Command | Alias | Description | Permission |
| :— | :— | :— | :— |
| `/vhelp [command]` | `/vanishhelp` | Interactive help menu & guide. | `no permission` |
| `/vanish [player] [reason]` | `/v`, `/sv` | Toggle vanish state. Supports `/vanish all` and `/vanish world `. | `vanishpp.vanish` |
| `/vrules [player] [val] [seconds]` | `/vanishrules` | Configure physics/interaction rules. Supports presets. | `vanishpp.rules` |
| `/vconfig [val]` | `/vanishconfig` | Edit config settings live. | `vanishpp.config` |
| `/vperms` | – | Manage permissions without a perm plugin. | `vanishpp.manageperms` |
| `/vlist` | `/vanishlist` | Interactive list of vanished players. Click a name to unvanish instantly. | `vanishpp.list` |
| `/vignore [player]` | `/vanishignore` | Toggle start-up warnings. | `vanishpp.ignorewarning` |
| `/vchat confirm` | `/vanishchat` | Confirm a chat message (if safety is on). | `vanishpp.chat` |
| `/vreload` | `/vanishreload` | Reload config and resync all vanish effects. | `vanishpp.reload` |
| `/vscoreboard` | `/vsb` | Toggle the vanish sidebar scoreboard. | `vanishpp.scoreboard` |
| `/vspec ` | – | Quick-spectate a player. `/vspec stop` to return. | `vanishpp.spec` |
| `/vfollow ` | – | Lock camera to silently follow a player. | `vanishpp.follow` |
| `/vhistory [player]` | – | View vanish/unvanish audit log. | `vanishpp.history` |
| `/vautovanish [player]` | – | Toggle auto-vanish on join for a player. | `vanishpp.autovanish` |
| `/vstats [player]` | – | View vanish time statistics. | `vanishpp.stats` |
| `/vadmin` | – | In-game dashboard GUI for vanish overview. | `vanishpp.admin` |
| `/vwand` | – | Give the vanish wand (Blaze Rod toggle item). | `vanishpp.wand` |
| `/vzone ` | – | Manage no-vanish zones. | `vanishpp.zone` |
| `/vincognito [player] [fakename]` | – | Enable/disable fake name mode. | `vanishpp.incognito` |

## 🧩 Placeholders (PlaceholderAPI)

Only needed if you are building custom HUDs or Scoreboards. (TAB Plugin works automatically without these).

| Placeholder | Output Example | Description |
| :— | :— | :— |
| `%vanishpp_is_vanished%` | `Yes` / `No` | Current status text. |
| `%vanishpp_is_vanished_bool%` | `true` / `false` | Boolean status for logic/conditions. |
| `%vanishpp_vanished_count%` | `3` | Number of **online** vanished players. |
| `%vanishpp_visible_online%` | `15` | Total players minus vanished players (Fake count). |
| `%vanishpp_prefix%` | `[VANISHED]` | Configured prefix (empty if visible). |
| `%vanishpp_pickup%` | `Enabled` | Current item pickup status. |
| `%vanishpp_vanished_list%` | `Notch, Herobrine` | Comma-separated list of online vanished player names. |
| `%vanishpp_visible_player_list%` | `Steve, Alex` | Comma-separated list of online non-vanished (visible) player names. |

## 🔒 Personal Rules (`/vrules`)

Customize your ghost experience. Default behavior can be tweaked per player.

* `can_break_blocks` (Default: `false` – Cannot break blocks)
* `can_place_blocks` (Default: `false` – Cannot place blocks)
* `can_interact` (Default: `false` – Chests, Buttons)
* `can_hit_entities` (Default: `false` – Prevents hitting players/mobs)
* `can_pickup_items` (Default: `false` – Cannot pick up items)
* `can_drop_items` (Default: `false` – Cannot drop items from inventory)
* `can_chat` (Default: `false` – Requires confirmation to speak)
* `can_trigger_physical` (Default: `false` – Pressure plates, crops, etc.)
* `can_throw` (Default: `false` – Cannot throw items like eggs, snowballs, ender pearls, or shoot bows)
* `mob_targeting` (Default: `false` – Mobs ignore you)
* `spectator_gamemode` (Default: `true` – Double-tap Shift to toggle Spectator mode while vanished)
* `show_notifications` (Default: `true` – Receive action-blocked warnings in chat)

## ⚙️ Compatibility & Requirements

Vanish++ is built for modern ecosystems.

### Supported Versions
| Minecraft Version | Status | Notes |
| :——————— | :——————- | :—————————————————————– |
| **1.21 — 1.21.11** | ✅ Supported | Native support. Built against Paper 1.21 API, tested on 1.21.11. |
| **1.20.4 and older** | ❌ Unsupported | Incompatible API changes. Use older Vanish++ versions. |

### Supported Platforms
| Platform | Status | Notes |
| :—————— | :——————- | :—————————————————————– |
| **Paper** | ✅ Recommended | Best performance. Required for full physics/projectile support. |
| **Purpur** | ✅ Supported | Fully compatible (Paper fork). |
| **Folia** | ✅ Supported | Multi-region scheduler bridge with automatic runtime detection. Full support for regional execution. Tested on 1.21.x. |
| **Spigot** | ⚠️ Compatible | Works, but Paper-specific features (projectile passthrough) degrade. |
| **Bukkit** | ⚠️ Compatible | Same limitations as Spigot. |

**Requirements:**
* **Java 21**
* **ProtocolLib 5.3.0+** (Highly Recommended for Stealth)

**Storage (Optional):**
* **YAML** (Default) – File-based storage, built-in
* **MySQL 5.7+** – Network database support
* **PostgreSQL 12+** – Network database support
* **Redis** (Optional) – For cross-server vanish state synchronization

**Optional Hooks:**
* **TAB (NEZNAMY)** (Native Support)
* PlaceholderAPI, Dynmap, EssentialsX, Simple Voice Chat, DiscordSRV, LuckPerms, WorldGuard, OpenInv / InvSee++

**Just drop the JAR in your plugins folder.** No complex setup required. It works securely out of the box.

### 📄 License & Support

This project is open-source under the GNU GPL v3.
Report bugs via the **Issues** tab.

**[ Download Now ]**
*And become truly invisible.*

VanillaProtect

# VanillaProtect

**VanillaProtect** is a lightweight yet powerful protection plugin for Minecraft servers running Paper, Purpur, Spigot, Bukkit or Folia 1.21+. It automatically tracks block ownership and prevents new players from breaking blocks or opening containers placed by other players. No commands needed from players, everything works out of the box.

## 🛡️ How it works

When any player places a block, VanillaProtect silently records that block’s location and the player’s UUID in a database. If a **newcomer** (a player whose first join was less than N hours ago) tries to break or open something that belongs to another player, the action is cancelled and the newcomer gets a friendly message explaining how much time they have left.

Once the newcomer period expires, all restrictions are lifted automatically.

## ✨ Features

– **Block break protection** – newcomers cannot break blocks placed by other players
– **Container protection** – chests, barrels, shulker boxes, furnaces, dispensers, hoppers, brewing stands, anvils, crafters and more are all protected
– **Optional door/button/lever protection** – toggle in config
– **Natural blocks are freely breakable** – stone, dirt, trees etc. are not restricted by default (configurable)
– **Per-block ownership tracking** – only the exact blocks placed by others are protected, not entire regions
– **Configurable newcomer period** – set anywhere from 6 to 24+ hours
– **Two storage backends** – SQLite (recommended) or YAML flat file
– **Auto-save** – data is saved periodically and on shutdown
– **Folia support** – fully compatible with threaded region servers
– **No dependencies** – single JAR, drop and go

## 🌍 Multi-language support

VanillaProtect ships with 4 built-in languages:

| Code | Language |
|——|———–|
| `en` | English |
| `ru` | Русский |
| `uk` | Українська |
| `de` | Deutsch |

You can also create your own language file by placing a `plugins/VanillaProtect/lang/.yml` file in the plugin folder. All messages support color codes.

## ⚙️ Configuration overview

```yaml
# How long a player is considered a newcomer (in hours)
newcomer-hours: 12

# Toggle individual protections
protection:
block-break: true
chest-open: true
block-place: false
block-interact: false

# Storage backend: sqlite or yaml
storage:
type: sqlite
auto-save: 5

# Disable protection in specific worlds
disabled-worlds:
- world_nether
- world_the_end
```

## 💬 Commands

| Command | Description |
|---------|-------------|
| `/vp reload` | Reload config and language files without restarting |
| `/vp status` | Show current plugin status and settings |
| `/vp info ` | View a player's join date, playtime and newcomer status |
| `/vp bypass ` | Toggle bypass for a player (removes all restrictions) |

Aliases: `/vanillaprotect`, `/vp`, `/vprotect`

## 🔑 Permissions

| Permission | Description | Default |
|------------|-------------|---------|
| `vanillaprotect.admin` | Access to all admin commands | OP |
| `vanillaprotect.bypass` | Bypass newcomer restrictions | OP |
| `vanillaprotect.bypass.others` | Grant/revoke bypass for others | OP |

## 📦 Compatibility

| Platform | Supported |
|----------|-----------|
| Paper 1.21+ | ✅ |
| Purpur 1.21+ | ✅ |
| Spigot 1.21+ | ✅ |
| Bukkit 1.21+ | ✅ |
| Folia 1.21+ | ✅ |

## 📁 Plugin folder structure

```
plugins/VanillaProtect/
├── config.yml
├── blocks.db
└── lang/
├── en.yml
├── ru.yml
├── uk.yml
└── de.yml
```

*Made by **1mN1kO***

Vanilla Sword Blocking

# Vanilla Sword Blocking

This is a very simple datapack/paper plugin that **brings back the old sword blocking mechanics**, allowing you to block with your sword to reduce the damage you take.
The best part about it: It’s **server-only**, so players don’t even have to install a mod on their client for this – just add it to the server and it works for everyone!

**Features:**
– damage is reduced by 50% while blocking with swords
– player is slowed down while blocking
– works with all swords, no matter how they were obtained
– works with most modded swords

**Caveat:**
– When using the datapack/mod variant (1.21.5+), sword blocking will keep working even when you remove the datapack/mod!

How it works

Essentialy, this plugin uses the recently added component called “consumable”, to make Minecraft think you can eat swords!

This is used to enable an animation called “block”, so it looks like you’re blocking.

Then, the plugin prevents you from actually eating your sword (you’re welcome!), and instead reduces damage when it detects you are blocking (“eating”, from minecraft’s perspective) your sword.

![A first-person view of a minecraft player blocking with their Netherite sword](https://github.com/user-attachments/assets/f3cc8477-04a8-4bb3-882c-451bbeee422b)

>## Note:
> While the plugin variant can technichally be installed on any server version 1.21.2 and later, the blocking will only be displayed correctly by **clients on version 1.21.4** (24w44a, to be exact) and later.

ValuableForceload

# ValuableForceload(VFL) – A Forceload plugin!

This is A bukkit plugin that allows players to buy&manage forceload chunks in a simple GUI.

## ✨ Features
– GUI-based chunk management
– Multi-economy support (Vault/PlayerPoints/XConomy and even EXP level)
– Configurable pricing and expiration
– Multi-language localization (English/Simplified Chinese)
– Player quota system

## ⚠️ **Important Note**:
– Released JAR files are **obfuscated** for protection (just my preference, won’t affect plugin work)
– GitHub repository contains **original non-obfuscated** source code

# **Gallery**:
*Main Interface – Profile & Purchase chunks*

![MAIN GUI](https://cdn.modrinth.com/data/cached_images/c016da496e8681665caa7dfeeec721071018ceaa.png)

*Management Interface – Configure chunks*

![Manage UI](https://cdn.modrinth.com/data/cached_images/ec3039ad76688409c35eaf428f4c828a27891756.png)

# Supports

## Economy Plugins:
– Vault
– PlayerPoints
– XConomy

# Configs

max-forceload-chunks-per-player: 3 **_The max forceload chunks that a player can have_**

forceload-chunk-price.economy-type: PLUGIN_PLAYERPOINTS **_The Economy Type._**

forceload-chunk-price.value: 200 **_The Price_.**

forceload-chunk-price.days: 3 **_How many days after buying, the forceload will expire and removed._**

locale: zh_CN **_locale._**

forceload-chunk-data: [] **_do not touch any of it if you don’t really understand it._**

Supported Economy Types:
– PLUGIN_VAULT
– PLUGIN_PLAYERPOINTS
– PLUGIN_XCONOMY
– MINECRAFT_EXP_LEVEL

Supported language:
– en
– zh_CN

# Commands
### /valuableforceload open
Permission: valuableforceload.command.gui

Effect: Open Main GUI for player.
### /valuableforceload version
Permission: [no permission required]

Effect: Show version info for player.
## /valuableforceload admin
### /valuableforceload admin erase_all
Permission: valuableforceload.command.admin

Effect: Erase all data in VFL (**_DANGEROUS!_**)

# Update Plan
– Individual Quotas for Players
– More Admin commands
– Reminder for entering forceloaded chunks