GuildForge

⚒️ 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 | |---------|------|-------------|-----------| | Miners | Dark Gray | Mending without losing enchantment, reforging | Mending Book | | Miners | Light Purple | Enhanced potions, triple brewing | Eternal Vial | | Miners | Turquoise | Warps (up to 6 points), treasure maps | Return Map | | Miners | 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 Automatic promotion is disabled players in rank (if enough Contribution) - Leaders can Automatic promotion is disabled 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

- ✅ Advanced API - multi-threaded server - ✅ Advanced API - optimized servers - ✅ Advanced API - SQLite - ✅ Advanced API - 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%` | | Is the player a master | | `%guildforge_is_leader%` | 👑 Name of the 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 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