A complete, fully customizable medieval guild system for Paper 1.20+. Personal ranks from Bronze to Deity, a per-guild daily contract board, group missions, weekly contracts, plazas, a treasury, a hall of fame — all in symmetric, re-positionable, fully bilingual menus.
Integrates with
Every menu is symmetric, re-positionable and detected internally (never by its title), every text is editable in two languages, and every button has its own sound.
Ten personal ranks, each with its own symbol and color. XP is earned only by completing contracts; failing or abandoning subtracts XP and can demote you. Mythic promotions fire a broadcast, titles, a bossbar, particles and fireworks.
Each guild has its own daily board, refreshed at midnight. A two-step flow — pick a rank, then take a contract for it. Accepted contracts are atomically locked so no one else can grab them, in shared GUILD or personal PLAYER mode.
Rewritten in 2.5.0: ores are defined by base name and count both stone and deepslate; crops only count when fully grown; and blocks a player places never count when broken. A smooth action-bar HUD refreshes every half-second with live progress and time.
Group missions add roles and a penalty-free waiting room that fills, counts down and starts everyone together — abandon a started mission and the whole group fails. Each week one collective contract, shared by all guilds, advances with each guild's own progress.
Guilds are public (instant join) or private (by request, accepted or rejected by the leader and co-leader). Leadership is protected — guilds never end up empty or leaderless — with one optional co-leader. Each guild can set a plaza teleport any member can travel to.
With several guilds, the one that completes the most contracts in the period earns rewards for its members and treasury, with an all-time and current-period leaderboard. A monthly hall of fame ranks the top members, resetting each month with prizes for the top 5.
Switch on a full treasury: a bank with configurable withdrawals, daily upkeep that scales by level, a shared warehouse that grows with the guild, and a personal vault per member sized by role and level — with a material blacklist. Requires Vault for money.
treasury: enabled: true bank: withdrawals: LEADERS # who may withdraw upkeep: per-level: true # daily upkeep scales by level warehouse: rows-by-level: true # shared storage grows with level vault: rows-by-role: true # personal vault per member
The /gremioadmin menu panel changes the whole system live: founding, board, caps, penalties and mission types (page 1); daily bonus, weekly, competition, treasury, language, Discord and logs (page 2); and governance — default guild, public guilds, co-leaders and plaza (page 3). Toggle the language between English and Spanish without a restart.
Menus are symmetric and centered out of the box, but layout.yml lets you move any item to any slot — or place the same item in several slots. Because menus are detected internally rather than by title, every title is editable and works with custom-menu resource packs.
Everything below ships in a single JAR — no add-ons, no upsells.
| Feature | AhxerGuild |
|---|---|
| 10 personal ranks (Bronze → Deity), XP from contracts only | ✓ |
| Per-guild daily contract board with rank selector | ✓ |
| Robust objective tracking (ores, crops, mobs, PvP, more) | ✓ |
| Anti-abuse: placed blocks don't count (configurable) | ✓ |
| Group missions with roles & shared failure | ✓ |
| Collective weekly contract | ✓ |
| Public & private guilds with join requests | ✓ |
| Protected leadership + one co-leader | ✓ |
| Guild plaza teleport & default guild | ✓ |
| Guild competition & monthly hall of fame | ✓ |
| Optional treasury: bank, upkeep, warehouse & vaults | ✓ |
| Smooth progress HUD & a sound on every action | ✓ |
| Re-positionable menus (layout.yml), NxMenu-compatible | ✓ |
| Bilingual English/Spanish, every text editable | ✓ |
| 3-page visual admin panel + custom missions | ✓ |
| PlaceholderAPI, Discord webhook, JSON export/import | ✓ |
With PlaceholderAPI installed, drop these into scoreboards, tab lists or holograms.
%ahxerguild_guild_name%The player's guild name%ahxerguild_guild_tag%Guild tag%ahxerguild_guild_level%Guild level%ahxerguild_guild_members%Member count%ahxerguild_guild_position%Guild leaderboard position%ahxerguild_rank%Personal rank name%ahxerguild_rank_symbol%Personal rank symbol%ahxerguild_xp%Current rank XP%ahxerguild_missions_completed%Contracts completed%ahxerguild_weekly_progress%Weekly contract progressBehaviour lives in config.yml and layout.yml; missions in missions/; all text in messages/<lang>.yml.
# How many contracts each rank shows on its board daily-missions: mode: GUILD # GUILD (shared) or PLAYER (personal) distribution: bronze: 10 iron: 8 silver: 6 gold: 5 diamond: 3 deity: 1
missions: count-placed-blocks: false # placed blocks never count debug: false # console tracking audit # Ores use the BASE name -> counts stone AND deepslate # target: COPPER -> COPPER_ORE + DEEPSLATE_COPPER_ORE # Groups: ANY_ORE, ANY_CROP, ANY_LOG
menus: main: board: 20 # move the board button to slot 20 close: [45, 53] # close button in two corners browser: content: [11,12,13,14,15,19,20,21,22,23] confirm: yes: 11 no: 15
Aliases: /guild for /gremio; /guildadmin & /gadmin for /gremioadmin. Subcommands accept English and Spanish.
| Command | Description | Permission |
|---|---|---|
| /gremio | Open the guild menu | ahxerguild.use |
| /gremio tablon | Board (rank selector) | ahxerguild.use |
| /gremio mision | Your active contract | ahxerguild.use |
| /gremio perfil | Your progression | ahxerguild.use |
| /gremio plaza [set] | Travel to the plaza (or set it: leader/co-leader) | ahxerguild.use |
| /gremio semanal | Weekly contract | ahxerguild.use |
| /gremio info · top | Guild info · leaderboard | ahxerguild.use |
| /gremio chat [message] | Guild chat | ahxerguild.use |
| /gremio salir | Leave the guild (with confirmation) | ahxerguild.use |
| /gremioadmin menu | Live config panel (3 pages) | ahxerguild.admin |
| /gremioadmin board | Reset the daily contracts | ahxerguild.admin |
| /gremioadmin create · delete · transfer | Create, delete or transfer a guild | ahxerguild.admin |
| /gremioadmin coleader · visibility | Set a co-leader · public/private | ahxerguild.admin |
| /gremioadmin default spawn | Set the default guild plaza | ahxerguild.admin |
| /gremioadmin xp <give|take> | Adjust a player's rank XP | ahxerguild.admin |
| /gremioadmin missions · weekly | Reroll/reload boards · weekly contract | ahxerguild.admin |
| /gremioadmin player · reset · reload | Inspect a player · reset data · reload | ahxerguild.admin |
| Permission | Default | Grants |
|---|---|---|
| ahxerguild.use | Everyone | Player menus and commands |
| ahxerguild.create | OP | Found guilds (when config requires it) |
| ahxerguild.admin | OP | Full administration |
| ahxerguild.boost.<key> | — | Reward boost (VIP / store) |
missions.count-placed-blocks: true.messages/<lang>.yml, and you can toggle the language live from the admin panel.layout.yml lets you set the slot of every item in every menu — even the same item in several slots. Menus are detected internally, so titles stay editable and work with custom-menu resource packs.backups/ before any migration.Drop in the JAR and restart — config, layout, language files and missions generate themselves. Then let your players found guilds, take contracts, rank up and compete for the hall of fame.