ВЕРСИИ (2)

# NewGenTeam 1.1.0 > **Release date:** September 4, 2026 > **Minecraft:** Paper 26.2+ > **Java:** 25+ ## Platform & Build Updates * Upgraded **Paper API** from `1.21.4-R0.1-SNAPSHOT` to `26.2.build.121-stable`. * Minecraft 26.2 adopts Mojang's new year-based versioning scheme introduced in 2026. * Upgraded **PacketEvents** from `2.11.2` to `2.13.0`. * Upgraded the **Java toolchain** from `21` to `25`. * Paper 26.2 requires **JVM 25 or newer**. * Upgraded **Gradle Wrapper** from `8.10.2` to `9.7.1`. * Upgraded **Shadow Gradle Plugin** from `8.3.5` to `9.6.1`. * Required for proper handling of Java 25 bytecode (class major version 69). * Updated plugin version from `1.0.0` to `1.1.0`. * Kept `api-version: '1.21'` to maintain compatibility across the **1.21+ and 26.x** version lines. ## Sign Input The Sign Input system has been significantly improved for large servers, with a focus on reliability and performance. ### Session Timeout * Added a **60-second timeout** for every sign input session. * Sessions are automatically cancelled if the client does not send an `UPDATE_SIGN` packet. * The original block is restored automatically. * The callback receives `null` when a session expires. * Prevents abandoned sessions from remaining in memory indefinitely. ### Ghost Sign Fix * Fixed an issue where cancelling a sign input session could leave a **ghost sign** visible on the client. * `cancel()` now always sends the original block state back to the player when they are still online. * Offline players are safely ignored, maintaining Folia compatibility. ### Race Condition Protection * Added atomic `ConcurrentHashMap.remove(key, value)` handling. * Prevents timeout handlers and packet responses from processing the same session simultaneously. * Guarantees that a session callback cannot be triggered twice. ### Input Sanitization Client-provided sign input is now sanitized: * Maximum length: **64 characters** * Removes the legacy color character `§` * Removes control characters * Protects against maliciously crafted client input ### Performance Improvements * Cached the global ID of `OAK_SIGN` instead of repeatedly calling `SpigotConversionUtil`. * Added an early fast-path in `onPacketReceive` before parsing the packet wrapper. * Sign packet processing now has virtually zero overhead for normal player traffic. ## Bug Fixes ### Team Chat Color Injection Fixed a security and formatting issue in `ChatService`. Previously, players could inject legacy color or formatting codes such as: * `&c` * `§a` * `&k` into team chat messages, potentially changing the color or formatting of the entire message. Team chat input is now sanitized before being inserted into the chat format. ### Code Cleanup * Removed the unused `ChatInputService`. * The project exclusively uses `SignInputService` for sign-based input. ## Known Issues ### `TeleportFlag.EntityState.RETAIN_PASSENGERS` `TeleportFlag.EntityState.RETAIN_PASSENGERS` in `HomeService` is marked **deprecated-for-removal** in Paper 26.2. There is currently no replacement constant available that provides the same intended behavior. The flag is therefore intentionally retained because it remains the correct option for team home teleportation.

# NewGen Team Modern Team, Faction & Guild plugin for **Paper 1.21+** and **Folia**, built on **Java 21**. NewGen Team is designed for modern Minecraft servers, providing a configurable, high-performance and developer-friendly team system. Every aspect of the plugin—from GUI layouts and messages to themes and gameplay settings—is fully configurable through YAML files without requiring recompilation. --- ## Features - ✅ Fully configurable GUI layouts - ✅ Team, Faction & Guild management - ✅ Async database operations - ✅ SQLite, MySQL, MariaDB & PostgreSQL - ✅ HikariCP connection pooling - ✅ PlaceholderAPI expansion - ✅ Vault economy support - ✅ PlayerPoints integration - ✅ Theme system powered by MiniMessage - ✅ Vietnamese & English language support - ✅ Developer API - ✅ Bukkit Events - ✅ Folia native support - ✅ Daily logging system - ✅ Java 21 --- <details> <summary><b>Configuration System</b></summary> Everything inside NewGen Team is configurable. ``` plugins/ └── NewGenTeam/ ├── config.yml ├── settings.yml ├── levels.yml ├── homes.yml ├── chest.yml ├── database.yml ├── hooks.yml ├── logs.yml ├── theme.yml ├── lang/ │ ├── en_US.yml │ └── vi_VN.yml └── menus/ ``` Configuration files are automatically generated on first startup. Missing options are merged automatically after updates while preserving administrator changes. </details> --- <details> <summary><b>GUI System</b></summary> Every inventory interface is fully configurable. Supported options include: - Item position - Material - Glow - Custom Model Data - Permission - Enable / Disable - MiniMessage formatting - Theme tokens GUI text is completely separated into language files. No Java knowledge required. </details> --- <details> <summary><b>Theme System</b></summary> NewGen Team uses a centralized theme configuration. Supported tokens: ``` <primary> <secondary> <accent> <success> <warning> <danger> <info> <muted> ``` Changing a single color updates every GUI, title and message throughout the plugin. Legacy color codes are not used. </details> --- <details> <summary><b>Language System</b></summary> Currently supported languages: - English (en_US) - Vietnamese (vi_VN) Language can be changed inside: ``` config.yml ``` Missing translations automatically fall back to English. New language files can be added without modifying the plugin. </details> --- <details> <summary><b>Database</b></summary> Supported storage providers: - SQLite - MySQL - MariaDB - PostgreSQL Powered by HikariCP connection pooling. Features: - Async queries - Automatic reconnect - Safe SQLite fallback - Zero blocking database operations on the main thread </details> --- <details> <summary><b>Performance</b></summary> NewGen Team is designed for high-performance servers. Features include: - Async storage - Memory cache - HikariCP pooling - Optimized scheduler - Folia compatible - Cached PlaceholderAPI values - No unnecessary database queries Suitable for both small SMP servers and large networks. </details> --- <details> <summary><b>PlaceholderAPI</b></summary> Identifier: ``` newgenteam ``` Examples: ``` %newgenteam_name% %newgenteam_name_display% %newgenteam_tag% %newgenteam_role% %newgenteam_owner% %newgenteam_members% %newgenteam_members_max% %newgenteam_online% %newgenteam_level% %newgenteam_bank% %newgenteam_kills% %newgenteam_deaths% %newgenteam_kdr% %newgenteam_rank% ``` Every placeholder uses cached values. No database query is executed while requesting placeholders. </details> --- <details> <summary><b>Plugin Integrations</b></summary> Supported integrations: | Plugin | Purpose | |----------|----------| | PacketEvents | Required | | Vault | Team Economy | | PlayerPoints | Team Upgrades | | PlaceholderAPI | Placeholders | Each integration can be enabled or disabled individually inside: ``` hooks.yml ``` </details> --- <details> <summary><b>Logging System</b></summary> Daily log files are automatically generated. ``` logs/ ├── admin/ ├── daily/ ├── errors/ └── transactions/ ``` Debug mode is available for troubleshooting. </details> --- <details> <summary><b>Developer API</b></summary> NewGen Team provides a clean Bukkit API. Available events <details> <summary>Spoiler</summary> -  </details> include: ``` TeamCreateEvent TeamDeleteEvent TeamJoinEvent TeamLeaveEvent TeamKickEvent TeamLevelUpEvent BankDepositEvent BankWithdrawEvent ``` Designed for addon developers. </details> --- <details> <summary><b>Compatibility</b></summary> Supported server software: - Paper - Folia - Purpur Minecraft: - 1.21.4+ - Future 1.21.x releases Java: - Java 21 </details> --- ## Screenshots Screenshots below demonstrate several parts of the plugin. - Main Menu - Team Menu - Admin Menu - Team Bank - Team Home - Team Levels - Settings - Theme System --- ## Commands ``` /team /t /faction /f /guild /g ``` Includes support for creating teams, inviting players, team homes, chat, administration and configuration reloading. --- ## Support Discord https://discord.gg/P3NSwtJ2aw --- ## Building Windows ```bash gradlew.bat build ``` Linux / macOS ```bash ./gradlew build ``` Compiled jars are generated inside: ``` build/libs/ ``` --- ## License All Rights Reserved unless otherwise specified. --- Thank you for choosing **NewGen Team**.