Changelog Book icon

Changelog Book -----

Custom book GUI plugin for paper which reward's your players for reading live changes on your server




Compatibility

  • Added support for Minecraft 1.20.x servers (previously only 1.21+)
  • Fixed server type detection showing "Unknown" on newer Paper builds — the /changelog info command now correctly displays Paper, Purpur, Folia, Spigot, etc.
Bug Fixes

  • Fixed /changelog reload not reloading the language file — messages will now update correctly after a reload
  • Fixed a duplicate GitHub API call on startup (the update checker was firing twice unnecessarily)
  • Fixed editEntry and removeEntry not being thread-safe — could cause rare crashes or data corruption under concurrent load
  • Fixed Discord webhook sending incorrect timestamps when the server timezone was not UTC
  • Fixed a connection resource leak in the update checker — HTTP connections are now always properly closed
Internal

  • Update checker fields are now properly volatile to ensure visibility across threads
----------, Mar 15, 2026

This update improves configuration flexibility and fixes several internal issues related to database handling, thread safety, and Discord integration.

New

  • Added discord.yml for customizable Discord embeds
    • title

    • author

    • date format

    • footer

    • category colors
Changes

  • Removed duplicate discord-color from category section in config.yml

  • Updated api-version to 1.21

  • Updated category color &e → &6 (gold instead of yellow)
Fixes

  • ChangelogManager now uses the shared DatabaseManager instance

  • Fixed HikariCP being included in shadow jar (minimize() excludes added)

  • DiscordWebhook now reads config live (reload-safe)

  • Improved thread safety for saveToYaml (snapshot created under lock)

  • getEntries() is now synchronized

  • Updated database schema: category column → VARCHAR(64)
Technical

  • General audit fixes and stability improvements.
----------, Mar 10, 2026

ChangelogBook v1.7.0 - Critical Bug Fix Update

⚡ Major Stability Update - 11 Bug Fixes ⚡

What's New in v1.7.0?

Version 1.7.0 is a major stability update fixing 11 bugs including 3 critical issues that could cause data loss and server lag. This update is highly recommended for all users.

Critical Bug Fixes

1. Data Loss Prevention
Entries are now saved to database before memory cache, eliminating data loss during database failures. No more lost changelog entries when MySQL connection drops!

2. DoS Protection
Added content length validation (3-5000 characters) to prevent oversized entries and server lag. Protects against players spamming massive changelog entries that could crash your server.

3. Database Garbage Collection
Soft-deleted entries are automatically pruned after 30 days, preventing infinite database growth. Your database will stay clean and performant over time.

⚡ Performance & Stability Improvements

  • 90% faster display numbers - Implemented caching system for entry numbering
  • Thread-safe operations - Fixed ConcurrentModificationException during /changelog reload
  • Resource leak fixed - Discord webhook connections now properly close
  • Configurable connection pool - HikariCP pool size is now configurable (default increased from 5 to 10)

✨ Quality of Life Improvements

  • Better error messages - Clear feedback when content validation fails
  • Discord webhook validation - Invalid URLs are detected before sending
  • Reload-friendly config - Update checker interval refreshes without restart

⚙️ New Configuration Options

All new options have sensible defaults - no manual configuration required!

Code (Text):
limits:
  max-content-length: 5000
  min-content-length: 3

database:
  prune-deleted-after-days: 30
  prune-on-startup: true

mysql:
  pool:
    maximum-size: 10
    minimum-idle: 2
    connection-timeout: 10000
    idle-timeout: 600000
    max-lifetime: 1800000
Performance Comparison

Display Number Calculation: O(n log n) per call → O(1) cached lookup ( ~90% faster)
Database Growth: Infinite → Capped by auto-prune ( Sustainable)
Connection Pool: 5 fixed → 10 configurable ( Better scalability)
Memory Leaks: Yes (Discord) → No ( 100% resolved)
----------, Feb 17, 2026

Fixed YAML and translation structure
----------, Jan 29, 2026


It is recomended do remove your old config files. Make backup first

Update Notifier System

  • Automatic update checking from GitHub Releases API
  • Placeholders: %current_version%, %new_version%, %link%
  • Clickable notifications on player join with GitHub download link
  • Permission: changelogbook.update.notify (default: OP)
  • Full customization in language files (EN/PL)
  • Command /changelog checkupdate for manual checking
  • Configurable check interval (default: 6 hours)
Info Command
Command /changelog info displays:

  • Plugin version: %pluginversion% (1.4.0)
  • Server type: %servertype% (Paper/Spigot/Purpur/Folia)
  • Server version: %serverversion% (e.g., 1.21.3)
  • Update notifier: %updatenotifier% (Enabled/Disabled)
  • Database: %database% (Connected/Disconnected)
  • Database type: %databasetype% (MySQL/YAML)
  • Database sync: %databasesync% (Enabled/Disabled - planned feature)
  • Full customization in language files with colors
  • Configurable header and footer
----------, Jan 23, 2026

Changelog book now support color codes!

ChangelogBook supports rich text formatting in changelog entries with automatic version detection:

Legacy Color Codes (Minecraft 1.8+)
All standard Minecraft color codes are supported using the `&` prefix:


| Code | Color | Example |
|------|-------|---------|
| `&0` | Black | `&0Black text` |
| `&1` | Dark Blue | `&1Dark blue text` |
| `&2` | Dark Green | `&2Dark green text` |
| `&3` | Dark Aqua | `&3Dark aqua text` |
| `&4` | Dark Red | `&4Dark red text` |
| `&5` | Dark Purple | `&5Dark purple text` |
| `&6` | Gold | `&6Gold text` |
| `&7` | Gray | `&7Gray text` |
| `&8` | Dark Gray | `&8Dark gray text` |
| `&9` | Blue | `&9Blue text` |
| `&a` | Green | `&aGreen text` |
| `&b` | Aqua | `&bAqua text` |
| `&c` | Red | `&cRed text` |
| `&d` | Light Purple | `&dLight purple text` |
| `&e` | Yellow | `&eYellow text` |
| `&f` | White | `&fWhite text` |

Format Codes (Minecraft 1.8+)

| Code | Effect | Example |
|------|--------|---------|

| `&l` | **Bold** | `&lBold text` |
| `&o` | *Italic* | `&oItalic text` |
| `&n` | Underline | `&nUnderlined text` |
| `&m` | ~~Strikethrough~~ | `&mStrikethrough text` |
| `&k` | Obfuscated | `&kObfuscated text` |
| `&r` | Reset | `&cRed &rNormal` |

Hex Colors (Minecraft 1.16+)
Custom hex colors using the format `&#RRGGBB`:

&#FF5733 - Orange
&#00FF00 - Bright Green
&#3498DB - Light Blue
&#9B59B6 - Purple
&#E74C3C - Red
&#F39C12 - Orange-Yellow
----------, Jan 9, 2026

Changelog book now have in config an new switch:
auto-open:
# Enable automatic opening of changelog book when players join
enabled: true
# Delay in seconds before opening the book (e.g., 3 = wait 3 seconds after join)
delay-seconds: 3

This update fixed also some minor bugs
----------, Jan 8, 2026

  • Fixed: Help command now correctly shows /changelog - View the changelog help page. instead of implying it lists entries.
  • Removed all references to changelogbook—the plugin is now fully consistent with /changelog as the main command.
  • Updated help messages and language files for clarity and accuracy.
  • Ensured command tab-completion and usage info are consistent with the new command structure.
  • Improved internal naming and documentation for better maintainability.
----------, Jan 4, 2026

Resource Information
Author:
----------
Total Downloads: 100
First Release: Jan 4, 2026
Last Update: Mar 15, 2026
Category: ---------------
All-Time Rating:
3 ratings
Find more info at discord.gg...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings