PlaceholderAPI is a Bukkit/Spigot/Paper plugin that provides a unified placeholder system for Minecraft servers. It allows server owners and plugin developers to display dynamic information (e.g., player name, coordinates, plugin stats) using a simple %identifier_params% syntax. The plugin acts as a central registry for placeholder expansions, which can be loaded from a local 'expansions' folder or downloaded from the eCloud (a remote expansion repository). The architecture is a standard Bukkit plugin with a command router, expansion managers (local and cloud), a high-performance character-based replacer, and an abstract scheduler layer that supports Bukkit, Paper, and Folia. Key entry points include the PlaceholderAPI static API class, the PlaceholderAPIPlugin main class, and the /papi command. External dependencies include bStats for metrics, Adventure for modern chat components, and the Spigot/Paper API. The codebase is well-structured, with clear separation of concerns, extensive use of interfaces and dependency injection, and includes unit tests and JMH benchmarks for the replacer.
ChestShop is a mature Bukkit/Spigot/Paper plugin that enables players to create and operate shops using chests and signs. It provides a full economy-driven trading system: players place a sign on a chest to define a shop, set prices, and buy/sell items. The plugin handles shop creation, transaction validation, inventory management, and economic transfers, with extensive integration hooks for popular protection and economy plugins (Vault, Reserve, WorldGuard, GriefPrevention, PlotSquared, Lockette, etc.). The architecture is event-driven and modular, with a core plugin module and version-specific adapter modules to support Minecraft versions from 1.13 to 1.20.5. It uses a custom configuration system with annotations, a lightweight database layer (SQLite via ORMLite), and a comprehensive localization system supporting 40+ languages. The codebase is well-structured with clear separation of concerns, but carries technical debt from deprecated Bukkit APIs, manual database migrations, and tight coupling to many external plugin APIs.
This is a web application for viewing and analyzing Minecraft server performance timings reports. It consists of a PHP backend that handles report upload, caching, and data transformation, and a React-based frontend for interactive visualization. The backend parses a proprietary compressed timing format from Minecraft servers (Paper, Sponge, etc.) into a structured JSON object, caches it, and serves it via REST endpoints. The frontend fetches this data and renders charts, tables, and drill-down views of timing handlers, regions, and plugins. The application is a single-page application built with React 15, Webpack 2, and Babel 6, with a heavy reliance on jQuery-like PHP utilities and the Stiphle rate-limiting library. The architecture is a classic LAMP stack with PHP serving as both the API and the HTML shell. Key entry points are index.php (main page), data.php (API), post.php (upload endpoint), and backend_daemon.php (CLI daemon). The system uses a file-based cache with gzip compression and serialization. The frontend manages state with a global data object and uses Chart.js for TPS and entity graphs. The codebase demonstrates a custom JSON deserialization trait (FromJson) that maps JSON arrays to typed PHP objects using PHPDoc annotations, which is a notable pattern for handling evolving data formats. However, the project shows significant technical debt with outdated dependencies and a monolithic global state approach in the frontend.