How boiscljo/sba works
Project type and purpose
• This is a multi-module Java project targeting the Spigot/Paper Minecraft server platform.
• It consists of two Gradle subprojects:
– api: a public Addon API offering interfaces, data classes, and custom event definitions so third-party addons can hook into the SBA (Survive BedWars Addon) system.
– plugin: the core SBA plugin implementation that brings the game mode to life by registering commands, listeners, services, game-loop tasks, and integrating with external plugins (e.g., Citizens, PlaceholderAPI, BungeeCord).
File structure
• Top-level modules
– api/: defines IConfigurator, AddonAPI, event classes, data holders, game interfaces (IArena, IParty, etc.), and language/permission abstractions.
– plugin/: the actual plugin code, organized by subpackages:
• commands/ – command handlers and CommandManager
• listener/ – Spigot event listeners
• game/ – Arena, GameStorage, Generator logic, and scheduled GameTaskManager
• service/ – services such as AIService, NPCStoreService, AntiCheatIntegration
• party/ – Party and PartyManager implementations
• config/ – SBAConfig and related configuration loaders
• special/ – special game mechanics (PopupTower, SpawnerProtection) and their runnables
• visual/ – scoreboard management (Lobby and Game scoreboards) using pronzelib
• fix/ – compatibility adapters for different server distributions (Magma, Mohist, ViaVersion, etc.)
• placeholderapi/ – SBAExpansion for PlaceholderAPI integration
• utils/ – various helpers (DateUtils, MessageUtils, SBAUtil)
– build scripts (build.gradle, settings.gradle) and CI workflows (.github/workflows)
README for additional insights
• (Empty in this snapshot)
• We infer from package names and class roles that the plugin orchestrates a BedWars-style minigame with parties, generators, upgrades, and in-game shops.
Detail
• External integration points (PlaceholderAPI, Citizens, BungeeCord, AntiCheat).
• Life cycle: plugin load → configuration → registration → game loop → shutdown.