Streaker

Streaker is a production-ready Paper/Purpur plugin that adds daily login streaks, milestone rewards, animated inventory GUI, PlaceholderAPI placeholders, async SQL persistence, Caffeine caching, and HikariCP pooling.

Features

• Daily streak claims based on the server timezone.
• Configurable reset grace for missed days.
• Reward milestones such as 7, 14, 30, 60, and 100 days.
• Multiple reward commands, chance, multipliers, messages, and conditions.
• SQLite, MySQL, and MariaDB support.
• Async database operations with prepared statements.
• Caffeine cache and debounced batched profile saves.
• Animated configurable GUI designs.
• PlaceholderAPI expansion.
• JUnit 5 and MockBukkit test setup.

Commands

Placeholders

Installation

1. Build with ./gradlew build.
2. Put build/libs/Streaker-1.0.0.jar into the server plugins folder.
3. Start the server once to generate configs.
4. Edit config.yml, database.yml, rewards.yml, messages.yml, and menus.yml.
5. Run /streak reload or restart the server.

Configuration

Primary files:

• config.yml controls timezone, claim behavior, cache, write-behind, notifications, and leaderboard size.
• database.yml selects SQLite, MySQL, or MariaDB and tunes HikariCP.
• rewards.yml defines milestone rewards.
• menus.yml defines GUI layouts.
• messages.yml defines MiniMessage output.

Example reward:

rewards:
  30:
    name: "<gradient:#ff512f:#f09819>Monthly Inferno</gradient>"
    icon: "CHEST"
    chance: 100.0
    multiplier: 1.0
    commands:
      - "crate key give %player% legendary 1"

API

RuntimeContext implements StreakerApi:

CompletableFuture<StreakProfile> profile(UUID uuid, String playerName);
CompletableFuture<ClaimResult> claim(Player player);
CompletableFuture<StreakProfile> setStreak(UUID uuid, String playerName, int value);

Documentation

• Architecture
• Database
• GUI
• Optimization
• Media prompts
• Project audit

FAQ

Does Streaker block the main thread?
No. SQL and config IO run asynchronously. Bukkit-only work is returned to the main thread.

Can rewards run more than once for the same milestone?
No. Reward history has a unique key per player, reward, and streak day.

Can I use PlaceholderAPI in commands?
Yes. Install PlaceholderAPI and keep rewards.placeholderapi enabled.

Roadmap

• Redis sync for multi-server networks.
• Web dashboard.
• Seasonal reward campaigns.
• In-game GUI editor.

Support

Open an issue with your Paper version, Streaker version, database type, config snippet, and relevant logs.