> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sentrystudios.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Core Infrastructure

> An overview of the foundational architecture that powers Sentry Studios resources.

Sentry Studios utilizes a unified, high-performance architecture across all of our products. Our core infrastructure is built on three main pillars.

<CardGroup cols={3}>
  <Card title="Zero Impact" icon="gauge-high" iconType="duotone">
    Asynchronous off-thread processing.
  </Card>

  <Card title="Always Synced" icon="database" iconType="duotone">
    Automated data persistence & caching.
  </Card>

  <Card title="Secured" icon="shield-check" iconType="duotone">
    Dynamic verification protocols.
  </Card>
</CardGroup>

***

## High-Performance Architecture

Our systems guarantee zero impact on your main server thread, ensuring that your server's TPS remains perfectly stable even under heavy load.

<Tabs>
  <Tab title="Asynchronous Execution">
    **No more lag spikes.** Heavy operations, including command parsing, player data lookups, and file IO, are processed entirely off the main thread and async using our open sourced project **Sentry Lib**
  </Tab>

  <Tab title="Smart Caching">
    **Instant response times.** High-frequency data is cached locally in memory, meaning UI menus and stats load instantly while background processes sync the data safely.
  </Tab>

  <Tab title="Multi-Threaded Support">
    **Built for the future.** Our infrastructure supports advanced multi-threaded platforms (like Folia) natively out of the box to fully utilize modern hardware and build your server for pure intensity.
  </Tab>
</Tabs>

***

## 💾 Data Management

We provide flexible data storage solutions that scale effortlessly with your community.

<AccordionGroup>
  <Accordion title="Zero-Config Local Storage" icon="hard-drive">
    By default, our systems initialize with localized, file-based databases (`SQLite`). This provides immediate, plug-and-play functionality with zero setup required.
  </Accordion>

  <Accordion title="Network-Wide Synchronization" icon="network-wired">
    For advanced setups, seamlessly migrate to remote databases (`MySQL`). This allows multiple servers to read and write to the same data source simultaneously.
  </Accordion>

  <Accordion title="Automated Schema Migrations" icon="clock-rotate-left">
    Database schemas update automatically alongside your software version, preventing data corruption and removing the need for manual maintenance. (eg. /wipe export)
  </Accordion>
</AccordionGroup>

***

## 🛡️ Software Integrity

<Info>
  These security measures run silently in the background and are highly optimized to have little or **zero** impact on runtime performance.
</Info>

To ensure all users are running authentic, unaltered software, we employ robust protection protocols:

<Steps>
  <Step title="Advanced Protection Protocols">
    Core system logic is heavily secured against unauthorized modification to prevent malicious actors from exploiting the software or circumventing intended mechanics.
  </Step>

  <Step title="Dynamic Verification">
    Each deployment undergoes automated, real-time validation checks to confirm its authenticity. This guarantees the software running on your system is official.
  </Step>

  <Step title="Tamper Mitigation">
    In the rare event that unauthorized modifications are detected, the system safely halts execution to protect your broader server environment from vulnerabilities.
  </Step>
</Steps>

***

## Environment Compatibility

To guarantee maximum stability, our architecture is optimized exclusively for modern server environments. We actively drop support for legacy software to ensure we can leverage the latest Java capabilities and performance enhancements.

<CardGroup cols={2}>
  <Card title="Required Runtime" icon="java" iconType="brands">
    Built exclusively for **Java 17** and **Java 21**. Our systems utilize modern garbage collection and memory management protocols.
  </Card>

  <Card title="Supported Forks" icon="code-branch" iconType="solid">
    Fully optimized for high-performance server software including **PaperMC**, **Purpur**, and **Folia**.
  </Card>
</CardGroup>

***

## Modular Engine

Rather than hardcoding features, our infrastructure acts as a flexible engine that you control.

<CardGroup cols={2}>
  <Card title="Dynamic Data Injection" icon="code" iconType="duotone">
    Server metrics and player statistics can be universally injected into our graphical interfaces using standardized placeholder protocols.
  </Card>

  <Card title="Live Configuration" icon="rotate" iconType="duotone">
    Design changes, messaging updates, and layout modifications can be applied on the fly via dedicated reload commands—requiring zero server downtime.
  </Card>
</CardGroup>

***

## Developer Ecosystem & Modularity

Rather than hardcoding features, our infrastructure acts as a flexible engine that you control and expand upon.

<CardGroup cols={2}>
  <Card title="Dynamic Data Injection" icon="code" iconType="duotone">
    Server metrics and player statistics can be universally injected into our graphical interfaces using standardized placeholder protocols.
  </Card>

  <Card title="Live Configuration" icon="rotate" iconType="duotone">
    Design changes, messaging updates, and layout modifications can be applied on the fly via dedicated reload commands—requiring zero downtime.
  </Card>

  <Card title="Event Hooks" icon="webhook" iconType="duotone">
    Extensive API dispatches allow your custom plugins to hook into our core events, triggering external logic seamlessly.
  </Card>

  <Card title="Headless Integrations" icon="puzzle-piece" iconType="duotone">
    Designed to work directly with external tools, web dashboards, and network-wide proxies or discord webhooks without conflicts.
  </Card>
</CardGroup>

***

## Where to Next?

Now that you understand how our systems operate under the hood, you can see how to deploy these resources on your own network or dive into specific product configurations.

<Card title="Deploy Your First Resource" icon="rocket" iconType="duotone" href="https://docs.sentrystudios.org/getting-started-1">
  Follow our step-by-step setup guide to install your software, configure your database, and get your network running.
</Card>