Botz Guild Manager

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 <player> 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.