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, .gws presets, 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

Installation

1. Drop the JAR into plugins/
2. Start the server (configs generate automatically)
3. Edit plugins/GuildPlugin/config.yml as needed
4. Run /guildadmin reload (or restart)

When upgrading: back up data first. Prefer regenerating language files so new message keys appear correctly.

Commands

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)

Full list: project wiki → PlaceholderAPI reference.

Links

• GitHub
• Issues
• Docs: GuildWorld / GuildWar / SDK Developer Guide (in the repository Wiki/)

License

GNU GPL v3.0