GuildForge

Minecraft 版本： 1.2.1 1.2.2 1.2.3 1.2.4 1.2.5 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： folia paper purpur

标签： adventure game-mechanics utility

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

For administrators

? PlaceholderAPI

Available placeholders:

? 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