BotzGuildz — 适用于 Forge 服务器的深度公会系统
BotzGuildz 是一款专为 Minecraft Forge 1.20.1 设计的全面且以服务器为核心的公会模组。它远远超越了简单的群组管理——提供公会战争、竞技场战斗、完全由数据包驱动的升级商店、突袭小队、决斗、排行榜以及深度的经济集成。无论你是运营小型生存服务器还是大型类似 factions 的社区,BotzGuildz 都能让你的玩家拥有共同奋斗的目标。
? 公会
创建具有自定义名称和标签的公会,招募成员,并建立你的声望。公会通过登录、击杀和战争胜利获得经验值(XP)——升级以解锁更强大的升级项。每个行动都会记录在持久化的活动日志中,以便领导者始终了解情况。
聊天框中显示自定义名称 + 短标签
共享公会家园传送功能,可配置冷却时间
公会每日公告 (MOTD)
仅限公会成员和官员的聊天频道 (/gc, /goc)
持久化活动日志(最近 50 个事件)
1–25 级进度系统(上限可配置)
?️ 职位与权限
超越“领袖/成员”的限制,采用完全自定义的职位系统。你可以创建任意数量的职位,分配任何优先级,并授予它们所需的精确权限——不多不少。
权限节点:INVITE · KICK · SET_HOME · MANAGE_RANKS · MANAGE_BANK · MANAGE_UPGRADES · MANAGE_ALLIES · DECLARE_WAR · TOGGLE_FF
默认职位(Leader, Officer, Member, Recruit)完全可定制,并且可以根据服务器需求补充任意数量的自定义职位。
? 公会银行与经济
每个公会都有一个共享银行,用于资助升级、战争和联盟。如果安装了 Numismatics,该银行会与其集成;否则回退到内置的物理物品货币系统。
随时存入、取出和查看余额
可配置的银行上限(可通过升级提升至 2 倍或 3 倍)
战争赌注自动托管——锁定直至战争结束
所有交易记录到公会历史中
⚔️ 公会战争
向任何公会宣战,押注货币,争夺霸权。选择你的战场:
开放世界 —— PvP 在任何地方发生。无时间限制。首先耗尽对手总生命值的公会获胜。
竞技场模式 —— 两个公会传送到专用的 guild_arena 维度。自动生成一个罗马斗兽场。战斗 5 分钟(可配置)。击杀数最高者获胜。
可配置的玩家生命值、赌注金额和冷却时间
战争宣言要求对方公会在 120 秒内接受
投降选项 —— 拥有 REDUCED_LOSS 升级时,即使失败也能保留 25% 的赌注
战争胜利奖励公会经验值和全额托管赌注池
? 升级系统(基于数据包)
升级商店是一个完全交互式的 GUI——一个带有分类标签、多页浏览和实时余额显示的 6 行箱子界面。所有升级均从数据包加载,使得系统无需任何代码更改即可完全自定义服务器内容。
内置升级类别:
类别 示例
⚔️ 战斗 Damage Boost I/II, Defense I/II, Arena War
? 实用 Member Cap I/II, Chunk Claims, Home Bypass
? 经济 Earn Rate I/II, Bank Cap I/II, War Shield
?️ 防御 XP Bonus I/II, Reduced War Loss
? 奥术 Alliance System, Custom Chat Color
升级效果类型包括:被动属性修饰符、一次性物品奖励、购买时的药水效果以及服务器命令执行。全部在 JSON 中定义——无需编码。
?️ 完整的数据包指南可在 Wiki 中找到——通过几个 JSON 文件创建你自己的升级类别和升级项。
? 联盟
解锁 ALLIANCE 升级并开始与其他公会形成伙伴关系。盟约公会之间无法互相伤害,并在公会信息中可见。最大联盟数量可配置。
? 突袭小队
在挑战强大的首领之前组建一个突袭小队——然后让系统处理其余事宜。任何最大生命值达到 50+ 颗心(100 HP)的生物都自动符合首领目标的条件。适用于原版首领以及调整到该阈值的任何模组生物。
使用 /raid party create 组建小队,使用 /raid party invite <player> 邀请成员
第一个击中首领的玩家为该组认领它
在整个战斗过程中按玩家追踪伤害
首领死亡时:正常掉落被取消,并根据造成的伤害按比例重新分配
每位玩家直接在背包中获得其份额
完整的摘要消息:造成伤害、百分比以及获得的物品数量
使用 /raid party status 在战斗中查看实时伤害数据
? 决斗
挑战任何玩家进行 1v1 决斗,可配置生命值和可选的货币赌注。半径强制执行系统确保双方诚实——逃离竞技场即自动判负。
可选的货币赌注,奖金自动支付给获胜者
可配置的生命值(1 到 999)、接受超时和半径限制
全球决斗胜利排行榜 (/duel top)
? 排行榜
/guild top —— 按银行余额排名的前 10 名公会
/guild top wars —— 按战争胜利排名的前 10 名公会
/duel top —— 按决斗胜利排名的前 10 名玩家(解析离线玩家名称)
? FTB Chunks 集成(可选)
如果安装了 FTB Chunks,CHUNK_CLAIM_I 和 CHUNK_FORCE_LOAD 升级会自动将额外的领地声明和强制加载槽位同步到公会的 FTB 团队中。
⚙️ 高度可配置
几乎所有值都可以在 botzguildz-server.toml 中调整:
货币名称、符号和物品
击杀、登录和战争胜利的经验值率
最大公会等级、成员上限、银行上限
战争接受超时、战争冷却时间、竞技场持续时间
决斗超时和半径
联盟上限、家园冷却时间等
? 要求
Minecraft: 1.20.1
Forge: 47.4.16+
Java: 17+
FTB Chunks: 可选 —— 用于领地声明升级集成
? Wiki 与文档
完整文档可在 GitHub Wiki 上找到,包括:
完整的命令参考
带有 JSON 示例的数据包指南
配置参考
升级系统详情
专为那些不仅仅想要一个 /clan 命令的服务器社区而设计。
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧