
RuinedCollections
Configurable player collections, rewards, leaderboards, and menus for Paper/Folia.
- Загрузки
- 84
- Подписчики
- 0
- Обновлён
- 28 июля 2026 г.
- Лицензия
- RuinedCollections-Free-Use
Опубликован 30 мая 2026 г.
RuinedCollections
RuinedCollections is a configurable collections plugin for Paper and Folia servers. It is built for servers that want Hypixel SkyBlock-style collection progress without being locked into one set of items, menus, rewards, or storage choices.
Current support
- Paper and Folia
1.21through26.2 - Java 21 bytecode for the plugin jar
- Java 25 recommended for current Paper/Folia 26.x servers
- PlaceholderAPI, Vault, and LuckPerms-compatible setups
- SQLite by default, MySQL for larger networks
What admins can customize
- Collections for vanilla blocks/items, entities, custom item keys, and command-driven custom rewards
- Tier goals from small starter values to very large long-term targets
- Rewards per tier, including command rewards, money rewards, permission-style setups, and custom server commands
- GUI menus, lore, progress text, locked/unlocked states, and filler items
- Leaderboards and PlaceholderAPI placeholders for menus, scoreboards, NPCs, holograms, and external leaderboard displays
Safety and scale
RuinedCollections is designed for small servers and larger live networks. Progress writes are batched, leaderboards are cached, offline players are handled by UUID and saved names, and reward claims are protected against duplicate execution. The plugin also writes a diagnostics log so startup problems, config mistakes, reward failures, storage issues, and migration/import problems are easier to track down.
Commands
/collectionsopens the player collections menu./rc helpshows the admin command list./rc validatechecks collection files for common mistakes./rc diagnosticsshows diagnostics status and recent log lines./rc exportand/rc importhelp move data between servers or storage setups.
First setup
Drop RuinedCollections.jar into plugins, start the server once, then check the generated files under plugins/RuinedCollections. The default collections and template files are meant to be edited and copied, so admins have working examples before building their own collections.
For deeper setup notes, examples, placeholders, custom item formats, and migration guidance, use the GitHub docs/wiki linked on this page.
Ченджлог
1.0.19Релиз26.1.1, 26.1.2, 26.2 · 28 июля 2026 г.
RuinedCollections 1.0.19
This release tightens storage ordering, import completion, reward recovery, and player-placed block tracking.
- Player loads and exports now wait for writes that were already queued, preventing stale reconnect or offline-edit reads.
- Import completion no longer waits on the storage writer from inside that same writer.
- Reward claims rolled back after a disconnect refresh fast reconnects, and individual reward exceptions are written to diagnostics.
- Player-placed records now cover multi-block placements, piston movement, gravity-block falls, explosions, burning, fading, and leaf decay.
/rc createnow gives non-block materials an item-pickup source instead of an unusable block-break source.- Wildcards consistently take precedence over named material or entity entries.
- Invalid storage types, table prefixes, future schema versions, persistent-data types, and malformed numeric values fail clearly.
- Diagnostics limits are bounded against accidental extreme values.
- Updated Gradle to
9.6.1, Shadow to9.6.1, SQLite JDBC to3.53.2.1, and current pinned GitHub Actions revisions. - Release jars now use reproducible archive ordering and timestamps.
Runtime-tested on Paper 1.21.build.130 with Java 21, Paper 26.2.build.84-stable, and Folia 26.2.build.1-beta. The release also compiles against both the Paper 1.21 API baseline and Paper 26.2.build.84-stable.
Release jar: RuinedCollections.jar
SHA-256: 636960276674b30e9a2b8cc4d79b6da33e8e6d46ab19337a99bda08bfd7e9639
1.0.18Релиз26.1.1, 26.1.2, 26.2 · 13 июля 2026 г.
RuinedCollections 1.0.18
This release is a full reliability and performance pass over storage, progress tracking, leaderboards, imports, rewards, and Folia scheduling.
- Ordered database writes prevent progress sets, additions, claims, and imports from arriving out of sequence.
- Player load tokens protect fast disconnects and reconnects from stale data callbacks without retaining old players in memory.
- Leaderboard refreshes now coalesce safely, reject stale results, and keep the per-player rank cache bounded.
- Player-placed block records are written in efficient transactional batches and flushed during graceful shutdown.
- Exports use one consistent database snapshot, and overlapping imports are blocked.
- Progress intervals, block batching, PlaceholderAPI bars, leaderboards, and bStats settings now apply correctly on reload.
- Reward shutdown handling, Folia timer overflow protection, compatible Paper fork detection, config validation, and diagnostic privacy were tightened.
- HikariCP, SQLite JDBC, and PlaceholderAPI dependencies were updated.
- Added SQLite integration tests for ordered writes, caps, overflow handling, snapshots, claims, names, and placed-block batches.
Validated with Paper 26.2.build.60-beta and Folia 26.1.2.build.8-stable. PaperMC had not published a Folia 26.2 server build at release time.
Release jar: RuinedCollections.jar
SHA-256: 36442fa41f192e8d4a2e7779fba1b831b85f610fe47214907ed055905303b3f9
1.0.17Релиз26.1.1, 26.1.2, 26.2 · 10 июля 2026 г.
RuinedCollections 1.0.17
- Hardened protected collection menus against cross-player and stale-state access.
- Prevented rapid same-tick crafting from overcounting collection progress.
- Rejects invalid economy reward amounts during collection validation.
- Built and verified for Paper and Folia from 1.21 through 26.2.
1.0.16Релиз26.1.1, 26.1.2, 26.2 · 26 июня 2026 г.
RuinedCollections 1.0.16
- Fixed capped progress saves so offline, admin, and batched progress writes stay capped at the highest configured tier under concurrent writes.
- Rechecked Paper/Folia 1.21 through 26.2 metadata, default collection templates, reload handling, diagnostics, bStats, and leaderboard placeholders.
- Release jar: RuinedCollections.jar.
- SHA-256: CA09F2ADB7D7C0049A6029725B08F3FA5E3AB6B70AD3EFE99BEE4162D22FCA41.
1.0.15Релиз26.1.1, 26.1.2, 26.2 · 21 июня 2026 г.
RuinedCollections 1.0.15
- Added validated Paper/Folia 26.2 support.
- Compiled cleanly against Paper 26.2.build.25-alpha while keeping the 1.21 API baseline for older supported servers.
- Updated release metadata and docs for the 1.21 through 26.2 support range.
- Smoke-tested on a clean Paper 26.2 build 25 server with /rc validate passing.
1.0.14Релиз26.1, 26.1.1, 26.1.2 · 13 июня 2026 г.
RuinedCollections 1.0.14
- Added bStats support with the RuinedCollections bStats plugin id.
- Shaded and relocated bStats inside the jar to avoid dependency conflicts.
- Added aggregate-only charts for storage type, optional hooks, leaderboard state, enabled collection count, and source type usage.
- Documented the bStats setup and what data the plugin does and does not send.
- Keeps support for Paper and Folia from 1.21 through 26.1.2.
1.0.13Релиз26.1, 26.1.1, 26.1.2 · 13 июня 2026 г.
RuinedCollections 1.0.13
- Added menu drag protection so players cannot drag items into RuinedCollections inventories.
- Hardened quit/rejoin progress saving so reconnects do not load stale progress while quit-time saves are still writing.
- Refreshes leaderboard and rank caches after saved progress so placeholders update faster.
- Made collection source parsing stricter: automatic sources now need materials/entities, with
*available for intentional wildcards. - Broken collection files with no valid sources or tiers are rejected instead of loading into menus.
- Updated collection docs for armor sources and explicit wildcards.
1.0.12Релиз26.1, 26.1.1, 26.1.2 · 30 мая 2026 г.
Release jar is now direct-upload friendly while keeping SQLite and MySQL support through Paper's built-in library loader.
- Reduced RuinedCollections.jar below marketplace upload limits.
- Added Paper runtime library declarations for SQLite and MySQL drivers.
- Kept Paper/Folia support from 1.21 through 26.1.2.
- Updated installation and troubleshooting docs.
Комментарии
Загружаем…