Botz Guild Manager

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 full player-driven economy, daily missions, a shared vault, raid parties, duels, leaderboards, and deep FTB 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.

• 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)
• Join Requests — players can /guild apply without a direct invite; officers accept or deny

🎖️ 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 exactly the permissions they need — nothing more.

Permission nodes: INVITE · KICK · SET_HOME · MANAGE_RANKS · MANAGE_BANK · MANAGE_UPGRADES · MANAGE_ALLIES · MANAGE_VAULT · MANAGE_MISSIONS · MANAGE_BOUNTIES · 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.

💰 Economy

A full player-driven market ecosystem — all systems share the same currency.

Personal & Guild Banking

• Every player has a personal wallet; use /bank to deposit, withdraw, pay other players, or donate to the guild
• Guild treasury (/guild bank) with rank-gated withdrawals, daily limits, and war escrow
• Configurable bank cap (upgradeable to 2× or 3× via upgrades)

Auction House (/ah)

• Server-wide marketplace for fixed-price listings and timed auctions with bidding
• Items and coins are queued and delivered on login if you're offline when a sale resolves
• Configurable listing fee, max active listings, and max auction duration

Player Shops (/shop)

• Set up a storefront backed by a real chest in the world
• Other players right-click the registered block to browse and buy directly
• Stock is drawn live from the linked chest — just restock and go

Guild Shops (/guild shop)

• Guild-owned storefronts managed by officers with unlimited stock
• Optionally register a physical block as the storefront

Bounties (/bounty)

• Place a currency bounty on any player
• Collected automatically when that player is killed in PvP — no action needed
• Stack multiple bounties from multiple players; winner takes all

Guild Bounty Board (/guild bounty)

• Officers post item-collection quests funded by the guild bank
• Any player on the server can claim them by delivering the required items

Native support for Create: Numismatics — uses Numismatics currency automatically if installed; falls back to a configurable physical-item currency (default: gold ingots).

📋 Guild Missions

Three daily shared quests — Kill, Mine, and Collect — randomly generated per guild each day. Any guild member's actions count toward the shared goal. Completing a mission deposits a reward into the guild bank and pays out personally to every contributing member.

• /guild missions — open the mission GUI with progress bars and timers
• Missions auto-refresh daily; officers can force-refresh early with MANAGE_MISSIONS permission

🗄️ Guild Vault

A shared 45-slot item chest accessible to all guild members.

• Any member can deposit; withdrawals require MANAGE_VAULT permission
• Every deposit earns the depositor Contribution Points
• View top contributors with /guild contributions

🤝 Alliances

Unlock the ALLIANCE upgrade and start forming partnerships with other guilds.

• Allied guilds cannot hurt each other
• /guild ally chat — toggle a cross-guild broadcast channel; your messages reach all online members of every allied guild simultaneously
• /guild ally tp <guild> — teleport to an allied guild's home (configurable cooldown)
• /guild ally list shows each ally's home status (✔/✖)
• Maximum alliance count is configurable (default: 3)
• If FTB Teams is installed, alliance formation/breaking automatically syncs ALLY/NEUTRAL team relations so allies can see each other's claimed chunks

⚔️ Guild Wars

Declare war on any guild, stake a currency wager, and fight for dominance. Choose your battlefield:

• Open World — PvP happens anywhere. 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. Highest kill count within the time limit wins.

Configurable lives per player, wager amounts, accept timeout, and cooldowns. 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 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.

Upgrade effect types: passive stat modifiers, one-time item rewards, potion effects on purchase, and server command execution — all defined in JSON.

🐉 Raid Parties

Form a raid party before taking on a powerful boss, then let the system handle the rest. Any mob with 50+ hearts of max health automatically qualifies. Works with vanilla bosses and any modded mob tuned to that threshold.

• Damage is tracked per player throughout the fight
• On boss death: drops are redistributed proportionally by damage dealt
• Full summary message with damage %, item count received per player

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

📊 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

🔗 FTB Integration (Optional)

• Syncs FTB team color to guild chat color on login
• CHUNK_CLAIM_I / FORCE_LOAD upgrades sync extra slots to the guild's FTB team automatically
• Alliance formation/breaking syncs FTB Teams ALLY/NEUTRAL relation

⚙️ 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, cooldown, arena duration
• Duel timeout and radius
• Alliance cap, ally TP cooldown, home cooldown
• Auction House fee, listing limits, max duration
• Bounty min/max, shop listing limits

📋 Requirements

📖 Wiki & Documentation

Full documentation on the GitHub Wiki — complete command reference, datapack guide, economy setup, and configuration reference.

Built for server communities that want more than just a /clan command.

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.