README.md

English README

ArcPass

现代化的 Minecraft 服务器战斗通行证系统

English | 文档 | Discord

---

功能特性

• 🎮 多档位通行证 - 免费版、高级版及自定义档位
• 📅 赛季系统 - 管理赛季内容与专属奖励
• 🎯 任务系统 - 日常、周常、赛季、挑战任务
• ⏱️ 在线时长任务 - 使用 playtime 触发器按在线分钟累计进度
• 🎁 丰富奖励 - 物品、命令、经济、权限、称号、装饰
• 💰 多货币支持 - Vault/CMI 经济系统 及点卷插件 (PlayerPoints, CoinsEngine, TokenManager)
• 🏷️ 多称号插件 - DeluxeTags、TAB、PlayerTitle、NametagEdit 自动降级
• ✨ 装饰粒子 - PlayerParticles 集成，支持粒子效果奖励
• 🌐 多语言支持 - 内置国际化系统
• ⚡ Folia 兼容 - 完整支持 Folia 服务器
• 🔌 开发者 API - 轻松与您的插件集成

环境要求

• Java 17 或更高版本
• Paper/Spigot 1.18+ 或 Folia 1.20+
• (可选) Vault / CMI - 经济系统集成
• (可选) PlayerPoints / CoinsEngine / TokenManager - 点卷货币
• (可选) PlaceholderAPI - 变量支持
• (可选) LuckPerms - 权限奖励
• (可选) DeluxeTags / TAB / PlayerTitle / NametagEdit - 称号奖励
• (可选) PlayerParticles - 装饰粒子奖励

安装方法

1. 从 Releases 下载 ArcPass.jar
2. 将文件放入服务器的 plugins 文件夹
3. 重启服务器
4. 在 plugins/ArcPass/ 中配置插件
5. 在 license.yml 中填入您的许可证密钥

命令列表

命令	描述	权限
/ap	打开主菜单	arcpass.use
/ap level	查看当前等级	arcpass.command.level
/ap quests	查看任务	arcpass.command.quests
/ap claim	领取奖励	arcpass.command.claim
/ap admin	管理员面板	arcpass.admin

配置文件

config.yml

# 默认语言
locale:
  default: zh_CN

# 通行证设置
pass:
  max-level: 100
  base-experience: 100
  experience-multiplier: 1.1

# 调试模式
debug: false

开发者 API

Gradle (Kotlin DSL)

repositories {
    maven("https://maven.pkg.github.com/KiteMC/ArcPass")
}

dependencies {
    compileOnly("com.kitemc:arcpass-api:1.8.3")
}

Maven

<repository>
    <id>github</id>
    <url>https://maven.pkg.github.com/KiteMC/ArcPass</url>
</repository>

<dependency>
    <groupId>com.kitemc</groupId>
    <artifactId>arcpass-api</artifactId>
    <version>1.8.3</version>
    <scope>provided</scope>
</dependency>

使用示例

import com.kitemc.arcpass.api.ArcPassAPI;
import com.kitemc.arcpass.api.ArcPassProvider;

public class MyPlugin extends JavaPlugin {

    @Override
    public void onEnable() {
        // 检查 ArcPass 是否已加载
        if (ArcPassProvider.isLoaded()) {
            ArcPassAPI api = ArcPassProvider.get();

            // 获取玩家数据
            api.getPlayerData(player.getUniqueId())
                .thenAccept(data -> {
                    data.ifPresent(playerData -> {
                        int level = playerData.getLevel();
                        getLogger().info("玩家等级: " + level);
                    });
                });

            // 添加经验
            api.addExperience(player.getUniqueId(), 100);
        }
    }
}

事件监听

@EventHandler
public void onLevelUp(PlayerLevelUpEvent event) {
    Player player = Bukkit.getPlayer(event.getPlayerId());
    if (player != null) {
        player.sendMessage("恭喜！您已达到 " + event.getNewLevel() + " 级");
    }
}

变量 (PlaceholderAPI)

需要安装 PlaceholderAPI。

变量	描述
%arcpass_level%	当前等级
%arcpass_exp%	总经验值
%arcpass_exp_next%	升级所需经验
%arcpass_rank_level%	等级排行榜排名
%arcpass_rank_exp%	经验排行榜排名

技术支持

• 📖 在线文档
• 💬 Discord
• 📧 邮箱: starry_cbz@outlook.com

许可协议

本插件为付费插件，禁止未经授权的传播。

© 2024-2026 KiteMC. 保留所有权利。