ChaLib [1.8 - 26.1]

Support & Feedback
If you have any questions, encounter any issues, or have suggestions for improvements, feel free to reply directly below on this resource page.
Bug reports, feedback, suggestions, and feature ideas are always welcome.

Overview
ChaLib is the official shared library and core dependency for the Cha plugin series.
It provides a unified foundation for plugins in the series by including shared utilities, reusable methods, core systems, internal support functions, and developer-oriented APIs.

This plugin is intended to work as a backend dependency rather than a standalone gameplay plugin.
If another Cha plugin requires ChaLib, it must be installed in order for that plugin to work properly.

In the current version, ChaLib also provides a number of practical core functions used throughout the Cha ecosystem, including command parsing, GUI compatibility wrappers, database integration, scheduler utilities, economy/region adapters, config wrappers, cache tools, and reusable custom events.

Included Core Support
ChaLib includes shared systems such as:

• Utility methods
• Helper functions
• Internal APIs
• Core plugin logic
• Compatibility support
• Shared backend handling
• Reusable common functions for Cha plugins
• Developer API events
• Config and language wrappers
• Cache and scheduler utilities

The exact usage of these systems depends on which Cha plugins you are running.

Key Features

• Unified command framework with tab completion and automatic help pages
• GUI compatibility layer for GermPlugin and DragonCore
• MySQL + Hibernate + Druid integration with optional shared connection pools
• Quartz scheduler integration with optional JDBC persistence
• Serialized task queue manager for sync/async operations
• Economy adapters: Vault, PlayerPoints, XConomy, NyEconomy
• Region adapters: World, LocationBox, WorldGuard, Residence
• Config and lang wrapper APIs (ConfigYaml, LangYaml, ConfigYamlFolder)
• Timed cache utilities for global and player-scoped data
• Custom core events for plugin developers

Commands
Permissions Model
This plugin currently uses sender-role control in code:

• Player only
• OP only
• Console only
• OP or Console

No standalone permission nodes are currently declared in plugin.yml for command branches.

Dependency Notice
Some Cha plugins require ChaLib to be installed before they can load correctly.
Please check the dependency information on each plugin page.

Installation

1. Put the ChaLib jar into your server's plugins folder
2. Install any optional dependency plugins required by your actual feature usage
3. Start the server once to generate config files
4. Edit config.yml based on your environment
5. Use /chalib reload after changes

Make sure you are using the correct version combination for your server and dependent Cha plugins.

Configuration
Default config:
Config notes:

• database.enable: enables core MySQL connection bootstrap
• database.share: enables shared pool mode
• addon-event: enables extra high-frequency events (tick / async tick / jump / day-change)
• quartz-persistence: enables Quartz JDBC job store and requires ChaCoreMysql
• pool-size exists in config, but may not yet be fully wired into the current core bootstrap flow

Developer API Events
Usage Notes

• Enable addon-event only when needed due to per-tick event overhead
• CommandUtil supports delayed command chains and conditional syntax with "<>" separator
• BungeeCord utility requires plugin messaging channel setup in your own plugin flow
• LangYaml placeholder parsing depends on PlaceholderAPI

Compatibility

• Build target: Java 8
• Tested base: Spigot 1.21.4
• Use on other versions only after your own compatibility testing

Important
ChaLib is not meant to be used as a standalone gameplay plugin.
Its main purpose is to support other plugins in the Cha series.

If you install ChaLib by itself, you may not see direct player-facing features.