- 版权类型
- 原创
- 插件中文名称
- 红烧月卡
- 插件英文名称
- HSMonthcard
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- Leaves
- 语言支持
- 中文(简体)
- 前置组件
- 无
- 适配版本(Java)
- 最新版本
- 26.x
- 1.21
- 1.20
高级月卡插件
角色领取动画 · 独立背景演出 · 多卡种月卡 · 每日祝福 · 自动续期管理 · 完全自定义
为什么使用 HSMonthcard ?
传统月卡插件通常只负责记录期限和执行奖励命令,玩家每天看到的仍然只是一条领取消息,HSMonthCard 将这套流程做成了完整的二游式月卡演出,玩家登录后可以查看剩余天数,点击领取今日祝福,并看到角色动画、独立背景、粒子、音效与奖励文字依次呈现,领取完成后再次点击即可退出,每种月卡都能拥有独立的角色动画、演出布局、每日奖励、购买奖励、权限权益和到期提醒,让你的月卡玩家体验更足!功能一览
嘛,就是月卡插件啦,简单下介绍特点:
- 二游式领取演出:角色动画、动态背景、粒子与音效完整呈现
- 多卡种独立配置:每张月卡拥有独立奖励、期限、权限和演出效果
- 灵活奖励接入:通过控制台命令兼容经济、货币与物品插件
- 自定义月卡标识:提供 PAPI 变量,可用于名称、Tab、聊天和菜单
使用与分发协议
- 插件仅限购买者在授权范围内使用
- 禁止分发、泄露、转售插件本体及附赠美术资源
- 对外分发或加入公开服务端整合包前,须取得作者书面许可
- 违反协议时,作者有权停止更新与售后服务
plugins/HSMonthCard/
├─ config.yml
├─ storage.yml
├─ messages.yml
├─ cards/
│ ├─ moonlight.yml
│ └─ 其他月卡.yml
├─ presentations/
│ ├─ moonlight.yml
│ └─ 其他演出.yml
├─ animations/
│ ├─ moonlight-idle/
│ ├─ moonlight-reward.gif
│ └─ moonlight-star-ring.gif
├─ generated/
│ └─ hsmonthcard.zip
├─ claims.yml
└─ data.db
├─ config.yml
├─ storage.yml
├─ messages.yml
├─ cards/
│ ├─ moonlight.yml
│ └─ 其他月卡.yml
├─ presentations/
│ ├─ moonlight.yml
│ └─ 其他演出.yml
├─ animations/
│ ├─ moonlight-idle/
│ ├─ moonlight-reward.gif
│ └─ moonlight-star-ring.gif
├─ generated/
│ └─ hsmonthcard.zip
├─ claims.yml
└─ data.db
YAML:
# 每日领取记录的刷新时间,格式为 HH:mm,使用服务器系统时区
daily-reset-time: "04:00"
auto-open:
# 玩家进入服务器后是否自动展示尚未领取的月卡;安装 AuthMe 时从认证成功后开始
enabled: true
# 自动展示前等待的游戏刻,20 ticks = 1 秒
join-delay-ticks: 40
# 多张月卡同时可领取时的处理方式:
# queue - 按卡种 priority 从高到低依次展示
# highest - 只展示 priority 最高的一张
multiple-card-mode: queue
# queue 模式下,两张月卡演出之间等待的游戏刻
next-card-delay-ticks: 10
claim:
# 玩家未加载演出资源时,/hsmc claim 是否直接发放奖励
command-fallback: true
# 领取记录保留天数,小于 1 时按 1 天处理
history-retention-days: 400
compatibility:
authme:
# 检测到 AuthMe 时,是否等待玩家登录或注册成功后再发送资源包和自动演出
enabled: true
resource-pack:
# 是否生成和使用 HSMonthCard 资源包,关闭后无法播放演出
enabled: true
# 是否由本插件在玩家加入时发送资源包
# 使用 CraftEngine、ItemsAdder 时应保持 false,避免重复发包
send-on-join: false
# send-on-join 为 true 时填写玩家可访问的完整下载地址
# 不能填写 127.0.0.1,除非客户端与服务端在同一台机器
public-url: ""
# true 时玩家拒绝或下载失败会被服务器断开连接
required: false
# 客户端资源包确认界面的提示,支持 MiniMessage
prompt: "<gold>月卡祝福演出需要加载资源包</gold>"
hosting:
# 是否启用插件内置 HTTP 托管,默认关闭
enabled: false
# HTTP 监听地址,0.0.0.0 表示监听所有网卡
bind-address: "0.0.0.0"
# HTTP 监听端口,范围 1-65535;端口必须未被其他程序占用
port: 8766
YAML:
# 文件名就是卡种 ID,文件名仅使用小写字母、数字、下划线或短横线
# 当前文件的卡种 ID 为 moonlight
# 是否加载这张月卡,false 时整张卡不会注册
enabled: true
# 月卡名称,支持 MiniMessage
display-name: "<gradient:#91d7ff:#fff2b0><bold>月光月卡</bold></gradient>"
# 卡种排序权重,数值越大越优先展示和作为主卡
priority: 100
duration:
# /hsmc demo 演示时显示的默认剩余天数,也作为 max-stacked-days 的下限
default-days: 30
# 最多可累计的有效天数,不得小于 default-days
max-stacked-days: 365
# 续费方式:
# extend - 在现有到期时间后继续增加天数
# replace - 从当前时间重新计算期限
renewal-mode: extend
presentation:
# 使用 presentations/<profile>.yml 中的哪套演出参数
profile: "moonlight"
# 动画路径均相对于 plugins/HSMonthCard/animations/,支持 GIF 或 PNG 帧目录
# 等待领取时循环播放的角色动画,不能为空
idle-animation: "moonlight-idle"
# 独立循环背景动画,留空即关闭,领取时不会重新开始播放
background-animation: "moonlight-star-ring.gif"
# 点击领取后播放的角色动画,留空时复用 idle-animation
reward-animation: "moonlight-reward.gif"
permission:
# 是否根据月卡有效状态自动添加或移除 active 权限
synchronize: false
# synchronize 为 true 时同步的权限节点
active: "hsmonthcard.card.moonlight"
# PAPI 展示变量的内容;值留空时对应变量返回空文本
placeholders:
# %hsmonthcard_badge% 或 %hsmonthcard_moonlight_badge%
badge: "&b[月光月卡] "
# %hsmonthcard_icon% 或 %hsmonthcard_moonlight_icon%
icon: "&b✦"
# %hsmonthcard_short_name% 或 %hsmonthcard_moonlight_short_name%
short-name: "&b月光"
daily-reward:
# 是否启用每日领取奖励
enabled: true
# 奖励名称与数量,可在演出文本和 commands 中使用
name: "月华结晶"
amount: 60
# 每日领取成功后由控制台执行的命令
# 可用:{player} {player_uuid} {card_id} {card_name} {remaining_days}
# {expiration_date} {reward_name} {reward_amount}
commands:
- "give {player} amethyst_shard {reward_amount}"
purchase-reward:
# 是否在 /hsmc give 首次开通或续费时发放一次购买奖励
enabled: false
# 购买奖励名称与数量,同样可在 commands 中使用
name: ""
amount: 0
# 开通或续费成功后由控制台执行的命令
commands:
# - "eco give {player} 300"
events:
# 首次开通、续费、撤销时额外执行的控制台命令
# 可用占位符与奖励 commands 相同
first-activation:
# - "say {player} 首次开通了 {card_name}"
renewal:
# - "say {player} 续费了 {card_name}"
revoke:
# - "say {player} 的 {card_name} 已被撤销"
reminders:
# 玩家登录时是否将这张卡加入未领取演出队列
unclaimed-on-join: true
# 剩余天数等于列表中的数值时发送到期提醒,不填写条目表示关闭
expiring-days:
- 3
- 1
作者与联系
QQ:2521192830爱发电:https://afdian.com/a/welosecraft