⚒️ 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

1. Download the latest version from Releases
2. Place GuildForge-1.0.1.jar in the plugins/ folder
3. Restart the server or execute /reload confirm
4. 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