CSX Keyall
CSX KeyAll is a lightweight, high-performance auto-reward plugin for Minecraft servers (Spigot/Paper 1.21.x) that automates global giveaway countdowns with MySQL (HikariCP) pooling, anti-crash SQLite storage, and full PlaceholderAPI integration.
Описание
CSX KeyAll
High-Performance Automated KeyAll System for Minecraft Servers
Lightweight, modern, and database-safe KeyAll scheduler designed for Paper-based Minecraft servers.
Built with asynchronous processing, PlaceholderAPI integration, multi-language support, countdown persistence, and optimized database handling.
Features • Requirements • Installation • Configuration • Commands • Permissions • Building • Troubleshooting • License
✨ Features
⏰ Automated Countdown System
- Fully automated KeyAll execution
- Persistent countdown storage
- Crash-safe timer recovery
- Millisecond precision timing
- Manual execution support
🗄 Database Support
| Database | Supported |
|---|---|
| SQLite | ✅ |
| MySQL | ✅ |
| H2 (Legacy) | ✅ |
Database Features
- HikariCP Connection Pooling
- Async Database Queries
- Automatic Storage Detection
- Smart Database Migration
- H2 → SQLite Auto Conversion
🌎 Localization
- Multi-language Support
- Indonesian Language Included
- English Language Included
- Fully Customizable Messages
🔌 PlaceholderAPI Integration
Available Placeholders:
%csxkeyall_time%
%csxkeyall_seconds%
%csxkeyall_minutes%
Compatible With:
- TAB
- Scoreboards
- Holograms
- ActionBars
- BossBars
📋 Requirements
| Software | Version |
|---|---|
| Minecraft | 1.21.x |
| Java | 21+ |
| Paper | Supported |
| Purpur | Supported |
| Spigot | Supported |
| PlaceholderAPI | Optional |
📥 Installation
1. Download Plugin
Place:
csx-keyall-1.0.jar
inside:
/plugins/
2. Start Server
Start the server once.
The plugin will automatically generate:
/plugins/CSX-Keyall/
3. Configure Plugin
Edit:
config.yml
Configure:
- Database
- Commands
- Language
- Interval
4. Reload
/keyall reload
or restart the server.
⚙️ Configuration
Example:
database:
type: "SQLITE"
host: "localhost"
port: 3306
name: "minecraft"
username: "root"
password: ""
ssl: false
lang: "id"
interval-millis: 3600000
commands-list:
- "crate giveall vote 1"
- "bc &b&lCSXID &7» &aEveryone has received 1x Vote Key!"
📖 Commands
| Command | Description | Permission |
|---|---|---|
| /keyall info | View remaining countdown | keyall.use |
| /keyall reset | Reset countdown | keyall.admin |
| /keyall set-time | Modify timer | keyall.admin |
| /keyall cmd | Force execute KeyAll | keyall.admin |
| /keyall reload | Reload configuration | keyall.admin |
🔐 Permissions
| Permission | Default | Description |
|---|---|---|
| keyall.use | true | Access player commands |
| keyall.admin | op | Access admin commands |
🛠️ Building From Source
Clone Repository
git clone https://github.com/COSAX-ID/CSX-Keyall.git
cd CSX-Keyall
Build
mvn clean package
Output:
target/csx-keyall-1.0-SNAPSHOT.jar
📂 Project Structure
CSX-KeyAll/
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── dev/cosax/csxkeyall/
│ │ └── resources/
│ │ ├── plugin.yml
│ │ ├── config.yml
│ │ └── lang/
│ │ ├── en.yml
│ │ └── id.yml
│ └── test/
├── pom.xml
└── README.md
🔧 Troubleshooting
PlaceholderAPI Not Working
Make sure:
- PlaceholderAPI is installed
- Server has been restarted
- Expansions are loaded correctly
MySQL Connection Failed
Check:
- Host
- Port
- Username
- Password
- Firewall Settings
Countdown Reset After Restart
Ensure the plugin has permission to write data inside:
/plugins/CSX-KeyAll/
👨💻 Credits
Developed By
| Role | Name |
|---|---|
| Organization | COSAX.ID |
| Lead Developer | COSAXID |
| Developer | minggudev |
GitHub
📜 License
This project is licensed under the MIT License.
For more information, see the LICENSE file.
⭐ Support
If you enjoy using CSX KeyAll, please consider giving this repository a star.
Your support helps future development and maintenance.