Перейти к содержимому
Mineforgian

RuinedCollections

Configurable player collections, rewards, leaderboards, and menus for Paper/Folia.

Загрузки
24
Подписчики
0
Обновлён
26 июня 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.21 through 26.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

  • /collections opens the player collections menu.
  • /rc help shows the admin command list.
  • /rc validate checks collection files for common mistakes.
  • /rc diagnostics shows diagnostics status and recent log lines.
  • /rc export and /rc import help 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.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.
1.0.11Релиз26.1, 26.1.1, 26.1.2 · 30 мая 2026 г.

Improves leaderboard refresh safety, import/export hardening, and current Paper API validation.

  • Coalesces duplicate leaderboard refreshes and ignores stale async cache results after reloads
  • Moves export file generation onto the snapshot worker
  • Reports invalid collection, menu, and import YAML clearly instead of failing silently
  • Refreshes leaderboard caches after imports
  • Keeps release jar output as RuinedCollections.jar

SHA256: E89F9ED80CAA99BE560049061622E0AABDCCAB6294ABCABB4C97569721ED9CDA

Комментарии

Загружаем…