Addict-O-Guild

Granular Guilds, claimed territory protection, WoW-Style Guild Bank with live-sync & audit logs!


⭐ What is Addict-O-Guild?
Addict-O-Guild is a premium-grade guild management and territory protection plugin designed for modern Spigot servers. It allows players to create guilds, invite members, assign custom block permissions per role, and claim land chunks.

It features a complete MMO WoW-Style Guild Bank System with 7 unlockable tabs, rank-based tab permissions, real-time visual movement syncing between viewers, and administrative database log auditing. It also features dual-storage backend capabilities (YAML flat files or remote MySQL), interactive land boundary crossing notifications, PVP friendly-fire settings, and quick private guild chat (`/g`).

✨ Key Features

• WoW-Style Guild Bank: Set a targeted chest (single or trapped) as the guild's central bank chest with /aog setbank. An option in config.yml allows admins to restrict players from setting their own chests.
• ️ General / Public Guild Bank: Administrators can set a public chest (e.g. at spawn or in town) using /aog setpublicbank. Right-clicking it lets any player access their own guild's bank, facilitating shared community bank zones!
• Sequentially Unlockable Tabs: 7 tabs in total. Tab 1 is free, and Tabs 2-7 can be unlocked sequentially by the Leader by paying a custom price from Vault economy.
• Rank-Based Tab Access Checkboxes: The leader can toggle Member and Officer access checkboxes directly from the GUI (bottom row) for each tab independently.
• Live GUI Inventory Sync: Multiple players viewing the same tab see item moves, deposits, and withdrawals in real-time.
• Complete Audit Logging (Toggleable): Every single deposit and withdrawal is logged with timestamps and player details to a local bank_logs.txt file and a dedicated MySQL table (addict_guild_bank_logs) for administration archives (not queryable in-game). Can be fully enabled or disabled in config.yml.
• Granular Custom Permissions: Guild leaders can customize block building, block interaction, and container opening permissions independently for each guild role (Leader, Officer, Member).
• Adjacency-restricted Claiming: Claiming territory uses chunk boundaries. The first claim can be anywhere, but subsequent claims MUST connect to an existing guild chunk (up to 10 max by default).
• Dual Backend Storage: Save all guild data and claims locally in YAML files or link them to a high-speed remote MySQL database with tables auto-generated at startup.
• Immersive Territory Notifications: Real-time ActionBar notification alerts players whenever they cross chunk borders from Wilderness into guild territory or vice versa.
• Private Guild Chat Channel: Speak directly in guild chat with /g <message> or toggle chat mode with /aog chat.
• Anti-Friendly Fire: Toggle PVP damage between guild members in the main configuration.
• Full Translation Support (i18n): Clean translation dictionaries (English & French pre-configured) with automatic fallbacks.

Commands & Permissions

Commands:

• /aog create <name> - Creates a new guild with the given name (spaces allowed).
• /aog invite <player> - Invites a player to join your guild.
• /aog join <guild> - Accepts a pending invitation.
• /aog kick <player> - Kicks a member out of the guild.
• /aog leave - Leaves your current guild.
• /aog promote <player> - Promotes a member to the next role (supports leader delegation).
• /aog demote <player> - Demotes an officer to a member.
• /aog claim - Claims the chunk you are standing on.
• /aog unclaim - Unclaims the chunk you are standing on.
• /aog unclaimall - Unclaims all guild chunks.
• /g <message> - Speak instantly in private guild chat.
• /aog chat - Toggles private guild chat channel for normal typing.
• /aog setperm <role> <perm> <true/false> - Modifies access controls for a specific role (BUILD, INTERACT, CONTAINER).
• /aog setbank - Sets the targeted chest (single/trapped) as the guild's bank (Leader only, must be inside guild claim).
• /aog setpublicbank - Sets the targeted chest as a general/public guild bank (Admin only).
• /aog bypass (Alias: /aog buypass) - Toggles administrator bypass mode.
• /aog info [guild] - Views detailed statistics, claims, and role lists of a guild.
• /aog list - Lists all registered guilds on the server.
• /aog reload - Reloads configuration files and re-initializes databases.
• /aog border - Displays particle effects around your guild's territory perimeter for 10 seconds.

Permissions:

• addictoguild.use - Access to all player guild commands. (Default: true)
• addictoguild.admin - Access to administrative reload commands. (Default: op)
• addictoguild.admin.bypass - Access to toggle administrator bypass mode. (Default: op)

⚙️ Installation Instructions

• Make sure Vault and a compatible economy provider are installed.
• Place Addict-O-Guild-1.1.1.jar in the /plugins/ directory.
• Restart your server to generate configurations.
• (Optional) Edit config.yml and switch mysql.enabled to true if you wish to use a MySQL database.
• Reload the plugin with /aog reload and create your guild!