Home

DynamicPterodactyl

DynamicPterodactyl is a companion extension for Paymenter's built-in Pterodactyl integration. It adds live RAM, CPU, disk, and allocation quotes; short-lived checkout and upgrade commitments; deterministic node placement; capacity alerts; and operator diagnostics without replacing Paymenter's provisioning authority.

Current Architecture

The reconciled implementation is documented in Architecture Overview. It combines the preserved live resource-calculation work with the Paymenter 1.5.7 reservation, upgrade, and lifecycle remediation.

Key contracts:

• PterodactylInventoryService owns strict paginated reads of locations, nodes, servers, and allocations.
• ResourceCalculationService combines live inventory with local commitments and per-node NodeCapacityPolicy records.
• CPU capacity is configured locally; stock Pterodactyl does not expose a cpu_threads node field.
• Customer quotes expose aggregate capacity only. Node identities remain admin diagnostics.
• Cart events create and cancel commitments. Paid service and upgrade state is owned by the matching Paymenter lifecycle, not invoice or service-created listeners in this extension.
• Dynamic stock requires exclusive provisioning control for every eligible node, an encrypted application API key, scheduler health monitoring, and an exact reviewed extension/Paymenter commit pair.

Documentation Map

Start and operate

• Getting Started
• Configuration
• Deployment
• Testing
• Troubleshooting

Understand the system

• Architecture Overview
• Companion Extension Pattern
• Data Consistency Model
• Service Layer Design
• Event-Driven Architecture
• Core Services

Reference

• API Reference
• Database Schema
• Admin Interface
• Event System

Preserved Qoder Pages

All 42 pages from the earlier Qoder Wiki migration remain in this Wiki, along with their hierarchy and source trail. Deep-dive pages that describe retired controllers, listeners, services, or endpoint shapes are visibly marked as a preserved snapshot and point back to the canonical reconciled architecture.