Cotani Framework v1.1.2 ยท Java 25 ยท Paper 26.2

Cotani API Documentation

Official API javadocs for modular Paper & Folia plugin architecture with non-blocking execution and clear contracts.

๐ŸŽ–๏ธ
Gameplay

cotani-achievement

Asynchronous player achievements with statistic criteria, idempotent unlocks, rewards, events, and SQL progress.

๐Ÿงพ
Operations

cotani-audit

Immutable append-only audit events with bounded queries and async persistence.

๐Ÿ—„๏ธ
Operations

cotani-audit-storage

Idempotent SQL persistence adapter with indexed queries and migrations for audit events.

๐Ÿง 
Infrastructure

cotani-cache

Caffeine-backed caches with automatic dirty tracking, bulk flushing, and persistence.

๐Ÿงน
Operations

cotani-cleanup

Safe asynchronous cleanup of loaded world entities with preview mode, allow-list policies, batching, and region-thread removal.

โšก
Gameplay

cotani-command

Declarative command framework with async arguments, cooldowns, and Folia thread safety.

โš™๏ธ
Infrastructure

cotani-config

YAML binding to immutable records with constraint validation and async reloads.

โฑ๏ธ
Gameplay

cotani-cooldown

Local and distributed SQL-backed cooldown limiters with automatic expiration pruning.

๐Ÿงฑ
Foundation

cotani-core

Centralized plugin lifecycle ownership and reverse-order resource disposal.

๐Ÿ’ฌ
Gameplay

cotani-dialog

Non-blocking reactive chat, sign, and anvil prompt dialogs with cancellation and timeouts.

๐Ÿช„
Gameplay

cotani-display

Modern Display Entity engine for text, item, and block holograms.

๐Ÿ’ฐ
Gameplay

cotani-economy

Exact BigDecimal economy with atomic transactions and idempotency guarantees.

๐Ÿ“ข
Gameplay

cotani-event

Reflection-free, high-performance event bus with execution order prioritizations.

๐Ÿค
Gameplay

cotani-friend

Immutable asynchronous friendships, requests, blocks, optimistic revisions, and domain events.

๐Ÿ“ฆ
Gameplay

cotani-gui

Declarative reactive inventory interfaces, pagination, and anti-exploit click debounce.

๐Ÿ–ฅ๏ธ
Gameplay

cotani-hud

Reactive zero-flicker scoreboards, dynamic tablist, bossbars, and actionbars.

๐ŸŽ’
Gameplay

cotani-inventory

Loss-less binary inventory synchronization, snapshots, rollbacks, and dupe-proof cross-server transfers.

๐Ÿ—ก๏ธ
Foundation

cotani-item

Fluent Paper 1.21+ data-component item, armor, and player skull builders.

๐Ÿ—“๏ธ
Infrastructure

cotani-job

Persistent named jobs with retries, recurring schedules, cancellation, and crash recovery.

๐ŸŒ
Foundation

cotani-locale

Player locale preferences, deterministic message fallback, and safe MiniMessage rendering.

๐Ÿ“
Gameplay

cotani-location

Immutable asynchronous homes and warps with safe Paper and Folia teleport integration.

โœ‰๏ธ
Gameplay

cotani-mail

Persistent asynchronous player mail with TTL, idempotent sends, inbox pagination, and SQL storage.

๐Ÿ›’
Gameplay

cotani-market

Persistent player marketplace with bounded listings, idempotent purchases, recovery-safe settlement, and SQL storage.

๐Ÿ“Š
Operations

cotani-metrics

Micrometer metrics instrumentation with optional Prometheus HTTP exporter endpoint.

๐Ÿท๏ธ
Gameplay

cotani-nametag

Scoreboard team-driven nametag formatting, tablist sorting priority, and collision rules.

๐Ÿ“ฆ
Module

cotani-npc

Cotani โ€” high-performance virtual NPC and packet interaction module for Paper and Folia

๐Ÿ“ฆ
Module

cotani-party

Cotani - asynchronous party and group service

๐Ÿ“ฆ
Module

cotani-permission

Cotani - asynchronous permission service

๐Ÿ“ฆ
Module

cotani-placeholder

High-performance placeholder parsing and resolution with optional PlaceholderAPI bridge.

โš–๏ธ
Gameplay

cotani-punishment

Immutable asynchronous bans, mutes, warnings, expiration, revocation, and audit integration.

๐Ÿงญ
Gameplay

cotani-quest

Objective-based player quests with optimistic progress, idempotent claims, events, and SQL storage.

๐ŸŽฏ
Gameplay

cotani-queue

Asynchronous priority queues, expiring tickets, and atomic matchmaking groups.

๐Ÿ†
Gameplay

cotani-ranking

Named, bounded player rankings backed by cotani-statistics.

๐ŸŒ
Infrastructure

cotani-redis

Non-blocking Redis client, pub/sub messaging, distributed locks, and cross-server sync.

๐Ÿ“ฆ
Module

cotani-region

Cotani โ€” high-performance 3D spatial region and protection module for Paper and Folia

๐ŸŽ
Gameplay

cotani-reward

Persistent idempotent player rewards with cooldowns, streaks, immutable grants, and SQL storage.

๐Ÿ”—
Gameplay

cotani-reward-integration

Idempotent economy and entity-thread-safe inventory settlement adapters for rewards.

๐Ÿ—“๏ธ
Gameplay

cotani-season

Seasonal player progression with idempotent experience grants, cumulative levels, reward claims, events, and SQL storage.

๐Ÿ“ˆ
Gameplay

cotani-statistics

Atomic asynchronous player statistics with bounded rankings, domain events, and SQL persistence.

๐Ÿ’พ
Infrastructure

cotani-storage

SQLite, MySQL, and MariaDB queries, schema migrations, and transaction management.

๐Ÿงต
Foundation

cotani-task

Async, global, region, and entity scheduling with fluent TaskChain thread transitions.

๐ŸŒ€
Gameplay

cotani-teleport

Policy-driven teleport pipelines with hazard checks, combat tags, and countdown warps.

โœ๏ธ
Foundation

cotani-text

MiniMessage text formatting, audience messaging, and placeholder resolution.

๐Ÿค
Gameplay

cotani-trade

Confirmation-based player trading with immutable offers and idempotent settlement.

๐Ÿ‘ค
Gameplay

cotani-user

Async user profile resolution, online caching, and session lifecycle management.