Guild Plugin

New Features

1. Added guild warehouse, expanding with guild level upgrades (/guild warehouse) 2. Added automatic database backup functionality 3. Added built-in module for simple activity tracking 4. Refactored the plugin's 5 example modules 5. Enhanced the quest module: fixed task issues and added a guild tree for storing quest experience 6. Suppressed non-essential console output to reduce log spam 7. Refactored plugin core: - Hot reload now covers all configurable items - Fixed placeholder issues and optimized placeholder performance - Async and caching improvements 8. Added relation/invite logging, warehouse access logs, and war report export 9. Updated plugin documentation

Other Changes

1. Removed Arabic language support Update Notes: Before updating, it is recommended to manually back up your plugin data. During the update, you need to delete all files and directories except guild.db and guild.db-shm (guild.db-wal is optional — if deleted, it will be regenerated on startup without affecting usage). This ensures all configurations are freshly generated.

Updates: 1. Added compatibility for Minecraft 1.20.x versions 2. Added world management system, allowing arena creation (not available on some Folia versions) 3. Added basic guild war functionality, allowing guild wars to be created 4. Removed teleport restrictions on Folia servers Update Notes: It is recommended to back up your plugin data before updating. You will need to delete the lang folder and config.yml configuration, then restart the server to generate new language files and configuration before making any modifications.

Updates: - Enhanced SDK support for module GUI graphical extensions, including Bedrock form support for module-integrated GUIs (existing over-cap guilds are unaffected). Fixes: - Fixed an issue where guilds could still accept new member join requests even after reaching the member capacity limit.

chore(lang): sync and deduplicate translation files across 27 languages - Complete bedrock-test form keys and 313 bedrock-* GUI keys across 27 languages (31 YAML sections) - Remove duplicate keys in economy, application-mgmt, economy-management, and relation-management sections

Features

- Player type detection (Java / Bedrock) with Geyser reflection - Cumulus form forwarding via BungeeCord proxy - Cross-server message routing with queue buffering - No hard dependency on Geyser — automatic fallback

- Properly reload language files and apply immediately - Add multi-language registerGUIButton overloads to GuildPluginAPI - Refactor button labels to use i18n keys - Core API: GuildPluginAPI.java — added registerGUIButton overload supporting displayNameKey and loreKeys Update notice: Delete all config files except guild.db, guild.db-shm, and guild.db-wal. This requires reconfiguring config.yml and database.yml.

- Fixed invitee name display in invitation notifications - Fixed force delete guild in guild management GUI - Added guild chat feature - Added configurable teleport delay for guild home - Fixed /g applications subcommand Update notice: Delete all config files except guild.db, guild.db-shm, and guild.db-wal. This requires reconfiguring config.yml and database.yml.

- Completely refactored language structure: separated GUI, command, and module messages - Added more languages: German, French, Spanish, Japanese, Korean, Traditional Chinese, Malay, Italian, Dutch, Swedish, Turkish, Vietnamese, Thai, Arabic, Czech, Portuguese, Ukrainian, Romanian, Hungarian, Danish, Finnish, Norwegian (plus custom language file support) - Added 3 new APIs to the SDK (see Wiki for details) - Expanded module marketplace with custom download source support - Fixed command logic and added missing command key values. Update notice: Delete all config files except guild.db, guild.db-shm, and guild.db-wal. This requires reconfiguring config.yml and database.yml.

- Translated plugin config files to English - Fixed return navigation tracking in ConfirmDeleteGuildGUI - Removed redundant closeInventory in admin GUI; replaced hardcoded text with i18n - Replaced hardcoded text in Guild Logs GUI with i18n Note: This update is optional — no critical fixes or major new features.

- Fixed dual-table write logic for deposit records - Added multi-language support for SystemSettingsGUI status - Improved guild funds GUI with dynamic source return - Added guild economy management via GUI - Added skin/head support to GuildDetailGUI - Added admin force transfer owner function; adjusted admin GUI layout - Completed missing multi-language keys

- Fixed force teleport errors in guild teleport command; unified teleport logic - Completed missing multi-language keys - Officially applied member contribution data table - Added guild funds GUI and balance query - Fine-tuned existing GUI layouts - Fixed navigation target when returning from log GUI - Fixed MySQL table creation errors

1. Added a GUI for regular guild members to fix issues preventing members from performing guild teleport and leave guild operations 2. Fixed thread scheduling issues when players leave the guild 3. Fixed skin/head display in the guild member GUI

1. Fixed errors occurring during module loading 2. Fixed download failures caused by duplicate module names 3. Fixed colored log message output 4. Added more necessary notifications/hints

Improved guild search and filter functionality, and fixed various defects in GUI interaction logic.

1. Updated cloud module repository – added ability to view, download, enable, and disable modules. New command: `/guildmodule cloud` 2. Added plugin update checker – use `/guildadmin update` to check for new versions and update 3. Set plugin output language to English for better internationalization 4. Fixed abnormal plugin output

Added version check feature.

Set the default message of the plugin log to English.

feat: add v1.5 SDK API and investment service - New GuildInvestmentService for investment records - New member management API (add/remove/role change) - New economy event dispatch (deposit/withdraw notifications) - New role change event and placeholder extensions - Added investedBalance field to MemberData - Added API test module and Maven build profile

fix skull skin display and Folia teleport compatibility

Added missing language key values.

v1.5.0 Changelog

Version Upgrade Notes

Before using this version, you must delete the following old files; otherwise, configuration loading may encounter issues: - config.yml - messages_br.yml - messages_en.yml - messages_pl.yml - messages_zh.yml ---

New Features

- Guild Level Upgrade Economy Configuration: Added configurable economy requirements for guild level upgrades in config.yml. - No Economy Plugin Support: Allows the guild plugin to function normally even when no economy plugin is enabled. ---

Improvements & Fixes

- Tag Color Scope Restriction: Removed square brackets and appended a reset code at the end, finally escaped by ColorUtils.colorize(). Synchronized updates were made to the Guild Info GUI and PlaceholderUtils. - GUI Layout Unification & Code Optimization: Adjusted the layout of the following GUI classes to unify layout logic and optimize code readability: - ApplicationManagementGUI - CreateRelationGUI - EconomyManagementGUI - GuildInfoGUI - GuildListManagementGUI - GuildRelationsGUI - GuildSettingsGUI - InviteMemberGUI - KickMemberGUI - PromoteMemberGUI - RelationManagementGUI - Language File Completion: Completed missing key values in the following language files: - messages_br.yml - messages_en.yml - messages_pl.yml - messages_zh.yml ---

Version Notes

This version includes all updates from v1.4.7, v1.4.8, and v1.4.9. It is recommended that all users upgrade to this version.

Allow guild plugin to work without an economy plugin enabled.

Fixed numerous GUI display issues and fixed some language files.

Fixed multiple GUI display issues and corrected several language files.

Fixed Folia compatibility

Fixed internal variable display issues. Everyone should update to this version – please delete old language configs; new ones will be auto-generated on startup/reload. For custom language configs, ensure: 1. Update message keys as per v1.4.4 2. Add any missing keys by comparing with the new version If needed, use translation tools to convert `messages_zh.yml` into your local language config.

Fixed an issue where internal GUI variables were displayed incorrectly. It is recommended to delete the language file and reload the plugin to regenerate the fixed language config. If using your own custom language config, please review the detailed fixes for the corresponding version on GitHub and apply them manually. You can also submit an issue with your language config file attached, and we will add core support and maintenance for that language.

Fixed loading of external multi-language support.

Updated the SDK. This is a transitional version; it is recommended to update to the latest version later.

Updated the SDK. This is a transitional version; it is recommended to update to the latest version later.

**Completed the second module "member-rank" with full member contribution value management functionality. Main command: /guildmodule The module has been added to the file for download and trial. First, add modules-member-rank.jar to \plugins\GuildPlugin\modules, then either run the command /guildmodule load modules-member-rank.jar or restart the server to load the module. Finally, you can use the member contribution value management feature in the GUI.** Download link for the modules-member-rank module: [modules-member-rank.jar](https://github.com/chenasyd/-GuildPlugin/releases)

**Completed the first module "announcement" with full announcement management functionality. Main command: /guildmodule The module has been added to the file for download and trial. First, add modules-announcement.jar to \plugins\GuildPlugin\modules, then either run the command /guildmodule load announcement.jar or restart the server to load the module. Finally, you can use the announcement management feature in the GUI.** Download link for the modules-announcement module:[modules-announcement.jar](https://github.com/chenasyd/-GuildPlugin/releases)

- Fixed log variable mapping {0} - Build module framework

Fixed asynchronous call error when shutting down Folia

#### Fully Supported Languages - Chinese (zh) - English (en) - Polish (pl)

#### Multilingual GUI Update Summary - 11 GUI interfaces now support multilingual titles - 3 language files ~20 GUI definitions - ~15 GUI classes modified to unify text retrieval - 3 message files added for broader localization - Original `gui.yml`and`messages.yml` removed; version unchanged, fully functional

Fixed some minor issues. Updated the GUI. Important: To use this version, you must delete the old gui.yml file, otherwise the new GUI will not work.

- All deletion operations now use a confirmation GUI. - Full permission verification and error handling implemented. - Safe and stable teleportation in Folia environments. - Backward compatibility is maintained.

v1.2.4: Improved the plugin's visual display by assigning a distinct color to each member role.

Fully adapted for Folia while maintaining compatibility with major plugin platforms. Fixed how timestamps are stored in the database. The author needs to return to focus on studies for now. Due to limited availability, I may not be able to respond to issues or messages on other platforms promptly. There will also be no further plugin updates in the short term. If urgent modifications are needed, please feel free to adjust the source code directly. The latest code has been pushed to GitHub.

Critical Fixes & Improvements

GUI Stability Fixes - Automatically close guild menus when a guild is deleted to prevent players from browsing deleted guild data (avoids null reference errors). Permission System Overhaul - Fixed an issue where permissions configurations in config.yml were not being loaded by the PermissionManager. - Fully migrated hardcoded permission mappings to configuration-driven architecture. - Enhanced PermissionManager to now dynamically read permission matrices from ConfigManager (via config.yml). - All menu permission checks now strictly follow the centralized config.yml permissions. Database Configuration Update - Revamped database.yml implementation logic. - ⚠️ Breaking Change: Deprecated database configurations in config.yml (now exclusively managed via database.yml). Upgrade Instructions 1. Mandatory: Delete existing config.yml and database.yml to allow clean regeneration. 2. New files will auto-generate with optimized defaults on server restart.

工会插件 (Guild)

一个功能完整的Minecraft工会系统插件，支持工会创建、成员管理、经济系统、关系管理等功能。

功能特性

核心功能

- 工会创建与管理: 支持工会创建、删除、信息查看 - 成员管理: 邀请、踢出、提升、降级成员 - 权限系统: 基于角色的权限管理（会长、官员、成员） - GUI界面: 完整的图形用户界面，操作便捷 - 经济系统: 工会资金管理、存款、取款、转账 - 等级系统: 工会等级提升，增加成员上限 - 关系管理: 工会间关系（盟友、敌对、中立、开战、停战） - 工会家: 设置和传送到工会家 - 申请系统: 玩家申请加入工会

高级功能

- 异步处理: 所有数据库操作均为异步，不影响服务器性能 - 多数据库支持: 支持SQLite和MySQL - 占位符支持: 集成PlaceholderAPI - 经济集成: 通过Vault支持多种经济插件 - 权限集成: 与Bukkit权限系统完全集成

GUI界面

主界面

- 创建工会: 创建新的工会 - 工会信息: 查看当前工会信息 - 成员管理: 管理工会成员 - 申请管理: 处理加入申请 - 工会设置: 修改工会设置 - 工会列表: 查看所有工会 - 工会关系: 管理工会关系

创建工会界面

- 工会名称输入: 设置工会名称（3-20字符） - 工会标签输入: 设置工会标签（最多6字符，可选） - 工会描述输入: 设置工会描述（最多100字符，可选） - 确认创建: 支付费用创建工会 - 取消: 返回主界面

成员管理界面

- 成员列表: 显示所有成员 - 邀请成员: 邀请新成员 - 踢出成员: 踢出现有成员 - 提升成员: 提升成员职位 - 降级成员: 降级成员职位

经济系统

功能特性

- 工会资金: 每个工会独立的资金账户 - 存款系统: 成员可以向工会存款 - 取款系统: 成员可以从工会取款 - 转账系统: 工会间资金转账 - 贡献记录: 记录每个成员的贡献 - 等级升级: 资金达到要求自动升级

基础工会信息变量

工会基本信息

- %guild_name% - 工会名称 - %guild_tag% - 工会标签 - %guild_membercount% - 工会成员数量 - %guild_maxmembers% - 工会最大成员数 - %guild_level% - 工会等级 - %guild_balance% - 工会余额（保留2位小数） - %guild_frozen% - 工会状态（正常/已冻结/无工会）

玩家在工会中的信息

- %guild_role% - 玩家在工会中的角色（会长/官员/成员） - %guild_joined% - 玩家加入工会的时间 - %guild_contribution% - 玩家对工会的贡献度

工会状态检查变量

玩家状态

- %guild_hasguild% - 玩家是否有工会（是/否） - %guild_isleader% - 玩家是否是会长（是/否） - %guild_isofficer% - 玩家是否是官员（是/否） - %guild_ismember% - 玩家是否是工会成员（是/否）

工会权限检查变量

权限状态

- %guild_caninvite% - 是否可以邀请玩家（是/否） - %guild_cankick% - 是否可以踢出成员（是/否） - %guild_canpromote% - 是否可以提升成员（是/否） - %guild_candemote% - 是否可以降级成员（是/否） - %guild_cansethome% - 是否可以设置工会传送点（是/否） - %guild_canmanageeconomy% - 是否可以管理工会经济（是/否）