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.