GuildForge

# ⚒️ GuildForge !(https://img.shields.io/badge/version-1.0.1-aqua) !(https://img.shields.io/badge/Paper-1.21+-darkblue) !(https://img.shields.io/badge/Purpur-1.21+-purple) !(https://img.shields.io/badge/Folia-✅-success) !(https://img.shields.io/badge/Java-21-orange) !(https://img.shields.io/badge/license-MIT-darkgreen) **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 (https://github.com/yourusername/GuildForge/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%` | | Is the player a master | | `%guildforge_is_leader%` | **👑 Is the guild leader** | | `%guildforge_leader_name%` | **👑 Name of the leader** | ## 📁 Configuration ### Basic settings (`config.yml`) ```yaml # 👑 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 histo