
Guild Plugin
Guild Plugin delivers a full-featured guild system for Minecraft servers, enabling players to create, manage, and grow their factions.
Автор: chenasyd3,7 тыс.5обновлён 17 авг. 2026 г.
ЭкономикаУправление
Описание
Guild Plugin
A feature-complete Minecraft guild / faction system — economy, relations, leveling, full GUI, modular SDK, void-world arenas, and fixed-map guild war. Free and open-source. Supports Spigot, Paper, Purpur, and Folia.
Highlights
- Guild management — create, invite, kick, promote/demote, applications, home teleport
- Economy — guild bank (deposit / withdraw / transfer) via Vault
- Relations — ally, enemy, neutral, war, truce (with request flow)
- Leveling — configurable levels, costs, and member caps
- Full GUI — inventory menus for nearly every action; Bedrock form support when Geyser + Cumulus are available
- Worlds & Guild War — void arenas, wand selection,
.gwspresets, challenge → signup → fight → teardown (/guildworld,/guildwar) - Modular SDK — hot-load modules at runtime (
/guildmodule), EventBus, ServiceContainer, CustomGUI - Multi-language — Chinese, English, and 20+ other languages
- Async DB — HikariCP with SQLite or MySQL
Guild War is fixed-map team PVP, not claim/territory war, and is separate from diplomatic relation type
war.
Requirements
| Minecraft | 1.20.1+ |
| Java | 17+ |
| Soft depends | Vault (economy), PlaceholderAPI (placeholders), Geyser-Spigot / ImagoCore (optional GUI extras) |
| Software | Version |
|---|---|
| Spigot | 1.20.1+ |
| Paper | 1.20.1+ |
| Purpur | 1.20.1+ |
| Folia | 1.20.1+ (world create/load gated to supported Folia builds) |
Installation
- Drop the JAR into
plugins/ - Start the server (configs generate automatically)
- Edit
plugins/GuildPlugin/config.ymlas needed - Run
/guildadmin reload(or restart)
When upgrading: back up data first. Prefer regenerating language files so new message keys appear correctly.
Commands
| Command | Alias | Description |
|---|---|---|
/guild | /g | Player guild GUI & commands |
/guildadmin | /ga | Admin panel |
/guildmodule | /gm | Hot-load / unload modules |
/guildworld | /gworld | Void worlds, presets, recovery |
/guildwar | /gwar | Fixed-map guild war |
Guild War (quick flow)
/guildwar challenge <guild> [--preset] [--mode first|timed|survive]
/guildwar accept
/guildwar join
/guildwar ready # both officers → start early
Victory modes: first (first to N kills), timed (score by time), survive (last team standing).
PlaceholderAPI (common)
| Placeholder | Description |
|---|---|
%guild_name% | Guild name |
%guild_tag% | Guild tag |
%guild_membercount% | Member count |
%guild_maxmembers% | Max members |
%guild_level% | Guild level |
%guild_balance% | Balance (2 decimals) |
%guild_frozen% | Status |
%guild_role% | Player role |
%guild_hasguild% | Has guild (Yes/No) |
%guild_isleader% | Is leader |
%guild_caninvite% / %guild_cankick% / … | Permission checks |
Full list: project wiki → PlaceholderAPI reference.
Links
License
GNU GPL v3.0
Последние версии
Все версии →release
Guild Plugin 1.6.6
1.6.617 авг. 2026 г.103Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bungeecord
Что нового
suppress certain log outputs
release
Guild Plugin 1.6.6
1.6.617 авг. 2026 г.619Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Что нового
**This release (v1.6.6) includes the following changes since the previous stable release (v1.6.5):**
- All updates from `1.6.6-snapshot.1` through `1.6.6-snapshot.5`
- Additional updates after `1.6.6-snapshot.5`:
- Added guild leadership transfer feature
- Removed online check for kicking; offline members can now be kicked
alpha
Guild Plugin 1.6.6-snapshot.5
1.6.6-snapshot.514 авг. 2026 г.22Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Что нового
## New Features
1. Added guild warehouse, expanding with guild level upgrades (`/guild warehouse`)
2. Added automatic database backup functionality
3. Added built-in module for simple activity tracking
4. Refactored the plugin's 5 example modules
5. Enhanced the quest module: fixed task issues and added a guild tree for storing quest experience
6. Suppressed non-essential console output to reduce log spam
7. Refactored plugin core:
- Hot reload now covers all configurable items
- Fixed placeholder issues and optimized placeholder performance
- Async and caching improvements
8. Added relation/invite logging, warehouse access logs, and war report export
9. Updated plugin documentation
## Other Changes
1. Removed Arabic language support
**Update Notes:**
Before updating, it is recommended to manually back up your plugin data. During the update, you need to delete all files and directories **except** `guild.db` and `guild.db-shm` (`guild.db-wal` is optional — if deleted, it will be regenerated on startup without affecting usage). This ensures all configurations are freshly generated.
alpha
Guild Plugin 1.6.6-snapshot.4
1.6.6-snapshot.412 авг. 2026 г.15Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Что нового
**Updates:**
1. Added compatibility for Minecraft 1.20.x versions
2. Added world management system, allowing arena creation (not available on some Folia versions)
3. Added basic guild war functionality, allowing guild wars to be created
4. Removed teleport restrictions on Folia servers
**Update Notes:**
It is recommended to back up your plugin data before updating. You will need to delete the `lang` folder and `config.yml` configuration, then restart the server to generate new language files and configuration before making any modifications.
alpha
Guild Plugin 1.6.6-snapshot.3
1.6.6-snapshot.311 авг. 2026 г.43Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Что нового
**Updates:**
- Enhanced SDK support for module GUI graphical extensions, including Bedrock form support for module-integrated GUIs (existing over-cap guilds are unaffected).
**Fixes:**
- Fixed an issue where guilds could still accept new member join requests even after reaching the member capacity limit.
alpha
Guild Plugin 1.6.6-snapshot.2
1.6.6-snapshot.228 июл. 2026 г.86Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Что нового
chore(lang): sync and deduplicate translation files across 27 languages
- Complete bedrock-test form keys and 313 bedrock-* GUI keys across 27 languages (31 YAML sections)
- Remove duplicate keys in economy, application-mgmt, economy-management, and relation-management sections
alpha
Guild Bungee v1.6.6-snapshot.1
1.6.6-snapshot.128 июл. 2026 г.10Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bungeecord
Что нового
## Features
- Player type detection (Java / Bedrock) with Geyser reflection
- Cumulus form forwarding via BungeeCord proxy
- Cross-server message routing with queue buffering
- No hard dependency on Geyser — automatic fallback
alpha
Guild Plugin v1.6.6-snapshot.1
1.6.6-snapshot.128 июл. 2026 г.8Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Что нового
**Core Image-Based GUI System**
## Bug Fixes (since v1.6.5)
- Fix #36: GUI using global scheduler on Folia/Canvas
- Fix missing keys in core and GUI modules; reuse existing keys where possible
## Update Summary
- **Core Image-Based GUI System** — Guild Plugin now integrates with the standalone ImagoCore plugin, enabling image-based titles and layouts
- **ImagoCore Integration** — ImagoCoreHook serves as a soft-dependency bridge; ImagoGuiConfig manages GUI type-to-background bindings; GuiImageLayoutConfig supports custom multi-slot layouts
- **Bedrock Edition Full Adaptation** — PlayerConnectionService provides a unified facade with dual detection (BungeeClientAPI + GeyserAPI) to accurately identify Bedrock players. Cumulus form transport is implemented in dual-mode (local Geyser and BungeeCord proxy), allowing Bedrock players behind a proxy to also enjoy native form-based GUI experiences
release
Guild Plugin 1.6.5
1.6.53 июл. 2026 г.288Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2bukkit, folia, paper, purpur, spigot
Что нового
- Properly reload language files and apply immediately
- Add multi-language registerGUIButton overloads to GuildPluginAPI
- Refactor button labels to use i18n keys
- Core API: GuildPluginAPI.java — added registerGUIButton overload supporting displayNameKey and loreKeys
⚠️ Update notice: Delete all config files except guild.db, guild.db-shm, and guild.db-wal. This requires reconfiguring config.yml and database.yml.
release
Guild Plugin 1.6.4
1.6.415 июн. 2026 г.165Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2bukkit, folia, paper, purpur, spigot
Что нового
- Fixed invitee name display in invitation notifications
- Fixed force delete guild in guild management GUI
- Added guild chat feature
- Added configurable teleport delay for guild home
- Fixed /g applications subcommand
⚠️ Update notice: Delete all config files except guild.db, guild.db-shm, and guild.db-wal. This requires reconfiguring config.yml and database.yml.