How filkond/upgradesapi works
UpgradesAPI is a Java library for tracking upgrade progress and deriving buffs, with an example Bukkit plugin that exposes upgrades to players. The runtime path runs from player commands or events through a player-specific controller, which finds or creates a holder and can collect buffs from configured upgrade levels. The API controller loads and saves holders through a data source; the API also includes a database-backed source and DAO. The graph includes documented module capabilities, but unsampled implementations and some Bukkit wiring are represented only where indexed references support them.
Main entry points: PlayerUpgradesController.java Player controller · AbstractAdvancedController.java Advanced controller · UpgradeControllerImpl.java Upgrade controller · PlayerHolder.java Player holder
Components 21
Bukkit example
- Plugin startup
upgrades-example/src/main/java/com/filkond/upgrades_example/UpgradesExample.java - Player events
upgrades-example/src/main/java/com/filkond/upgrades_example/listener/PlayerListener.java - Upgrade command
upgrades-example/src/main/java/com/filkond/upgrades_example/command/UpgradeExecutor.java - Player controller
upgrades-example/src/main/java/com/filkond/upgrades_example/PlayerUpgradesController.java - Player holder
upgrades-example/src/main/java/com/filkond/upgrades_example/PlayerHolder.java
Upgrade and buffs
- Upgrade types
upgrades-advanced/src/main/java/com/filkond/upgrades/configuration/SimpleUpgradeType.java - Upgrade levels
upgrades-advanced/src/main/java/com/filkond/upgrades/configuration/UpgradeLevel.java - Buff values
upgrades-advanced/src/main/java/com/filkond/upgrades/configuration/buff/UpgradeBuff.java - Progress holder
upgrades-advanced/src/main/java/com/filkond/upgrades/holder/AdvancedHolder.java - Advanced controller
upgrades-advanced/src/main/java/com/filkond/upgrades/controller/AbstractAdvancedController.java - Buff collector
upgrades-advanced/src/main/java/com/filkond/upgrades/utils/BuffCollector.java - Buff interface
upgrades-advanced/src/main/java/com/filkond/upgrades/controller/BuffController.java
Controller and storage
- Upgrade controller
upgrades-api/src/main/java/com/filkond/upgrades/controller/UpgradeControllerImpl.java - Controller contract
upgrades-api/src/main/java/com/filkond/upgrades/controller/UpgradeController.java - Data source
upgrades-api/src/main/java/com/filkond/upgrades/datasource/UpgradesDataSource.java - Database source
upgrades-api/src/main/java/com/filkond/upgrades/datasource/DBUpdateDataSource.java - Holder DAO
upgrades-api/src/main/java/com/filkond/upgrades/holder/dao/UpgradeHolderDAOImpl.java - DAO contract
upgrades-api/src/main/java/com/filkond/upgrades/holder/dao/UpgradeHolderDAO.java - Holder contract
upgrades-api/src/main/java/com/filkond/upgrades/holder/UpgradeHolder.java
Other components
- Bukkit player
- SQL database
Connections 27
- Bukkit player → Player events: triggers
upgrades-example/src/main/java/com/filkond/upgrades_example/listener/PlayerListener.java - Bukkit player → Upgrade command: invokes
upgrades-example/src/main/java/com/filkond/upgrades_example/command/UpgradeExecutor.java - Player events → Player controller: uses
upgrades-example/src/main/java/com/filkond/upgrades_example/listener/PlayerListener.java - Upgrade command → Player controller: uses
upgrades-example/src/main/java/com/filkond/upgrades_example/command/UpgradeExecutor.java - Plugin startup → Player controller: creates
upgrades-example/src/main/java/com/filkond/upgrades_example/UpgradesExample.java - Plugin startup → Player events: registers
upgrades-example/src/main/java/com/filkond/upgrades_example/UpgradesExample.java - Player controller → Advanced controller: extends
upgrades-example/src/main/java/com/filkond/upgrades_example/PlayerUpgradesController.java - Player controller → Upgrade types: configures
upgrades-example/src/main/java/com/filkond/upgrades_example/PlayerUpgradesController.java - Player controller → Player holder: creates
upgrades-example/src/main/java/com/filkond/upgrades_example/PlayerUpgradesController.java - Player controller → Data source: receives
upgrades-example/src/main/java/com/filkond/upgrades_example/PlayerUpgradesController.java - Player holder → Progress holder: implements
upgrades-example/src/main/java/com/filkond/upgrades_example/PlayerHolder.java - Player holder → Holder contract: uses
upgrades-example/src/main/java/com/filkond/upgrades_example/PlayerHolder.java - Upgrade types → Upgrade levels: defines
upgrades-advanced/src/main/java/com/filkond/upgrades/configuration/SimpleUpgradeType.java - Upgrade levels → Buff values: contains
upgrades-advanced/src/main/java/com/filkond/upgrades/configuration/SimpleUpgradeLevel.java - Advanced controller → Upgrade controller: extends
upgrades-advanced/src/main/java/com/filkond/upgrades/controller/AbstractAdvancedController.java - Advanced controller → Progress holder: loads progress
upgrades-advanced/src/main/java/com/filkond/upgrades/controller/AbstractAdvancedController.java - Advanced controller → Buff collector: builds
upgrades-advanced/src/main/java/com/filkond/upgrades/controller/AbstractAdvancedController.java - Advanced controller → Buff interface: implements
upgrades-advanced/src/main/java/com/filkond/upgrades/controller/AbstractAdvancedController.java - Buff collector → Progress holder: reads progress
upgrades-advanced/src/main/java/com/filkond/upgrades/utils/BuffCollector.java - Buff collector → Buff values: collects
upgrades-advanced/src/main/java/com/filkond/upgrades/utils/BuffCollector.java - Upgrade controller → Data source: loads and saves
upgrades-api/src/main/java/com/filkond/upgrades/controller/UpgradeControllerImpl.java - Upgrade controller → Controller contract: implements
upgrades-api/src/main/java/com/filkond/upgrades/controller/UpgradeControllerImpl.java - Upgrade controller → Holder contract: manages
upgrades-api/src/main/java/com/filkond/upgrades/controller/UpgradeControllerImpl.java - Data source → Database source: implemented by
upgrades-api/src/main/java/com/filkond/upgrades/datasource/DBUpdateDataSource.java - Database source → Holder DAO: uses
upgrades-api/src/main/java/com/filkond/upgrades/datasource/DBUpdateDataSource.java - Holder DAO → DAO contract: implements
upgrades-api/src/main/java/com/filkond/upgrades/holder/dao/UpgradeHolderDAOImpl.java - Database source → SQL database: reads and writes
upgrades-api/src/main/java/com/filkond/upgrades/datasource/DBUpdateDataSource.java