{"id":109192,"date":"2026-06-06T13:07:45","date_gmt":"2026-06-06T10:07:45","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/nds-api\/"},"modified":"2026-06-06T13:07:45","modified_gmt":"2026-06-06T10:07:45","slug":"nds-api","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/nds-api\/","title":{"rendered":"NDS-API"},"content":{"rendered":"
\n

# NoieDigitalSystem API for Minecraft<\/p>\n

### A Next-Generation Economy Protocol for Minecraft Server Ecosystems<\/p>\n

![Paper](https:\/\/papermc.io\/)
\n![Folia](https:\/\/papermc.io\/software\/folia)
\n![Java](https:\/\/adoptium.net\/)
\n![PostgreSQL](https:\/\/www.postgresql.org\/)
\n![Redis](https:\/\/redis.io\/)
\n![bStats](https:\/\/bstats.org\/plugin\/bukkit\/NoieDigitalSystem-API\/28509)
\n![License](https:\/\/github.com\/Misty4119\/nds-api\/blob\/main\/LICENSE)<\/p>\n

**NDS-API** is a high-performance, async-first economy protocol designed as a **modern replacement for Vault**. Built with native Folia support, PostgreSQL JSONB persistence, Redis-based cross-server synchronization, and `BigDecimal` precision for all monetary operations.<\/p>\n<\/div>\n

—<\/p>\n

## Architecture Overview<\/p>\n

“`
\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
\n\u2502 NDS-API Architecture \u2502
\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524
\n\u2502 \u2502
\n\u2502 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u2502
\n\u2502 \u2502 Your Plugin \u2502 \u2502 Your Plugin \u2502 \u2502 Your Plugin \u2502 \u2502
\n\u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2502
\n\u2502 \u2502 \u2502 \u2502 \u2502
\n\u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2502
\n\u2502 \u25bc \u2502
\n\u2502 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u2502
\n\u2502 \u2502 NDS-API Plugin Layer \u2502 \u2502
\n\u2502 \u2502 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u2502 \u2502
\n\u2502 \u2502 \u2502 NdsApiPlugin \u2502\u2500\u2500\u2500\u25b6\u2502 Shared Configuration Manager \u2502 \u2502 \u2502
\n\u2502 \u2502 \u2502 (Entry Point) \u2502 \u2502 (\/plugins\/NoieDigitalSystem\/) \u2502 \u2502 \u2502
\n\u2502 \u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2502 \u2502
\n\u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2502
\n\u2502 \u2502 \u2502
\n\u2502 \u25bc \u2502
\n\u2502 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u2502
\n\u2502 \u2502 Core Manager Layer \u2502 \u2502
\n\u2502 \u2502 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u2502 \u2502
\n\u2502 \u2502 \u2502 PlayerDigitalManager\u2502 \u2502 DigitalManager (Server Digitals) \u2502 \u2502 \u2502
\n\u2502 \u2502 \u2502 (Player Currencies) \u2502 \u2502 + GlobalDigitalManager \u2502 \u2502 \u2502
\n\u2502 \u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2502 \u2502
\n\u2502 \u2502 \u2502 \u2502 \u2502 \u2502
\n\u2502 \u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2502 \u2502
\n\u2502 \u2502 \u25bc \u2502 \u2502
\n\u2502 \u2502 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u2502 \u2502
\n\u2502 \u2502 \u2502 Repository Layer (Facade) \u2502 \u2502 \u2502
\n\u2502 \u2502 \u2502 \u2022 Cache Manager (In-Memory + Redis) \u2502 \u2502 \u2502
\n\u2502 \u2502 \u2502 \u2022 JSONB Parser (PostgreSQL Native) \u2502 \u2502 \u2502
\n\u2502 \u2502 \u2502 \u2022 Transaction Pipeline (Optimistic Locking) \u2502 \u2502 \u2502
\n\u2502 \u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2502 \u2502
\n\u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2502
\n\u2502 \u2502 \u2502
\n\u2502 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u2502
\n\u2502 \u25bc \u25bc \u25bc \u2502
\n\u2502 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u2502
\n\u2502 \u2502 PostgreSQL \u2502 \u2502 Redis \u2502 \u2502 Virtual \u2502 \u2502
\n\u2502 \u2502 (JSONB) \u2502 \u2502 (Pub\/Sub) \u2502 \u2502 Threads \u2502 \u2502
\n\u2502 \u2502 Primary Store \u2502 \u2502 Cross-Server \u2502 \u2502 (Java 21) \u2502 \u2502
\n\u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2502
\n\u2502 \u2502
\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
\n“`<\/p>\n

—<\/p>\n

## Key Features<\/p>\n

| Feature | Description |
\n|———|————-|
\n| **Async-First Design** | All database operations return `CompletableFuture` for non-blocking I\/O. Zero main-thread blocking. |
\n| **Native Folia Support** | Automatic detection with `RegionScheduler` and `GlobalRegionScheduler` integration. |
\n| **PostgreSQL JSONB Backend** | Flexible schema with optimistic locking (`version` column) for data integrity. |
\n| **Redis Cross-Server Sync** | Real-time state synchronization via Pub\/Sub channels for multi-server deployments. |
\n| **BigDecimal Precision** | All monetary operations use `java.math.BigDecimal`. No floating-point rounding errors. |
\n| **Virtual Threads (Java 21)** | Leverages Project Loom’s virtual threads for efficient I\/O-bound operations. |
\n| **Shared Configuration** | Single `config.yml` shared across NDS ecosystem plugins at `\/plugins\/NoieDigitalSystem\/`. |
\n| **Facade Pattern Architecture** | Clean separation of concerns with manager facades delegating to specialized components. |<\/p>\n

—<\/p>\n

## System Requirements<\/p>\n

| Component | Minimum Version | Recommended | Notes |
\n|———–|—————–|————-|——-|
\n| **Java** | 21 | 21+ | Virtual threads require Java 21+ |
\n| **Server** | Paper 1.21.4 | Paper\/Folia 1.21.4+ | Folia for multi-threaded region support |
\n| **PostgreSQL** | 12 | 15+ | JSONB and optimistic locking support |
\n| **Redis** | 6.0 | 7.0+ | Optional; required for cross-server sync |
\n| **Memory** | 512MB | 1GB+ | Varies with player count and cache size |<\/p>\n

—<\/p>\n

## Installation<\/p>\n

### Step 1: Download<\/p>\n

Download the latest `NoieDigitalSystem-API-x.x.x.jar` from GitHub Releases.<\/p>\n

### Step 2: Deploy<\/p>\n

Place the JAR file in your server’s `plugins\/` directory.<\/p>\n

### Step 3: Configure<\/p>\n

The plugin uses a **shared configuration architecture**. Configuration is stored at:<\/p>\n

“`
\nplugins\/NoieDigitalSystem\/config.yml
\n“`<\/p>\n

**Minimal Required Configuration:**<\/p>\n

“`yaml
\n# PostgreSQL Connection (Required)
\npostgresql:
\n host: “localhost”
\n port: 5432
\n database: “minecraft”
\n username: “postgres”
\n password: “your_secure_password”
\n poolSize: 50<\/p>\n

# Redis Connection (Optional – for cross-server sync)
\nredis:
\n enabled: true
\n host: “localhost”
\n port: 6379
\n password: “”
\n timeout: 3000
\n“`<\/p>\n

### Step 4: Verify<\/p>\n

Restart the server and check for successful initialization in the console:<\/p>\n

“`
\n[NoieDigitalSystem-API] Detected server type: Folia
\n[NoieDigitalSystem-API] Using shared configuration at: \/plugins\/NoieDigitalSystem\/config.yml
\n[NoieDigitalSystem-API] Digital Manager initialization completed.
\n[NoieDigitalSystem-API] NDS API Plugin enabled successfully!
\n“`<\/p>\n

—<\/p>\n

## Developer Integration<\/p>\n

### Dependency Setup<\/p>\n

#### Gradle (Kotlin DSL)<\/p>\n

“`kotlin
\nrepositories {
\n mavenCentral()
\n}<\/p>\n

dependencies {
\n compileOnly(“io.github.misty4119:noiedigitalsystem-api:2.0.0”)
\n}
\n“`<\/p>\n

#### Gradle (Groovy DSL)<\/p>\n

“`groovy
\nrepositories {
\n mavenCentral()
\n}<\/p>\n

dependencies {
\n compileOnly ‘io.github.misty4119:noiedigitalsystem-api:2.0.0’
\n}
\n“`<\/p>\n

#### Maven<\/p>\n

“`xml
\n
\n io.github.misty4119<\/groupId>
\n noiedigitalsystem-api<\/artifactId>
\n 2.0.0<\/version>
\n provided<\/scope>
\n<\/dependency>
\n“`<\/p>\n

### Plugin Configuration<\/p>\n

#### paper-plugin.yml (Paper 1.19.4+)<\/p>\n

“`yaml
\nname: YourPlugin
\nversion: ‘1.0.0’
\nmain: com.example.yourplugin.YourPlugin
\napi-version: ‘1.21’
\ndependencies:
\n server:
\n NoieDigitalSystem-API:
\n load: BEFORE
\n required: true
\n“`<\/p>\n

#### plugin.yml (Legacy)<\/p>\n

“`yaml
\nname: YourPlugin
\nversion: 1.0.0
\nmain: com.example.yourplugin.YourPlugin
\napi-version: ‘1.21’
\ndepend: [NoieDigitalSystem-API]
\n“`<\/p>\n

—<\/p>\n

## API Usage<\/p>\n

### Obtaining the API Instance<\/p>\n

“`java
\nimport noie.linmimeng.noiedigitalsystem.api.plugin.NdsApiPlugin;
\nimport noie.linmimeng.noiedigitalsystem.manager.DigitalManager;
\nimport noie.linmimeng.noiedigitalsystem.manager.PlayerDigitalManager;
\nimport org.bukkit.plugin.Plugin;
\nimport org.bukkit.plugin.java.JavaPlugin;<\/p>\n

public class YourPlugin extends JavaPlugin {<\/p>\n

private PlayerDigitalManager playerDigitalManager;
\n private DigitalManager digitalManager;<\/p>\n

@Override
\n public void onEnable() {
\n \/\/ Obtain the NDS-API plugin instance
\n Plugin ndsPlugin = getServer().getPluginManager().getPlugin(“NoieDigitalSystem-API”);<\/p>\n

\/\/ Validate plugin availability and type
\n if (ndsPlugin == null) {
\n getLogger().severe(“NoieDigitalSystem-API is not installed!”);
\n getServer().getPluginManager().disablePlugin(this);
\n return;
\n }<\/p>\n

if (!(ndsPlugin instanceof NdsApiPlugin)) {
\n getLogger().severe(“NoieDigitalSystem-API is not the expected type!”);
\n getServer().getPluginManager().disablePlugin(this);
\n return;
\n }<\/p>\n

\/\/ Cast and obtain managers
\n NdsApiPlugin ndsApi = (NdsApiPlugin) ndsPlugin;
\n this.playerDigitalManager = ndsApi.getPlayerDigitalManager();
\n this.digitalManager = ndsApi.getDigitalManager();<\/p>\n

getLogger().info(“Successfully integrated with NoieDigitalSystem-API v2.0”);
\n }
\n}
\n“`<\/p>\n

### Player Digital Operations<\/p>\n

All player operations are **asynchronous** and return `CompletableFuture`.<\/p>\n

“`java
\nimport java.math.BigDecimal;
\nimport java.util.UUID;
\nimport java.util.concurrent.CompletableFuture;<\/p>\n

\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n\/\/ GET BALANCE
\n\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\nCompletableFuture balanceFuture = playerDigitalManager.getDigital(playerUUID, “coins”);<\/p>\n

balanceFuture.thenAccept(balance -> {
\n \/\/ Executes on async thread – DO NOT call Bukkit API directly here
\n getLogger().info(“Player balance: ” + balance.toPlainString());
\n});<\/p>\n

\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n\/\/ GIVE DIGITAL (Add to balance)
\n\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\nBigDecimal amountToGive = new BigDecimal(“100.50”);<\/p>\n

playerDigitalManager.giveDigital(playerUUID, “coins”, amountToGive)
\n .thenRun(() -> {
\n getLogger().info(“Successfully credited ” + amountToGive + ” coins”);
\n })
\n .exceptionally(ex -> {
\n getLogger().severe(“Failed to credit coins: ” + ex.getMessage());
\n return null;
\n });<\/p>\n

\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n\/\/ TAKE DIGITAL (Subtract from balance)
\n\/\/ Returns false if insufficient balance
\n\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\nBigDecimal amountToTake = new BigDecimal(“50.00”);<\/p>\n

playerDigitalManager.takeDigital(playerUUID, “coins”, amountToTake)
\n .thenAccept(success -> {
\n if (success) {
\n getLogger().info(“Successfully debited ” + amountToTake + ” coins”);
\n } else {
\n getLogger().warning(“Insufficient balance for debit operation”);
\n }
\n });<\/p>\n

\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n\/\/ SET DIGITAL (Absolute value assignment)
\n\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\nBigDecimal newBalance = new BigDecimal(“1000.00”);<\/p>\n

playerDigitalManager.setDigital(playerUUID, “coins”, newBalance)
\n .thenRun(() -> {
\n getLogger().info(“Balance set to ” + newBalance);
\n });<\/p>\n

\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n\/\/ GET ALL PLAYER DIGITALS
\n\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\nplayerDigitalManager.getPlayerDigitals(playerUUID)
\n .thenAccept(digitals -> {
\n digitals.forEach((name, value) -> {
\n getLogger().info(name + “: ” + value);
\n });
\n });
\n“`<\/p>\n

### Server Digital Operations<\/p>\n

Server digitals are **server-wide variables** (e.g., world boss HP, event counters).<\/p>\n

“`java
\n\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n\/\/ GET SERVER DIGITAL
\n\/\/ Note: This is a synchronous operation that reads from cache
\n\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\nBigDecimal worldBossHp = digitalManager.getDigitalMap().get(“world_boss_hp”);<\/p>\n

\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n\/\/ MODIFY SERVER DIGITAL (Async operations)
\n\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\ndigitalManager.giveDigital(“world_boss_hp”, new BigDecimal(“1000”))
\n .thenRun(() -> getLogger().info(“World boss HP increased”));<\/p>\n

digitalManager.takeDigital(“world_boss_hp”, new BigDecimal(“500”))
\n .thenAccept(success -> {
\n if (success) {
\n getLogger().info(“World boss HP decreased”);
\n }
\n });<\/p>\n

digitalManager.setDigital(“world_boss_hp”, new BigDecimal(“10000”))
\n .thenRun(() -> getLogger().info(“World boss HP reset”));
\n“`<\/p>\n

### Global Player Digitals<\/p>\n

Global digitals are **currencies available to all players** (e.g., “coins”, “gems”). Once created, every player automatically has access to this digital type.<\/p>\n

“`java
\n\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n\/\/ CREATE GLOBAL DIGITAL
\n\/\/ Parameters: name, initialAmount, limit (-1 = no limit)
\n\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\ndigitalManager.createGlobalDigital(“gems”, 0.0, -1.0)
\n .thenRun(() -> {
\n getLogger().info(“Created global digital ‘gems’ – available to all players”);
\n });<\/p>\n

\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n\/\/ CHECK IF GLOBAL DIGITAL EXISTS
\n\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\ndigitalManager.isGlobalDigitalExists(“gems”)
\n .thenAccept(exists -> {
\n if (exists) {
\n getLogger().info(“‘gems’ is a registered global digital”);
\n }
\n });<\/p>\n

\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n\/\/ GET ALL GLOBAL DIGITALS
\n\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\ndigitalManager.getGlobalDigitals()
\n .thenAccept(globals -> {
\n globals.forEach((name, defaultAmount) -> {
\n getLogger().info(“Global: ” + name + ” (default: ” + defaultAmount + “)”);
\n });
\n });
\n“`<\/p>\n

### Error Handling Patterns<\/p>\n

**All async operations should implement proper exception handling:**<\/p>\n

“`java
\nplayerDigitalManager.getDigital(playerUUID, “coins”)
\n .thenAccept(balance -> {
\n \/\/ Success path
\n processBalance(balance);
\n })
\n .exceptionally(ex -> {
\n \/\/ Error path – database connection, timeout, etc.
\n getLogger().severe(“Database operation failed: ” + ex.getMessage());<\/p>\n

\/\/ Log full stack trace for debugging
\n if (getConfig().getBoolean(“debug”, false)) {
\n ex.printStackTrace();
\n }<\/p>\n

\/\/ Return null for Void-returning futures
\n return null;
\n });<\/p>\n

\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n\/\/ CHAINED OPERATIONS WITH ERROR PROPAGATION
\n\/\/ \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\nplayerDigitalManager.getDigital(playerUUID, “coins”)
\n .thenCompose(balance -> {
\n if (balance.compareTo(new BigDecimal(“100”)) >= 0) {
\n return playerDigitalManager.takeDigital(playerUUID, “coins”, new BigDecimal(“100”));
\n }
\n return CompletableFuture.completedFuture(false);
\n })
\n .thenAccept(success -> {
\n if (success) {
\n \/\/ Proceed with purchase logic
\n }
\n })
\n .exceptionally(ex -> {
\n getLogger().severe(“Transaction failed: ” + ex.getMessage());
\n return null;
\n });
\n“`<\/p>\n

—<\/p>\n

## Core API Reference<\/p>\n

### PlayerDigitalManager<\/p>\n

Manages **player-specific digitals** (currencies, points, custom variables).<\/p>\n

| Method Signature | Return Type | Description |
\n|—————–|————-|————-|
\n| `getDigital(UUID playerUUID, String digitalName)` | `CompletableFuture` | Retrieves the player’s balance for the specified digital. Returns `BigDecimal.ZERO` if not found. |
\n| `setDigital(UUID playerUUID, String digitalName, BigDecimal amount)` | `CompletableFuture` | Sets the player’s balance to an exact value. Auto-creates the digital if it doesn’t exist. |
\n| `giveDigital(UUID playerUUID, String digitalName, BigDecimal amount)` | `CompletableFuture` | Adds the specified amount to the player’s balance. Respects configured limits. |
\n| `takeDigital(UUID playerUUID, String digitalName, BigDecimal amount)` | `CompletableFuture` | Subtracts the amount from balance. Returns `false` if insufficient funds. **Atomic operation.** |
\n| `getLimit(UUID playerUUID, String digitalName)` | `CompletableFuture` | Gets the maximum balance limit. Returns `null` if no limit is set. |
\n| `setLimit(UUID playerUUID, String digitalName, BigDecimal limit)` | `CompletableFuture` | Sets the maximum balance limit. Pass `null` to remove the limit. |
\n| `getPlayerDigitals(UUID playerUUID)` | `CompletableFuture>` | Returns all digitals and their values for a player. |
\n| `getPlayerDigitalLimits(UUID playerUUID)` | `CompletableFuture>` | Returns all digitals and their limits for a player. |
\n| `isDigitalExists(UUID playerUUID, String digitalName)` | `CompletableFuture` | Checks if the digital exists for the player (includes global digitals). |
\n| `createDigital(UUID playerUUID, String digitalName, BigDecimal initialAmount, BigDecimal limit)` | `CompletableFuture` | Creates a player-specific digital (rarely needed; auto-created on first use). |
\n| `removeDigital(UUID playerUUID, String digitalName)` | `CompletableFuture` | Removes a player-specific digital entry. |
\n| `grantDigital(UUID playerUUID, String digitalName, BigDecimal amount)` | `CompletableFuture` | Grants a special digital to a player (creates if not exists). |
\n| `revokeDigital(UUID playerUUID, String digitalName)` | `CompletableFuture` | Revokes\/removes a digital from a player. |
\n| `loadPlayerData(UUID playerUUID)` | `CompletableFuture` | Pre-loads player data into cache. Called automatically on player join. |
\n| `unloadPlayerData(UUID playerUUID)` | `void` | Removes player data from memory cache. Called automatically on player quit. |
\n| `clearCache()` | `void` | Clears all cached player data. Use with caution. |<\/p>\n

### DigitalManager<\/p>\n

Manages **server-level digitals** and **global player digital definitions**.<\/p>\n

| Method Signature | Return Type | Description |
\n|—————–|————-|————-|
\n| `getDigitalMap()` | `Map` | Returns all server digitals and their current values (synchronous cache read). |
\n| `getDigitalLimitMap()` | `Map` | Returns all server digitals and their limits. |
\n| `setDigital(String digitalName, BigDecimal amount)` | `CompletableFuture` | Sets a server digital to an exact value. |
\n| `giveDigital(String digitalName, BigDecimal amount)` | `CompletableFuture` | Adds to a server digital’s value. |
\n| `takeDigital(String digitalName, BigDecimal amount)` | `CompletableFuture` | Subtracts from a server digital. Returns `false` if insufficient. |
\n| `removeDigital(String digitalName)` | `CompletableFuture` | Removes a server digital entirely. |
\n| `getLimit(String digitalName)` | `BigDecimal` | Gets the limit for a server digital (synchronous). |
\n| `setLimit(String digitalName, BigDecimal limit)` | `CompletableFuture` | Sets the limit for a server digital. |
\n| `isDigitalExists(String digitalName)` | `CompletableFuture` | Checks if a server digital exists. |
\n| `renameDigital(String oldName, String newName)` | `CompletableFuture` | Renames a server digital. Updates cache and Redis. |<\/p>\n

#### Global Digital Methods<\/p>\n

| Method Signature | Return Type | Description |
\n|—————–|————-|————-|
\n| `createGlobalDigital(String digitalName, double initialAmount, double limit)` | `CompletableFuture` | Creates a global digital available to all players. Pass `-1` for no limit. |
\n| `isGlobalDigitalExists(String digitalName)` | `CompletableFuture` | Checks if a global digital definition exists. |
\n| `removeGlobalDigital(String digitalName)` | `CompletableFuture` | Removes a global digital definition. **Does not delete player data.** |
\n| `getGlobalDigitals()` | `CompletableFuture>` | Returns all global digital definitions. |
\n| `getGlobalDigitalAmount(String digitalName)` | `CompletableFuture` | Gets the default amount for a global digital. |
\n| `getGlobalDigitalLimit(String digitalName)` | `CompletableFuture` | Gets the limit for a global digital. |<\/p>\n

—<\/p>\n

## Thread Safety & Concurrency<\/p>\n

### Async-First Architecture<\/p>\n

**Critical Rule:** All NDS-API methods that perform I\/O operations are asynchronous and return `CompletableFuture`.<\/p>\n

“`java
\n\/\/ \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
\n\/\/ \u2551 CORRECT: Non-blocking async pattern \u2551
\n\/\/ \u255a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255d
\nplayerDigitalManager.getDigital(playerUUID, “coins”)
\n .thenAccept(balance -> {
\n \/\/ This callback executes on a virtual thread (Java 21)
\n \/\/ Safe for I\/O operations, NOT safe for Bukkit API calls
\n processBalanceAsync(balance);
\n });<\/p>\n

\/\/ \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
\n\/\/ \u2551 INCORRECT: Blocking the main thread \u2551
\n\/\/ \u255a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255d
\n\/\/ \u26a0\ufe0f NEVER DO THIS – Will cause server lag\/freeze
\nBigDecimal balance = playerDigitalManager.getDigital(playerUUID, “coins”).get();
\n“`<\/p>\n

### Bukkit\/Paper Thread Model<\/p>\n

When you need to interact with the Bukkit API from an async callback, you **must** schedule the operation on the main thread:<\/p>\n

“`java
\nplayerDigitalManager.getDigital(playerUUID, “coins”)
\n .thenAccept(balance -> {
\n \/\/ Schedule Bukkit API calls on the main thread
\n Bukkit.getScheduler().runTask(plugin, () -> {
\n Player player = Bukkit.getPlayer(playerUUID);
\n if (player != null && player.isOnline()) {
\n player.sendMessage(“Your balance: ” + balance.toPlainString());
\n }
\n });
\n });
\n“`<\/p>\n

### Folia Region Scheduler<\/p>\n

For **Folia** servers, use the entity\/region scheduler instead of the global scheduler:<\/p>\n

“`java
\nplayerDigitalManager.getDigital(playerUUID, “coins”)
\n .thenAccept(balance -> {
\n \/\/ For Folia: Use the entity’s scheduler
\n Player player = Bukkit.getPlayer(playerUUID);
\n if (player != null && player.isOnline()) {
\n player.getScheduler().run(plugin, scheduledTask -> {
\n player.sendMessage(“Your balance: ” + balance.toPlainString());
\n }, null);
\n }
\n });
\n“`<\/p>\n

**Thread Model Summary:**<\/p>\n

| Environment | Callback Thread | Bukkit API Access |
\n|————-|—————–|——————-|
\n| Bukkit\/Paper | Virtual Thread (async) | Requires `Bukkit.getScheduler().runTask()` |
\n| Folia | Virtual Thread (async) | Requires `entity.getScheduler().run()` or `RegionScheduler` |<\/p>\n

—<\/p>\n

## Data Model<\/p>\n

### Digital Types<\/p>\n

| Type | Scope | Use Case | Example |
\n|——|——-|———-|———|
\n| **Player Digital** | Per-player | Player-specific currencies\/variables | Player’s private bank balance |
\n| **Global Player Digital** | Definition \u2192 All Players | Standard currencies everyone has | `coins`, `gems`, `points` |
\n| **Server Digital** | Server-wide | World state, event counters | `world_boss_hp`, `server_event_score` |<\/p>\n

### JSONB Structure<\/p>\n

**Player Data Example:**<\/p>\n

“`json
\n{
\n “coins”: 1500.50,
\n “gems”: 42,
\n “stamina”: 100,
\n “_limits”: {
\n “coins”: 1000000,
\n “stamina”: 160
\n }
\n}
\n“`<\/p>\n

**Server Data Example (uuid = ‘00000000-0000-0000-0000-000000000000’):**<\/p>\n

“`json
\n{
\n “world_boss_hp”: 50000,
\n “event_score”: 12500,
\n “_global_digitals”: {
\n “coins”: { “initial”: 0, “limit”: -1 },
\n “gems”: { “initial”: 0, “limit”: 9999 }
\n }
\n}
\n“`<\/p>\n

—<\/p>\n

## Configuration Reference<\/p>\n

Complete configuration with all available options:<\/p>\n

“`yaml
\n# \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n# PostgreSQL Configuration (Required)
\n# \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\npostgresql:
\n host: “localhost”
\n port: 5432
\n database: “minecraft”
\n username: “postgres”
\n password: “your_secure_password”<\/p>\n

# Connection pool settings
\n poolSize: 50 # Maximum connections in pool
\n connectionTimeout: 30000 # Connection timeout (ms)
\n idleTimeout: 600000 # Idle connection timeout (ms)
\n maxLifetime: 1800000 # Maximum connection lifetime (ms)<\/p>\n

# \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n# Redis Configuration (Optional – for cross-server sync)
\n# \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\nredis:
\n enabled: true
\n host: “localhost”
\n port: 6379
\n password: “”
\n timeout: 3000<\/p>\n

# Channel prefixes for Pub\/Sub
\n channels:
\n player: “nds:player:”
\n server: “nds:server:”
\n global: “nds:global:”<\/p>\n

# \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n# Digital Definitions
\n# \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\ndigitals:
\n coins:
\n display_name: “Coins”
\n persist_on_zero: false # Delete entry when balance reaches 0<\/p>\n

gems:
\n display_name: “Gems”
\n persist_on_zero: true # Keep entry even at 0 balance<\/p>\n

# \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\n# Vault Integration (Compatibility Layer)
\n# \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550
\nvault:
\n enabled: true
\n enabled_digitals:
\n – “coins”
\n default_currency: “coins”
\n“`<\/p>\n

—<\/p>\n

## Protocol Specification<\/p>\n

NDS-API is built on a **cross-platform protocol specification** designed for multi-language SDK support.<\/p>\n

### Protocol Domains<\/p>\n

| Domain | Description |
\n|——–|————-|
\n| **Identity** | Player\/Server\/System identity abstraction with UUID-based addressing |
\n| **Asset** | Currency\/variable definitions with scopes (Player, Global, Server) |
\n| **Event** | Append-only event sourcing for immutable audit trails |
\n| **Transaction** | Atomic operations with configurable consistency modes |
\n| **Result** | Standardized success\/failure response envelope |<\/p>\n

### Protocol Repository<\/p>\n

For the full protocol specification, multi-language SDK documentation, and Protocol Buffers definitions:<\/p>\n

**github.com\/Misty4119\/nds-api**<\/p>\n

—<\/p>\n

## Migration from Vault<\/p>\n

NDS-API includes a **Vault compatibility layer** for gradual migration.<\/p>\n

### Enabling Vault Compatibility<\/p>\n

“`yaml
\nvault:
\n enabled: true
\n enabled_digitals:
\n – “coins”
\n default_currency: “coins”
\n“`<\/p>\n

### Migration Strategy<\/p>\n

1. **Install NDS-API** alongside your existing Vault provider
\n2. **Enable Vault compatibility** in NDS-API configuration
\n3. **Test thoroughly** in a staging environment
\n4. **Migrate data** using the built-in migration tools
\n5. **Remove legacy Vault provider** once verification is complete<\/p>\n

—<\/p>\n

## Troubleshooting<\/p>\n

### Common Issues<\/p>\n

| Symptom | Cause | Solution |
\n|———|——-|———-|
\n| `NoieDigitalSystem-API not found!` | Plugin not installed or load order issue | Ensure JAR is in `plugins\/` and check `paper-plugin.yml` dependencies |
\n| Connection pool exhausted | Too many concurrent database operations | Increase `poolSize` in config; check for unclosed connections |
\n| Redis sync not working | Incorrect Redis configuration or firewall | Verify Redis connection; check `redis.enabled: true` |
\n| `ClassCastException` on API access | Multiple NDS versions loaded | Ensure only one NDS JAR is in `plugins\/` |
\n| Slow performance | Blocking main thread with `.get()` | Never use `.get()` on main thread; use async callbacks |<\/p>\n

### Debug Mode<\/p>\n

Enable debug logging for detailed diagnostics:<\/p>\n

“`yaml
\ndebug:
\n enabled: true
\n log_level: “DEBUG”
\n log_sql: true
\n“`<\/p>\n

—<\/p>\n

## Support<\/p>\n

– **Issues & Bug Reports:** GitHub Issues
\n– **Protocol SDK:** nds-api Repository
\n– **Documentation:** Wiki<\/p>\n

—<\/p>\n

## License<\/p>\n

“`
\nCopyright 2024-2026 Noie Linmimeng<\/p>\n

Licensed under the Apache License, Version 2.0 (the “License”);
\nyou may not use this file except in compliance with the License.
\nYou may obtain a copy of the License at<\/p>\n

http:\/\/www.apache.org\/licenses\/LICENSE-2.0<\/p>\n

Unless required by applicable law or agreed to in writing, software
\ndistributed under the License is distributed on an “AS IS” BASIS,
\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
\nSee the License for the specific language governing permissions and
\nlimitations under the License.
\n“`<\/p>\n

—<\/p>\n

\n

**NoieDigitalSystem** \u2014 Next-generation economy protocol for Minecraft.<\/p>\n

*Designed for the future. Built for today.*<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

Async-first, Redis Sync, High Performance Economy Engine for Developers.<\/p>\n","protected":false},"featured_media":109193,"template":"","meta":{"_minecraft_slug":"nds-api","_minecraft_project_id":"p5KYrpRK","_minecraft_author":"misty4119","_minecraft_license":"Apache-2.0","_minecraft_downloads":13,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"nds-api.zip","_minecraft_size_bytes":10682123,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:58:37.690967Z","_minecraft_date_created":"2026-03-02T22:18:10.207826Z","_minecraft_date_modified":"2026-01-29T17:10:26.257467Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/nds-api","_minecraft_icon_attachment_id":109193,"_minecraft_imported_at":"2026-06-06T10:07:47+00:00","_minecraft_import_hash":"da1e8ca5a2aa9edd4cc1c3239f18e3e5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,125,127],"mod_loader":[131,132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-109192","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-folia","mod_category-paper","mod_loader-folia","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nNDS-API - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/nds-api\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"NDS-API - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Async-first, Redis Sync, High Performance Economy Engine for Developers.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/nds-api\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"12 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nds-api\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nds-api\\\/\",\"name\":\"NDS-API - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nds-api\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nds-api\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/nds-api-icon-7fbbf5cfd05c02d48203855572838fd9e4eedbda_96.webp\",\"datePublished\":\"2026-06-06T10:07:45+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nds-api\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nds-api\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nds-api\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/nds-api-icon-7fbbf5cfd05c02d48203855572838fd9e4eedbda_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/nds-api-icon-7fbbf5cfd05c02d48203855572838fd9e4eedbda_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/nds-api\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"NDS-API\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"NDS-API - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/nds-api\/","og_locale":"en_US","og_type":"article","og_title":"NDS-API - Minecraft","og_description":"Async-first, Redis Sync, High Performance Economy Engine for Developers.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/nds-api\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"12 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/nds-api\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/nds-api\/","name":"NDS-API - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/nds-api\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/nds-api\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/nds-api-icon-7fbbf5cfd05c02d48203855572838fd9e4eedbda_96.webp","datePublished":"2026-06-06T10:07:45+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/nds-api\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/nds-api\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/nds-api\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/nds-api-icon-7fbbf5cfd05c02d48203855572838fd9e4eedbda_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/nds-api-icon-7fbbf5cfd05c02d48203855572838fd9e4eedbda_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/nds-api\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"NDS-API"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/109192","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/109193"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=109192"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=109192"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=109192"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=109192"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}