Botz Guild Manager

Minecraft 版本： 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6

平台： forge

BotzGuildz — In-Depth Guild System for Forge Servers
BotzGuildz is a comprehensive, server-focused guild mod for Minecraft Forge 1.20.1. It goes far beyond simple group management — offering guild wars, arena battles, a fully datapack-driven upgrade shop, raid parties, duels, leaderboards, and deep economy integration. Whether you're running a small survival server or a large factions-style community, BotzGuildz gives your players something to work toward together.

? Guilds
Create a guild with a custom name and tag, recruit members, and build your reputation. Guilds earn XP through logins, kills, and war victories — leveling up to unlock more powerful upgrades. Every action is logged in a persistent activity log so leaders always know what's happening.

Custom name + short tag shown in guild chat
Shared guild home teleport with configurable cooldown
Guild Message of the Day (MOTD)
Guild-only and officer-only chat channels (/gc, /goc)
Persistent activity log (last 50 events)
Level 1–25 progression system (configurable cap)
?️ Ranks & Permissions
Go beyond "leader/member" with a fully custom rank system. Create as many ranks as you want, assign them any priority, and grant them exactly the permissions they need — nothing more.

Permission nodes: INVITE · KICK · SET_HOME · MANAGE_RANKS · MANAGE_BANK · MANAGE_UPGRADES · MANAGE_ALLIES · DECLARE_WAR · TOGGLE_FF

Default ranks (Leader, Officer, Member, Recruit) are fully customizable and can be supplemented with as many custom ranks as your server needs.

? Guild Bank & Economy
Every guild has a shared bank that funds upgrades, wars, and alliances. The bank integrates with Numismatics if installed, or falls back to a built-in physical-item currency system.

Deposit, withdraw, and check balance at any time
Configurable bank cap (upgradeable to 2× or 3× via upgrades)
War wagers are automatically escrowed — locked until the war resolves
All transactions logged to guild history
⚔️ Guild Wars
Declare war on any guild, stake a currency wager, and fight for dominance. Choose your battlefield:

Open World — PvP happens anywhere. No time limit. First guild to deplete the opponent's total lives wins.

Arena Mode — Both guilds teleport into the dedicated guild_arena dimension. A Roman Colosseum is generated automatically. Fight for 5 minutes (configurable). Highest kill count wins.

Configurable lives per player, wager amounts, and cooldowns
War declarations require the opposing guild to accept within 120 seconds
Forfeit option — with the REDUCED_LOSS upgrade, you keep 25% of your wager even when losing
War wins reward the guild with XP and the full escrow pot
? Upgrade System (Datapack-Driven)
The upgrade shop is a fully interactive GUI — a 6-row chest interface with category tabs, multi-page browsing, and live balance display. All upgrades are loaded from datapacks, making the system completely server-customizable without any code changes.

Built-in upgrade categories:

Category Examples
⚔️ Combat Damage Boost I/II, Defense I/II, Arena War
? Utility Member Cap I/II, Chunk Claims, Home Bypass
? Economy Earn Rate I/II, Bank Cap I/II, War Shield
?️ Defense XP Bonus I/II, Reduced War Loss
? Arcane Alliance System, Custom Chat Color
Upgrade effect types: passive stat modifiers, one-time item rewards, potion effects on purchase, and server command execution. All defined in JSON — no coding required.

?️ Full Datapack Guide is available in the wiki — create your own upgrade categories and upgrades with a few JSON files.

? Alliances
Unlock the ALLIANCE upgrade and start forming partnerships with other guilds. Allied guilds cannot hurt each other and are visible in guild info. Maximum alliance count is configurable.

? Raid Parties
Form a raid party before taking on a powerful boss — then let the system handle the rest. Any mob with 50+ hearts (100 HP) of max health automatically qualifies as a boss target. Works with vanilla bosses and any modded mob tuned to that threshold.

Form a party with /raid party create, invite with /raid party invite
First party member to hit the boss claims it for the group
Damage is tracked per player throughout the entire fight
On boss death: normal drops are cancelled and redistributed proportionally by damage dealt
Each player receives their share directly in their inventory
Full summary message: damage dealt, percentage, and item count received
Use /raid party status to see live damage numbers mid-fight
? Duels
Challenge any player to a 1v1 duel with configurable lives and an optional currency wager. A radius enforcement system keeps both players honest — flee the arena and you auto-forfeit.

Optional currency stakes with automatic pot payout to the winner
Configurable lives (1 to 999), accept timeout, and radius limit
Global duel win leaderboard (/duel top)
? Leaderboards
/guild top — Top 10 guilds by bank balance
/guild top wars — Top 10 guilds by war wins
/duel top — Top 10 players by duel wins (resolves offline player names)
? FTB Chunks Integration (Optional)
If FTB Chunks is installed, the CHUNK_CLAIM_I and CHUNK_FORCE_LOAD upgrades automatically sync extra claim and force-load slots to the guild's FTB team.

⚙️ Highly Configurable
Nearly every value is adjustable in botzguildz-server.toml:

Currency name, symbol, and item
XP rates for kills, logins, and war wins
Max guild level, member cap, bank cap
War accept timeout, war cooldown, arena duration
Duel timeout and radius
Alliance cap, home cooldown, and more
? Requirements
Minecraft: 1.20.1
Forge: 47.4.16+
Java: 17+
FTB Chunks: Optional — for chunk-claim upgrade integration
? Wiki & Documentation
Full documentation is available on the GitHub Wiki, including:

Complete command reference
Datapack guide with JSON examples
Configuration reference
Upgrade system details
Built for server communities that want more than just a /clan command.