CoinsAndPoint是一个_双货币_的经济API

一、插件简介

Coins And Point 是适配 Paper 1.21.11 开发的轻量化、高稳定双货币经济插件，内置金币（coins）+点券（point）两套独立货币体系，无实体物品、纯数值存储，完美适配生存、RPG、公益服、小游戏各类服务器。 插件采用单文件全局存储，无需拆分玩家文件，维护简单；自带管理员操作二次确认机制，杜绝误操作；支持全自动定时保存、关服强制保存，数据零丢失风险；全部文本可自定义配色，兼容服务器彩色格式符号，同时提供全局占位符，可对接计分板、GUI界面等场景。

二、主要功能

• 双货币独立体系：金币(long)、点券(int)，双货币禁止负数，数值安全严谨，转账、扣款自动校验余额
• 安全管理机制：OP增减货币需30秒二次确认，超时、输入其他内容自动取消，防误删误加数据
• 全自动数据存储：服务启动自动加载、关闭强制全量保存、玩家在线状态5秒定时自动保存，杜绝数据丢失
• 全配置化文本：所有提示语句统一在 config.yml 配置，支持彩色符号，可自由修改适配服务器风格
• 玩家自由转账：支持金币、点券双向玩家互转，余额不足自动拦截并提示
• 通用占位符支持：内置双货币全局占位符，适配计分板、玩家信息、GUI等场景
• 轻量化无冗余：无多余依赖、无实体货币、无卡顿线程，低资源占用，适配各类配置服务器

- 预留拓展接口：开放UUID货币读写接口，可后续对接充值后台、商城系统、任务奖励等拓展功能

三、指令合集

玩家可用类

• 指令 功能
• /money 查看自身金币、点券数量
• /coins 查看自身金币数量
• /point 查看自身点券数量
• /pay coins [玩家] [数量] 给特定玩家支付金币 金币不足时自动取消
• /pay point [玩家] [数量] 给特定玩家支付点券 点券不足时自动取消

管理操作类

• 指令 功能
• /coins add/take [玩家] [数量] 添加/扣除特定玩家的金币
• /point add/take [玩家] [数量] 添加/扣除特定玩家的点券
• （注：管理指令需要二次执行来确认）

CoinsAndPoint is an economic API with dual-currency

I. Plugin Overview

Coins And Point is a lightweight and highly stable dual-currency economy plugin developed for Paper 1.21.11. It features two independent currency systems: coins and points, with no physical items and pure numerical storage. It is fully compatible with survival, RPG, public welfare and minigame servers of all types. The plugin uses single-file global storage without separate player files for easy maintenance. It comes with a secondary confirmation mechanism for administrator operations to prevent misoperations. It supports automatic scheduled saving and forced saving upon server shutdown to eliminate risks of data loss. All text supports customizable color schemes and server color format codes, along with global placeholders compatible with scoreboards, GUIs and other scenarios.

II. Core Functions

• Independent dual-currency system: Coins (long type) and Points (int type). Negative balances are prohibited for both currencies with strict value validation; balance checks run automatically during transfers and deductions.
• Secure management mechanism: OPs must confirm currency adjustments within 30 seconds. The operation auto-cancels upon timeout or irrelevant input to avoid incorrect data additions or deletions.
• Fully automatic data storage: Auto-loads data on server startup, performs full forced saves on shutdown, and runs automatic 5-second interval saves while players are online to prevent data loss.
• Fully configurable text: All message prompts are centralized in config.yml with color code support, fully editable to match server styles.
• Player peer-to-peer transfers: Two-way transfers of coins and points between players, with automatic blocking and prompts for insufficient balances.
• Universal placeholder support: Built-in global dual-currency placeholders compatible with scoreboards, player info panels, GUIs and more.
• Lightweight and streamlined: No redundant dependencies, no physical currency items, no laggy threads, low resource consumption, compatible with servers of all hardware configurations.

- Reserved extension interfaces: Exposed UUID-based currency read/write interfaces for future integration with payment backends, mall systems, quest rewards and other extended features.

III. Full Command List

Player Commands

• Command Function
• /money Check personal coin and point balances
• /coins Check personal coin balance
• /point Check personal point balance
• /pay coins [Player] [Amount] Send coins to a target player; auto-cancels if coins are insufficient
• /pay point [Player] [Amount] Send points to a target player; auto-cancels if points are insufficient

Administrator Commands

• Command Function
• /coins add/take [Player] [Amount] Add or deduct coins for a target player
• /point add/take [Player] [Amount] Add or deduct points for a target player
• (Note: Administrator commands require secondary execution for confirmation)