Zian GTS

✨ Zian GTS

Zian GTS is a secure and persistent Global Trade System for Cobblemon servers running Minecraft 1.21.1.

Buy, sell, inspect, withdraw, and manage Pokémon through a polished in-game marketplace designed for multiplayer servers.

---

🛒 Global Pokémon Marketplace

Publish Pokémon: Publish Pokémon directly from your party.

Browse Listings: View Pokémon currently available on the public market.

Buy Pokémon: Purchase Pokémon using the configured AVECOINS currency.

Withdraw Listings: Remove your own active listings safely.

Seller Earnings: Receive pending earnings after a successful sale.

Transaction History: Review completed purchases, sales, and claims.

Filters: Filter listings by Shiny, Alpha, Legendary, or personal ownership.

Sorting: Sort offers by price, level, or publication date.

Pagination: Navigate large markets without overwhelming the interface.

---

🔍 Detailed Pokémon Preview

Every listing can display detailed information before purchase.

Level: View the Pokémon's current level.

Gender: Check the Pokémon's gender.

Nature: Inspect the Pokémon's nature.

Ability: View the active ability.

Moves: Review the current moveset.

Individual Values: Inspect the Pokémon's IV values.

IV Radar: Use the visual IV radar to compare stats quickly.

Special Status: Detect Shiny, Alpha, and Legendary Pokémon.

Seller Information: See the seller and listing price before confirming a purchase.

---

💰 AVECOINS Economy Integration

Zian GTS integrates with the AVECOINS wallet system.

Supported AVECOINS Versions: 2.3 and 2.4.

Server Validation: Prices, balances, currencies, ownership, and transaction results are validated on the server.

Wallet Protection: The client cannot decide which currency is used or how much a player pays.

---

🛡️ Secure Multiplayer Architecture

Zian GTS is designed for multiplayer servers and uses server-side validation for every important operation.

Duplicate Purchase Protection: A listing cannot be purchased twice.

Ownership Validation: Players can only withdraw their own listings.

Pokémon Transfer Protection: Pokémon ownership is checked before and after delivery.

Persistent Market Data: Listings survive normal server restarts.

Persistent Earnings: Seller proceeds are stored safely until claimed.

Durable Transaction Journal: Sensitive operations are recorded in a recovery journal.

Crash Protection: Interrupted operations are preserved for administrative review.

Fail-Closed Recovery: Uncertain operations can temporarily block trading instead of being repeated automatically.

---

🔐 LuckPerms Support

LuckPerms is optional and is only required on the server.

General Access: ziangts.use

Browse Listings: ziangts.list

View Personal Listings: ziangts.mine

Publish Pokémon: ziangts.sell

Buy Pokémon: ziangts.buy

Withdraw Listings: ziangts.cancel

Claim Earnings: ziangts.claim

View Recovery Data: ziangts.admin.recovery

Resolve Recovery Operations: ziangts.admin.recovery.resolve

Explicit permission denials are respected, including for operators.

If LuckPerms is installed but unavailable, the affected action is denied for safety. Without LuckPerms, the default permissions remain active.

---

🎮 Commands

Player Commands

/gtsv2

/gtsv2 open

Administrative Commands

/gtsv2 status

/gtsv2 recovery

/gtsv2 recovery resolve <operation-uuid>

/gtsv2 recovery resolve <operation-uuid> confirm

Recovery commands should only be used after checking the AVECOINS wallet, Pokémon storage, pending earnings, and market state.

---

📦 Requirements

Minecraft: 1.21.1

Java: 21

NeoForge: 21.1.228 or newer

Cobblemon: 1.8 or newer

Kotlin for Forge: 5.10 or newer

AVECOINS: 2.3 or 2.4

Optional Permission System: LuckPerms compatible with NeoForge

Zian GTS has also been tested on Youer 1.21.1.

---

🧪 Beta 2.3

AVECOINS 2.4 Compatibility: Updated wallet validation and compatibility checks.

Permission Enforcement: Added server-side LuckPerms checks for all major GTS actions.

Safer Failures: Actions are denied when an installed LuckPerms provider cannot be queried.

Recovery Protection: Recovery resolution now requires execution on the Minecraft server thread.

Documentation: Improved permission, recovery, and transaction documentation.

Windows Testing: Improved crash-recovery tests for long Windows classpaths.

Interface: Updated GTS screens and shared visual styling.

Release Version: Updated the project and build artifact to 1.0.0-beta.2.3.

Zian GTS is currently in active beta development. Future releases may improve the interface, expand configuration options, update visual assets, and add additional compatibility improvements.

---

❤️ Support and Feedback

If you find a bug or compatibility issue, include the following information in your report.

Minecraft Version

NeoForge Version

Cobblemon Version

AVECOINS Version

Zian GTS Version

Server Software

Relevant Server Logs

Steps to Reproduce