⚒️ GuildForge
GuildForge is a powerful plugin for Minecraft that adds a deep guild system with unique abilities, Contribution economics, and exclusive items.
Created for the "SubMine" server
✨ Features
🏰 5 unique guilds
| Guild | Color | Abilities | Exclusive |
|---|---|---|---|
| Smiths | Dark Gray | Mending without losing enchantment, reforging | Mending Book |
| Alchemists | Light Purple | Enhanced potions, triple brewing | Eternal Vial |
| Cartographers | Turquoise | Warps (up to 6 points), treasure maps | Return Map |
| Farmers | Green | Accelerated growth, rapid reproduction | Apple of Abundance |
| Miners | Dark gray | +10% to ore, 3x3 hammer | Heart of the Mountain |
👑 Guild Leaders System (NEW in 1.0.1!)
- Only administrators can assign guild leaders via
/guildadmin setleader <player> - Leaders receive a special button in the menu for managing members
- Leaders can promote players in rank (if enough Contribution)
- Leaders can demote players in rank (Contribution is reduced to the minimum)
- ❌ Automatic promotion is disabled - now only through the chapter!
📊 Rank and Progress System
- 4 ranks in each guild (from apprentice to guardian)
- Visual progress bar to the next rank
- Chat prefixes with guild color and rank
- Integration with PlaceholderAPI
💰 Contribution Economy
- Points for profile actions (ore mining, potion brewing, crafting, etc.)
- Spending on exclusive items
- Display in the action bar and GUI
🗺️ Warps for cartographers
- Creation of personal teleportation points
- The number of warps depends on the rank
- Saving between restarts
🔧 Technical features
- ✅ Full Folia support - multi-threaded server
- ✅ Support for Paper and Purpur - optimized servers
- ✅ Asynchronous database operation - SQLite
- ✅ PlaceholderAPI - more than 10 placeholders
- ✅ Advanced API - for creating add-ons
📥 Installation
- Download the latest version from Releases
- Place
GuildForge-1.0.1.jarin theplugins/folder - Restart the server or execute
/reload confirm - Done! 🎉
🎮 Commands
For players
| Command | Description |
|---|---|
/guild |
Open the guild menu |
/warp |
Warp management (for cartographers) |
/warp create <name> |
Create a warp |
/warp <name> |
Teleport to the warp |
/warp delete <name> |
Delete the warp |
For administrators
| Command | Description |
|---|---|
/guildadmin reload |
Reload configs |
/guildadmin info <player> |
Player information |
/guildadmin setguild <player> <guild> |
Set guild |
/guildadmin addcontribution <player> <amount> |
Add points |
/guildadmin setleader <player> |
👑 Set guild leader |
🔌 PlaceholderAPI
Available placeholders:
| Placeholder | Description |
|---|---|
%guildforge_guild% |
Guild name |
%guildforge_guild_color% |
Guild color |
%guildforge_rank% |
Rank name |
%guildforge_rank_prefix% |
Rank color prefix |
%guildforge_contribution% |
Contribution points |
%guildforge_has_guild% |
Has guild |
%guildforge_is_master% |
|
%guildforge_is_leader% |
👑 Is the guild leader |
%guildforge_leader_name% |
👑 Name of the leader |
📁 Configuration
Basic settings (config.yml)
# 👑 Settings for guild leaders
leaders:
can_transfer_leadership: false
can_kick_members: true
max_leaders_per_guild: 1
notify_leader_on_ready: true
# Warp Settings
warps:
max_warps:
surveyor: 3
pathfinder: 4
master: 5
keeper: 6
🔧 Compatibility
Platform Version Status
Paper 1.21+ ✅ Full support
Purpur 1.21+ ✅ Full support
Folia 1.21+ ✅ Full support
Spigot 1.21+ ⚠️ Basic support
Bukkit 1.21+ ⚠️ Basic support
📦 API for developers
java
// Get the API
GuildForgeAPI api = GuildForge.getAPI();
// 👑 New methods in 1.0.1
boolean isLeader = api.isGuildLeader(player);
Player leader = api.getGuildLeader(player);
api.setGuildLeader(admin, target); // Only for admins
api.promotePlayer(leader, target);
api.demotePlayer(leader, target);
List<Player> promotable = api.getPromotableMembers(leader);
// Subscribe to events
api.registerGuildListener(new GuildEventListener() {
@Override
public void onRankUp(Player player, Rank oldRank, Rank newRank) {
// Player is promoted
}
@Override
public void onRankDown(Player player, Rank oldRank, Rank newRank) {
// Player is demoted (new in 1.0.1)
}
});
📜 Version history
1.0.1 (February 2025) - Current version
👑 Guild Head System (only admins can assign)
📈 Guild Heads can promote/demote players
❌ Automatic rank promotion is disabled
🔄 Automatic Folia/Paper detection
🐛 GUI bugs have been fixed
1.0.0 (January 2025)
First release
Basic guild mechanics
Contribution system
Exclusive items
👨💻 Author
Ragnarok
GitHub: @Psych0858
Discord: Ragnarok363
📄 License
MIT License © 2025 Ragnarok
