2.0.0
Compatibility
Changes
ā» RecyclePlugin v2.0.0 ā Full Rewrite
ā Migration Notice
> š„ Massive update ā complete rewrite of the plugin architecture v2.0.0 introduces a completely new config structure.
If you are upgrading from v1.x:
- Old configs are no more supported
- It is strongly recommended to:
- Delete your old config.yml, lang files.
- Restart the server
- Reconfigure using the new system
No support for errors using old config.yml and lang files.
š Highlights
- ā Fully config-driven system
- š„ Custom GUI fully configurable
- š¾ Persistent player stats (no more resets)
- š Live reload support (
/rpadmin reload) - ⨠Configurable sounds & particles
- š§ Clean and scalable architecture
š Added
-
100% configurable GUI
- Layout, items, actions, dynamic elements
-
Recycling preview system
- Live reward preview in GUI
-
Persistent stats system
- Stored in
data/stats.yml - Tracks total recycled items per player
- Stored in
-
Lucky system
- Chance-based reward multiplier
-
Cooldown system
-
Update Checker
- Console + OP notifications
-
Tab completion
/rpadmin reload
š Changed
- Complete rewrite of plugin core
- Reworked recycling logic (clean, deterministic, no desync)
- Improved durability-based reward calculation
- Reworked XP system (rarity-based + enchant scaling)
- Refactored GUI system (no hardcoded elements)
š Fixed
- Fixed reward desync between preview and confirm
- Fixed duplicate reward bug
- Fixed stats reset on server restart
- Fixed GUI refresh inconsistencies
- Fixed sound/particle compatibility (modern registry)
ā Config
- New structure:
- config.yml ā full control (gui + recycle + effects + messages)
- data/stats.yml ā player stats
- Legacy compatibility supported (
items:fallback)
ā Breaking Changes
- Old configs may require update
- GUI is now fully config-based
- Some keys renamed for consistency
š Performance
- Reduced allocations in GUI refresh
- Optimized recycling calculations
- Cleaner event handling
š® Roadmap
- Economy support (Vault)
- Money rewards option
- Leaderboards (
/recycle top) - PlaceholderAPI support
- Per-item custom behaviors
- Advanced permissions
š¬ Notes
This version lays the foundation for future expansion.
The plugin is now modular, scalable, and ready for public servers.
š„ v2.0.0 = stable, clean, and production-ready
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:fmSo86JZ:JVOgb0GW"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:fmSo86JZ:JVOgb0GW"
}

