EcoTrophies

# EcoTrophies EcoTrophies adds placeable ArmorStand trophies that generate currency over time. Players can equip special tiered armor, increase a trophy’s production and storage capacity, collect the generated currency through a configurable GUI, and pick the trophy back up with its armor still attached. ## How does it work? 1. An admin or plugin gives a player a trophy. 2. The player places it in the world. 3. Special EcoTrophies armor is equipped by right-clicking the trophy or using its GUI. 4. Every armor piece increases the trophy’s currency production. 5. Wearing a complete matching armor set can provide an additional set bonus (enabled by default). 6. Generated currency is stored inside the trophy until the owner collects it. Production rates, storage capacity, armor tiers, set bonuses, trophy types and currencies, Guis, texts and messages are all configurable. ## Features - ArmorStand trophies - Passive custom currency generation - Claimable income with configurable storage limits - Multiple configurable trophy types and currencies - Individual production and capacity values for every armor tier - Optional full-set production bonuses - Mixed armor sets supported - Trophy pickup with equipped armor preserved - Collection history showing who collected currency, how much and when - Owner protection with administrator bypass permission - Configurable trophy limits per player - Configurable names, lore, messages, sounds, particles and holograms - Decimal production rates, such as `0.05` currency per minute - Optional PlaceholderAPI and FancyHolograms support ## Tiered armor Regular Minecraft armor cannot power trophies. Players must use special EcoTrophies armor issued by an admins or plugins. For example a crates or shop plugin with command support. The default tiers are: 1. Leather 2. Chainmail 3. Copper 4. Iron 5. Gold 6. Diamond 7. Netherite Every helmet, chestplate, pair of leggings and pair of boots contributes independently. This allows players to mix armor tiers while gradually improving their trophy. Complete matching sets can provide an additional configurable bonus. Set bonuses can also be disabled entirely. ## Trophy GUI Right-click a trophy to open its menu. The GUI displays: - Equipped armor - Current production per minute - Stored currency - Storage capacity - Trophy owner - Collection logs - Collect button - Pickup button Armor can be equipped by shift-clicking it from the player inventory. Shift-clicking an equipped piece returns it to the player. Only the owner can open, modify or pick up a trophy unless the player has the bypass permission. ## Economy support EcoTrophies supports: - Vault - CoinsEngine - ExcellentEconomy Vault exposes one configured currency. ExcellentEconomy (CoinsEngine) can be used for trophy types that generate different currencies, such as: - Money - Tokens - Shards - Credits - Fragments - Mob Coins - Custom server currencies ## Commands ```text /ecotrophy give <player> trophy <type> /ecotrophy give <player> armor <set> /ecotrophy remove /ecotrophy reload /ecotrophy list /ecotrophy info /ecotrophy debug ``` ## Permissions ```text ecotrophies.admin ecotrophies.give ecotrophies.reload ecotrophies.use ecotrophies.bypass ``` ## Dependencies Required: - Paper 1.21+ - Java 21 - One supported economy setup: - Vault with a Vault-compatible economy plugin like essentialsX - CoinsEngine - ExcellentEconomy Optional: - PlaceholderAPI - FancyHolograms ## PlaceholderAPI Available placeholders: ```text %ecotrophies_count% %ecotrophies_total_rate% %ecotrophies_stored% ``` ## Configuration EcoTrophies separates its configuration into clean YAML files: - `config.yml` — economy, production, limits, visuals and sounds - `trophies.yml` — trophy types, currencies, item names and lore - `armor.yml` — armor tiers, production, capacity and set bonuses - `gui.yml` — menu layouts, icons, names and lore - `messages.yml` — all player-facing messages Nearly every visible part of the plugin can be changed without modifying the jar. ## Why EcoTrophies? EcoTrophies combines decoration, progression and server economy into one easy-to-understand system. It gives players a reason to collect better armor tiers, build trophy areas and regularly return to collect their generated currency all while giving server owners full control over balancing and presentation.