# Home

> A deeply customized guild plugin designed for Minecraft network servers (Velocity)

**KaGuilds** is a powerful, highly customizable Minecraft guild plugin built for modern network servers. It leverages **SQL transactions** and **cross-server message bus** to ensure data consistency and security in distributed environments, providing players with a seamless cross-server guild experience.

***

## ✨ Core Features

### 🔄 Complete Cross-Server Synchronization

Based on Velocity message channels, enabling:

* Global guild chat, notifications, and invitations
* Real-time synchronization of guild information and permissions
* Cross-server player invitations and join requests
* Data consistency guarantees

### 💰 Deep Economy Integration

* **Guild Bank**: Supports deposits and withdrawals with transaction logs
* **Vault System**: Multiple lockable vaults with lease management
* **Contribution System**: Earn contribution points through deposits and withdrawals
* Complete fee configuration system

### 👥 Rigorous Rank System

Three-tier permission structure:

* **Owner** - Full control
* **Admin** - Management permissions
* **Member** - Basic permissions
* Supports promotion, demotion, and ownership transfer

### 📈 Dynamic Level System

* Dynamically increases member limits and features
* Each level unlocks unique Buffs and privileges

### 🎮 PvP Arena

* Guild battles with custom equipment kits
* Match timing and win conditions
* Statistics tracking and reward commands
* BOSS bar real-time status display

### 🖼️ Highly Customizable GUI

* Rich menu system
* Supports custom layouts, materials, and Lore
* TrMenu-like editing experience

### 📊 PlaceholderAPI Support

* Scoreboard and chat integration
* Rich placeholder variables
* Real-time data updates

### 🌍 Multi-Language Support

* **Simplified Chinese**: `zh_CN.yml`
* **English**: `en_US.yml`
* Full localization support

## 💰 Support & Purchase

KaGuilds is a paid open-source plugin. You can download the source code from GitHub and build the plugin yourself.

{% embed url="<https://github.com/Katacr/KaGuilds/>" %}

If you want to support the developer, you can also purchase and download the plugin from various plugin platforms.

{% hint style="info" %}
Only users who purchase the plugin are eligible for technical support.
{% endhint %}

***

## 🤝 Community & Feedback

* **GitHub**: [Katacr/KaGuilds](https://github.com/Katacr/KaGuilds/)
* **Issue Tracker**: [GitHub Issues](https://github.com/Katacr/KaGuilds/issues)

## 📄 License

This project is open-sourced under the [GPL-3.0](https://www.gnu.org/licenses/gpl-3.0.html) license.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://katacr.gitbook.io/plugins/kaguilds-en/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.